Cursor 接入 AI SDK Harness：统一编码 Agent，先分清接口层和模型层

Cursor 接入 AI SDK Harness：统一编码 Agent，先分清接口层和模型层

Vercel 8 月 27 日宣布，Cursor 已通过 @ai-sdk/harness-cursor 进入 AI SDK harness layer。应用可把 cursor 交给统一的 HarnessAgent；适配器内部使用 @ai-sdk/harness-acp，通过 Agent Client Protocol（ACP）连接 Cursor。同一层还支持 Claude Code、Cline、Codex、Deep Agents、Grok Build、OpenCode 和 Pi。

接口层在收敛，但工程上的可替换范围没有那么大。Harness 管模型调用之上的运行环境：会话、沙箱、技能、工具、权限确认、上下文压缩和子 Agent。模型网关处理 API 凭据、模型路由、限额、计费和失败切换。两层解决的问题不同，也会留下不同的故障证据。

HarnessAgent 统一了启动方式，没有抹平运行时差异

统一接口可减少胶水代码。产品原本要分别启动 Codex、Claude Code 或 Cursor，处理各自的流式输出和生命周期；现在可围绕 HarnessAgent 组织沙箱与会话逻辑，再由适配器连接具体 harness。

ACP 承担客户端与 Agent 运行时之间的连接协议。它让 Cursor 进入 AI SDK 的共同抽象，但不会自动统一模型、技能目录、系统指令、审批策略或上下文整理方式。一个 Agent 能读哪些文件、何时请求批准、失败后能否恢复，仍由 harness、适配器版本和沙箱配置共同决定。

迁移测试不能只看代码能否编译。至少要覆盖文件修改范围、命令授权、工具顺序、长会话压缩、断线恢复和取消行为。不同 harness 即使用同一模型，提示编排和上下文选择仍会改变结果。涉及安全修复或大范围重构时，可让独立模型审阅补丁与测试报告，减少某个 Agent 自评产出的偏差。

模型网关、Harness 与 DASP 分别处在三层

统一编码 Agent 后，团队还会遇到模型供应商切换。Harness 决定 Agent 怎样工作；大模型 API 中转决定请求发给哪一个模型、使用哪把 Key、如何限流与统计成本。站内的[编码 Agent 统一模型网关指南](/articles/coding-agent-ai-gateway-openai-compatible-api-guide)侧重模型调用，AI SDK Harness 解决运行时抽象。只接入一层，无法同时获得运行时可替换和模型侧可治理。

可以按请求链检查责任边界：业务应用调用 HarnessAgent，适配器经 ACP 启动 Cursor，Cursor 再通过兼容 API 访问模型。任务卡在权限确认时查 harness；出现 429、供应商超时或额度异常时查模型网关；多个 Agent 对方案有分歧时，可把[DASP 协议](/dasp/reference)放在上层保留提案、证据和决策过程。

分层也影响成本口径。Harness 层看任务完成率、工具轮次与人工接管；模型层记录 token、延迟与供应商费用；业务层衡量合并率与缺陷逃逸。混成“单次 Agent 成本”后，很难看出费用增加来自模型、工具循环还是失败重试。

试点适合选择可自动验收、能够回放的任务，例如修复单元测试、更新依赖或受约束的代码审查。固定仓库快照、模型和预算，比较完成率、补丁大小、测试结果与人工介入点。若系统已经依赖 Cursor 专有能力，不必为形式统一立刻迁移全部流程；新建多 Agent 平台则可尽早把业务代码与具体 harness 解耦，同时在模型网关保留供应商级路由与审计。

Vercel 的[官方更新](https://vercel.com/changelog/cursor-ai-sdk-harness-adapter)列出了安装包、接口与当前支持的 harness。AnyAIS 可作为模型调用层统一管理兼容 API、密钥和用量；Harness 与 ACP 则继续负责 Agent 的实际运行，两者组合后才形成完整的编码 Agent 基础设施。