正文预览

选学案例 · 可练习

用 Pi Durable Assistant 观察断点恢复

结果

在本机运行一个基于 Pi Durable 的网页版个人 Agent，让它执行一个需要等待 10 秒的任务；等待中途强制结束进程。进程被重新拉起后，任务从中断处接着做完：三条待办各只添加一次，等待按原截止时间继续，最终回答照常出现。

这个案例和 CASE 06 有什么不同

CASE 06 用进度文件手动保存检查点，恢复靠新会话读取文件。本案例的检查点由 Pi Durable 框架自动保存：每调用一次模型、执行一个工具都会存档，恢复不需要人写进度文件。两种方法解决的是同一类问题，适用场景不同：日常用 Pi 处理长任务，CASE 06 的方法已经足够；开发需要长期在线的 Agent 应用时，才值得了解本案例的框架做法。

固定材料

• 演示项目：Pi Durable Assistant v0.1.0，基于 @earendil-works/pi-durable@1.1.0，MIT 许可。
• 运行环境：Node.js 22.13 或以上、npm、Git。不需要 API Key、Docker 或服务器。

非官方项目

Pi Durable Assistant 是本书作者小墨同学的个人开源项目，不是 Earendil 官方产品。Pi Durable 本身仍处于实验阶段，API 可能变化；本案例固定在上面的版本复现。

1. 取得固定版本

在练习目录中执行：

mkdir -p ~/Downloads/pi-practice
cd ~/Downloads/pi-practice
git clone --branch v0.1.0 https://github.com/xiaomoBoy/pi-durable-assistant.git
cd pi-durable-assistant
node --version
npm ci
npm run check

node --version 应显示 v22.13 或更高版本；npm run check 结束、回到终端提示符且没有报错，再继续。