Pi Agent 任务断点继续

✅ 重点一句话

Pi 默认自动保存会话，不需要手动执行保存命令，只要你启动pi的时候不带 --no-session，所有对话、历史、任务上下文都会自动写入硬盘，关机重启电脑之后，可以直接恢复这个开发任务继续跑。

存储位置（Windows）：
$HOME\.pi\agent\sessions\
每个项目目录单独分组保存会话jsonl文件

一、给当前长任务起名字（推荐，方便以后找）

在pi交互窗口里面输入：

/name 后端项目开发任务

这样会话就打上名字，后面/resume一眼识别，不会分不清会话。

查看当前会话信息（ID、文件路径）：

/session

二、下次开机恢复任务（2种方式，都要先cd进入你的项目文件夹！）

⚠️ 必须先cd到项目根目录！Pi会话是绑定项目工作目录的，不在对应文件夹看不到这个项目的会话。

方式1：直接继续最近一次会话（最简单）

PowerShell：

cd D:\code\你的项目文件夹
pi -c

启动后直接加载上次这个目录最近的会话，完整对话历史全部回来。

方式2：会话列表手动挑选（多个任务时用）

cd D:\code\你的项目文件夹
pi -r

弹出会话选择菜单，你刚才命名的后端项目开发任务就在列表里，回车选中恢复。

进入pi里面也可以在交互界面打开会话选择器：

/resume

三、恢复会话之后，切换DeepSeek模型

恢复会话后，直接按 Ctrl+L，选中deepseek / deepseek-flash。

会话保存的是对话历史，不会锁定模型，恢复之后可以随时切换模型，和你刚才欠费中断场景完美适配。
恢复后发一句：继续刚才的开发任务，agent带着全部历史继续推进。

四、重要限制（一定要知道）

1. 自动保存是在每一轮LLM回合结束写入磁盘。
   如果是正在调用LLM中途欠费/断电，那当前这一轮未完成的LLM请求不会被保存，历史上下文都在，但是不会自动重试失败那一步，需要你手动发指令继续。
2. 文件修改是直接改你本地项目文件。会话保存只保存对话历史，不做代码版本备份！
   建议关键节点用git提交，防止agent改错代码，会话只管对话上下文，不负责文件回滚。
3. /compact 上下文压缩：任务很长、消息太多token暴涨时，可以在pi里执行，压缩早期历史，避免超出模型窗口：

/compact

五、常用会话命令（pi交互内）

/resume          # 浏览当前项目所有历史会话
/name xxx        # 给当前会话命名
/session         # 查看会话ID、文件位置
/tree            # 会话树，可以回退到历史节点，分叉新任务
/fork            # 从当前会话分叉出新会话（不破坏原始会话）
/clone           # 复制当前会话

六、不保存会话的坑（千万别带这个参数）

如果启动pi用了下面这条，会话不会保存，关机直接丢失：

pi --no-session

七、你的场景实操流程总结（你现在这个GLM欠费中断任务）

1. 现在pi里执行 /name 项目开发（GLM中断，后续切DeepSeek）
2. 退出pi，关机
3. 下次开机，打开PowerShell，cd到项目目录
4. pi -c 恢复完整会话
5. Ctrl+L切换deepseek-flash
6. 发送指令：刚才调用模型时欠费中断，请基于全部历史继续完成开发任务