dsh-study-coach：DSH 的学习教练插件

前言¶

DeepSeek Harness（DSH）支持通过插件扩展能力。dsh-study-coach 专注于自学场景。它将一门课程拆解为知识地图，逐单元记录掌握度，安排每日任务，并提供一个学生可见进度的网页面板。

它是什么¶

该插件由 Ame-Choo 开发，提供两套能力：

• 对话能力：提供 21 个 study_* 工具和「学习教练」agent 预设。这些工具仅在「学习教练」模式的作用域内可见。
• 网页面板：挂载在 DSH Web 服务器上的 /study 路径，包含八页内容。

插件仓库只包含代码，不包含学习数据。数据默认存储在本地。

核心功能¶

1. 知识地图：支持大类/模块/最小单元三层结构。画布支持拖拽和缩放（Ctrl/Cmd + 滚轮）。每个单元挂载了网课和练习材料。
2. 掌握度记录：支持六档（没接触过/见过/能跟做/能独立做/熟练稳定/能讲明白）。必须挂证据（如哪次自评、哪道题、哪张照片）。证据不等于分数，是可追溯的记录。
3. Web 面板：路径 /study。包含今日任务、知识地图、资料图谱、档案、资料、工具、对话八页。面板顶部有体检卡，提示当前最该动哪儿。
4. 辅助工具：每日任务排程、错题本、记忆卡（艾宾浩斯）。

安装与启用¶

插件通过 npm 安装。

pnpm add dsh-study-coach

先决条件：
* DSH >= 0.2.0-rc.1
* Node >= 22.13.0

安装后必须重启 DSH 才能生效。

典型用法¶

1. 在 DSH 里开一个「学习教练」模式的会话。
2. 说清学什么、要掌握到什么程度、每天能学多少分钟、最晚什么时候。
3. 把材料丢给它，说一句「读一遍」。它会登记、通读、画地图。
4. 在面板上查看今天要做什么，做完跟教练说一声。

数据与维护¶

• 存储位置：默认存放在 ~/.dsh/study-coach/。
• 环境变量：可通过设置 DSH_STUDY_ROOT 环境变量修改数据根目录。
• 数据独立性：数据独立于代码，卸载、升级、重装不会丢失。

注意事项¶

• 作用域：工具只挂在「学习教练」模式的作用域里，其他会话看不见。
• 面板访问：面板里点「打开」，不在已登记材料范围内回 404，已登记但盘上找不到回 410。
• 证据要求：掌握度档案每条判断必须挂证据。

生态¶

该插件遵循 MIT 协议。可通过 GitHub 获取源码。