dsh-code-reading-coach
代码研读教练（Code Reading Coach）— 交互式引导研读论文对应开源代码的 Agent 预设插件。五段研读法：锚定论文主张 → 地形扫描 → 入口追踪 → 核心映射 → 闭环验证。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:tobysunsun/dsh-code-reading-coach#c574202e6c067b3c93e26ed590541201b0a61e35Code Reading Coach 以 dsh-code-reading-coach 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个 DeepSeek Harness Agent 预设：交互式引导你研读论文对应的开源代码。
读 AI/软件论文时，论文结构是固定的，开源仓库却各不相同、常常不知从何入手。代码研读教练用五段研读法带你一步步看懂：先明确告知代码用的是什么语言与框架架构（并确认你是否熟悉），再把「论文讲的东西」逐条映射到「代码里的实现」，最后跑起来验证——让你从「不知道从哪入手」到「讲得出整个系统的故事」。
# 默认 profile（web）可直接复制运行：
dsh plugin --profile web add github:tobysunsun/dsh-code-reading-coach
安装后重启 dsh，然后新建会话，在预设选择器中选择「代码研读教练」。
新建会话选好预设后，直接说：
五段研读法，每一段只问一个问题、只给一个下一步：
| 阶段 | 做什么 | 产出物 |
|---|---|---|
| 0 锚定 | 把论文蒸馏成 3–5 条核心主张，变成代码要回答的问题 | 主张清单 |
| 1 地形 | 先明确告知语言 + 框架/架构（并确认你熟不熟悉），再扫描依赖清单、目录树、测试布局 | 地形图（含技术栈） |
| 2 入口 | 找「能跑起来的东西」，追踪顶层执行流 | 执行流图 |
| 3 核心映射 | 完整阅读核心模块，逐条核对论文主张 | 论文↔代码映射表 |
| 4 闭环 | 跑最小测试、手推一条数据流、改一行观察、费曼复述 | 研读笔记 |
其他贴心设计：
<仓库名>-notes.md，跨会话接着读。想先看一次完整产出的样子？见 examples/note-example.md。
我没读论文，能直接用吗？ 可以。没有论文时，它会把「帮我搞懂这个仓库」当成你的学习目标，走同样的引导流程。
我用的不是 web profile？
把安装命令里的 web 换成你的 profile 名即可（ls ~/.dsh/profiles 查看）。
想锁定某个版本？
用 github:tobysunsun/dsh-code-reading-coach#<commit-sha> 安装指定提交。
不放心第三方插件？
源码很小，只有 lib/index.js 和 preset/ 三个文件，可先审阅；实现细节见 CONTRIBUTING.md。
dsh plugin --profile web remove dsh-code-reading-coach
卸载不会自动删除预设目录（避免误删你改过的文件）；如需移除：
rm -rf ~/.dsh/.agent-presets/code-reading-coach
MIT © TobySUN。预设本体改编自 DeepSeek Harness 内置 standard preset（MIT）。
想为它做贡献、了解实现或发布细节？见 CONTRIBUTING.md。