
字节笔记本
2026年11月4日 · 约 3 分钟读完
Pi 长时任务插件横评:从 pi-goal 到 Pi Durable
让 Pi 连续跑几小时甚至几天不中断,任务断了还能恢复,最好还能自动拆任务、跑测试、审代码、接着执行。这不是一个插件能做到的事,而是五个插件各自解决不同环节的组合。
Pi 生态里长时任务插件目前有五个值得关注的选择:pi-long-task、Pi Durable、pi-agents、pi-durable-subagents 和 pi-goal。它们的定位差异很大,选错了会浪费不少时间。
一、五个插件各自解决什么
pi-long-task 自动拆分 TODO、运行 Worker、失败重试、进度监控加 Git 提交,支持 Goal Loop,默认最长运行 48 小时可调。适合一次性把完整开发需求交给 Pi 持续执行。Pi Durable 是官方实验性的持久化运行框架,任务步骤写入存储、支持断点恢复、进程重启后继续执行,适合开发 24×7 Agent 服务但需要自己搭工作流。pi-agents 提供持久化具名 Agent、后台任务和 Agent 图编排,主 Agent 可以继续处理其他工作。pi-durable-subagents 基于 Pi Durable 提供持久化子 Agent,支持后台运行、实时干预、恢复未完成工作和 Git Worktree 隔离。pi-goal 走轻量路线,给 Pi 增加 /goal 长期目标模式,保存目标、自动循环执行、暂停后手动恢复,适合持续优化测试覆盖率或重构维护任务。
安装也简单,核心的 pi-long-task 一条命令就行:pi install npm:pi-long-task。装完在 Pi 里输入目标描述,它会围绕目标生成任务、运行 Worker、检查完成情况并按配置继续下一轮。
二、长时任务的关键区分
这里需要区分两个容易混淆的概念:目标持续循环和进程崩溃后的可靠恢复。pi-goal 更偏前者,保存的是长期目标,适合持续优化测试覆盖率这类「方向不变、逐步逼近」的任务。Pi Durable 更偏后者,解决的是进程重启后从断点继续执行的问题。如果你的场景是 Mac mini 或 VPS 上部署一个长期运行、断线恢复、允许远程干预的 Pi Agent,Pi Durable 加持久化子 Agent 加独立进程守护加任务状态存储是更完整的组合。Cloudflare 也已经提供通过 Durable Objects 运行 Pi Durable 的方案。
三、注意事项
pi-agents 当前的持久化子 Agent 不能直接使用父会话的 MCP 服务器和其他扩展工具,主要依赖内置文件和 Shell 工具,功能有边界。pi-long-task 的 Goal Loop 默认最长 48 小时,超时需要手动调整配置。Pi Durable 还是官方实验性框架,API 和行为可能变化。如果只是希望丢给 Pi 一个需求让它连续开发十几个小时,先用 pi-long-task 就够了。
来源:Pi 官方文档与插件目录(2026-11-03 直读);jprokay/pi-long-task 仓库;Earendil Works Pi Durable 文档。


