DeepSeek Harness
DeepSeek Harness 详解：插件、Profile 与 Agent Runtime
基于源码介绍 DeepSeek Harness（dsh）的 Cordis 插件架构、Profile、Bundle 以及开发预览边界。
你将学会
- dsh is a plugin-composed agent harness built on Cordis.
- Profiles and bundles determine which services mount at boot.
- Developer-preview status means you must pin and re-verify behavior.
开始前需要
- Basic HTTP and API knowledge
Leave with a concrete implementation checklist and a testable starting point.
先看结论
- dsh 是基于 Cordis、由插件组合的 Agent Harness。
- Profile 和 Bundle 决定启动时挂载哪些服务。
- 开发预览意味着必须固定版本并重新核验行为。
先给结论
DeepSeek Harness（dsh）是 DeepSeek AI 开源的 Agent Harness。README 明确说明它采用“一切皆插件”的架构，并由 Cordis 驱动，因此模型适配器、工具、持久化和 Agent Loop 都可以组合或替换。
它目前仍是开发预览版本，不是冻结的兼容性契约。仓库明确提醒会出现破坏性变更，因此评估时应固定提交或版本，并把实验与生产自动化隔离。
组件如何组合
Profile 是保存在 Harness Home 中的一组命名组合，列出 Bundle 并保存用户补丁；Web 和 Headless 是随仓库提供的模板。Bundle 则是 Cordis 配置行及其挂载代码的分发格式。
架构文档列出的核心脊柱包括 Session、系统提示词组装、工具、Agent 和具体 Agent Loop。扩展包依赖服务定义而不是具体 Provider，因此驱动可以替换。
适用与不适用
当你需要可运行的 Agent 界面、Headless 模式、插件、工作区和明确的审批边界时，dsh 很适合作为学习和实验对象。它尤其适合想理解 Agent Runtime 如何组装的工程师。
不要把它当作稳定的评测基准或无条件可用的生产平台。当前 README 和开发指南才是命令、Node 版本和预览限制的事实来源。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best fit | Inspecting and composing an agent runtime | A tiny script that only needs one model call |
| Operational posture | Pin versions and inspect preview changes | Prefer a stable API contract with fewer moving parts |
实施步骤
- 1
同时阅读 README 与架构文档。
- 2
把功能映射到服务定义、Provider 和 Consumer。
- 3
根据是否需要服务器选择 Web 或 Headless Profile。
- 4
记录实验使用的提交、Node 版本和命令。
可复制示例
profile -> bundles -> cordis.patch.yml -> plugin tree
|
+-> sessions / tools / agent loop / model adapter常见问题
DeepSeek Harness 稳定吗？
仓库将其标记为开发预览，并警告会有破坏性变更。请固定测试版本。
资料来源
- DeepSeek Harness README来源核查 2026-08-27
- DeepSeek Harness architecture guide来源核查 2026-08-27