插件开发教程 zoahdev/dsh-tutorials

DeepSeek Harness 中文/英文教程集

作者：zoahdev · 2026-08-15 · 所有命令实测于 Windows（Node 24 / pnpm 11 / dsh 0.1.0-rc.6）

| 篇目 | 内容 |
| zh-01-start.md | 从零上手：安装、启动、Web UI、第一次对话、Windows 踩坑 |
| zh-02-architecture.md | 架构解读：一切皆插件、Cordis、工具 DSL、bundle/profile/patch |
| zh-03-plugin.md | 手把手写第一个插件（配套 dsh-github-release-radar 源码） |
| zh-04-contributing.md | 贡献者路线图：官方认可的方式与 14 天计划 |
| zh-05-intelligence.md | 一分钟尽调任何仓库：dsh-github-intelligence 实战（含真实输出） |
| zh-06-doctor.md | 用 dsh-plugin-doctor 给插件做体检（--full 完整链路） |
| zh-07-awesome.md | 让插件通过 awesome-dsh-plugin 的 Review：维护者 Checklist |
| zh-08-peers.md | dsh 插件依赖陷阱：prerelease peer 版本与 ERESOLVE |
| zh-09-search.md | 用 dsh-plugin-search 在 DSH 里找插件（搜→查→体检→装） |
| zh-10-marketplace.md | 在 DSH Marketplace 发布插件（含 allowBuilds 实测坑） |
| zh-11-prepare-crash.md | 调试 undefined.prepare 崩溃全家桶（#1697/#1763 根因与修复） |
| zh-12-visibility.md | 在 dsh 生态被看见：24 小时复盘（可复制 checklist） |
| zh-13-market.md | 在 DSH 里一键装插件：dsh-subscribe in-harness 市场实战（v0.3） |
| zh-14-doctor-triage.md | dsh-plugin-doctor 排障手册：profile-shadow / manifest-bom / dsh-doctor/v1 契约 |
| zh-15-retrieval-efficiency.md | 高效代码库检索：AGENTS.md 工具优先约定（#1864 效率反馈） |
| zh-16-self-evolution.md | 让 agent 自我进化：dsh-rule-evolve 实战（验证驱动闭环） |
| zh-17-growth-report.md | 让 agent 的成长看得见：Agent Growth Report 实战 |

| Post | Content |
| en-01-start.md | 入门：安装、运行、Web UI、常见坑 |
| en-02-architecture.md | 架构概述 + 术语表 |
| en-03-plugin.md | 构建你的第一个插件（完整翻译） |
| en-04-contributing.md | 贡献者路线图（摘要） |
| en-05-intelligence.md | 一分钟仓库尽调，含真实输出 |
| en-06-doctor.md | 为你的 dsh 插件做健康检查（完整链路） |
| en-07-awesome.md | 通过 awesome-dsh-plugin 审查清单 |
| en-08-peers.md | Prerelease peer 与 ERESOLVE 排障 |
| en-09-search.md | 在 DSH 内部查找插件 |
| en-10-marketplace.md | 发布到 DSH Marketplace |
| en-11-prepare-crash.md | 调试 undefined.prepare 崩溃家族 |
| en-12-visibility.md | 在 dsh 生态中被注意到（复盘） |
| en-13-market.md | 在 DSH 内一键安装插件（in-harness 市场） |
| en-14-doctor-triage.md | doctor 分诊：profile-shadow / manifest-bom / v1 契约 |
| en-15-retrieval-efficiency.md | 高效检索：工具优先的 AGENTS.md 契约 |
| en-16-self-evolution.md | 让 agent 进化：dsh-rule-evolve 实战 |
| en-17-growth-report.md | 让 agent 成长可见：成长报告 |
| zh-18-lan-deploy.md | 内网部署 dsh web：非安全上下文崩溃的根因与修法 |
| en-18-lan-deploy.md | 内网部署：非安全上下文崩溃根因 + 修法 |
| zh-19-compaction-cache.md | compaction 缓存击穿：为什么每次自动压缩都多付钱 |
| en-19-compaction-cache.md | Compaction 缓存未命中：为什么自动压缩会重复计费 |
| zh-20-pet-evolve.md | dsh-pet-evolve：把 agent 成长变成一只宠物 |
| en-20-pet-evolve.md | dsh-pet-evolve：把 agent 成长变成一只宠物 |
| zh-21-evolution-badge.md | 进化徽章：把规则库变成 README 上的 SVG |
| en-21-evolution-badge.md | 进化徽章：把规则库变成 README 上的 SVG |
| zh-22-session-shelf.md | dsh-shelf：给你的 dsh 会话一个书架 |
| en-22-session-shelf.md | dsh-shelf：给你的 dsh 会话一个书架 |
| zh-23-doctor-action.md | dsh-plugin-doctor-action：把发布前体检装进 CI |
| zh-24-pipeline.md | 插件开发流水线：8 个插件一天上线的实战复盘（骨架/质量基线/踩坑/社区闭环） |
| en-23-doctor-action.md | dsh-plugin-doctor-action：在 CI 中进行发布前检查 |
| zh-25-community-workflow.md | 社区贡献工作流：从 bug 报告到证据级回复（值班/核验/GraphQL/家族化） |
| en-25-community-workflow.md | 社区贡献工作流：证据级回复（分诊/核验/GraphQL/家族化） |
| zh-26-submission-gate.md | 通过 awesome-dsh-plugin 收录 gate：三个检查/年龄门/regate 自动兜底/403 坑/故障表 |
| zh-27-family-triage.md | 用已知问题家族图谱做 bug 分类核验：13 个家族/命中挂增量/未中开新族/家族测试惯例 |
| zh-28-security-boundaries.md | 沙箱信任边界与 fail-closed 原则：#3245 run_code 逃逸/允许清单/可验证性/检查表 |
| en-26-submission-gate.md | 通过 awesome-dsh-plugin 收录 gate：检查 / 年龄门 / regate 兜底 / 403 坑 / 故障排查 |
| zh-26-submission-gate.md | 通过 awesome-dsh-plugin 收录 gate：三个检查/年龄门/regate 自动兜底/403 坑/故障表 |
| en-27-family-triage.md | Bug 家族分诊：13 个已验证家族 / 追加增量 / 发现新家族 / 家族测试惯例 |
| en-28-security-boundaries.md | 沙箱信任边界与 fail-closed：#3245 逃逸 / 允许清单 / 可验证性 / 检查表 |
| en-24-pipeline.md | 插件流水线：一天内完成 8 个已验证插件（骨架/质量门禁/避坑/社区闭环） |

配套资源

- 插件源码（GitHub）：zoahdev/dsh-github-release-radar
- 旗舰整合（GitHub）：zoahdev/dsh-github-intelligence
- 插件模板（GitHub）：zoahdev/dsh-plugin-template
- 插件医生（GitHub）：zoahdev/dsh-plugin-doctor
- 插件搜索（GitHub）：zoahdev/dsh-plugin-search
- 插件市场（GitHub）：zoahdev/dsh-subscribe
- 在线站点（GitHub Pages）：zoahdev.github.io/dsh-tutorials
- 插件源码（本地副本）：outputs/deepseek-plugin
- 社区材料包：outputs/community-kit

发布建议

- 中文篇适合掘金/知乎/公众号；英文篇适合个人博客 / Dev.to / X。
- 每篇发布时把 [你的…] 占位符替换成真实链接。