今天把 DeepSeek 刚开源的 deepseek-harness 拉到本地跑了下。

服务默认起在 3080 端口，打开页面后顺手抓了下入口源码，里面的初始化脚本直接把整个客户端架构给暴露了：

window.__DSH_BOOT__ = {
  "rev": "dcccb8324e44",
  "entries": [
    { "id": "@deepseek-ai/dsh-typert-registry", "url": "/plugins/@deepseek-ai/dsh-typert-registry/client.js?rev=f41d56e0b747" },
    { "id": "@deepseek-ai/dsh-api-gateway", "inject": ["@deepseek-ai/dsh-typert-registry", "@deepseek-ai/dsh-client-connection"] },
    { "id": "@deepseek-ai/dsh-cordis-client-runner", "inject": ["@deepseek-ai/dsh-client-runtime", "@deepseek-ai/dsh-api-remotes"] }
  ]
}

密密麻麻全是 @deepseek-ai/dsh-* 前缀的微插件。

平时聊 Agent，大家习惯把注意力全放在 Prompt 怎么调、大模型上下文有多长、推理评测刷了多少分上。但真到了生产环境跑任务，经常发现模型逻辑挺清晰，工具一调却卡死，或者权限和会话状态乱成一锅粥。

DeepSeek 官方在这个项目里提了一个很底层的公式：Agent = Model + Harness

所谓的 Harness（测试底座/执行挽具），其实就是承载大模型跟操作系统、文件读写、权限沙箱打交道的那套神经中枢。底座如果设计得太重或者层层封装过度，大模型再聪明也会被中间链路拖死。

Cordis 微内核架构：为什么要把 UI 和权限全拆成插件

做过 Agent 框架二次开发的同学大多踩过这些坑：很多框架把工具调用（Tool Calling）、权限判定和通信协议死死绑定在核心 Runtime 里。想定制一个权限拦截策略，或者给前端加个独立的 SubAgent 监控面板，得把整套代码拉下来重新编译打包。

DeepSeek Harness 选的技术路线很特别，它底层直接借用了 Node 生态里非常成熟的 Cordis 元框架。

从 API 网关、TypeRT 类型注册表，到前端页面上的侧边栏、对话流、权限预设面板（permission-presets），每个能力都是按标准规范解耦的独立插件。

比如上面源码里的 dsh-api-gateway，它启动时通过 inject 显式声明依赖 dsh-typert-registry 和 dsh-client-connection。服务初始化时按拓扑顺序加载，哪个模块出异常，直接在插件层做熔断与热替换，主 Runtime 根本不需要跟着重启。

这种把前端交互、后端通信与模型执行环境全部“插件化”的做法，在工程维护上要清爽很多。

---

Minimal Mode 评测：为什么官方基准测试只给 Shell 和文件编辑

在评估 DeepSeek-V4-Flash 等模型的 Agentic 能力时，官方文档特意强调了一个测试标准——Minimal Mode（极简模式）。

这个模式的限制非常苛刻：

• 剥离所有针对特定任务定制的复杂高阶工具
• 执行环境里只暴露基础的 Shell 终端和 File Editor（文件编辑器）

没有预埋的外挂检索接口，也没有针对特定 Benchmark 的提示词补丁。

让模型像人类程序员一样，拿到一个 Bug 报告后，自己敲命令去 grep 搜代码、定位报错行、用文件编辑修改，最后再跑单元测试验证。

在 Agent 评测领域，给工具加各种黑盒胶水代码很容易虚高跑分。把工具集压到最精简的极简模式，模型能不能闭环解决问题，不仅考验它的规划能力，更考验 Harness 对多轮交互反馈（Observation）的吞吐稳定度。

一旦底层 Harness 的上下文管道足够干净，模型的推理步骤反而更加稳定，不会在冗余的工具调用和参数解析里打转。

---

关于 Agent 基础设施的几点思考

本地折腾这套 Harness 下来，最深的一个体会是：

过去一年里，社区涌现了大量把概念包装得非常庞杂的 Agent 库，动辄多层抽象类和复杂的调用链，出了问题断点都不知道打在哪。

DeepSeek Harness 展现出的思路更贴近一线工程交付：Runtime 保持微内核与高透明度，所有业务特性交给插件去做扩展，模型只专注于终端与代码层面的真实交互。

如果正在搭建自己的自动化 Agent 流程，不妨重新审视一下自己的执行底座——是在笨重的封装里打补丁，还是回归到这种清晰的插件化与极简工具链上。

---

开源参考：

• 底层架构：Cordis Meta-Framework & TypeRT Plugin Registry
• 官方仓库：github.com/deepseek-ai/deepseek-harness