2026 年 8 月 13 日晚，DeepSeek 正式发布并开源了它的首款智能体产品——DeepSeek Harness（简称 DSH），版本 v0.1 开发者预览，MIT 协议，代码托管在 GitHub（发布当天星标突破 3.4 万）。官方给出的公式很直白：模型（大脑）+ Harness（身体）= 智能体。也就是说，Harness 不是新模型，而是一套让大模型真正「动手干活」的 Agent 运行框架：管理上下文、调度工具、执行任务闭环，甚至能跑多智能体协作。本教程带你从一条命令启动，到替换插件、复盘会话日志，完整走一遍这个「一切皆插件」的本地 Agent 工作台。
先搞懂：为什么需要 Harness 这个「执行层」？
过去的 DeepSeek 更像一个「顾问」：你提问，它给建议，具体操作还得自己来。Harness 给大模型装上了「手和脚」——它能自己拉取代码、定位问题、修改、跑测试，直到把活干完交给你。要理解它的价值，先看传统方案和 Harness 的区别：
| 对比维度 | 传统方式（自己搭） | DeepSeek Harness |
|---|---|---|
| 模型接入 | 每个模型写一套调用代码 | 模型只是插件，配置即换 |
| 工具调用 | 手写函数封装 | Bash/文件/检索等现成插件，可替换实现层 |
| 会话可观测 | 难复盘 Agent 到底看到了什么 | append-only 会话日志 + Trajectory 视图 |
| 扩展方式 | 改源码或 fork | 装/换插件，不改一行框架代码 |
版本提醒：当前是 v0.1 开发者预览版，README 明确警告会有破坏性变更（breaking changes），插件 API 尚未稳定。适合实验与二次开发，生产环境请等待 1.0。
Step 1：一条命令启动 Harness Web 工作台
只要电脑上有 Node.js，打开终端执行一条命令即可（首次会自动拉取依赖）：
npx @deepseek-ai/dsh web启动成功后，浏览器打开 http://127.0.0.1:3080，就是 Harness 的 Web 工作台。也可以用源码方式安装（git clone 后 pnpm install && pnpm build && pnpm dsh web）。
dsh --profile headless "跑一遍测试并总结失败项"，适合脚本化调用；另有 Python SDK 供程序化使用。Step 2：配置模型与工作区
1. 打开 Web UI → 右上角「Settings」→「Models」
2. 填入 DeepSeek API Key（默认供应商），保存即生效，无需重启
3. 回到首页点「Choose workspace」，
把存放项目代码的目录添加并选中（不选工作区无法发起会话）
4. 开始会话前，按需调整 Permission 权限策略Step 3：四种预设模式，按场景选一个
Harness 出厂自带四种预设，它们只是同一批插件的不同「组合方式」：
| 模式 | 定位 | 包含什么 |
|---|---|---|
| Standard 标准 | 完整编码 Agent | 文件编辑、Shell、检索、Skills、计划、子代理、工作流 |
| Code 代码（PTC） | 程序化工具调用 | 模型生成 TypeScript 组合多步操作，减少多轮往返 |
| Minimal 极简 | 最小环境基准测试 | 仅持久 bash + str_replace_editor |
| Creator 创造 | 开发调试插件 | 运行时检查、内存中试验 Cordis 插件、自创 preset |
Step 4：跑第一个真实任务
1. 在工作台发起新会话（New Session）
2. 输入一个完整任务，例如：
「检查当前仓库的 CI 配置，找出失败原因并修复，
然后运行测试，最后给我一份修复摘要」
3. Agent 会自主执行：读文件 → 定位问题 → 改代码 → 跑测试
4. 涉及敏感操作时，Web UI 会按权限策略弹窗请求批准
5. 任务完成后，它会输出一份结构化总结安全第一：在执行不信任的任务前，务必先配置好 Permission 权限策略。Harness 给 Agent 的权限越大，潜在破坏面也越大。
Step 5：一切皆插件——换模型、换工具
Harness 基于 Cordis 插件元框架构建：模型、工具、技能、会话、沙箱、存储、循环、调度、UI 全是可独立加载/卸载的插件，通过服务与事件协作。以 Bash 工具为例，接口定义、本地实现、面向模型的工具暴露被拆成三层——把执行后端从本地换到容器/云端，只需换「实现层」。替换插件靠改配置（cordis.patch.yml 或 --patch 覆盖），用 --dump-config 可查看当前启动的具体插件清单。
dsh-plugin 话题发布的社区插件就是非正式「插件市场」。发布自己插件时加上该话题便于被发现。Step 6：用会话日志复盘「Agent 到底看到了什么」
Harness 会把所有模型看到的内容写入只追加（append-only）的会话日志：系统提示、思维链、工具调用与结果、子 Agent 调度、每一次上下文注入。在 Trajectory 视图里可以按来源逐条检视；恢复、分叉、检索、回放都基于同一事件流。这意味着「Agent 当时到底看了什么、为什么这么做」不再是黑盒——这也是它区别于多数封闭工具的关键优势。
复盘一次失败任务的标准姿势：
1. 打开该会话的 Trajectory 视图
2. 按来源过滤：模型输出 / 工具结果 / 上下文注入
3. 定位「决策转折点」：哪一步给错了信息？
4. 修正提示词或权限策略后，Fork 该会话重跑常见问题速查
| 你遇到的问题 | 原因 & 解决 |
|---|---|
| npx 启动后页面打不开 | 确认端口 3080 未被占用，浏览器访问 http://127.0.0.1:3080 |
| 会话一直提示未配置模型 | Settings → Models 里没填 Key，或 Key 无效/未充值 |
| 找不到工作区 | 必须先 Choose workspace 选中项目目录，会话编辑器才会可用 |
| 升级后插件不兼容 | v0.1 为开发者预览，插件 API 会有破坏性变更，锁定版本使用 |