pi-config

我的个人 pi 定制仓库：扩展、主题、agent 配置。

结构

extensions/    个人扩展(pi 包资源,自动加载)
vendor/        第三方扩展的本地修补版(subtree 管理)
               pi-thinking-steps: fork v1.0.11 + 修复 pi≥0.84.3 打包构建下
               补丁失效的问题(改从包公共入口获取活类)
themes/        gruvbox-dark 主题(pi 包资源)
config/        非包资源,通过 install.sh 安装到 ~/.pi/agent/
               (settings.json 为复制,其余符号链接:keybindings.json / mcp.json /
                models.json / statusline 配置 / APPEND_SYSTEM.md /
                pi-permission-system 权限配置)
tests/         扩展的验证脚本(node 直接跑)
install.sh     装机/恢复脚本

新用户安装（从零开始）

# 1. 装官方 pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# 2. 拉本仓库(位置随意——install.sh 会把实际路径写入本机 settings.json)
gh repo clone JohnFengg/pi-config ~/AI/pi-config

# 3. 一键安装:安装所有配置 + 注册本地 pi 包
cd ~/AI/pi-config && ./install.sh

# 4. 首次启动 pi 会自动安装 settings.json 里列的全部 npm 包;
#    然后 /login 配置你的模型凭证(凭证不随仓库分发)
pi

settings.json 的本地包路径

仓库模板 config/settings.json 不含本地仓库路径条目;install.sh 用 pi install 把仓库路径写入 ~/.pi/agent/settings.json(规范化为相对 agent 目录的相对路径)。 因此 clone 到任何位置都能工作,路径会随安装机自动适配。

注意:settings.json 是复制而非符号链接(它包含本机特定的包路径状态); 模板更新后需重新运行 install.sh 才会同步。

只想要扩展和主题、不要机器配置的话,也可以像普通 pi 包一样直接装:

pi install git:github.com/JohnFengg/pi-config

注意:git 方式安装的副本由 pi 包管理器托管,pi update 时会 git clean + 重置到远端 ref,不要在托管副本里改东西;日常改动走下面的本地工作流。