原样的 Pi
终端界面、引擎和工具不变；历史仍是原生 JSONL。
$ celagent
命令
-
celagent -
celagent list -
celagent <id> # 从 BOS 恢复 -
celagent task ledger
持久化 完成回合 → BOS 写入队列 → 写入成功后按会话 ID 恢复
两台机器均需配置条件写入检测冲突
每一轮都存进 BOS
每轮保存
完成的回合进入 BOS 写入队列；条件写入检测冲突。
先读 BOS
写入失败留在队列；不静默退回截断缓存。
配置、保存、恢复
先配置存储
配好 BOS，运行 doctor 和 cas-probe。
等写入成功
BOS 写入成功后才能跨机恢复。
按 ID 恢复
在已配置的机器上 list，再按 ID 打开。
任务可从断点恢复
celagent task submitcelagent task statuscelagent task ledger
Celld 任务支持断点恢复和幂等任务记录。配置细节见仓库文档。
开始使用
安装脚本从 GitHub Release 下载二进制，含 celld 运行时。
-
一键安装
curl -fsSL https://github.com/hxddh/celagent/releases/latest/download/install.sh | sh -
自检：配置、凭证、节点、BOS 连通
celagent doctor -
启动 TUI
celagent
常见问题
会同步工作区吗？
不会。恢复会话不会在另一台机器上准备项目文件和运行环境。依赖跨机恢复前，先确认 BOS 写入成功。
BOS 写入失败会怎样？
可重试的失败会留队，跨机恢复要等写入成功。恢复先读 BOS，仅对象不存在时才回退到 worker 缓存；BOS 超时或权限失败时，不会静默退回截断缓存。
历史怎么保存？
sessions/<id>.jsonl 保存 Pi 历史，包含工具调用和分支。旧 JSON 会话使用兼容的文本恢复路径。
怎么安装？
celagent 复用 Pi 引擎及其工具。从 GitHub Release 用 install.sh 安装，Windows 使用 install.ps1；上游 Celld 没有 Windows 包。
celagent