前言¶

DSH 强调插件化，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。在这个生态里，很多插件用于扩展 agent 的能力边界。对于学习或复习场景，直接让 agent 解释知识点，和“做题、暴露问题、再练”的流程并不一样。

dsh-teacher 是一个 DSH 插件。它从 markdown 问题集出发，让 agent 以提问方式推进，不在过程中直接给出答案，并在会话中记录 knowledge gaps，再用 FSRS-5 spaced-repetition schedule 对到期缺口做 on-demand retest。

这是什么¶

dsh-teacher 的定位是：

DSH teacher plugin: Socratic tutor that leads you to answers from a markdown question set, tracks knowledge gaps in-session, and retests them on a spaced-repetition schedule.

它解决的问题，是把“让 agent 讲解”变成“围绕问题集进行提问、评分和重测”。

已核实资料中的仓库地址为：

https://github.com/Yihong89/dsh-teacher

资料中未单独确认维护者身份；仓库路径显示为 Yihong89/dsh-teacher。package.json 中声明许可证为 MIT，版本为 0.3.0。

核心功能¶

下面介绍已核实的主要能力。

教师模式¶

插件把 agent 变成教师，策略是：

• never answers, always asks
• 教师策略隐藏 answer keys
• 不直接给出答案

这个模式的目标不是直接解释，而是从问题出发，由 agent 提问并引导作答。

问题集与 SQLite 存储¶

插件可以从 markdown 问题集加载课程，并持久化到 SQLite question store。

已核实事实中说明存储对象包括：

• courses
• questions
• quiz runs

运行环境要求 DSH rc.6+ 和 Node ≥ 22.5，并使用内置 node:sqlite。

知识缺口跟踪¶

插件会在会话中跟踪 knowledge gaps，并用 SQLite gap ledger 做跨会话持久化。

相关工具包括：

• note_gap
• grade_answer
• retest
• summary

间隔复习¶

插件使用 FSRS-5 spaced-repetition schedule 对到期 gaps 做 on-demand retest。

也就是说，缺口被记录后，可以进入后续重测流程，而不是只在当前会话里出现一次。

LLM-free quiz¶

插件提供 LLM-free quiz popup，支持：

• MCQ
• free-text

提交接口为：

POST /dsh-teacher/quiz/submit

这个 quiz 是 LLM-free 的，完成后再交给 teacher 的 LLM analysis 处理。

评分与苏格拉底式讲解¶

插件提供 post-quiz LLM analysis/grading，工具名为 analyze_quiz，并对错误点做 Socratic walk。

Web client¶

Web client 提供：

• quiz cards
• gaps button
• gap panel

这些组件用于在浏览器侧查看题目、缺口和相关面板状态。

安装与启用¶

安装前确认环境满足：

• DSH rc.6+
• Node ≥ 22.5

package.json 中声明的依赖包括：

• zod ^4.0.0
• dsh-voice-core from github:Yihong89/dsh-voice-core

安装命令如下：

dsh plugin --profile web add "github:Yihong89/dsh-teacher"

安装后重启 web profile：

dsh --profile web

典型用法¶

加载问题集¶

使用 /teach 加载问题集并进入教师模式：

/teach questions.md

这一步会把问题集载入 SQLite store，并进入 teacher mode，但不会自动开始教学。

打开 quiz¶

使用 /quiz 打开 LLM-free quiz popup，覆盖整个题库：

/quiz

完成后，结果会交给 teacher 的 LLM analysis，并进入 Socratic walk。

查看知识缺口¶

使用 /gaps 查看当前课程的 gap ledger：

/gaps

重测到期缺口¶

使用 /retest 展示到期 gaps，用于 on-demand drill：

/retest

该步骤使用 FSRS-5 schedule。

会话结束总结¶

使用 /summary 输出会话结束时的 knowledge-gap 与 misconception summary：

/summary

命令与工具¶

插件支持的命令：

• /teach
• /quiz
• /gaps
• /retest
• /summary

插件提供的工具：

• next_question
• import_curriculum
• quiz
• analyze_quiz
• note_gap
• grade_answer
• retest
• summary

适用场景与注意¶

这个插件适合已经有一份 markdown 问题集，希望把它变成“提问—作答—评分—重测”流程的场景。

使用时注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 许可证为 MIT。
• README 状态显示 tests passing (83/83)。
• M5 Publish 状态为 partial (◐)，最终发布状态未完全确认。
• Star count、category 和目录页 URL 未在当前已核实资料中确认。

结尾¶

dsh-teacher 的价值，在于把 DSH agent 的使用方式从“直接给答案”切换到“围绕问题集推进练习”，并把知识缺口和间隔复习保留下来。

GitHub：

https://github.com/Yihong89/dsh-teacher

社区目录页：当前已核实资料未提供可访问地址。