koishi-plugin-go-bank

围棋题库管理与训练插件，提供快捷出题、沉浸刷题、SM-2 复习、个人训练计划、定时推送等功能。

版本

v0.0.9 — 2026-05-17

指令

快捷出题

| 指令 | 说明 | |---|---| | !8k | 随机一道 8K 题（含 8K+） | | !8k 10 | 随机十道 8K 题 | | !官子 | 随机一道官子题 | | !官子-8k | 随机一道 8K 官子题 | | !官子-8k 5 | 随机五道 8K 官子题 |

支持难度：18K~1K(+), 1D~7D(+)。支持类型：死活、对杀、手筋、官子、其他。

数量上限 20 题。

学习模式

| 指令 | 说明 | |---|---| | 查题 <类型> <难度> | 按类型+难度查询，如 查题 死活 3K | | 随机 | 完全随机一题，支持 -t -d 参数过滤 | | 复习 | 开始今日 SM-2 间隔复习 | | 今日计划 | 开始当日学习计划 | | 个人计划 | 设置/修改学习计划（模板填写） | | 重置个人计划 | 查看进度并重置计划 | | 统计 | 查看学习统计（正确率、累计等） |

做题操作

| 指令 | 说明 | |---|---| | 获取答案 | 查看当前题答案（session 内题目） | | 整点答案 | 查看最近一次推送题目的答案 | | 会了 / 勉强 / 忘了 | 提交自评，自动出下一题 | | 下一题 | 获取下一题（沉浸/复习/计划模式） | | 继续 | 继续下一组（计划模式） | | 退出 | 退出当前模式 |

其他

| 指令 | 说明 | |---|---| | 统计 | 查看学习统计 | | !帮助 / !help | 显示帮助 |

配置

go-bank:
  apiBaseUrl: 'http://127.0.0.1:8000'   # 后端 API 地址

  # 每日定时推送
  dailyPush:
    enabled: false
    time: '06:00'
    type: ''                            # 筛选题型留空=不限
    groups: []                          # 目标群号列表
    message: '☀️ 早上好！今日围棋题目已送达~'
    slots:
      - difficulty: ''
        count: 3

  # 整点推送（10:00-21:00）
  hourlyPush:
    enabled: false
    startHour: 10
    endHour: 21
    type: ''
    groups: []
    message: '⏰ 整点一道围棋题：'
    slots:
      - difficulty: ''
        count: 1

架构

src/
├── index.ts        # 入口：配置 Schema、命令注册、调度器启动
├── api.ts          # GoBankAPI — 后端 HTTP 通信
├── middleware.ts   # 消息处理：获取答案/整点答案、评分、下一题、退出
├── parser.ts       # 快捷命令解析 (!8k, !官子-8k 等)
├── scheduler.ts    # 定时推送（每日+整点）+ 推送题目缓存
├── session.ts      # 内存会话管理（key=userId）
└── types.ts        # 类型定义 + 常量（难度层级、题型映射等）

核心设计

• 推送题目缓存：推送后按群号缓存题目，整点答案 指令根据 session.channelId 查缓存返回答案，与沉浸做题的 获取答案（依赖 session）完全解耦
• 随机取题修复 (v0.0.7)：randomProblems 从分页列表 page=1 改为循环调用 /api/problems/random 真实随机端点，避免每次推送返回相同题目
• SM-2 间隔复习：后端驱动，会了(4) / 勉强(3) / 忘了(1) 三级自评
• 个人计划：模板填写 → 每日生成新题+复习混合计划 → 分组推进

变更记录

v0.0.9

• 新增 整点答案 指令，查看推送题目答案，与 session 无关
• 推送消息模板化：去掉题目编号/难度/类型文字，图片含题目信息
• 推送底部文案：发送 "整点答案" 查看答案

v0.0.7

• 修复 randomProblems 非随机 bug：从分页列表 page=1 改为循环调用 /api/problems/random

v0.0.6 及之前

• 初始版本：快捷出题、沉浸刷题、SM-2 复习、个人计划、定时推送