这一篇把我的个人配置迁移指南整合进专题，目标是在新机器上快速复刻一套可用的 Pi Coding Agent 环境。

安全提醒：Pi 扩展拥有较高系统权限。只安装可信来源的扩展；不要把 API Key、登录凭据、浏览器授权状态写入公开文档或仓库。

1. 前置条件

• 已安装并能正常运行 pi
• Node.js 建议 >= 22.20.0（Pi 源码当前要求 Node >= 22.19.0）
• 已配置至少一个模型 Provider

Pi 的核心非常克制：默认工具少、内置工作流少。真正让 Pi 变强的是扩展系统。理解扩展系统后，你会发现 Pi 不是一个固定形态的产品，而是一套可以组合的 Agent 平台。

1. 五类可定制资源

Pi 的可定制能力主要分成五类：

类型	解决什么问题	典型例子
Prompt Templates	复用一段常用提示词	/review、/fix-tests、/write-doc
Skills	按需加载的专业能力说明	PDF 处理、GitNexus 使用、shadcn 组件操作
Extensions	TypeScript 扩展，改变运行时行为	权限拦截、状态栏、自定义工具、Provider
Themes	终端 UI 颜色主题	dark、light、tokyo-night
Pi Packages	把上面几类打包分发	pi-subagents、@ollama/pi-web-search、@juicesharp/rpiv-todo