四源雷达:能力从哪来
pi 的工具、技能、提示词、配置不是写死在代码里的——它们从四个来源被扫描、加载、合并。Resource Loader 就是这台四源雷达。
持久优先级:package < user < project(就近覆盖) ┌────────┐ ┌─────────┐ ┌────────┐ ┌──────────┐ │ package │ │ user │ │ project│ + │ CLI │ │ 内置/npm │ │ ~/.pi │ │ ./.pi │ │ 临时注入 │ └────────┘ └─────────┘ └────────┘ └──────────┘ 同名资源:project 盖 user 盖 package --extension
四个来源
- package:随包分发的内置资源,或安装的 npm 扩展包。优先级最低。
- user:
~/.pi下的个人配置,跨项目通用。 - project:项目根目录
./.pi(含CLAUDE.md),团队共享、随仓库走。持久来源里优先级最高。 - CLI:启动时用
--extension等参数临时注入(temporary 作用域),只在本次会话生效,不写进任何配置文件。
持久来源的合并规则是「就近覆盖」:同名资源,project > user > package。于是个人习惯能盖过包默认,项目规范又能盖过个人。CLI 注入则像一张「便利贴」——这次有效,关掉就没。