30 秒快速回答：DeepSeek Harness（命令行 dsh）是 DeepSeek 于 2026 年 8 月 13 日开源的首个 Agent 运行框架，MIT 协议。它把模型、工具、会话、沙箱乃至 Agent 循环全部做成可替换插件，让你在本机就能搭起一个可自由组合、可完整回放每一步决策的 AI 编程智能体。
一句话价值：它补齐了 DeepSeek 从「会思考的模型」到「真能干活的 Agent」之间缺失的执行层——也就是「Model + Harness = Agent」公式里的后一半。
一、Model + Harness = Agent：它补上了什么
大模型本身只会「输出文字」，它不会自己改文件、跑命令、查网页。把这些能力串起来、并保证过程可控，正是 Harness 的职责。DeepSeek Harness 的定位不是又一个聊天机器人，而是可自由组合的 Agent 运行时底座：模型负责推理，Harness 负责上下文管理、工具调用、任务规划、错误重试等所有工程化工作。
它直接对标 Claude Code 与 OpenAI Codex，标志着 DeepSeek 从「模型提供商」迈入「开发者工具」赛道。项目由拥有 6 枚 ACM 金牌、曾在 Jane Street 工作九年的崔添翼带队。
二、「一切皆插件」：Cordis 架构详解
这是 Harness 最核心的设计哲学。它底层基于 Cordis——一个只做三件事的插件元框架：
| 职责 | 说明 |
|---|---|
| 插件生命周期管理 | 加载、启动、停止、卸载 |
| 依赖注入 | 插件之间的服务依赖解析 |
| 全局事件总线 | 插件通过类型化事件协作 |
Cordis 内核不含任何模型、工具或 UI 逻辑。模型适配器、工具注册表、技能系统、会话日志、沙箱、存储、Agent 循环、调度、Web UI，全部是 130+ 个独立插件，通过服务与事件协作。
这意味着框架内部没有需要改源码的「特权内核」：想换模型？换一个模型插件；想禁掉联网搜索？在配置里卸载对应插件即可；想加一个内部系统工具？写一个新插件挂载上去。所有改动都在配置层完成，无需 fork 项目。
三、四种运行模式：从基准测试到生产自动化
Harness 内置四种预设模式，各自加载不同的插件集合：
| 模式 | 插件组合 | 适用场景 |
|---|---|---|
| 标准（Standard） | 完整工具集：文件编辑、shell、联网搜索、技能、规划、子 Agent | 日常开发、项目重构 |
| PTC | 标准能力 + 用 TypeScript 生成代码编排多轮工具调用 | 复杂多步任务、可编程工作流 |
| 极简（Minimal） | 仅一个 shell + 一个文件编辑工具 | 最小环境下的模型基准测试 |
| 创造（Creation） | 完整能力 + 运行时检查与实验插件 | 插件开发、自定义 Agent 预设 |
其中 PTC（程序化工具调用）值得一提：传统工具调用是模型一轮轮地发请求，PTC 则让模型生成一段代码，一次性组合多轮工具调用，减少往返、提升复杂任务的稳定性。
四、一分钟跑起来
前置条件是 Node.js（^22.19.0 或 >=24）。最快路径只有一行命令：
npx @deepseek-ai/dsh web
启动后浏览器访问 http://127.0.0.1:3080，在 Settings → Models 填入 DeepSeek API Key（也可配置 Anthropic、OpenAI、Bedrock、Azure 或任意 OpenAI 兼容端点），再选一个工作目录，就能让 Agent 读文件、改代码、跑命令了。
从源码运行（适合二次开发插件）：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
无界面自动化可走 headless 一次性执行：
dsh --profile headless "run the tests and summarize failures"
五、为什么开发者关注它：可观测性与生态
Harness 的另一条主线是全程可追踪。模型看到的每一样东西——系统提示词、思维链、每一次工具调用及结果、子 Agent 调度、上下文注入——都会写入仅追加（append-only）的会话日志。开发者可在 Trajectory 视图里按来源筛选，并对会话做恢复、分叉、检索与回放，方便复现和排查 Agent 的每一步决策。
横向对比更能看清它的差异：
| 维度 | DeepSeek Harness | 传统 Agent 框架 |
|---|---|---|
| 架构 | 一切皆插件（Cordis） | 单体内核 + 扩展点 |
| 扩展方式 | 配置层挂载插件，不改源码 | 常需 fork 或 patch 内核 |
| 可观测性 | 仅追加会话日志 + Trajectory 视图 | 通常只记录工具调用 |
| 运行模式 | 标准 / PTC / 极简 / 创造 | 通常一种 |
| 协议 | MIT 开源 | 视项目而定 |
总结与延伸阅读
DeepSeek Harness 的核心价值可以归纳为三点：一切皆插件的可组合架构（无特权内核，全部能力可替换）、四种预设模式（覆盖基准测试到生产自动化）、append-only 会话轨迹（每一步决策可审计、可回放）。
需要提醒的是，它目前仍是 v0.1 开发者预览版，官方明确提示后续会有破坏性变更，暂不建议直接用于生产关键链路。
延伸阅读：
- 官方仓库：
github.com/deepseek-ai/deepseek-harness - 官方文档：
deepseek.com/harness/en - 底层框架论文：《A Programming Paradigm for Spatiotemporal Composability》（北大 × DeepSeek 联合署名）
- 结合本站《什么是 MCP 协议》《Agent + RAG + MCP 怎么配合》阅读，理解 Harness 在 Agent 技术栈中的位置。