如何迁移 pi-extensions 弃用包：deprecated 扩展升级指南

【免费下载链接】pi-extensionsA monorepo of Pi Coding Agent extensions项目地址https://gitcode.com/gh_mirrors/pi/pi-extensions点击查看免费下载如果你在使用 Pi Coding Agent 扩展仓库 pi-extensions会发现部分扩展已被移入 deprecated/ 目录并停止维护。这篇 pi-extensions 弃用包迁移指南会带你快速搞清楚哪些扩展该替换、换成什么、怎么安全切换以及 7 个无替代方案的弃用包如何直接卸载避免踩新旧扩展同时加载的坑。deprecated 目录是什么在 pi-extensions 这个 monorepo 中deprecated/下的包仅作为源码参考保留已被排除在活跃工作区的检查、测试、发布和维护之外详见 README.md 末尾的 Deprecated packages 小节。简单说装了这些包不会报错但你得不到任何功能更新和安全修复。每个包的 README 顶部都有WARNING警告块说明替代方案和卸载命令。弃用包迁移速查表这是本次升级最常用的一页速查表先判断你的扩展属于哪一类弃用扩展替代方案操作pi-workflowpi-plan-modepi-goal卸载后安装两个聚焦包需迁移配置文件pi-codex-accountspi-accounts卸载后安装pi-accounts可自动导入旧凭据pi-chrome-devtoolsChrome DevTools MCP改用 Pi 原生 MCP 接入pi-firecrawlFirecrawl MCP改用 Pi 原生 MCP 接入pi-retryPi 内置retry设置直接卸载即可pi-google-genaigrounding-with-google-genai技能先配置好技能再卸载pi-cbmem/pi-image-drop/pi-webui/pi-jupyter/pi-sidebar/pi-telegraph/pi-wait-what无替代直接卸载所有卸载命令格式统一pi uninstall npm:narumitw/包名如果是项目级安装加上--local参数。pi-workflow 迁移拆分为 pi-plan-mode 和 pi-goalpi-workflow是弃用包中功能最重的一个它把 Plan规划和 Goal自主执行合并成了单一包现在拆成了两个独立维护的包pi-plan-mode 和 pi-goal。行为映射哪些功能有替代哪些没有原有用途替代方式只做规划不执行安装pi-plan-mode继续用/plan只做 Goal 执行安装pi-goal继续用/goal同一个 Pi 会话中同时用 Plan 和 Goal两个新版包可共存匿名工作流互斥锁防止同时激活/workflow统一管理器无替代改用独立的/plan和/goal原子/自动 Plan-to-Goal 交接、回滚无替代实验性有序 Goal 队列无替代把剩余工作合并进一个显式 Goal六步安全切换流程完整步骤见 deprecated/pi-workflow/README.md 的 Safe switch-over 小节先完成或停止正在进行的合并式工作导出需要保留的 Plan对不再需要恢复的 Goal 状态执行/goal clear退出 Pi避免旧命令处理器、定时器残留在内存中卸载合并包pi uninstall npm:narumitw/pi-workflow按需安装pi install npm:narumitw/pi-plan-mode和pi install npm:narumitw/pi-goal启动新会话确认/plan和/goal都显示预期的未激活状态。⚠️ 千万不要把pi-workflow归档包与pi-plan-mode或pi-goal同时加载——它们故意复用相同的命令、工具和事件通道名同时加载会产生重复处理器和竞争的状态归属。配置文件如何拆分旧版使用单一文件~/.pi/agent/pi-workflow.json新版分别读取同目录下的pi-plan-mode.json和pi-goal.json。迁移规则是按嵌套对象拷贝不要整体复制只把plan对象拷贝到pi-plan-mode.json的顶层只把goal对象中受支持的字段拷贝到pi-goal.json的顶层顶层的workflow对象planHandoff字段和goal.experimental.goals有序队列不要拷贝因为它们在新版中没有对应物在新文件被接受前保留旧文件备份。新版包也提供了替代方案若确实需要Plan 交给 Goal 执行的持久交接可以手动执行/plan export PLAN.md导出计划文件再/goal implement and verify the approved plan in PLAN.md启动 Goal——这是刻意设计的手动流程不提供原子激活或回滚。浏览器与爬虫扩展迁移改用 Pi 原生 MCPpi-chrome-devtools浏览器自动化和pi-firecrawl网页抓取/搜索的迁移思路一致卸载扩展改用 Pi 原生 MCP 支持接入上游官方 MCP 服务器。详细步骤分别在 deprecated/pi-chrome-devtools/README.md 和 deprecated/pi-firecrawl/README.md 的 Migration to native MCP 小节。通用流程完成进行中的操作并退出 Pi让扩展释放托管的浏览器和临时配置执行pi uninstall卸载扩展项目级安装加--local把官方 MCP 服务器条目合并进用户级~/.pi/agent/mcp.json保留已有服务器配置运行pi mcp list验证连接新开会话后用/mcp查看状态。两个值得注意的差异工具名变了MCP 工具会加命名空间前缀例如firecrawl_scrape变为mcp__firecrawl__firecrawl_scrape之前保存的工具白名单、Plan mode 选择需要同步更新旧配置文件不会被自动转换pi-chrome-devtools.json、pi-firecrawl.json等文件保留原样作为备份没有任何自动迁移或删除新设置需要在 MCP 服务器配置中显式重建。pi-codex-accounts 迁移到 pi-accounts账号切换场景最简单旧版只管 Codex 订阅账号新版 pi-accounts 覆盖所有内置/login提供商OpenAI、Anthropic、GitHub Copilot、Kimi、OpenRouter、Radius、xAI 等。pi uninstall npm:narumitw/pi-codex-accounts pi install npm:narumitw/pi-accountspi-accounts会自动导入旧版pi-codex-accounts.json中的数据同时保留源文件以便回滚。同样注意两个包不要同时加载因为它们可能同时刷新同一份轮换的 Codex 凭据。无替代方案的弃用包直接卸载以下 7 个扩展弃用时没有提供替代品处理方式是卸载后按自身工作流调整扩展原因与替代思路pi-cbmem基准测试表明收益不足以抵消开销且 token 用量显著增加见 deprecated/pi-cbmem/README.mdpi-image-drop无替代图片暂存页面功能移除见 deprecated/pi-image-drop/README.mdpi-webui无替代见 deprecated/pi-webui/README.mdpi-jupyter无替代见 deprecated/pi-jupyter/README.mdpi-sidebar见 deprecated/pi-sidebar/README.mdpi-telegraph发布类功能移除见 deprecated/pi-telegraph/README.mdpi-wait-what手动暂停 侧边提问可实现同类工作流可改用 pi-btw 的/btw另有pi-retry当前 Pi 版本已内置 provider 重试、Codex WebSocket 续期和可配置的空闲超时retry与httpIdleTimeoutMs设置直接卸载即可。卸载后其 90 秒停滞看门狗也一并移除见 deprecated/pi-retry/README.md。pi-google-genai的替代是grounding-with-google-genaiagent 技能注意顺序该技能依赖环境中的GEMINI_API_KEY或可发现的.env文件不读取旧的pi-google-genai.json所以要先配置好技能再卸载扩展见 deprecated/pi-google-genai/README.md。迁移避坑清单 改完扩展后重启 Pi 或执行/reload手动改的配置文件才会生效 不要同时加载归档包与其替代包pi-workflow Plan/Goal、pi-codex-accountspi-accounts都是同类冲突 旧设置文件一律先留作备份没有自动转换机制✅ 迁移后验证MCP 方案跑pi mcp listPlan/Goal 方案确认/plan与/goal初始状态正常 归档包源码仍在deprecated/下需要理解历史行为时可以本地构建检查npm run build后再pi -e .但不要在新会话中安装。按上面的速查表对号入座多数用户一次pi uninstallpi install就能完成升级只有pi-workflow用户需要额外处理配置文件拆分。迁移完成前建议保留一份~/.pi/agent/目录备份出问题时随时可以回滚。赞分享【免费下载链接】pi-extensionsA monorepo of Pi Coding Agent extensions项目地址https://gitcode.com/gh_mirrors/pi/pi-extensions点击查看免费下载相关推荐Commander.js 废弃功能完全指南已弃用Deprecated与已移除RemovedAPI 迁移手册Commander.js 废弃功能完全指南已弃用Deprecated与已移除RemovedAPI 迁移手册 Commander.js 是 Node.jCLIpi-extensions 开发者指南如何编写并发布你的第一个 Pi 扩展pi extensions 开发者指南如何编写并发布你的第一个 Pi 扩展 pi extensions 是一个面向 Pi Coding Agent 的开源 mUnoCSS弃用包历史包迁移指南UnoCSS弃用包历史包迁移指南 前言为什么需要迁移 随着UnoCSS的快速发展为了提供更好的开发体验和更优化的性能一些早期的预设包已经被重新设计和重前端构建工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考