前言¶

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

社區目錄頁：當前已覈實資料未提供可訪問地址。