DeepSeek Harness 开发者预览版介绍（一切皆插件）
DeepSeek 又放了大招！这次不是发模型，而是开源了一个给 Agent 用的框架——DeepSeek Harness，开发者预览版已经开放测试，并且全部开源。
官方打出的口号就四个字：一切皆插件。
这一篇用大白话讲清楚：Harness 到底是什么、为什么”一切皆插件”这么重要、四种运行模式怎么选，以及怎么一行命令把它跑起来。
一、先搞懂：Harness 是干嘛的？
用”灵魂和身体”来理解
官方有个很精辟的公式：
Agent = Model + Harness- Model（模型）：Agent 的灵魂——负责”想”
- Harness（框架/套具）：Agent 的身体——负责”做”
再打个比方：
模型就像一个聪明的大脑，但它没有手、没有脚、看不到周围。 Harness 就是给这个大脑装上眼睛、手和脚，让它能理解环境、使用工具、在真实场景里持续干活。
一句话：Harness 让 AI 不只”会说”，还能”会做”。
为什么需要它？
你有没有想过：ChatGPT 类模型本身只会”生成文字”，它怎么能去操作终端、改文件、访问网页？
靠的就是一层”套在模型外面的东西”——它负责：
- 把模型和外部工具（Shell、文件、网页）连接起来
- 管理 AI 的”思考 → 动手 → 看结果 → 再思考”循环
- 让 AI 能持续工作，而不是问一句答一句
DeepSeek Harness 就是干这个的框架。
二、核心设计：一切皆插件
这是 Harness 最核心的理念，也是它和别的框架最大的区别。
什么是”一切皆插件”？
在 Harness 里，几乎所有东西都是插件：
模型、工具、技能、会话、沙箱、存储、循环、调度、UI看到没——连模型、界面（UI）都是插件！
三层架构，讲得明明白白
| 层 | 是什么 | 作用 |
|---|---|---|
| Cordis 内核 | 插件框架（核心引擎） | 只负责插件的加载、卸载、依赖管理，不掺和能力 |
| 插件层 | 各种能力插件 | 提供模型/工具/技能/UI 等具体能力，通过”服务+事件”互相协作 |
| 配置层 | 配置文件 | 不写代码，就能选择、替换、扩展任意能力 |
大白话理解：
- Cordis 内核 = 乐高的底座，它不管你是拼飞机还是拼房子，只负责”卡扣能不能对上”
- 插件 = 一块块乐高零件，飞机轮子、房子窗户，想用哪个拼哪个
- 配置层 = 你照着图纸把零件拼起来，不用改造零件本身
为什么”一切皆插件”厉害？
因为可替换、可重组、可扩展：
- 今天用 A 模型，明天想换 B 模型？换个模型插件就行，不用改框架
- 想加一个”查数据库”的工具？写个插件挂上去
- 想要个不一样的界面？换 UI 插件
开发者完全不用动 Harness 源码，在配置层就能自由搭配——这就是”一切皆插件”的威力。
三、每一次运行都有迹可循
Harness 还有一个很贴心的设计：全程留痕。
它记录了什么？
模型看到的一切都会被写进只追加的会话日志：
- 系统提示词
- 思维链（模型内心怎么想的）
- 工具调用和结果
- 子 Agent 调度
- 每一次上下文注入
有什么用？
在 Trajectory 视图（轨迹视图）里，你可以按来源回看这一切。而且：
- 恢复：任务中断了，能从某处接着跑
- 分叉：在某个节点开一条新分支，尝试不同方案
- 检索：按来源查找历史记录
- 回放：重新播放整个运行过程
一句话：AI 每一步做了什么、为什么这么做，全部可查。 这对调试、审计、复现都极其重要。
四、四种运行模式，按需选择
Harness 提供了四种模式，应对不同场景：
1️⃣ 标准模式（Standard）
功能最完整的编码 Agent，开箱即用，支持：
- 文件编辑
- Shell 命令
- 文件与网页检索
- Skills（技能）
- 计划、目标
- 子代理、工作流
日常开发用这个就对了——相当于一个”全副武装”的 AI 程序员。
2️⃣ PTC 模式（Program-Through-Code）
具备标准模式全部能力，多了一个”Code Mode SDK”。
特点：让模型生成一段 TypeScript 程序，用这段程序把多步操作组合起来一次执行。
适合复杂的多步骤任务：AI 先写一段”指挥代码”，然后一口气协调多个工具干完一件事。
3️⃣ 极简模式（Minimal）
只保留两个工具：
- 持久
bash（命令行） str_replace_editor（文本替换编辑器）
这个模式是专门给模型基准测试用的——在最小化环境里测模型的真实能力，不掺多余工具干扰。这也是官方跑评测用的模式。
4️⃣ 创造模式（Creative）
给想自己造模式的人用：
- 检查当前运行时
- 在内存里试验 Cordis 插件
- 组合、创作新的模式（preset）
相当于”模式实验室”——你可以现场试插件、捏一个属于自己的 Agent 预设。
| 模式 | 定位 | 适合谁 |
|---|---|---|
| 标准 | 全功能编码 Agent | 日常开发 |
| PTC | 代码编排多步操作 | 复杂任务 |
| 极简 | 双工具基准测试 | 评测、研究者 |
| 创造 | 造自定义预设 | 高级开发者 |
五、快速上手：一行命令跑起来
方式一：快速体验（推荐）
装好 Node.js 后，一行命令启动 Web 界面：
npx @deepseek-ai/dsh web方式二：源码安装
git clone https://github.com/deepseek-ai/deepseek-harness然后按仓库里的说明完成安装即可。
六、开源与插件生态
Harness 是完全开源的（MIT 协议，免费随便用），项目在 GitHub：
- 项目仓库：
github.com/deepseek-ai/deepseek-harness - 开发者文档：
deepseek-harness.github.io/deepseek-harness - 社区插件：GitHub 上搜
dsh-plugin标签就能找到各路大神写的插件 - Cordis 论文：内核框架有对应的技术论文
⚠️ 注意：目前是开发者预览版，核心插件和基础 API 还在持续迭代，适合想尝鲜/二次开发的开发者，不太建议直接上生产。
七、总结
这一篇我们认识了 DeepSeek Harness：
- 它是干嘛的：给 Agent 装”手和脚”的框架，公式
Agent = Model + Harness - 核心理念：一切皆插件——模型、工具、技能、UI 全都能替换重组
- 三层架构：Cordis 内核（管加载）+ 插件层（管能力）+ 配置层（管组合）
- 全程留痕：运行轨迹可查，支持恢复/分叉/回放
- 四种模式：标准 / PTC / 极简 / 创造，按场景选
- 快速上手：
npx @deepseek-ai/dsh web一行启动 - 完全开源：MIT 协议，社区插件生态已起
一句话记住 DeepSeek Harness：一个”一切皆插件”的开源 Agent 框架——模型负责想，Harness 负责做，而且每个零件都能自由换。
如果你正在学 AI Agent 开发，这个框架值得关注——它把”Agent 能力模块化”这件事做到了极致，对理解”Agent 到底是怎么搭起来的”非常有帮助 🚀
本文内容基于 DeepSeek Harness 官方开发者预览版页面整理，项目处于预览阶段，细节以官方文档和 GitHub 仓库为准。