DeepSeek Harness / 01

DeepSeek Harness：一切皆插件的 Agent 运行时

DeepSeek Harness（DSH）是 DeepSeek 于 2026 年 8 月开源的 AI Agent 运行时框架。它不是一个 Prompt 模板或工具调用库，而是一个完整的产品级 Harness——负责把模型能力装配成可恢复、可控制、可审计的产品行为。开源后 GitHub 星数迅速突破 178k，说明社区对”模型之外的运行时工程”有强烈需求。

DSH 要解决的不是”如何调一次 API”，而是：如何让 Agent 连续运行几十轮，允许用户中途改方向，能从崩溃中恢复，在执行危险动作前停下来，并且能解释每一个副作用是怎样发生的。

DSH 最重要的判断：不存在特权内核

常见插件架构仍然保留一个不可替换的 Kernel。插件只能在 Kernel 预留的 Hook 上工作：你可以增加一个工具，却不能换掉工具循环；可以接一个存储，却不能改变会话如何成为上下文。

DSH 把边界再向内推了一步。模型适配器、工具注册表、会话日志和 Agent Loop 本身都是插件，可以从配置中替换。所谓“一切皆插件”不是插件数量很多，而是重要性不再自动带来不可替换的特权。

flowchart TD
  C["共享 Context"]
  C --> L["模型接缝"]
  C --> T["工具接缝"]
  C --> S["会话事实源"]
  C --> A["Agent Loop"]
  C --> U["UI 与宿主"]
  C --> P["安全与策略"]

这些插件站在同一棵 Context 树中，通过服务、事件和可逆副作用协作。耦合关系主要存在于运行时注册，而不是消费者直接导入某个具体实现。

Harness 要回答的五类问题

工程问题	DSH 的设计回答	典型接缝
如何接不同模型	协议与 Provider 作为可替换适配器	`ctx.llm`
如何让模型使用能力	工具声明、执行和策略组成管线	`ctx.tools`
如何保存和恢复	追加式事件作为事实源	`ctx.sessions`
如何干预中间过程	请求、工具和轮次暴露类型化事件	`agent/`、`tools/`
如何组成不同产品	Profile 组合插件树，Surface 只做宿主适配	Web、headless、外部 Profile

这张表不是 API 清单。它说明每个横切问题都拥有自己的可替换边界，而不是被硬编码进一个巨型 Agent 类。

三个思维实验

模型与工具协议继续变化

如果工具循环、模型协议和 Provider 实现写死在同一个核心里，协议演进会变成内核手术。DSH 把 LLM、Tools 和 Agent Loop 分开，哪个边界变化就替换哪个插件，其他部分继续使用原有契约。

产品形态无法提前枚举

Web、一次性 headless 任务、TUI、ACP 或 SDK 都需要同一套会话和工具能力。DSH 让产品形态成为 Profile 的组合结果，而不是复制一份核心代码。官方 Web 和 headless 只是两份预置，不是全部可能性。

个性化不应该都等待核心发版

审计工具结果、请求前路由、给单个 Agent 增加隔离策略，都可以附着在已有服务或事件上。局部需求由局部插件承担，核心仓库不必为每个用户维护分支。

这是不是过度设计

有可能。对一次性问答、普通 Skill、搜索服务或短进程 MCP，改配置并重启通常更简单。DSH 的价值只有在你确实需要替换进程内有状态组件、改变控制流、维护多个产品形态，或探索运行时自我修改时才明显。

因此，正确问题不是“一切皆插件是否更先进”，而是“你的系统是否需要把这个边界变成可替换能力”。可替换性提高了上限，也把依赖、生命周期、生态质量和版本兼容的成本带进了运行时。

官方事实来源：README、Architecture 和 Cordis 论文 A Programming Paradigm for Spatiotemporal Composability。

下一篇建议继续看：声明式与命令式：Cordis 的五个核心概念

这篇文章有帮助吗？

| GitHub 留言