先配置存储
安装发布版本，配置 BOS 桶和凭证。启动会话前，用 `celagent doctor` 检查访问，再用 `celagent cas-probe` 检查条件写入。
celagent · Pi 终端 Agent
换台机器，接着聊
使用 Pi 的终端界面，会话保存在 BOS。通过会话 ID，在另一台已配置相同存储的机器上恢复历史。
$ celagent
命令
-
celagent -
celagent list -
celagent <id> # 从 BOS 恢复 -
celagent task ledger
持久化 完成回合 → BOS 写入队列 → 写入成功后按会话 ID 恢复
两台机器均需配置条件写入检测冲突
持久化模型
写入成功后，可以跨机恢复
完成的回合进入 BOS 条件写入队列。写入成功后，另一台已配置的机器可以恢复该会话。
- 01
原生会话历史
sessions/<id>.jsonl 保存 Pi 历史，包含工具调用和分支。旧 JSON 会话使用兼容的文本恢复路径。
- 02
冲突与失败
条件写入检测并发冲突，可重试的写入失败会留队。BOS 超时或权限失败时，不会静默退回截断缓存。
配置、保存、恢复
配置、保存、恢复
每轮结束后保存
完成的回合进入 BOS 写入队列，通过条件写入处理冲突。可重试的网络失败会留队；跨机恢复需要等待写入成功。
恢复已保存的会话
在另一台已配置的机器上运行 `celagent list`，再用 `celagent <id>` 恢复。先读 BOS，仅对象不存在时才回退到 worker 缓存。
对话之外
分布式任务
celagent task submitcelagent task statuscelagent task ledger
Celld 任务支持断点恢复和幂等任务记录。配置与命令细节见仓库文档。
恢复条件与 Pi
恢复条件与 Pi
恢复会话不等于同步工作区
另一台机器仍需准备项目文件和运行环境。依赖跨机恢复前，先确认 BOS 写入成功。
Pi 引擎与安装
celagent 复用 Pi 引擎及其工具。从 GitHub Release 用 install.sh 安装，Windows 使用 install.ps1；上游 Celld 没有 Windows 包。