把一门课交给 AI，最常见的失败不是它讲错，而是讲得零散：第一节讲特征值，第三节才发现你还不会解线性方程组。Miaotofu01/Study-Mate 里的 StudyMate 就冲着这个问题去。站点分类 token 是「dsh 原生插件 · chat」，星标 560、综合分 67.7、周下载 1,425，信任档位「已验证」——本站已在 dsh 0.2.0-rc.2 下真实安装成功（L4 · 真实安装）。这篇不谈怎么装，只拆它凭什么能把「学一门课」组织成一条可执行的路线。
它交付的不是一次对话，而是一份课程
README 原话是「面向数学与计算机科目学习的助手，原则是『learn with doing』」，形态是一套数学/计算机学习工作流、SKILL 与 HTML 课件引擎：既可以是 DSH 的「学习模式」预设，也可以是 Google Antigravity 的原生多智能体插件，还能打包成 Codex / ChatGPT Work 插件。
课程由三块拼成——讲解｜练习｜项目实操。这不是三个功能按钮，而是三种产出物：讲解落成课件，练习落成题目，项目实操落成 lab。判断它成不成立，看这三样能不能被下一次会话继续使用，而不是聊完即弃。
五个角色，两种执行形态
一次完整建课要干五件事：收集资料、采图、课程设计、讲解、练习评估。StudyMate 把它们组织成五个角色，关键是分工不写死，跟着宿主能力走：宿主支持子代理时委派给子代理；不支持时就依次串行干完。
差别值得说清。子代理的价值不是「更快」，而是上下文隔离：采图要吞掉大量来源信息，若和讲解共用一份上下文，只会挤掉讲解的预算。串行模式下没有这层隔离，于是每次交接都必须把结论压成文件落到磁盘——在 StudyMate 里，文件不是备份，而是角色之间的接口。
路线图：知识点必须按前置依赖排开
每门课一份大纲，知识点按前置依赖排成路线图，每个知识点标上课型：大纲里写 概念／实操／实验，对应概念课、实操课、实验课。
为什么非要成图？因为「学到哪了」只有当前置关系显式存在时才可回答。总览页列全部科目与当前节点，点进去是知识点路线图：按依赖分层排开、按状态着色，点节点原地展开课件子卡片。你看到的不是时间线，而是「哪些必须先会、哪些现在就能学」的网。聊天式学习里，顺序由你提问的随机性决定；路线图把顺序责任从人身上拿走了。
进度与记忆为什么落在文件里
两条机制：学习进度落在文件里，每次新对话可继承；跨科目共享记忆记住你的现有水平、哪种讲法有效、常见卡点，下一门课不用重新自我介绍。
这两条解决的是不同问题。进度是「这门课到哪了」，属课程内状态；共享记忆是「你是什么样的学习者」，属跨课程状态。分开存，是让你新开一门课时既不丢旧进度，也不必把上一门课全背过来。所以它把「极少的、关于你的结论」排在「大量原文」前面。
一个可见效果是「换讲法」：你说「太简单了」或「没听懂」，它换一种讲法（加边界与反例，或降一层抽象），并把这条偏好记进共享记忆——偏好是资产，不是会话里的临时参数。
用文件而不是向量库，取舍在哪
从 README 口径看，它的信息与偏好由记忆文件保存，每次会话只带相关记忆、上下文短。这等于用「文件 + 规则」替代「全量语义检索」，换来三件事：可读（直接打开看 AI 记了什么）、可搬（学习数据默认在独立的 ~/StudyMate，与 DSH 本体分离，无需保留源码仓库）、可审（它坚持给产物落点立契约，README 才会明说 templates/*.html 单独打开只有裸 HTML「是设计如此」）。
代价也清楚：没有检索层，记忆取舍只能靠规则与摘要，写粗了就继承不到细节。这解释了它为什么宁可少记、记准。
上下文预算才是文件方案的真正对手
README 的对比表点得直白：直接跟 AI 聊天学，卡在「会话一长上下文就吃不下；聊完不留痕，下次从零开始」。文件方案不是让模型变聪明，而是让每次会话都从短上下文起步——把长期状态搬出上下文窗口，只按需带回来。这也解释了自检命令为什么是 npm test：它不需要真实 DSH、浏览器或模型服务，测试自己造临时科目、不碰你的学习工作区，用测试守住「记忆与进度的文件结构」这条数据契约。
HTML 课件引擎，以及必须如实说的边界
课件是主载体：教材式讲解、配图、定制题目与项目目标，产物是 HTML。第一次生成课程后，课程主页在工作区 <workspace>/index.html，是未来所有课件的入口。想先看真实产出，仓库自带 examples/ 完整示例工作区（线性代数 + 计算机网络），页面已渲染入库，clone 后打开 examples/index.html 就能一路点到课件。注意 templates/*.html 单独打开没样式，主页要从学习数据生成：python3 scripts/gen_home.py。
几条边界也要说清：站点「安装兼容性检查」对 dsh CLI 只报「未声明 dsh 版本约束」，而 README 要求 DSH 0.1.5-rc.2+，以 README 为准；它不是纯 Node 体系，要 Python 3.9+ 与 PyYAML，完整课件校验还需 jsonschema（缺了会跳过 schema 校验）；本站静态扫描标记「含敏感能力」（可执行外部命令、读写/删除本地文件，证据 4 处）且尚无人工评估；仓库建仓于 2026-09-17、不到三周、open issues 4 个，README 自述是「vibe 出来给自己用的一个小项目」，并列出「文档过于臃肿且充满 AI 味」等问题，作者承诺人工审查每个文件。
总结
StudyMate 把「学一门课」拆成五角色分工、前置依赖路线图、文件化进度与共享记忆、HTML 课件四件事，设计重心是让每次会话都用短上下文起步；想对照同类插件的中文清单与安装形态见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合：自学数学/计算机科目、希望课程有明确先后顺序的人；喜欢「教材式讲解 + 配图 + 定制题目」而非纯聊天的人；已开了一门课、需要跨会话继承进度的人；愿意用 DSH 学习模式预设、机器上能装 Python 3.9+ 的人。
不适合：需要实验设备或实验室操作的科目（它只面向数学与计算机）；纯文科背诵类科目；需要教师批改作业的场景——交给它只会得到一份没法落地的路线图。
标签：StudyMate、DeepSeek Harness、学习工作流、路线图、插件评测
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。