前言¶

用 DeepSeek Harness（DSH）做智能体开发时，课程类内容往往散在视频、文档和 GitHub 仓里。学员真正卡住的多半不是「某句话怎么念」，而是「我这台机器现在这一步过不去」——需要有人对照本地项目状态给下一步，又能从成套资料里快速查 BOM、装配和模型选型。

下面介绍 Yanshi-Robotics 维护的 yanshifu-plugin-cn（社区目录分类：记忆）。它是《偃师傅的 SO-101 落地指南》等四份资料的中文 DSH 插件封装，并挂上三个技能：开发陪跑、资料速查、资料更新。英文版仓库 yanshifu-plugin 尚未开放；中文版独立安装即可。

这是什么¶

yanshifu-plugin-cn 是一个 DeepSeek Harness 插件包，不含宿主逻辑，通过 cordis.patch.yml 挂载 @deepseek-ai/dsh-skill-filesystem，把包内 skills/ 下三个技能一并注册。答案与资料面向中文用户；插件本身只挂技能目录。

维护者：Yanshi-Robotics。当前包版本 0.4.4（见仓库 package.json），许可证 MIT。

三个技能各自做什么¶

yanshifu：机器人开发增强¶

加载后典型流程分三步：

1. 询问课程仓 clone 所在目录；确认过的路径写入 ~/.yanshifu/project.json，下次可直接确认是否仍在该路径。
2. 用只读脚本 skills/yanshifu/scripts/project-scan.py 扫描项目（不执行仓内程序、不碰硬件），根据产物判断进度（如 .venv/、校准目录、遥操日志、相机配置、数据集、训练 checkpoint 等）。
3. 汇报「你现在到 EP<N>，下一步是……」，再按实际卡点读代码与日志、建议离线评估（例如 ACT-1-Pick/offline_eval.py），并把要执行的命令写清楚。

涉及真实硬件的操作（开相机、占串口、电机上电等）只写出命令，由你在本机执行。需要引用资料里的数字时，技能会读 ../ask/knowledge/；整段资料问答可加载 ask 技能。

ask：四份资料速查¶

只从插件内四份正文（skills/ask/knowledge/ 下的 so101-guide.md、pc-checkup.md、github-signup.md、dsh-install.md 及索引）检索，例如 BOM 与参考价、舵机后缀、本机能否跑某模型、装配接线、切片与模型选型、节目更新到第几集等。不看你的项目目录；资料里没有的会说明没有，不编造。

update：把资料更新到最新一集¶

比对本地 SOURCES.md 等可机读字段与远程最新发布：已是最新则直说；落后则通过 skills/update/scripts/update.py 逐文件原子替换，只动本技能目录，不修改你的课程项目。

安装与启用¶

插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 LICENSE，确认符合你的环境要求。仓库要求 Node ^22.19.0 || >=24.0.0，DSH 版本见 package.json 的 engines.dsh 字段。

命令行（Web 配置 profile）¶

机器上需要 git（从仓库拉包时）：

dsh plugin --profile web add github:Yanshi-Robotics/yanshifu-plugin-cn

GitHub 慢或连不上时，可改用 release tarball（README 说明约 69 kB，从 GitHub release 托管下载）：

dsh plugin --profile web add https://github.com/Yanshi-Robotics/yanshifu-plugin-cn/releases/latest/download/yanshifu-plugin-cn.tgz

也可在 DSH Web 侧栏 Plugins 页 Add plugin 填入仓库地址，装完启用。底层等价于 dsh plugin --profile web add <来源>：装包并选为 bundle，README 称此插件无需额外重启。

用助手安装的提示词¶

README 提供一段可直接发给 Harness 助手的安装说明（含装完验收：技能列表应出现 yanshifu、ask、update，并执行 /yanshifu 验证会先问课程仓目录并汇报进度）。若 GitHub 拉不动，提示词中同样给出上述 tarball URL。

装完后务必确认技能列表里确有这三个技能；仅报「装好了」但列表里没有，是常见翻车点。

典型用法¶

带不带斜杠均可；短名 ask、update 与其他插件同名时，用 /yanshifu ask、/yanshifu update 可确保进入本插件技能。

/yanshifu                      看项目、报进度、给下一步
/yanshifu ask BOM 是什么        查四份资料
/ask 我这台电脑够不够跑 π₀.₅     等价于资料速查
/yanshifu update               把资料更新到最新一集

也可自然语言触发（技能说明里写了触发条件），或消息中出现 @yanshifu。进度扫描依赖本机 python3（3.10+）；不需要 remembered 路径时可运行 project-scan.py forget 清除 ~/.yanshifu/project.json。

资料来源与边界¶

技能侧参考三类来源：你的项目、偃师傅公开课程仓（如 Lets-Build-Robots-S1-SO101、lerobot-doctor、lerobot-remote-inference）、以及包内四份速查资料。资料未写明的，可能指向公开课程代码仓并标明出处。

明确不在范围内的问题（README 列举）：成本利润、供应商采购、橱窗运营、Season 2 及以后、其他机器人、通用编程等。包内知识是快照，出新一集需发新版插件或通过 /yanshifu update 拉齐正文；不打包图片与 PDF。

适用场景与注意¶

适合正在跟《一起手搓机器人》第一季做 SO-101、已在本地 clone 课程仓、希望 Harness 能读进度并查成套中文资料的开发者。

注意事项摘要：

• 默认只读：不改你仓内文件，改之前会先问。
• 不代跑碰硬件的命令。
• 进度由产物推断，会先请你确认是否正确。
• 仅中文回答；仓名 -cn 专供中文用户，与未开放的英文版各装各的。
• README 注明 Codex / Kimi 可用同仓 scripts/install.py 安装同一套 skills/，但作者仅对 DSH 路径做过本机实测；其他宿主需自行对照各平台文档。

链接¶

• 社区目录：https://www.skillhub.cn/plugins/Yanshi-Robotics/yanshifu-plugin-cn
• GitHub：https://github.com/Yanshi-Robotics/yanshifu-plugin-cn

社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；安装与使用即表示你信任该仓库源码在你当前 DSH 权限下执行。