DeepSeek 开源 Agent Harness：Cordis 插件架构与黑鲸实测
DeepSeek 正式开源 Agent 运行时框架 Harness，采用 Cordis 全插件架构，内置百余插件，并已开…
DeepSeek 近日正式发布并开源了其 Agent 运行时框架 DeepSeek Harness（简称 DSH，代号「黑鲸」），源代码已托管至 GitHub。框架将模型、工具、策略、存储与上下文管理全部抽象为可插拔模块，并内置超过 100 个官方插件，试图打造一个面向「自进化」与 DIY 的 Agent 操作系统。官方将其架构命名为 Cordis，灵感来自乐高底座板，开发者可像拼插零件一样自由替换或新增功能模块。
安装与基础使用
DeepSeek Harness 提供两种安装方式：在已配置 Node.js 环境的系统中，可通过 npx @deepseek-ai/dsh web 快速启动 Web UI；也可克隆官方仓库后按说明完整安装。目前没有 Electron 客户端，启动后需在浏览器中使用。首次打开会要求填入模型 API Key，官方推荐使用 DeepSeek 自家平台的 Key——但平台已宣布 17 日涨价，缓存相关费用调整较为明显。用户也可接入其他模型。
Web UI 整体风格与 DeepSeek 网页版相近，对话列表被改造为本地项目管理。开启会话前需额外选择工作目录与 Agent 预设。官方提供四类预设：
- 标准模式：完整的编码 Agent，涵盖文件编辑、Shell、检索、Skills、计划模式、目标追踪、子代理等。
- PTC 模式：在标准模式基础上叠加 Code Mode SDK，允许模型用 TypeScript 组合多步操作。
- 极简模式：仅保留 bash 与 str_replace_editor 两个工具，适合基准测试与最小化复现。
- 创造模式：在标准模式之上提供运行时检查、插件实验与 preset 创作指导。
也支持用户自定义预设。
核心机制与设计细节
DSH 的几个关键设计围绕「可观测、可改造」展开：
- 轨迹（Trajectory）回放窗口：与经过润色的 Chat 视图不同，轨迹展示的是事件级原始记录，可随时回放 Agent 内部行为，便于定位失败环节与 Token 消耗。
- 内置 Skills：仓库自带
dsh-code-review、dsh-find-simplifications、dsh-doc-standards、dsh-prose-standard等多个开发向技能，分别用于 PR 审查、代码简化建议、文档规范与全仓库文字品控。 - 主动澄清：在未开启计划模式的情况下，Agent 遇到指令模糊时会主动拉起多轮提问，并给出建议选项。
- Token 仪表盘：界面下方实时统计 Token 消耗与缓存命中率，内测期间命中率多在 99% 左右。
此外，DSH 支持图片附件上传，但需搭配多模态模型使用，因为 DeepSeek 自家 V4 模型在视觉理解上仍较弱。
与 Codex 的实测对比
在内测中，作者使用 V4 Flash 模型分别在 DSH 与 Codex 下跑了多个 demo：
- 鹈鹕自行车：两者结果接近，Codex 审美略优。
- 猪八戒 3D 白模：DSH 长程任务能力更强，单条 prompt 跑了约 20 分钟，最终产出更完整；Codex 仅用 6 分钟直接交付，但产物被形容为「不像个生物」。
- 第一人称射击游戏：DSH 在几乎没有额外提示的情况下，自行完成了下蹲、换弹、瞄准、NPC 等全部功能。
Codex 在 UI 体验上仍有优势，例如内置浏览器、文件管理与对话内视频播放，而 DSH 的右侧栏尚未完工，需要后续打磨。
Cordis 架构与生态意义
DSH 的核心是 Cordis 协议——一切皆插件。官方仓库的 Doc 文件夹中提供了从零构建插件并接入 Harness 的完整教程，甚至内置了一个用于魔改 Cordis 的 Skill，这与 Codex Harness「Rust 单体核心 + 外部挂件」的闭源思路形成对照。作者将这一区别类比为「iPhone vs 安卓」，并指出 DSH 为社区预留了 Plugin Store，已有社区开发者贡献了大鲸鱼 TUI、上古 QQ 风皮肤、鲸鱼 emoji 等插件。
更深层的设想是「自进化」：在 Cordis 协议下，模型可在不打断任务的前提下自行编写并安装插件；未来若从海量 Agent 实例中筛选高质量插件并回流主线，将形成持续迭代的闭环。不过对普通用户而言，插件生态的价值仍待沉淀，短期内更多受益者是愿意为后人种树的极客开发者。