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★ 32466
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.
superdesigndev/treg★ 4760
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.
TencentCloudBase/CloudBase-AI-Toolkit#dsh-plugin★ 1132
Tencent CloudBase backend for DeepSeek Harness — scaffold and deploy full-stack apps from chat, render query results as table cards with paging, sorting and CSV export, preview a deployment on its domain, and call the CloudBase MCP toolset (`mcp__cloudbase__*`) with device-code login.
gitroomhq/postiz-agent#dsh-postiz★ 506
Connects DeepSeek Harness to Postiz over MCP: list connected social media channels, fetch per-platform posting rules, and schedule, draft, or publish posts to X, LinkedIn, Instagram, Facebook, Threads, TikTok, YouTube, Reddit, Bluesky, Mastodon, Discord, Slack, Telegram and more; adds a postiz workflow skill.
EthanYoQ/Invoice-Downloader#dsh-invoice-downloader★ 500
Local IMAP invoice download, OCR, archive, and Excel reimbursement summaries for DeepSeek Harness.
anysearch-team/anysearch-dsh★ 450
AnySearch-powered real-time web and vertical search provider for DeepSeek Harness.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.