Pi Durable

Pi Durable 是 Pi 仓库中的实验性智能体运行框架。它先把对话、模型轮次、工具调用和应用状态提交到存储，再向外展示；重新打开持久存储后，可以从保存的检查点继续中断的工作。它适合开发任务持续时间超过单次进程生命周期的应用。

核心能力

模型接入由 pi-ai 提供，文档状态基于 Chord。对话由不可变记录组成，一次原子提交可以同时追加记录、修改文档并创建任务。持久任务按状态机保存步骤，避免把整段工作只看成一次无法恢复的函数调用。

注册表管理工具、扩展、钩子和任务，各对话保存自己的智能体选择。提交后可以等待结果；取消等待本身不会取消后台工作。这让开发者能够区分用户界面断开、调用者停止等待和真正中止任务，而不是把它们混为一谈。

实用工作流

按官方 README 一起安装 pi-durable、pi-ai 和 Chord，先复现短示例。MemoryStorage 适合理解 API，却不会在进程退出后保存数据。验证恢复能力时应选择 SQLite 或 JSONL 存储，打开运行框架，提交短任务，然后主动重启进程。

再次打开同一份存储并使用文档中的 resume 方法，检查任务状态和最终回答，再逐步加入外部工具。先用一个可撤销的操作测试中断边界。对话成功恢复，不代表第三方系统中的实际操作一定只执行了一次，重试与幂等仍需应用自行设计。

费用与限制

仓库采用 MIT 许可。模型调用、存储和部署分别产生费用，这不是有固定订阅价的托管助手。官方明确标注 API 为实验性，版本之间可能不经通知发生变化。实际部署应固定依赖版本，并在升级前测试已有对话数据和迁移路径。

应使用文档明确支持的存储实现，不能把导出的聊天文本当作完整恢复数据。工具重试、超时、外部副作用也需独立验证。首次集成保持工具范围小，能看清失败原因后再扩展。

常见问题与替代方案

内存示例能跨重启恢复吗？ 不能，必须选择持久存储后端。

它就是 Pi 终端应用吗？ 它是同一生态里的独立运行框架包，面向应用开发者。

可以先阅读官方包文档，对照 Pi 编码智能体，或浏览智能体基础设施。下一步建议先完成可重复的中断恢复实验，再验证业务真正依赖的外部状态变化。