← 文章 / 科技资讯
vercel 21天前 · 2026-11-01 04:34:24 · 29 阅读

确保每一个护套都经久耐用

开发者早已习惯在本地通过 Pi、Claude Code 等 harness 运行 coding agent。这些工具日常生成代码很可靠,但要让 agent 全天候运行,电脑就得一直开着不睡眠——由此才有了"合盖梗"和 Mac mini 需求激增。

CormacCormac@cormachayden_·Follow

agent 出现前后的软件工程师

ImageImage3:04 AM · May 3, 202619.6KReplyCopy linkRead 455 replies
现在 harness 可以跑在云端,笔记本终于可以合盖了。

Copy link to heading在云端运行 harness

Harness 负载正在向云端迁移。个人开发者在部署全天候的 coding agent 工作流,OpenWork 和 HanaAgent 等项目把开源 harness 当作应用背后的引擎,还有工程师在做自己的 harness 产品。

这类 harness 是为长期存活的进程设计的,session 常驻内存,agent 任务动辄运行几分钟甚至几小时。在本地,harness 可以直接、持续地访问同一块磁盘上的工作区和 session 历史,恢复被打断的工作只需一句 prompt。

在云端,你当然可以用 VM 加持久化存储复刻这套环境,但 VM 不会自动记录哪些模型调用和工具调用已完成,崩溃后也无法自动续跑被打断的 turn。一次 turn 失败或网络错误,就意味着工作白做。

此外,并非所有通过 harness 执行的智能体任务都需要沙箱。数据库查询和 API 调用可以直接在函数中安全运行,这也意味着所需的凭据无需进入沙箱。

复制标题链接让所有 harness 持久化

我们构建了 eve 和 fx,它们开箱即用地在云端持久运行。今天,我们正式推出 durable-harness,将这种持久化能力扩展到任意 harness,包括 Pi、OpenCode、Codex 和 Claude Code。它利用驱动 Workflow SDK 的相同机制,以抵御崩溃和函数超时。

使用 durable-harness,你可以:

  • 在 Vercel 上持久运行上述任一 harness

  • 使用自己的 Postgres 实例自托管 harness

  • 让本地 harness 工作流具备持久化能力

  • 构建你自己的持久化 harness

复制标题链接在回合中途崩溃后幸存的会话

以一个编程智能体为例,它正在为一个现有应用添加价格页面。该智能体读取现有页面,编写新页面,发起拉取请求(pull request),并等待 CI 完成后再汇报结果。

如果在其等待 CI 运行期间函数超时,会发生什么?

请在下方演示中终止函数或断开连接,以对比两个智能体的恢复方式,并查看哪些工作被重复执行。

如果没有持久化机制,智能体将停止工作,直到手动重启,且已完成的工作会被不必要地重复执行。

借助 durable-harness,新函数会从日志中读取已完成的结果并恢复回合。如果浏览器断开连接,智能体将继续运行,重新连接时会从日志中同步进度。

复制标题链接日志与队列

durable-harness 是我们开源产品组合中的最新包。它是一组适配器,工具,允许你现有的 harness 将会话保存在 World 中,这是 Workflow SDK 的持久化后端。

系统在持久化日志中记录每轮对话的每个步骤。在发起模型调用或工具调用前,先记下意图;调用结束后,记录结果。每轮对话由队列消息兜底,即使处理函数崩溃,队列也会将当前轮次交给新函数,新函数读取日志后无缝续接执行。

崩溃恢复后,日志清晰反映:哪些已完成、哪些正在运行、哪些尚未开始:

  • 已完成的调用不会重复执行,其结果直接从日志读取,因此不会产生重复计费。

  • 模型能延续之前的调用状态,而非从头重跑。

  • 标记为 replay: 'safe' 的中断工具会被重新执行。其他工具则标记为“可能已执行”,由模型自行判断是否需要检查。

对于自行维护会话文件的 Harness(如 Claude Code 的 transcript、Codex 的 rollout、OpenCode 的 event store),其每条记录都会镜像写入日志,新的函数或 Sandbox 可据此重建会话。

Copy link to heading选择你的 Harness

fx 和 eve 本身即具备持久化能力。对于其他工具,durable-harness 从外部增强持久化,无需修改 Harness 本身。

各 Harness 的完整配置指南,请查阅官方文档。

Copy link to heading随处运行

持久化 Agent 需要:每步操作的日志、进程崩溃后的轮次恢复机制、以及面向观察者的事件流。

Workflow SDK 将这三者封装于统一接口——World。

import type { Queue, Storage, Streamer } from '@workflow/world'interface World extends Storage, Queue, Streamer {}

World 即是在单一接口背后提供日志、兜底机制与事件流的统一实体。

durable-harness 写入该接口,因此同一 Agent 可在不同 World 间迁移而无需修改代码:

  • 部署在自己的服务器上时,可以使用 Postgres、MongoDB、Redis 或 Turso。

  • 只需两个变量,所有使用 durable-harness 的 agent 就能切换到 Postgres。

    WORKFLOW_TARGET_WORLD="@workflow/world-postgres"WORKFLOW_POSTGRES_URL="postgres://user:password@host:5432/database"

    这会让 durable-harness 改用 Postgres World 来保证持久化。

    如果需要更细的控制,比如设置命名空间、或在服务器启动时恢复会话,可以在代码中创建 World 并传给 agent:

    详见自托管文档。

    Copy link to heading在 Agent Runs 中查看每一次会话

    Vercel 上的 Agent Runs 会展示每个会话的完整 trace,包括每一次模型调用和工具调用。崩溃后恢复的 turn 也会出现在同一条 trace 里,你可以清楚看到每个 turn 在哪里中断、又从哪里继续。

    Agent Runs 标签页中的一个 Pi 会话,其中有一次被中断并重试的模型调用。

    Copy link to heading工具

    agent 只有你提供给它的工具,工具在你的函数中运行。每个工具都要声明崩溃中断后的处理策略。'safe' 类工具(如查询)可以重复执行;'never' 类工具(如退款)绝不能执行两次——模型会被告知该调用可能已经执行过,可以先行确认再决定是否重试。

    以上面演示中的编码 agent 为例,它的工具大概可以这样定义:

    • 读取文件、检查 CI 状态这类工具标记为 'safe',崩溃后可以自动重新执行。

    • 发布 PR 评论这类工具标记为 'never',避免重复发评论。

    下面以一个处理退款的 agent 为例,演示如何为每种策略各定义一个工具:

    lib/agent.ts
    1import { pi } from 'durable-harness/pi';
    2import type { HostTool } from 'durable-harness';
    3import { getOrder, refundOrder } from './orders'; // 你的业务代码
    4
    5const tools: HostTool[] = [
    6  {
    7    name: 'get_order',
    8    description: '查询订单',
    9    replay: 'safe', // 崩溃后安全重放
    10    inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] },
    11    execute: async ({ id }) => JSON.stringify(await getOrder(id)),
    12  },
    13  {
    14    name: 'refund_order',
    15    description: '订单退款',
    16    replay: 'never', // 绝不执行两次
    17    inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] },
    18    execute: async ({ id }) => JSON.stringify(await refundOrder(id)),
    19  },
    20];
    21
    22export const agent = pi({ model: 'anthropic/claude-sonnet-5.5', tools });

    查询操作可以在崩溃后重跑,退款操作则绝不会被执行两次。

    关于每个 harness 内置的工具(如 shell 和文件编辑),请参阅下文。

    复制标题链接文件

    当 harness 需要 shell 和文件支持时,直接在共享的 Serverless 函数宿主上运行是不安全的。多个会话可能共享同一个函数,且其文件系统并不能保证在函数调用之间持久化。

    为解决这一问题,durable-harness 提供了以下几种选项:

    • virtual() 将文件保存在会话日志中,并提供一个兼容 bash 的 shell。该 shell 无法访问函数自身的文件,也无法连接网络。它适合短任务和小型工作区,无需启动完整的沙箱。

    • virtual({ durable: false }) 将文件保存在内存中用于临时操作,并在每一轮对话结束时清除。

    • sandbox() 为会话提供独立的 Vercel Sandbox,其 /workspace 位于 Drive 上,生命周期长于任何沙箱和函数。它适合实际项目和长时间运行的任务。

    在文档中横向对比这三种方式。

    每个 harness 的内置工具运行在你选定的 workspace 上。在 Pi 中,CodingTools 会安装 Pi 自带的 read、write、edit 和 bash,而 virtualEnv() 或 sandboxEnv() 则负责为它们提供运行环境:

    lib/pi.ts
    1import { BACKGROUND_CONTEXT as ctx } from '@earendil-works/chord/context';2import { createRegistry, Harness, type S
    
    
    
    
    
    
    原始来源: vercel

    评论 (0)