ZH

 


四源雷达:能力从哪来

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 注入则像一张「便利贴」——这次有效,关掉就没。