自学学习教练 ALuoTop/dsh-student-coach

dsh-student-coach · 学生自学 AI 学习教练

基于「AI 学习助手」体系（四步法闭环、学科指令库、防幻觉自检、每日 4 问、复盘表、卷面分析）开发的 DeepSeek Harness 插件：学生自学全流程工具 + 技能包。

组成部分

| 部分 | 路径 | 作用 |
| Cordis 工具插件 | 仓库根目录（lib/） | 注册 9 个 study_ 模型工具：档案结构化读写 + 间隔复习排期 |
| student-coach 技能包 | skill/student-coach/ | 教练行为层：四步法学习闭环、5 学科指令库、防幻觉自检 6 法、每日 4 问、卷面分析模板 |

能力

| 工具 | 作用 |
| study_students_list | 列出学生档案（目录、三件套存在性、记录数） |
| study_student_init | 新建学生档案（错题本/反思卡/行动清单模板） |
| study_profile_view | 读取完整档案（会话开始时调用） |
| study_mistake_add | 错题入库（自动编号，当天到期复习） |
| study_mistake_update | 改状态/错因/补救；reviewed: true 追加巩固日期并按 1→2→4→7→14→30 天重排复习 |
| study_review_due | 到期复习清单 + 连续 3 次未执行行动项提醒 |
| study_daily_review | 每日 4 问自动判定：按档案完成情况自动给出目标校准/信号灯/交付物/明日建议 |
| study_reflection_add | 反思卡落盘（今日所学/主要收获/仍有困惑/下一步行动 + 每日 4 问结论） |
| study_action_add / study_action_update | 行动清单管理（标记已执行时连续未执行次数清零） |

数据保存在会话工作区的 study-tracker/<学生>/ 下：纯 Markdown、人类可读、跨会话持久，格式与其他学习技能兼容。

安装

① 工具插件（二选一）

方式 A：DSH 插件安装器（推荐）

dsh plugin install github:ALuoTop/dsh-student-coach
或 git+https://github.com/ALuoTop/dsh-student-coach.git 或发布到 npm 后：dsh plugin install dsh-student-coach

CLI 会用 pnpm 把插件装进 profile（$DSH_HOME/profiles/<profile>/node_modules）并自动登记插件行。
插件声明的 @deepseek-ai/ peer 依赖由安装内置的模块回退目录（$DSH_HOME/profiles/node_modules）解析，无需手动装依赖。

方式 B：手动注册（开发/克隆使用）

1. 克隆仓库到任意目录
2. 在你的 profile 补丁层 $DSH_HOME/profiles/<profile>/cordis.patch.yml 追加：

- insert:
- id: student-coach
name: file:///绝对路径/dsh-student-coach/lib/index.js
config: {}

3. file:// 方式下，插件自身的 @deepseek-ai/dsh-tools 导入需要从插件目录向上能解析到 node_modules。两种办法：把仓库放进 $DSH_HOME/profiles/<profile>/plugins/（靠回退农场解析）；或本地建符号链接 node_modules/@deepseek-ai/dsh-tools → 安装目录 …/host/node_modules/@deepseek-ai/dsh-tools。
4. 重启应用（或补丁热应用后新开会话）。

② student-coach 技能包

技能是工作区级的：把 skill/student-coach/ 整个目录复制到会话工作区的 .dsh/skills/ 下：

cp -R skill/student-coach <你的工作区>/.dsh/skills/

技能即热生效，无需重启。技能与插件可独立使用：只用插件也能管理档案；只用技能则退化为纯对话指导。

验证

设置页「插件」面板可见 student-coach 条目，或查询远程 API：

curl -s -X POST http://127.0.0.1:49175/api/pluginInventory/list \
-H "content-type: application/json" \
-d '{"type":"client-request","rpcId":"probe","method":"pluginInventory/list","payload":{"args":{}}}'

结果中出现 student-coach 且 fiberPhase: "active" 即成功（failed 表示导入或 apply 抛错）。
确认后新开一轮会话即可看到 study_ 工具。

本地开发

node --check lib/index.js # 语法检查
node -e 'import("./lib/index.js").then(({ format: f }) => { / 解析/序列化往返测试 / })' # 纯函数单测

- 补丁行变更（启用/禁用/配置）：编辑 cordis.patch.yml，运行中的桌面端热应用补丁层。
- 插件代码变更（热替换，无需重启）：把插件行 name 的 ?v=N 版本号 +1 即可——入口 URL 变化使 Loader 重新 import，单文件插件因此整体热替换。注意插件必须保持单文件：多文件时相对导入会命中进程内缓存的旧模块，导致改了不生效。
- 解析/序列化/复习排期等纯函数随插件一并导出为 format 对象（import { format } from "./lib/index.js"），便于单独测试与复用。
- 仓库内的 skill/ 是技能包的分发副本；本机生效的副本在工作区 .dsh/skills/student-coach/，同步：cp -R skill/student-coach <工作区>/.dsh/skills/。

DeepSeek Harness 插件模型速览

1. 插件 = Cordis 插件：ESM 模块导出 { name, inject, apply(ctx, config) }。
inject 声明服务（tools 注册模型工具、fs 读写文件、sandboxPolicy 解析沙箱策略）。
2. 加载 = Loader 补丁树：bundle 层 → profile 用户补丁层 cordis.patch.yml → --patch 覆盖层。
3. 模块解析双锚点：file://… 直连；裸包名先从安装目录解析；./相对路径 相对 profile 目录。
4. 工具注册：ctx.tools.register(defineTool({ name, description, parameters, output: { schema, render }, execute }))。
5. 沙箱：写文件携带按调用会话解析的策略 ctx.sandboxPolicy.resolve({ session })（会话 cwd 是 workspace-write 边界，无会话时 fail closed）；会话工作区取自 exec.agent.session.header.cwd。

兼容性

- 面向 DeepSeek Harness 0.1.0-rc.x（预发布）。API 仍可能变化；peer 依赖用 声明以减少摩擦。
- 纯 JS、无构建步骤、无原生依赖，Windows/macOS/Linux 通用。

License

MIT