pi-plugins-deploy

在新电脑上一条命令把 pi CLI 的全部插件装回来（只装插件，不动 models/mcp/密钥/提示词）。

npx pi-plugins-deploy --dry-run   # 先看计划
npx pi-plugins-deploy             # 一键部署

装了什么

| 内容 | 说明 | 落到 | |---|---|---| | settings.packages 全量 20 项 | 19 个 npm 插件 + 1 个本地路径项 | 合并进 ~/.pi/agent/settings.json | | extensions 实文件 | auto-retry、antigravity、diff/files/tps/prompt-url-widget、long-run-orchestrator、pi-rtk-optimizer 配置 | ~/.pi/agent/extensions/ | | 外部符号链接 3 个 | keylight、opencode-zen-pool、swarm-kit | 目标不存在时单文件回退 _vendor/ 副本 | | bin/github-mcp-wrapper.sh | github MCP 包装脚本 | ~/.pi/agent/bin/ | | plugins.json 参考副本 | 插件清单，方便自查 | ~/.pi/agent/plugins.json |

合并规则（安全）：只替换模板已覆盖的 packages 条目（去重，不产生重复），你自己的自定义插件条目和 settings 其余字段全部原样保留；旧 settings.json 先备份进 ~/.pi/agent/.deploy-backup-<时间戳>/，零删除、幂等可重跑。

不会碰：auth.json、secrets/、models/mcp（含密钥）、AGENTS/APPEND_SYSTEM、prompts、skills。包内零密钥（采集自检：明文家目录/密钥模式命中即退出码 1）。

部署后

1. 首次启动 pi 会自动 npm 安装 settings.packages 里全部插件（要联网）
2. 需手动就位（报告会提示）：
   • ~/.pi/agent/bin/github-mcp-server（24MB 二进制未打包）
   • ~/.pi/agent/secrets/github-token（写入 GitHub PAT）
3. ../../code/pi-computer-use（本地包）需克隆到 ~/code/pi-computer-use，否则 pi 启动会提示该路径无效

参数

npx pi-plugins-deploy --home <dir>     # 部署到指定 HOME（沙箱/迁移）
npx pi-plugins-deploy --dry-run        # 试运行不写盘
npx pi-plugins-deploy --no-settings    # 不改 settings.json，只落插件文件
npx pi-plugins-deploy --no-extensions  # 不部署 extensions
pi-plugins --help                      # 全局安装后的命令名

源机器更新（改了插件之后）

cd ~/code/pi-plugins-deploy
npm run pack:config        # 重新采集 settings.packages + extensions（自检不过拒绝）
npm test                   # 22 断言沙箱回归
npm version patch
npm publish --access public

与 pi-cli-config-deploy 的区别

| 包 | 内容 | |---|---| | pi-plugins-deploy（本包） | 只装插件：packages + extensions，零密钥 | | pi-cli-config-deploy | 整套配置：settings/models/mcp（密钥占位）/AGENTS/prompts/skills/extensions |