前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。在研读论文对应的开源代码时，论文结构通常固定，但代码仓库千差万别，往往让人不知从何入手。dsh-code-reading-coach 是一个 Agent 预设插件，通过「五段研读法」提供交互式引导，帮助你从「不知道从哪入手」到「讲得出整个系统的故事」。
插件定位¶
这是一个基于 DeepSeek Harness 的 Agent 预设插件，由 TobySUN 维护，采用 MIT 许可证。它的核心价值在于将抽象的代码阅读过程结构化，通过逐条映射论文主张与代码实现，降低研读门槛。
核心功能¶
该插件通过一套固定的流程引导阅读，主要包括以下五个阶段：
- 锚定：将论文内容蒸馏成 3–5 条核心主张，形成代码需要回答的问题清单。
- 地形：扫描代码语言、框架/架构、依赖清单、目录树及测试布局，形成地形图。
- 入口：定位可运行的入口点，追踪顶层执行流。
- 核心映射：阅读核心模块，逐条核对论文主张，生成映射表。
- 闭环：运行最小测试、手推数据流、修改代码观察结果，并进行费曼复述。
除了流程控制，它还具备以下能力：
- 仓库类型自适应：针对训练框架、内核库、模型仓库等不同类型，自动调整阅读路径。
- 深度三档切换：提供概览、追踪、深潜三个档位，默认从追踪开始，避免一开始就陷入细节。
- 费曼检查点：在深潜前要求用户用自己的话复述，讲不通则降档重讲。
- 矛盾显式标记：当代码实现与论文主张不符时，显式标记出来。
- 产出物沉淀：研读笔记会持续沉淀到工作区，生成
<仓库名>-notes.md文件，支持跨会话继续阅读。
安装与启用¶
使用官方安装命令添加插件。安装后必须重启 dsh 进程才能生效。
dsh plugin --profile web add github:tobysunsun/dsh-code-reading-coach
重启后，新建会话，在预设选择器中选择「代码研读教练」即可开始。
典型用法¶
选择预设后，可以直接输入以下指令：
- 「我想读 FlashAttention 的代码」—— 插件会先告知项目技术栈，再带你一步步阅读。
- 贴上一篇论文链接或 PDF —— 插件会先蒸馏论文主张，再逐一对照代码验证。
- 只有仓库、没有论文 —— 直接说「帮我搞懂这个仓库」，插件会将此作为学习目标。
适用场景与注意¶
该插件依赖 @deepseek-ai/cordis 和 @deepseek-ai/dsh-tools 环境。
源码与维护：插件源码结构简单，仅包含 lib/index.js 和 preset/ 三个文件，可自行审阅。
卸载说明：使用 remove 命令卸载时，不会自动删除预设目录（避免误删用户修改过的文件）。如需手动移除：
rm -rf ~/.dsh/.agent-presets/code-reading-coach
生态背景：此插件发布于社区目录，与 DeepSeek 或幻方无官方从属关系。
总结¶
如果你需要系统化地阅读 AI 或软件领域的论文代码，dsh-code-reading-coach 提供了一套经过验证的流程和交互模式。通过 MIT 许可证开源，你可以放心查看其实现细节。
