🧩
一切皆插件
模型适配器、工具注册表、会话日志、甚至 Agent 循环本身都是插件。没有任何需要"打补丁"的特权核心，每个部分都可以从配置里替换。
深色模式
DeepSeek Harness 从零到一实现一个 AI Agent
一切皆插件 —— 拆解 DeepSeek Harness 的原理与实现，用渐进式 Demo 手把手带你从零复刻一个可运行的 Agent
Skip to content
学习路线图
这个教程适合谁
- 计算机本科毕业生：写过 TypeScript / JavaScript，了解 HTTP 与 JSON，最好听说过 ChatGPT 的 Function Calling，但从未见过一个 Agent 框架的内部结构。
- 想要读懂 DeepSeek Harness 源码的工程师：官方文档以"查"为主，本教程以"学"为主，两者配合使用效果最好。
- 想要自己搭一个 Agent 系统的人：教程最后交付一个约 1500 行的教学版实现（mini-harness + Node 后端 + React 前端），麻雀虽小，五脏俱全。
你需要准备什么
| 工具 | 版本 | 说明 |
|---|---|---|
| Node.js | ≥ 20.19（推荐 22+） | 运行所有 Demo 与最终项目 |
| npm | 随 Node 附带 | 教程统一使用 npm，不需要 pnpm |
| 一个编辑器 | 任意 | 推荐 VS Code |
| DeepSeek API Key | 可选 | 全部 Demo 用 Mock 适配器即可运行；仅「接入真实模型」小节需要 |
一个重要的诚实话
DeepSeek Harness 目前处于 开发者预览（developer preview） 阶段，版本迭代很快，未来会有破坏兼容性的变更。本教程基于 0.1.0-rc.6 版本撰写，所有 Demo 都在该版本上实际运行验证过，依赖版本也已固定（pin），所以你现在照着做一定能跑通。但读的时候请把注意力放在架构思想上——这些思想才是跨版本稳定的资产。
目录导览
| 篇 | 内容 | 产出 |
|---|---|---|
| 原理篇 | 为什么"一切皆插件"、Cordis 五概念、turn/step 生命周期、会话日志 | 心智模型 |
| 源码拆解 | 对照真实仓库逐包拆解关键实现 | 读源码的能力 |
| 实战 Demo | 8 个由浅入深的可运行实验，全部基于真实 dsh 包 | 动手经验 |
| 教学版项目 | 从零实现 mini-harness + React 前端 + Node 后端 | 一个自己的 Agent |