Skip to content

[RFC] Pi Durable 适配:为 Personal Agent 建立持久执行内核 #10

Open

Description

@ydflow

状态:进行中。隔离恢复实验与初步评估已交付,桌面集成待验收。阶段:M1 · Durable Personal Core。总路线:#8;当前能力:#9。

2026-11-11 进展

PR #49 已合入,交付 ADR 0002、固定 Pi Durable 1.5.2 的独立恢复实验与三份验证记录。ADR 包含兼容矩阵、run/turn/tool/task 与研究 checkpoint 的映射、存储选型、迁移和退出方案。

  • Node 24.19.0、Bun 1.4.2、Electron 39.8.9 的 Node 模式均完成强制终止与全新进程恢复,结果为 firstReads=1、secondReads=2。
  • 已提交的第一步结果在源文件变更后仍可复用,未提交的第二步重读一次,第三个进程重开终态任务保持一致。
  • Windows 相关回归为 50 pass / 0 fail,工作区类型检查通过。PR CI 全仓结果为 1846 pass / 7 skipped / 0 fail,类型检查与 Secret Scan 通过。

下一轮通过 AgentRuntime 边界验证注册工具、模型设置、取消、预算和身份映射,并补 Electron 主进程与 Windows 打包态恢复验收。当前建议继续隔离适配实验,生产接入待上述验收。原验收清单继续保留,用于跟踪最终适配交付。

目标与价值

现有深度研究已经有 checkpoint 与中断恢复,但普通会话、个人任务与 Pi runtime 的持久执行尚未形成统一契约。先做可撤销的适配实验,决定复用、包装还是保留现有实现。

验收标准

  • 固定上游 commit/版本,列出 Trail 的 Bun、Electron、Node 与现有 Pi adapter 兼容矩阵
  • 给出 run/turn/tool/task 状态与现有 research checkpoint 的映射,说明迁移和退出方案
  • 用一个只读两步任务演示进程退出后的继续执行,并记录已完成工具是否被重放
  • 提交采用/暂缓的 ADR,明确存储后端、API 变化风险和未覆盖场景

验证方法

最小 PoC + 杀进程恢复日志;对照现有 research recovery 用例,不以单元测试代替桌面端验收。

源码起点

以上是已有实现的阅读入口,不代表拟议能力已实现。

依赖与最小贡献

无硬性前置,可独立开始。

从兼容性表和 ADR 开始,不先替换生产运行时。

参考

Pi Durable 官方文档(实验性 API,采用前固定版本;MemoryStorage 不是个人长期记忆)

参与

认领前先说明拟完成的最小范围,再评论 /claim。提交 PR 时附真实环境、验证命令和结果;仅完成部分时请列出剩余项。贡献入口:#7。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:runtime任务内核、持久执行与恢复enhancementNew feature or requesthelp wantedExtra attention is neededpriority:next近期优先推进的基础工作type:rfc需要先讨论契约和取舍的设计提案

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions