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 运行方法论。
支持桌面与移动端。回车可直接搜索。