DeepSeek Harness 中文教程
这套教程不做成泛泛的 DeepSeek 聊天和提示词大全，而是把 DeepSeek Harness 放在绝对主线：从会用 Agent，到理解 Harness，再到开发自己的 Agent 基础设施。
Developer Preview
当前教程固定验证版本为 @deepseek-ai/dsh@0.1.1-rc.2，对应官方 tag dsh-v0.1.1-rc.2。首发 21 篇（01～21）已发布，覆盖认知、安装、首次任务、四种模式与安全边界的完整闭环；后续批次正在陆续整理发布，标「施工中」的篇目尚未放出。
怎么选学习路线
- 第一次使用 Harness：按首发顺序从 01 开始，先建立认知，再完成安装、首次任务、四种模式和安全边界。
- 已经用过 Claude Code／Codex：先看 03 的选型对比和 83 的迁移指南（施工中），再看 16～21 理解 Harness 的模式差异。
- 准备开发 Agent 基础设施：先看 14～15 完成源码构建与版本维护；Agent Loop、Cordis、插件、SDK 与综合实战批次正在施工中。
💡 推荐路线：01 → 02 → 04～13 → 16～21。准备读源码或开发 Harness 时再接 14～15；第 03 篇竞品对比基于 2026-08-31 当日四家官方资料核对，竞品信息按日过期。
一 · 认识 DeepSeek Harness
- 01 · DeepSeek Harness 是什么 -- 产品定位、核心职责与 Developer Preview 边界
- 02 · Agent = Model + Harness -- 模型与执行系统的分工，一次任务的完整链路
- 03 · DeepSeek Harness、Claude Code、Codex、OpenCode 怎么选 -- 四家同日在线核对的分层对比与决策路径
- 04 · 模型、Agent、Harness、IDE 的关系 -- 一张任务链地图讲清四层概念
- 05 · DeepSeek 模型目录、API Key、价格与调用方式 -- 三个 V4 模型、峰谷价格与 Key 安全边界
二 · 安装与第一次使用
- 06 · 环境准备 -- Node.js、平台、网络与工作区自检（macOS 已实测）
- 07 · 用 npx 启动 Harness -- 固定版本启动 Web UI 与端口、缓存排错
- 08 · Web UI 与工作区 -- Host／Workspace／Session 的真实运行位置
- 09 · 配置 DeepSeek 官方 Provider 与默认模型 -- 凭据只写、目录可见与真实可用
- 10 · 配置第三方与自定义 Provider -- 最小配置与验证（真实第三方账号待实测）
- 11 · 跑通第一个代码任务 -- 真实模型完成首个任务并独立验收
- 12 · 文件修改、命令与审批 -- 工具管线与四种审批路径
- 13 · Session 与 Trajectory -- 会话保存、轨迹查看与重启恢复
- 14 · 从源码安装与本地开发 -- 固定 tag 冻结安装、类型检查与构建
- 15 · 升级、降级、卸载与安装排错 -- 版本四坐标、dist-tag 与分层排错
三 · 运行模式与工作流
- 16 · 怎么给 Harness 下达任务 -- 目标、边界与验证的六段式任务合同
- 17 · Standard Mode -- 完整编码 Agent 模式与 25 个原生工具
- 18 · PTC 模式（Code Mode） -- 用
run_code编排工具调用 - 19 · Minimal Mode -- 最小工具集与模型评测边界
- 20 · Creator／创造模式 -- 用 Harness 扩展 Harness，32 个工具
- 21 · 四种模式怎么选 -- 同任务四模式对照与选择树
- 22 · 探索陌生仓库（施工中）
- 23 · 定位并修复 Bug（施工中）
- 24 · 重构并保持行为不变（施工中）
- 25 · 编写测试并循环验证（施工中）
- 26 · 完成跨文件功能（施工中）
- 27 · 长任务与中途追加要求（施工中）
四 · Harness 核心能力（施工中）
28 · Agent Loop／29 · 文件工具／30 · Bash、PTY 与后台任务／31 · Web 搜索与访问／32 · LSP 代码导航／33 · 工具注册与执行／34 · 工具呈现方式／35 · 系统提示词组装／36 · 上下文、Token 与压缩／37 · Skills／38 · Plan Mode／39 · Goals／40 · Subagents／41 · Workflows／42 · Session 恢复与 Replay
五 · 安全边界（施工中）
43 · 审批策略与权限预设／44 · 沙箱、fail-closed 与命令安全
六 · Cordis 与 Harness 架构（施工中）
45～55：Cordis 五项原语、一切皆插件、插件树与 Profile、配置分层与 Patch、生命周期、Service 与依赖注入、Event 与 Waterfall、Session 持久化、Capability Seam、Agent Scope、错误恢复与运行时不变量
七 · 插件开发（施工中）
56～68：第一个插件、自定义工具、配置 Schema、工具拦截、超时重试、LLM Adapter、Agent Preset、自定义运行模式、设置卡片、Conversation Node、打包安装、测试热重载与生态发布
八 · SDK、实战与查阅（施工中）
69～85：Python SDK 与嵌入、Headless 自动化、定时任务、Telemetry、远程访问，以及代码审查、自动修复、内部 Agent 等完整实战，迁移指南、安全加固、最佳实践、排错速查与术语表
当前证据基线
- 官方资料固定到
dsh-v0.1.1-rc.2与 commitb150a551b8d465e31e418e1b2eaf5e79bbb7d28e。 - 已完成 macOS ARM64 上的 Web／Headless、四种 Preset、Mock Agent Loop、审批回传、Trajectory 与重启恢复基线。
- 已完成 macOS ARM64 上固定 tag 的冻结依赖安装、类型污染诊断、普通／官方构建、源码 CLI 与 Web HTTP 基线。
- 已完成六个零依赖工程夹具的探索、Bug、重构、测试循环、跨文件功能与中途追加要求基线。
- 已完成核心运行时 20 个代表性文件、686 条测试，以及 Session／Fork／Replay 补充 7 个文件、208 条测试；固定 tag 未随远端
master前移。 - 已完成 Cordis 与 Harness 架构基线：12 个代表性文件 280 条测试中 279 条通过；唯一未通过项为当前沙箱中的用户 Patch watcher 文件新增，已保留普通终端 HMR 后补。
- 已完成插件开发基线：同主题三阶段工作区 8 条测试、类型检查、构建与 pack dry-run 通过；固定源码 Adapter、Preset、Settings、Conversation、Timeout 与 Retry 合计 9 个文件 307 条测试通过。
- 已完成真实 DeepSeek API 三轮验收（300 余次真实模型请求）：四模式同任务对照、审批与沙箱链路、Goal／Skill／Subagent、Python SDK、红队注入零穿透、浏览器走查与普通终端沙箱回归；Windows／Linux 平台矩阵仍在后补。