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.

或使用命令行安装(适合开发者)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)

配套资源

发布建议

  • 中文篇适合掘金/知乎/公众号;英文篇适合个人博客 / Dev.to / X。
  • 每篇发布时把 [你的…] 占位符替换成真实链接。
上一个 Prev deepseek-harness-lite 下一个 Next dsh-skill-sidebar