相关项目与生态
Cordis、组合性论文、dsh-plugin 插件发现、评测口径与同类 agent harness 的中性对比
DeepSeek Harness 是一套更大生态的一部分。本节列出与它直接相关的项目，并把它们放到同类 agent harness（智能体框架）的语境里，帮助你判断与选择。
Cordis
Cordis 是 DeepSeek Harness 底层的插件框架，由 cordiverse 组织维护。它提供组合插件、服务、类型化事件与生命周期（fiber）的运行时模型，「一切皆插件」正是它的核心理念。Harness 以 vendored 形式内置了 Cordis 源码。
Cordis 的核心原语有三样：插件（实现服务的最小单位）、服务（挂在 ctx 上、按 key 查找的能力）与事件（插件之间的通信）。这些原语共同支撑起 Harness 的可组合性。想写插件，建议先读 Cordis 入门。
组合性论文
A Programming Paradigm for Spatiotemporal Composability 描述了 Cordis 的设计思想。所谓「时空组合性」，指的是把功能既在空间上（多个插件如何并存、协作）又在时间上（生命周期如何开始与回收）组合起来。想理解 Harness 为何采用插件化架构，可以从这篇读起。
预印本状态
该论文目前是作者标注为持续修订中的 preprint（预印本），尚未经过同行评议；适合作为设计思想的参考，不宜当作已被验证的结论引用。
性能与评测口径
阅读任何关于 DeepSeek Harness 的成绩数字前，先明确口径：
系统成绩，而非 Harness 成绩
DeepSeek 官方公告中，公开 Code Agent 基准的成绩是在「模型 + DeepSeek Harness 极简模式 + 参数配置 + 工具环境」整个系统上测得的。官方原文为：「对于公开基准测试集中的 Code Agent 任务，DeepSeek-V4-Pro-0813 使用 DeepSeek Harness 极简模式作为框架进行测试（使用 max 档位，top_p=0.95，temperature=1.0），其他框架下结果可能略有不同。」（见 DeepSeek API 官方公告）
因此，引用时应写「V4 Pro + Harness 极简模式下的系统成绩」，而不是「DeepSeek Harness 的成绩」。截至本文撰写时，尚无在同一模型、同一任务与同一预算下对 DeepSeek Harness 与其他 Harness 进行严格控制变量比较的独立研究；Harness 本身的贡献大小需要自行 A/B 测试，而不能从官方组合成绩反推。
插件发现：dsh-plugin 话题
社区插件通过 GitHub 的 dsh-plugin 话题被发现。为你的插件仓库添加这个话题，其他用户就能在话题页找到它；同样，你也可以在话题页浏览现有插件。安装方法见常见问题。
上游仓库
deepseek-ai/deepseek-harness 是本项目的上游仓库，包含全部源码、文档与问题追踪。仓库内除了核心框架，还包括：
- Python SDK 与 TypeScript SDK：供程序化调用。
- 示例组合包与可运行示例：位于
examples/。 - CLI：即
dsh命令，负责启动 profile。
本帮助中心即基于该仓库整理并本地化；如内容与最新版本不符，以上游为准。
谨防同名项目
「deepseek-harness」一词在官方发布前已被第三方项目使用，存在同名混淆与供应链冒充风险。安装与 fork 时请核对组织名 deepseek-ai 与 npm scope @deepseek-ai。详见安全与合规。
与其他 agent harness 的对比
agent harness 是承载 agent 的运行时框架：它把模型适配器、工具、文件系统、命令执行、沙箱与审批组合起来。市场上还有多款同类工具，下面的并列只做事实性描述，不含优劣判断：
| 项目 | 简述 | 许可 | 部署形态 | 定位 |
|---|---|---|---|---|
| DeepSeek Harness | 一切皆插件的 agent harness，由 Cordis 驱动 | MIT | 本地 Web / headless | 开放的可组合 Agent runtime |
| Codex CLI | OpenAI 的开源 coding agent（编程智能体），运行在终端 | Apache-2.0 | 本地 CLI + 云端模型 | 成熟的终端 coding agent |
| Claude Code | Anthropic 的编码工具，运行在终端 | 未以开源许可证发布 | 本地 CLI + 云端模型 | 成熟的终端 coding agent |
| Gemini CLI | Google 的开源 CLI，支持 MCP 与扩展 | Apache-2.0 | 本地 CLI + Google 云 | 面向 Google 生态的终端 agent |
| OpenCode | 多模型中立的开源 coding agent | MIT | 本地 CLI / 桌面 + 自选 provider | 多模型中立的开放 runtime |
Codex CLI 与 Claude Code 都是面向代码仓库的终端工具；DeepSeek Harness 同样让 agent 在本地工作区读写文件、运行命令。它的设计差异在于组合模型：每项能力都是可通过 Cordis 组合与替换的插件，因此更强调可定制性与可扩展性。选择哪一款，取决于你更看重生态、模型绑定还是组合自由度。
许可信息核对
上表许可信息为撰写时的仓库状态（Apache-2.0 / MIT 等均可在对应 GitHub 仓库核实）；许可证只覆盖软件代码本身，不覆盖模型权重、第三方插件与 API 服务条款。企业引入前应自行做 SBOM 与依赖许可清单，见安全与合规。