第三部分，上下文与 Sessions

Sessions、恢复与分支

理解 Pi Sessions 的自动保存、恢复、命名、tree、fork 和 clone 工作流。

进阶 / 12 分钟 / 第 16 篇

自动保存与恢复

Sessions 按工作目录保存在 ~/.pi/agent/sessions 中，每个文件是 JSONL。pi -c 继续最近会话，pi -r 浏览历史，--session 可按路径或 ID 打开。

--no-session 创建临时会话，不持久化。涉及敏感任务时仍要考虑命令输出是否进入日志和外部系统。

pi -c
pi -r
pi --name "修复登录"
pi --session <path-or-id>
pi --no-session

/tree 可以跳到历史任意节点继续，Sessions 用 parentId 形成树。/fork 从早期用户消息创建新文件，/clone 把当前活动分支复制为新 Session。

分支非常适合比较两种方案，但最终合并代码仍应通过 Git 完成。

以下图片直接来自本页引用的官方资料，本站保存本地副本并保留逐图来源。

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁，命令、包名和接口以官方最新文档为准。