IndyDevDan · 51:36 · 发布 2026-02-23 · 22.8万次观看(截至抓取) · 观看原视频 🔥 观众最高回放 29:56 — 本片高回放时刻见对应章节
主旨
让 Pi 从多个 location 同时加载 commands / skills / agents——全局(global) + 项目级(local)双源,让”哪些组件从哪里读”成为声明层配置,而不是某个固定路径。
核心论点
- Pi 的组件加载是声明式的 location 列表——你的 ext / skill / command / agent 可以来自任何 path,你不绑单一固定目录。(→ 详解1)
- 同时支持全局(global)+ 项目级(local)双 scope,与 Claude Code 共用
.claude/路径的设计相比,Pi 不替你决定 “组件在哪”。(→ 详解2) - 多个 location 一次性全 load,显示来源与数量:比如”41 skills 已 load” + 项目级 commands + 5 个 agents——所有组件一目了然。(→ 详解3)
- v3 的真正差异化是把”工具集合的来源”提到用户面——你不再受制于单一目录,你可以按项目/团队/角色同时混用多源 ext。(→ 详解4)
知识点详解
1. 声明式 location 列表 11:10
作者用 ext 显示 Pi 已经从多个 location 加载了 commands / skills / agents。屏幕上,Pi 会列出每类组件的来源路径。开发者不再需要在固定目录里编辑——ext 可以从自己公司 / 团队共享的 git 仓库、用户本机配置、项目级脚本等多个地方拉。
这一设计与 v6 widget 的 hookable 共属一套:Pi 不做隐式的”固定 home”,所有 path 都 explicit。
2. 全局 vs 项目级双 scope 11:10
演示中 Pi 列出了41 个全局 skills(来自 ~/.pi/skills/ 或类似),项目级 slash commands(来自 ~/.../classic/prime)与项目级 agents(来自 ~/.../agents/)。两类组件并行加载,互不冲突。
And you can see here it’s picked these up in multiple locations. (11:10)
这与 Claude Code 的”~/.claude 单源”形成对照——Claude Code 也支持项目级 .claude/,但优先级 / 命名冲突的处理常常是默默进行的;Pi 让来源显式可见。
3. 全量加载展示 11:10
You can see here it’s picking up all of my custom global skills, 41 skills, but also in this directory, you can see we have a classic/prime command. And you can see I’ve picked up a bunch of agents as well. (11:10)
这是 v3 给工程师的最直接价值:全量能力面板,你不用去翻每个目录找有什么,Pi 直接告诉你有哪些组件被加载。这是”自动 inventory”——你不需要同步文档。
4. 与 v1 / v2 相比的差异化 11:10
v1 / v2 改的是界面与交互;v3 改的是组件来源。这也是后续章节的基础——v6 widget、v7 subagent、v9 agent team 都依赖”组件可以来自任何 location”这一基础保障。
可执行步骤
- 在自己的 Pi 配置里加一个非默认 location(比如
~/.pi/team-extensions/),把自己团队的 ext 复制进去 - 在 ext 配置文件里声明该 location,启动 Pi 看是否所有组件都被加载
- 验证两个 location 有同名 skill 时的优先级行为(后到的覆盖前到的?文件顺序?)
- 在团队 member 的 ~/.pi/skills/ 上线一个新 skill,项目里跑 Pi 看是否自动出现
关联
- 互补(同能力层但是另一边的实施):本片 09-v7-Subagent-Widget.md — subagent 也是从声明式 location 加载,与 v3 一致
- 印证(全量能力面板可以减少文件同步成本):Graph RAG 笔记 —— 给 agent 一张知识图谱等于给 agent 全量能力面板,本片 v3 是同一原则在 ext 上的实现
- 互补(同一原则):CC 高阶课·搭建 Auto-Research —— CC 也强调 ext 加载位置可配置,但 Pi 把这一切显式化
一手来源与延伸
- Pi extension 文档:https://pi.dev/ — location 声明语法
- 视频 11:10-11:53(v3 cross-agent 演示)
术语
- Location:Pi 找组件(skills/commands/agents)的具体路径,可声明多个
- Global scope:与项目无关、跨项目复用的组件位置
- Project / local scope:仅在当前项目目录生效的组件位置
金句
You can see here it’s picked these up in multiple locations. (11:10) — Pi 不绑单一来源。
立场与利益
- 利益中性:location 加载是工具性能力,无直接挂商品
价值定位
对本片目标学习者的价值:
- 适合谁:有团队 / 多项目并行工作的工程师,需要共享 ext 与项目 ext 不互干扰
- 解决什么:在 Pi 配置里声明全局 + 项目多个 location,避免每个项目都得重复安装
- 认知 vs 实操:偏实操——5 分钟配置即可上手
- 跨源重叠少:这是 Pi 特有视角,v3 把”加载面”作为配置对象,与 Claude Code 的单源设计形成对照
自检问题
- v3 演示的 location 多源加载具体加载了哪几类组件? 答案:三类——commands / skills / agents,各自来自全局 (41 skills) + 项目 (classic/prime + agents) 多个 location。回跳 11:10
- Pi 的 location 多源加载与 Claude Code 的固定路径有什么本质差异?
答案:Pi 让来源显式可见,你可以从任何 path 拉;Claude Code 默认
~/.claude/+ 项目.claude/双源,冲突处理常常默默进行。Pi 的设计是”你掌握 inventory”。回跳 11:10 - 全量能力面板在团队协作上的最大价值是什么? 答案:你不需要同步文档,Pi 启动时告诉你有哪些组件被加载,降低”组件更新但没人知道”的失同步风险。回跳 11:10