zoahdev/dsh-tutorials
| 篇目 | 内容 | |---|---| | 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 天计划 |
catalog 简介 / catalog descriptioncatalog description:Bilingual tutorials for DeepSeek Harness: getting started, architecture, plugin development, pre-publish self-check, and contributor roadmap.
项目介绍Project Overview
dsh-tutorials 是 DeepSeek Harness 的中英文教程集,覆盖安装上手、架构、插件开发、发布市场、排障与社区贡献等主题。适合新手入门、写插件、发布或排查问题时查阅。命令实测于 Windows 与 dsh 0.1.0-rc.6,版本或环境不同需自行核对。
dsh-tutorials is a bilingual Chinese/English tutorial collection for DeepSeek Harness, covering setup, architecture, plugin development, marketplace publishing, troubleshooting, and community workflows. Use it when learning DSH, building or publishing plugins, or diagnosing common issues. Commands were tested on Windows with dsh 0.1.0-rc.6, so verify details for other versions or environments.
请帮我了解并安装插件:【dsh-tutorials】【https://github.com/zoahdev/dsh-tutorials】
把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.
或使用命令行安装(适合开发者)Or use CLI install (for developers)
命令行安装CLI Install
dsh plugin --profile web add github:zoahdev/dsh-tutorials
把 zoahdev/dsh-tutorials 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
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 实战 |
English
| Post | Content |
|---|---|
| en-01-start.md | Getting started: install, run, Web UI, pitfalls |
| en-02-architecture.md | Architecture summary + glossary |
| en-03-plugin.md | Build your first plugin (full translation) |
| en-04-contributing.md | Contributor roadmap (summary) |
| en-05-intelligence.md | One-minute repo due diligence with real output |
| en-06-doctor.md | Health-check your dsh plugin (full chain) |
| en-07-awesome.md | Passing the awesome-dsh-plugin review checklist |
| en-08-peers.md | Prerelease peers and ERESOLVE troubleshooting |
| en-09-search.md | Finding plugins from inside DSH |
| en-10-marketplace.md | Publishing to the DSH Marketplace |
| en-11-prepare-crash.md | Debugging the undefined.prepare crash family |
| en-12-visibility.md | Getting noticed in the dsh ecosystem (retrospective) |
| en-13-market.md | One-click plugin install inside DSH (in-harness market) |
| en-14-doctor-triage.md | doctor triage: profile-shadow / manifest-bom / v1 contract |
| en-15-retrieval-efficiency.md | Efficient retrieval: a tools-first AGENTS.md contract |
| en-16-self-evolution.md | Let agents evolve: dsh-rule-evolve in practice |
| en-17-growth-report.md | Make agent growth visible: the growth report |
| zh-18-lan-deploy.md | 内网部署 dsh web:非安全上下文崩溃的根因与修法 |
| en-18-lan-deploy.md | LAN deployment: insecure-context crash root cause + fix |
| zh-19-compaction-cache.md | compaction 缓存击穿:为什么每次自动压缩都多付钱 |
| en-19-compaction-cache.md | Compaction cache misses: why auto-compaction re-bills |
| zh-20-pet-evolve.md | dsh-pet-evolve:把 agent 成长变成一只宠物 |
| en-20-pet-evolve.md | dsh-pet-evolve: turn agent growth into a pet |
| zh-21-evolution-badge.md | 进化徽章:把规则库变成 README 上的 SVG |
| en-21-evolution-badge.md | The evolution badge: rule library as a README SVG |
| zh-22-session-shelf.md | dsh-shelf:给你的 dsh 会话一个书架 |
| en-22-session-shelf.md | dsh-shelf: give your dsh sessions a shelf |
| zh-23-doctor-action.md | dsh-plugin-doctor-action:把发布前体检装进 CI |
| zh-24-pipeline.md | 插件开发流水线:8 个插件一天上线的实战复盘(骨架/质量基线/踩坑/社区闭环) |
| en-23-doctor-action.md | dsh-plugin-doctor-action: pre-publish checks in CI |
| zh-25-community-workflow.md | 社区贡献工作流:从 bug 报告到证据级回复(值班/核验/GraphQL/家族化) |
| en-25-community-workflow.md | Community contribution workflow: evidence-grade replies (triage/verify/GraphQL/family-ize) |
| 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 | Passing the awesome-dsh-plugin Submission gate: checks / age gate / regate fallback / 403 pitfall / troubleshooting |
| zh-26-submission-gate.md | 通过 awesome-dsh-plugin 收录 gate:三个检查/年龄门/regate 自动兜底/403 坑/故障表 |
| en-27-family-triage.md | Bug-family triage: 13 verified families / append increments / found a new family / family test conventions |
| en-28-security-boundaries.md | Sandbox trust boundaries & fail-closed: #3245 escape / allow-lists / verifiability / checklist |
| en-24-pipeline.md | The plugin pipeline: 8 verified plugins in one day (skeleton/quality gate/pitfalls/community loop) |
配套资源
- 插件源码(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。
- 每篇发布时把
[你的…]占位符替换成真实链接。
nexu-io/open-design
freestylefly/awesome-gpt-image-2
anywhere-labs/dsh-desktop
walkinglabs/learn-harness-engineering
awesome-dsh-plugin/awesome-dsh-plugin
MemTensor/MemOS