这篇只讲操作：一条命令装完，新建会话选「学习模式」，说一句「我想学 X」，拿到第一节课和一张课程主页。插件是 Miaotofu01/Study-Mate（StudyMate），npm 包 @yunmiao/studymate，latest 1.0.0（2026-10-02 发布），MIT 许可。站点信任档位「已验证」------已在 dsh 0.2.0-rc.2 下真实安装成功（L4 · 真实安装），星标 560、综合分 67.7、周下载 1,425（周下载取自 npm 全网，含 CI、镜像与爬虫，不代表装机人数）。下面按顺序走。
前置依赖清单
先对齐这四样，能省掉后面大部分报错：DSH 0.1.5-rc.2+ （README「快速开始」口径）；Node.js 按 package.json 的 engines，即 ^22.19.0 || >=24.0.0；Python 3.9+ 与 PyYAML ；想让完整课件校验跑满，还要 jsonschema（缺了会跳过 schema 校验）。
有一个口径差异必须提醒：本站「安装兼容性检查」对 dsh CLI 一栏只写「未声明 dsh 版本约束」，因为 package.json 里确实没有这个字段；真实地板写在 README。所以以 README 的 0.1.5-rc.2+ 为准，别只看站点那一行。
第一步：装 DSH 引擎
桌面端可跳过------DeepSeek Harness Desktop 自带 DSH。走官方 CLI 的先装引擎：
第二步：跑安装命令（桌面端 / 官方 CLI 两条路）
安装命令只有一条，两条路都用它：
桌面端 ：桌面端自带 DSH，但需要它启动过一次之后 ，安装器才会用桌面端自带的 dsh 把「学习模式」装进 desktop 档位。装完完全退出桌面端再重新打开，新建会话时选「学习模式」。
官方 CLI ：引擎已装好，同一条安装命令默认注册到 web 档位，之后用下面这条启动：
站点详情页另给的等价写法是 dsh plugin --profile web add @yunmiao/studymate；npm 包发布者账号已校验与本仓库一致，走 npm 安装最省事。
第三步：依赖排查
安装器会检查 Python 依赖。Python 不自带 PyYAML ，安装器只检测、不代装。看到 >>> 或提示缺少 pip 时：在系统终端 里用安装器检测到的同一个解释器 执行它给出的 pip 命令，装完保留参数重跑原 npx 命令 。若报 Node 版本问题（如 EBADENGINE），那是 engines.node 造成的------Node 23.x 不在区间内，切到 22.19+ 或 24+ 再装。
中途对照：想先看同类插件清单
装到这一步，如果还想对照其它对话 / 记忆类插件的中文清单与安装形态，可以先翻一遍 完整插件清单与汉化避坑指南，回头再继续下面的步骤。
第四步：新建会话选「学习模式」
装完不重启等于没装。 预设在 DSH 启动时才被读取：桌面端要完全退出再打开 ，CLI 要重启并新建会话。重启后新建会话，在模式里选「学习模式」------看不到这个选项，九成是没重启，或引擎版本低于 README 要求的地板。
第五步：说第一句「我想学 X」
选中「学习模式」后直接说：
也可以说「我想学 C++ 打竞赛」「我想学计算机网络」；还没想好就说「我不知道学什么，帮我选方向」，它会一次聊一个问题，可选探索或跳过建议，选定后接回建课流程。
会话开在哪很重要 ：开在学习工作区目录 里（权限选 workspace-write 或 danger-full-access）最省事------课程就地建，零授权。学习工作区默认在 ~/StudyMate，所有课件与记忆都存放在工作区。会话开在别处（比如某个代码仓）也能用：课程先建在会话目录下的 .studymate-stage/<slug>（全程零授权），结束时总控问你一句放哪------学习工作区／桌面／文档文件夹／用户根目录／先留着------然后一次 cp -a 搬过去。
第六步：生成课程主页
第一次生成课程后，课程主页在工作区 <workspace>/index.html，是未来所有课件的入口。如果主页没出现，或你直接打开 templates/ 里的 HTML 发现没样式：主页要从学习数据生成，跑
再看 <workspace>/index.html（还没科目时是空状态页）。templates/*.html 引用的是生成后的工作区相对路径，单独打开只有裸 HTML，README 明确说「这是设计如此」。
第七步：自检、更新与数据位置
装完日常要跑的命令只有一条：
它不需要真实 DSH、浏览器或模型服务 ；测试自己造临时科目，不碰你的学习工作区。想先看真实产出，也可以 clone 仓库后打开 examples/index.html------那是自带示例工作区（线性代数 + 计算机网络），页面已渲染入库。
更新 ：再次运行 npx -y @yunmiao/studymate@latest install，然后重启对应的 DSH。数据位置 ：DSH 装在 ~/.dsh/studymate/engine/，但学习数据默认在独立的 ~/StudyMate------好处是无需保留源码仓库，代价是换机器要自己把工作区搬过去。
总结
整条路径就是：对齐 DSH / Node / Python 依赖 → 装引擎 → 跑 npx 安装 → 排查 PyYAML → 重启 → 选「学习模式」 → 说「我想学 X」 → 生成主页；想对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。
适合与不适合
适合 ：想按步骤一次性装通、需要明确操作顺序的人；自学数学/计算机科目的人；已在用 DSH 桌面端或官方 CLI、只想加一个学习模式预设的人；需要课程能跨会话继承进度的人。 不适合：机器上无法装 Python 3.9+ 或 PyYAML 的人（它不是纯 Node 体系）；Node 卡在 23.x 又不愿切换的人；只想零依赖、装完即用、不接受任何重启与依赖排查的人。
标签：StudyMate、DeepSeek Harness、安装教程、DSH 插件、学习模式
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。