前言¶
在 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。
