$ cat ~/map/durable-harness.md

durable-harness

把 pi 等编码 agent 跑成可恢复的 workflow 运行：回合中途崩溃也从事件日志续接。

tools✓ 10月19日

事实速查

安装

npm install durable-harness @earendil-works/pi-durable @earendil-works/chord @earendil-works/pi-ai just-bash

## 速览

Vercel Labs 的实验性库：把编码 agent 套件——pi 经由它自己的 durable Harness——作为 workflow 运行跑在 Workflow SDK World 上，对话、进行中的回合与每一次模型和工具调用都记入事件日志，崩溃的运行从中续接。

## 要点

$每个会话就是一个 workflow 运行：对话、进行中的回合与每一次模型和工具调用都记录在该运行的事件日志里。
$任何位置崩溃都从日志续接回合（可以换一台机器），不可重复执行的工具调用绝不会跑第二次。
$pi 的推荐接法是 durable-harness/pi-durable 适配器，在 World 支撑的存储上打开 pi 自带的 durable Harness；另有朴素的 durable-harness/pi 适配器。
$OpenCode 与 fx 各有适配器；Claude Code 与 Codex 只在会话自己的 Vercel Sandbox 里运行，不进共享 Function。
$模型选定的命令与文件在虚拟工作区或会话沙箱中执行，绝不落在驱动会话的那台机器上。
$本地开发用 Workflow SDK 的 local World，零配置；生产可部署到 Vercel，或用 Postgres World 等自托管 World。
$实验性 0.0.x 软件——API 可能随版本变化。

## 常见问题

Q durable-harness 只支持 pi 吗？

不是。它为 pi、OpenCode、libfx 的 fx、Claude Code 与 Codex 各提供适配器，各自经独立的子路径导入；其中 Claude Code 与 Codex 的运行被限制在会话自己的 Vercel Sandbox 内。

Q 运行到一半崩溃会发生什么？

回合从该运行的事件日志续接，可能在另一台机器上进行；不可重复执行的工具调用绝不会被执行两次。

## 参考链接

## 相关条目

最后更新: 2026年11月4日