Interactive code-reading coach for DeepSeek Harness: a five-phase guided walkthrough of the source behind a paper, starting by identifying its language and framework.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-code-reading-coach
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:tobysunsun/dsh-code-reading-coach
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
一个 DeepSeek Harness Agent 预设:交互式引导你研读论文对应的开源代码。
读 AI/软件论文时,论文结构是固定的,开源仓库却各不相同、常常不知从何入手。代码研读教练用五段研读法带你一步步看懂:先明确告知代码用的是什么语言与框架架构(并确认你是否熟悉),再把「论文讲的东西」逐条映射到「代码里的实现」,最后跑起来验证——让你从「不知道从哪入手」到「讲得出整个系统的故事」。
安装
# 默认 profile(web)可直接复制运行:
dsh plugin --profile web add github:tobysunsun/dsh-code-reading-coach
安装后重启 dsh,然后新建会话,在预设选择器中选择「代码研读教练」。
快速上手
新建会话选好预设后,直接说:
- 「我想读 FlashAttention 的代码」—— 它先告诉你这个项目的技术栈,再带你一步步读
- 贴上一篇论文链接 / PDF —— 它把论文主张蒸馏成要点,再逐一对照代码验证
- 只有仓库、没有论文:「帮我搞懂这个仓库」
它帮你做什么
五段研读法,每一段只问一个问题、只给一个下一步:
| 阶段 | 做什么 | 产出物 |
|---|---|---|
| 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。
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37918
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37097
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8650
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5964
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2216
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 2002
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.