第一次打开 DeepSeek Harness，很多人会把注意力放在“它能不能替我改代码”。真正进入高阶后，问题会迅速变成另一组：怎样把一次对话接进 CI？工具调用怎么审计？多个 Agent 该用 Subagent、Workflow、Goal 还是 Ralph？插件升级后，旧会话还能不能恢复？如果这些问题没有答案，Agent 跑通一次也还不能称为工程系统。
这正是本专题要解决的事。它不把 Harness 当作另一个聊天框，而把它当成一套可以组合模型、工具、会话、权限和执行环境的 Agent 运行框架。你也可以从专题独立入口收藏完整路线。
先看学习路线
| 阶段 | 文章 | 学完能做什么 |
|---|---|---|
| 1 | 安装、模型配置与最小插件 | 跑通 CLI、Web、Provider 和插件加载 |
| 2 | Headless 与 CI 自动化 | 把一次 Agent 任务接入脚本和流水线 |
| 3 | Cordis 插件与工具开发 | 理解服务、依赖、事件和工具扩展点 |
| 4 | 多 Agent 编排决策 | 正确选择 Subagent、Workflow、Goal、Ralph |
| 5 | 沙箱、审批与密钥边界 | 建立最小权限和一次性升级机制 |
| 6 | 会话事件与可观测性 | 记录耗时、工具、错误和可恢复状态 |
| 7 | 版本升级与回归测试 | 用固定样例和迁移清单控制预览版风险 |
为什么高级内容要占大头
安装只决定“能不能启动”，工程化决定“能不能放心地反复运行”。Harness 的核心能力分布在会话日志、系统提示、工具注册、Agent Loop、LLM 适配、文件系统与 Shell 等能力接缝中。一个功能看似只是新增工具，实际可能同时改变模型可见 Schema、审批路径、会话事件和恢复行为。
因此本专题按三层组织：第一层是使用入口，第二层是扩展框架，第三层是运行治理。初学者可以顺序阅读；已经跑通 Web UI 的开发者，可以直接从 Headless、插件或多 Agent 开始。
三条推荐路径
如果你只是个人开发者，先读安装篇和 Headless 篇，再读沙箱篇。目标是把“小任务—自动测试—人工审查”闭环跑稳。
如果你要开发插件，先读 Cordis 篇，再读事件与可观测篇。不要一上来替换 Agent Loop；优先在已有 ctx 服务和事件接缝上扩展。
如果你负责团队平台，重点阅读多 Agent、安全、可观测和升级回归。模型能完成一次任务只是演示，平台需要回答谁发起、读写了什么、为什么升级权限、花了多少、失败后如何恢复。
阅读时记住证据等级
本专题把信息分为三类：本站真实运行记录、官方发布说明、官方 master 文档。三者不能混为一谈。旧版本实测能证明当时的最小闭环，却不能证明新版本命令完全相同；master 文档能说明设计方向，也不等于某个 npm 发行包已经包含全部能力。
截至 2026 年 9 月 23 日，官方最新预发布为 v0.1.7-alpha.2。它仍处在快速演进期，所以每篇文章都会给出日期、版本边界和复核建议。
最终建议
把 DeepSeek Harness 学成“会点按钮”并不难，真正有价值的是掌握能力组合：用 Headless 接系统，用 Cordis 扩展行为，用多 Agent 分解任务，用沙箱限制副作用，用事件和回归测试把运行变得可解释。
从第一篇跑通最小闭环，再进入后面的高级文章。每增加一种能力，都补上一条可自动验证的完成条件；这是从玩具 Agent 走向可靠 Harness 的分水岭。