Agent Harness 是什么:用 12 步拆开模型、工具、状态、权限与 MCP
用 HARNESS-TRACE-751 固定任务记录一次 Agent 从输入、上下文、模型请求、工具调用到停止和回滚的完整轨迹,并分清 Harness 与 MCP 的责任边界。
它可能是 DeepSeek Harness(DSH),也可能是 Harness.io 的 DevOps AI,也可能是 Agent 运行框架这个通用概念,或一类 Coding Agent 编排工具。先确定词义,再进入对应教程。
四种含义
资料最近核验于 2026-09-10。如果搜索结果同时出现 Pipeline、模型工具链和 Coding Agent,先按下面四种含义拆开。
从安装和模型配置开始,用可检查的仓库任务理解插件组合与运行轨迹。
DevOps 平台能力Harness AI / Harness.io自然语言 Pipeline、构建部署排查、策略生成、Worker Agents 或 Harness 平台内 AI 能力。
运行框架与方法论Agent Harness模型、工具、状态、记忆、权限、Guardrails 和观测如何组成 Agent 运行框架。
Coding Agent 工具生态Coding Agent Harness统一或编排 Claude Code、Codex、OpenCode、Cursor 等 Coding Agent 的工具与工作流。
三分钟辨认
把你手上的链接、界面或命令填进这张表。四项能同时对上,才进入对应教程。
| 方向 | 身份与入口 | 运行位置 | 完成证据 |
|---|---|---|---|
| DeepSeek Harness / DSH | deepseek-ai/deepseek-harness | 本地终端与代码工作区 | 文件 diff、测试结果、工具轨迹 |
| Harness.io | developer.harness.io 与 Harness UI | Account、Org、Project、Pipeline 或 IDE | execution、YAML diff、审计记录或 PR |
| Agent Harness | 一种运行层概念;必须再写出具体实现 | 包围模型、工具和状态的 Host / runtime | 模型请求、工具调用、结果、终态与回滚轨迹 |
| Coding Agent Harness | 精确仓库、包名与版本 | CLI、SDK/API 或项目配置目录 | 事件终态、capability 测试或链接映射 |
项目或产品的准确名称:
发布者、域名或仓库:
我要操作的环境:
期望得到的具体产物:
失败时要看到的证据: 有两项答不出来时,先回官方项目页核对身份。不要把 DSH 的安装命令、Harness.io 的 Pipeline 操作和第三方 CLI 的参数混在一次尝试里。
Harness.io 入口
DevOps Agent、Worker Agent、MCP、IDE 扩展和 Code Quality 处理不同任务。先确定谁在何处发起动作。
| 你的动作 | 首先检查 | 验收重点 |
|---|---|---|
| 人在 Harness UI 分析一次失败或审查 YAML | DevOps Agent | execution 证据、Reject / Accept、重跑、RBAC、回滚 |
| 每次 Pipeline 运行时自动执行 AI 任务 | Worker Agent | Catalog Agent 版本、输入输出、调用者权限、Trigger 身份 |
| Cursor、Claude 或 VS Code 读取/修改 Harness 资源 | Harness MCP Server | OAuth / PAT、toolset、只读、elicitation、审计与撤销 |
| 人在 IDE 中查看 Pipeline、日志或审批 | Harness VS Code Extension | 登录身份、实际可见资源、操作权限和 IDE 内结果 |
| 从 CI 失败生成代码修复或 PR | Code Quality Agents / Autofix | 仓库范围、diff、测试、PR 审批和合并门禁 |
专题教程
内容覆盖概念、DevOps 场景、MCP、Worker Agents、Coding Agent 工具和与 MCP 的边界。
用 HARNESS-TRACE-751 固定任务记录一次 Agent 从输入、上下文、模型请求、工具调用到停止和回滚的完整轨迹,并分清 Harness 与 MCP 的责任边界。
用 DEVOPS-ERROR-761 在测试 Pipeline 制造可控 exit 17,按 D01–D14 验证 Analyze Error、证据引用、YAML 修复、拒绝/接受、重跑、权限负例与回滚。
用 HARNESS-MCP-742 完成 M01–M14:路线选择、客户端配置、只读范围、工具发现、失败负例、写入确认、审计与撤销。
从一次固定失败构建开始,用 W01–W14 完成 Harness Worker Agent 的入口选型、模型连接、Pipeline 引用、最小权限、结构化输出、负例、触发身份和撤销验收。
下载固定任务和验收表,先审 dry-run 与权限,再分别验证 harness.lol 事件流、Open Harness 能力声明和 Harnyard 符号链接。
选择边界
办公与桌面任务优先看 WorkBuddy,自托管和消息渠道优先看 OpenClaw,长期 Memory 与 Cron 优先看 Hermes。Harness 专题承接 DevOps 平台和 Agent 运行方法论。
支持桌面与移动端。回车可直接搜索。
“Harness”在 AI 语境里至少有四种常见含义,中文资料经常混用。搜索“harness 是什么”“ai harness 中文”的用户,多数想知道的是第二种:AI 代理(Agent)里常说的 harness。
| 含义 | 是什么 | 入口 |
|---|---|---|
| DeepSeek Harness(DSH) | DeepSeek 开源的 Agent 框架,可以本地安装、配置模型、处理代码仓库任务 | DSH 中文指南 |
| Agent Harness | Agent 的运行框架:把模型、工具、上下文、状态、权限、重试和观测组织在一起的那层代码 | Agent Harness 是什么 |
| Harness AI / Harness.io | DevOps 平台 Harness 提供的 AI 能力,例如自然语言生成 Pipeline、排查构建部署 | Harness AI DevOps 场景 |
| Coding Agent Harness | 统一或编排 Claude Code、Codex、Cursor 等 Coding Agent 的工具和工作流 | Coding Agent Harness 工具 |
模型本身只会根据输入生成输出。要让它“做事”,需要一层代码负责:把任务和上下文组织成请求,解析模型想调用的工具,真的去执行工具,把结果再喂回模型,记录状态,判断什么时候停下、什么时候需要人批准、失败后怎么重试或回滚。这一层就叫 harness,可以理解为套在模型外面的“驾驭装置”。
同一个模型,换一套 harness,表现可能差别很大:工具描述写得清不清楚、上下文怎么裁剪、权限怎么拦截、出错后能不能恢复,都由 harness 决定。所以讨论 Agent 好不好用时,常常要同时看模型和 harness。
MCP(Model Context Protocol)是一种协议,规定外部工具和数据源怎么以统一格式暴露给 Agent。Harness 是使用这些工具的运行框架。可以这样记:MCP 负责“工具怎么接进来”,harness 负责“什么时候调用、调用结果怎么处理、权限和状态怎么管”。一个 harness 可以支持 MCP,也可以用自己的工具接口。详细拆解见 Agent Harness 与 MCP 的边界。
没有统一译法。在 AI Agent 语境里常译作“运行框架”“驾驭层”或直接保留英文 harness;指 DevOps 平台 Harness 时是产品名,不翻译。
不是。Agent Harness 是一个通用概念;DeepSeek Harness(DSH)是 DeepSeek 开源的一个具体的 harness 实现。
入门使用不需要。当你想理解为什么同一个模型在不同 Agent 产品里表现不同,或者要自己搭 Agent 时,再学习 harness 会很有帮助。