正文预览
MAINTENANCE PATH · 安装后生命周期
安装以后：更新、退出登录与卸载
Pi 已经能正常使用以后，你迟早会遇到这些问题：提示有新版本时要不要更新？换一个模型账号是不是要重新安装？卸载以后，旧会话和 API Key 还在不在？
它们不是同一个动作。更新改变程序版本；退出登录处理 Pi 保存的认证；卸载只移除 pi 命令；本地会话、设置和 Package 由你另外决定是否保留。
准备更新前，可以先到Pi 版本更新记录输入当前版本或目标版本，检查新功能、Breaking Changes、迁移说明和已修复问题。版本档案用于理解差异，实际更新仍按本页的恢复点和验收步骤进行。
先记住最容易误判的一点
按照 Pi 官方当前说明，卸载 Pi 不会自动删除
~/.pi/agent/。这个目录可能包含认证信息、会话、设置和已安装 Package。看到pi: command not found，不能证明凭据和历史记录已经从电脑中消失。
本页同时覆盖蓝皮书当前采用的官方安装器和 npm 路线。更新 Pi 本体都可以先使用 pi update；卸载时必须回到自己原来的安装方式。Windows 用户看到“普通终端”时，仍应打开 Git Bash。
先判断自己要完成哪件事
| 你的目标 | 应做的动作 | 不会自动发生的事 |
|---|---|---|
| 使用新版 Pi | pi update | 不会顺便更新所有 Package |
| 只刷新模型目录 | pi update --models | 不会升级 Pi 本体 |
| 更新已安装 Package | 先 pi list，审查后用 pi update --extensions | 不代表 Pi 本体已经更新 |
| 换账号或移除 Pi 保存的凭据 | 在 Pi 中使用 /logout | 不会卸载程序或删除会话 |
| 暂时不用 Pi，但想保留历史 | 用原安装方式卸载 Pi，保留 ~/.pi/agent/ | 不会自动清理本地数据 |
| 不再保留这台电脑上的 Pi 数据 | 先退出登录和盘点，再单独处理数据目录 | 不能只靠卸载命令 |
不确定时，先停在“查看版本和盘点”阶段。检查命令不会替你修改设置。
1. 更新前先留下恢复点
不要在 Pi 正在修改文件、运行构建或等待模型回复时更新。先让当前任务结束，在 Pi 编辑区输入 /quit，回到普通终端。
如果当前目录是 Git 仓库，先用自己的正常流程确认重要修改已经提交或另有备份。Pi 的更新命令只负责 Pi，不会替你的项目创建恢复点。
记录当前版本和已安装 Package：
pi --version
pi list
把版本号记在临时笔记中。pi list 展示的是用户设置和当前项目设置中登记的 Package；它们可能包含能够执行代码的 Extension，所以后面不要未经检查就全部更新。
再确认 Pi 的本地数据目录是否存在，但不要打印其中的认证内容：
test -d ~/.pi/