Titpea
原样的 Pi
终端界面、引擎和工具都是 Pi 自己的，历史仍存为 Pi 的 JSONL 文件。
celagent 基于开源终端编码 Agent Pi
换台机器，接着写
把 Pi 编码 Agent 的会话逐轮存进百度对象存储（BOS），在另一台配置好的机器上按 ID 接着用。
curl -fsSL https://github.com/hxddh/celagent/releases/latest/download/install.sh | sh Pi 编码 Agent 终端界面 · 百度 BOS
- 许可
- MIT
- 版本
- v0.4.3
- 发布
- 2026年8月26日
- 联网
- 自动
$ celagent
命令
-
celagent -
celagent list -
celagent <id> # 从 BOS 恢复 -
celagent task ledger
持久化 完成的轮次 → BOS 写入队列 → 写入成功后按会话 ID 恢复
两台机器均需配置两台机器的写入冲突会被发现
完整的 Pi 会话，不是摘要
每轮保存
每完成一轮就排队写入 BOS，冲突的写入会被发现。
不静默回退
写入失败就留在队列里重试，不拿截断的缓存冒充完整历史。
先配置存储
配好 BOS 后，celagent doctor 检查连接，celagent cas-probe 确认能发现写入冲突。
按 ID 恢复
在已配置的机器上，celagent list 列出会话，celagent <id> 打开其中一个。
开始使用
装好后，检查 celagent 能否连上你的 BOS 存储桶。
-
检查配置、凭据和 BOS 连接
celagent doctor
数据的去向
- 每个完成的轮次以 Pi JSONL 写入你自己的 BOS 存储桶；celagent 在本机启动的 Celld 另存一份缓存。
- 提问和工具结果发往你配置的模型，默认是 DeepSeek。
- 没有模型 API 密钥时，celagent 用占位回复作答，方便先测试存储。
- 存储凭据来自环境变量或
~/.aws/credentials里的[bos]profile；celagent rm <id>删除会话。
常见问题
会同步工作区吗？
不会。恢复会话不会在另一台机器上准备项目文件和运行环境。依赖跨机恢复前，先确认 BOS 写入成功。
BOS 写入失败会怎样？
可重试的失败会留在队列里，换机恢复要等写入成功。恢复时先读 BOS，只有 BOS 里根本没有这个会话，才改用本机 Celld 的缓存；BOS 超时或权限出错时不会改用缓存，因为缓存可能被截断。
历史怎么保存？
每个会话以 sessions/<id>.jsonl 存在存储桶里，这是 Pi 自己的历史格式，含工具调用和分支。旧的 .json 会话仍能读取，按文本恢复。
怎么安装？
运行本页顶部的安装脚本。Windows 上在 PowerShell 里运行 README 中的 install.ps1 安装命令；它只装 celagent，不含 Celld，因为上游 Celld 没有 Windows 包。装好后运行 celagent doctor。
celagent