DeepSeek Harness Agent 的原理与实现：从零到一实现一个 AI Agent
一个完整可运行的 VitePress 中文教学站点，把 DeepSeek Harness（「一切皆插件」的 Agent 框架）拆解成一套适合计算机本科毕业生的渐进式教程：先懂原理，再用 8 个真实可运行的 Demo 掌握机制，最后亲手实现一个教学版目标项目（React 前端 + Node.js TypeScript 后端）。
仓库结构
dsh-harness-tutorial/
├── docs/ # VitePress 教程站点（中文）
│ ├── guide/ # 原理篇（8 章）
│ ├── source/ # 源码拆解篇（6 章）
│ ├── demos/ # 实战 Demo 篇（8 个 Demo 教程页）
│ ├── project/ # 教学版项目篇（8 章）
│ └── appendix/ # 术语表 / 常见错误 / 参考资料
├── demos/ # 渐进式 Demo 代码（基于真实 dsh 包，已验证）
│ ├── 01-first-plugin/ … 08-profile/
└── final-project/ # 教学版目标项目 mini-harness
├── packages/mini-harness/ # 核心库（约 900 行 TS，零运行时依赖）
├── apps/server/ # Node 后端（Express + SSE）
└── apps/web/ # React 前端（聊天 + 实时事件面板）
快速开始
# ① 教程站点
npm install
npm run docs:dev # http://localhost:5173/dsh-harness-tutorial/
# ② 渐进式 Demo（在 demos/ 下）
cd demos && npm install
npm run demo:1 # Demo 1–4
# Demo 5–8 见 demos/README.md（dsh headless overlay，无需 API Key）
# ③ 教学版项目（在 final-project/ 下）
cd final-project && npm install
npm run demo # 核心库冒烟测试
npm run dev:server # 终端 A：后端 http://127.0.0.1:4317
npm run dev:web # 终端 B：前端 http://localhost:5174
在线阅读
站点已通过 GitHub Actions 部署到 GitHub Pages：
https://yanhua1010.github.io/dsh-harness-tutorial/
版本锁定
- DeepSeek Harness（开发者预览）：
0.1.0-rc.6 - Cordis：
4.0.1 - Node.js：≥ 20.19（推荐 22+）
所有 Demo 均在该版本上实际运行验证。项目处于快速迭代期，架构思想稳定，API 细节请以官方文档最新版为准。
许可证
教程内容与代码均为教学用途，遵循 MIT 协议精神。DeepSeek Harness 本身以 MIT 开源。