Zero2Agent

DeepSeek Harness / 13

Runtime Surfaces：一套运行时如何服务多个宿主

DSH 同时有两个身份：它是一套可以直接运行的 Coding Agent，也是一套 Agent 开发框架。官方 Web 和 headless 可以看成官方已经拼好的两辆车；TUI、自动化任务或其他交互方式，则可以通过外部 Profile 和插件接入同一个运行时。

设计理念：运行时稳定，表面可替换

Web、CLI、headless、ACP 或 SDK 的输入输出不同，但不应该各自实现一套 Agent Loop。它们共享会话、事件、工具和策略，只在连接管理、认证、流式传输、断线恢复和退出码上有差异。

flowchart TD
  P["Profile"] --> H["Harness Runtime"]
  H --> W["Web"]
  H --> C["Headless"]
  H --> T["TUI 或外部宿主"]
  H --> S["SDK / API"]
  W --> L["共享事实源"]
  C --> L
  T --> L
  S --> L

如何理解官方实现的边界

如果用 Coding Agent 的产品标准比较，早期 DSH 的交互体验、插件质量和接口稳定性未必能与成熟产品相比。这并不否定它的价值：作为开发框架，它更像一套乐高零件和组合规则，官方产品只是其中一套预置拼法。

换引擎、工具、文件系统、沙箱、会话存储或 UI，最后拼出来的甚至不一定还是 Coding Agent。这种自由度带来的代价是生态质量不齐、接口持续变化和组合错误增多，使用时必须固定 Profile、版本和权限边界。

生态现状

“可替换”不只是架构承诺。截至 2026 年 8 月，DSH 已形成可观的插件生态：

  • GitHub dsh-plugin topic 下 10,000+ 公开仓库
  • 社区 Plugin Marketplace 索引 3,900+ DSH 专用插件和 14,000+ 通用 Skills
  • 插件按 12 个自动分类组织（模型适配、工具、存储、安全、UI 等）

生态规模验证了 Cordis 的组合模型在实践中可行，但也带来质量参差和版本兼容问题——社区教程中已有不少不准确描述（如”橙皮书”中关于 PTC 成本和动态工具生成的说法已被验证为不实）。使用第三方插件时，固定版本和审计权限是必要的。

什么时候应该选择 DSH

如果目标只是增加搜索、Skill 或少量 Hook，声明式扩展加短暂重启通常更便宜。若目标是研究可替换 Agent Loop、运行时组合多个产品形态、动态装配有状态能力，或者为自进化探索提供物理插槽，DSH 才真正体现差异。

它不会自动让模型更聪明，也不保证日常 Coding 体验超过成熟产品。它提供的是一个更高的 Harness 可变上限，并把生命周期、兼容性、权限和生态治理的复杂度一起交给开发者。

参考官方 Architecture。社区解读文章（如 DeepSeek Harness Agent OS）可作为阅读线索，但实现细节可能与当前版本不同，以官方仓库为准。

下一篇建议继续看：本模块已结束，可回到 DeepSeek Harness 总览 按设计问题复习。