前言¶
在 DeepSeek Harness（DSH）裏讓模型「教一門課」，常見結果是：一次回覆堆滿整章內容、很少當場檢驗理解、進度只留在聊天記錄裏，換會話或隔幾週再學很難接續。社區插件 dsh-teaching-mode（維護者 wbj19552259912-netizen，分類：工作流）把「講解 → 小測 → 歸檔」寫進每次模型請求的規則裏，默認關閉，用 /teaching on 開啓，不干擾日常對話。npm 包名 dsh-teaching-mode，當前發佈版本 0.9.5（MIT，Node ≥ 20）。
這是什麼¶
一句話：DSH 裏可開關的 teaching mode——一次只講一個小知識點，講完立刻出卡片題，小節結束寫複習資料到磁盤，同一門課可跨會話合併進度。
與「隨便聊着學」相比，插件強調硬約束：不整 topic 傾倒、mini-topic 後 1 題、topic 收尾再加 2 題、每節完成生成 review sheet 並落盤；作業只給答案與 walkthrough，不再跟測。
教學閉環¶
資料中的結構示意如下：
Section 8.5
├─ Topic A
│ ├─ mini-topic A1 ── explained → 1 card question
│ ├─ mini-topic A2 ── explained → 1 card question
│ └─ Topic A wrap-up ── 2 more card questions
└─ Topic B … same
Section 8.5 done → "8.5 review sheet" (concepts + exercises + answers)
Chapter done → merged into a chapter-level review
Prep gate（v0.9.0）：正式開課前模型需與你確認教材目錄/缺頁、歷年卷、章節路線、考試信息；未確認前只提問不講課。無教材時可按 README 流程逐章生成大綱與第一章，不一次生成全書。
跨會話續課（v0.9.3）：課程按科目歸一化綁定，而非單會話；新會話若筆記目錄不存在會複用已有 projects/<subject>/03-產出；/teaching courses、/teaching link <8-hex-prefix> 用於查看與接續。
筆記落盤位置¶
小節完成後自動寫入當前會話工作目錄下（由 Session.header.cwd 與 /teaching setup 的科目推導；/teaching status 可查看筆記目錄）：
<會話工作目錄>/projects/<subject>/03-產出/
| 內容 | 文件名 |
|---|---|
| 小節講義 | 第X章-<section>-講義.md |
| 小節複習 | 第X章-<section>-複習資料.md |
| 章總複習 | 第X章-總複習.md |
| 錯題本 | 錯題本.md |
文件名隨學習者語言（資料以中文課程爲例），便於與本地資料並列排序。
安裝與啓用¶
包已發佈在 npm，官方安裝方式爲：
npm install dsh-teaching-mode
DSH 桌面端不允許 CLI 直接管理 desktop profile，需在應用內打開會話，通過 plugin_manager → install_bundle，target 填包名 dsh-teaching-mode（由 DSH 從 npm 解析）。本地目錄安裝時使用 install_bundle，target 爲 file:<克隆目錄的絕對路徑>。安裝或更新後需重啓 DSH 或重載 profile。
會話內開關：
/teaching on
/teaching off
設置裏另有「新會話默認開啓 teaching mode」開關（瀏覽器本地偏好）；具體某次會話仍以 /teaching on|off 爲準。UI 入口：Settings → Teaching，以及會話側欄 Teaching 標籤（與 Chain of thought / Request context 並列）。
典型用法¶
1、開啓模式並綁定科目與教材：
/teaching on
/teaching setup 高等數學（同濟第七版上冊） | 教材文件名或說明
/teaching status
2、推進小節與進度（粒度可爲 section、知識點、章）：
/teaching section 8.5
/teaching progress 第8章 8.5 數據有多長
/teaching finish-section 8.5
3、記錄考試信息與欠賬、錯題：
/teaching exam 2026-12-31 | MC20+SA30+Calc50 | Ch1-5 | 5 past papers
/teaching debt 分部積分換元仍混
/teaching mistakes
/teaching review
4、章級收尾與索引（結束章需存在 第X章-總複習.md，可用 --force 跳過檢查）：
/teaching finish-chapter 第8章 | 第9章
/teaching index
更多命令見倉庫 README 的 Commands 表（含 courses、link、repair、prune、reset 等）。
適用場景與注意¶
適合：需要在 DSH 裏按教材/考試節奏系統自學，且希望進度、複習資料、錯題與工作區文件對齊，而不是隻堆在對話裏的開發者或學習者。
注意：
- 插件在 當前 DSH 進程權限 下運行，會向工作目錄寫入
projects/.../03-產出/；安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證。 - 默認關閉；只有顯式開啓後纔會注入教學協議。
- 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立社區信息源，與 DeepSeek / 幻方無官方從屬關係；星標等以頁面爲準（資料抓取時 GitHub 星標爲 0）。
結尾¶
dsh-teaching-mode 把 DSH 裏的 AI 輔導收成可執行的講課節奏：小步講解、即時測驗、小節與章節複習落盤，並支持同一科目跨會話合併進度。進一步瞭解與 issue 反饋見 GitHub，目錄介紹見 SkillHub。
