DeepSeek Harness、Loop And Graph

DeepSeek Harness、Loop、Graph：介绍、区别与使用指南

一句话定位：Loop 管一次局部执行，Graph 管多个单元怎么连，Harness 管整套运行约定。 三者是不同尺度的概念，不是三代替代关系。

一、三者是什么

1. Agent Loop（循环）

回答的问题是：“这一轮里，模型下一步做什么？”

模型读取上下文 → 发起工具调用 → 拿回结果 → 再决定是否继续。DeepSeek Harness 的架构文档把一次模型请求及其触发的工具调用称为 Step，把由零个或多个 Step 组成的一轮完整用户交互称为 Turn。

关键点：在 DeepSeek Harness 中，Loop 本身也只是一个可替换的插件，并非不可动摇的核心。

2. Graph（图）

回答的问题是：“多个执行单元怎么连接？”

只有三个概念：

• Node（节点）：干活的单元，可以是 Agent、普通函数、测试脚本，甚至"人工审批"；
• Edge（边）：干完之后去哪——并行、汇合、失败退回、等待审批；
• State（状态）：大家共享的档案——任务进度、返工次数、预算。

3. Harness（运行外壳）

回答的问题是：“模型运行时遵守哪些整套约定？”

包括上下文组装、工具暴露、权限检查、状态保存、失败恢复等。DeepSeek Harness 底层基于 Cordis 插件框架：Loop 驱动器、工具注册表、模型适配器、会话日志全是插件，皆可替换重组。Graph 只占其中工作流和调度的一部分。

核心判断：模型参数只决定一部分 Agent 能力，模型被怎样包起来，同样会改写结果。

二、三者的区别

破除一个迷思：Graph 不比 Loop “先进”，Harness 也不是终极形态。三者各管一层，共同构成完整的 Agent 工程体系。

三、使用指南

1. 什么时候用 Loop，什么时候画 Graph

大多数真实系统是混着用的：外层用 Graph 规定节点路线，每个复杂节点内部跑一个 Loop。

2. 选 Harness 模式

DeepSeek Harness 当前提供四种模式，同一个底座模型在不同模式下表现会明显不同：

同一模型换一套 Harness，结果可能就是另一种产品：Harness-Bench（2026 年 5 月发布）的主实验将 6 种可配置 Harness 与 8 个模型后端交叉组合，在 106 个离线任务上得到 5088 条运行轨迹，在任务、预算、超时和评估方式固定的条件下，六种 Harness 的汇总得分相差 23.8 个百分点。因此谈 Agent 能力时，模型和 Harness 应被视为一个组合。

3. 上手注意事项

• 启动入口：npx @deepseek-ai/dsh web（需自备模型凭据）；
• 当前为开发者预览版（MIT 许可证），官方明确提示后续会有不兼容改动，先做小规模受控试验（同模型、同任务、同预算下对比 Minimal 与 Standard），再决定是否扩大使用；
• 权限和沙箱不能只写在提示词里：工具调用需经过执行前钩子、权限检查、沙箱和审批，审批采用一次性授权；沙箱主要约束文件系统影响，网络访问和进程可见性不在通用规则覆盖范围内。

4. 实践建议

参考资料

• DeepSeek Harness 开源后，Graph Engineering 该换个讲法了（accesspath / 53AI）
• DeepSeek Harness 架构拆解（二）：概念地图（CSDN）
• 万物皆插件：DeepSeek Harness 底层揭秘（今日头条）