正文预览
MODULE 04 · STEP 11 · 可练习
Extension 的需求与验收
本课结果
你会显式加载一个只注册
/bluebook-check命令的教学 Extension，亲眼确认它出现、执行并在停用后消失。桌面通知放在本课最后作为进阶设计，不把终端内提示冒充系统通知。
我对 Extension 的理解来自一个很小的烦恼。Pi 跑长任务时，我会切到别的窗口，任务已经停下来却没有立即发现。
这个需求适合做第一个 Extension，因为它有清楚的触发条件、简单的系统动作，而且容易验收。
先把需求说清楚
不要一开始就写“实现完美的系统通知”。先给第一版定四条边界：
- 只在 Agent 结束工作、等待新消息时考虑提醒。
- 终端正在前台时不打扰。
- 提醒内容不包含私密任务全文。
- 提醒失败不得破坏 Pi 本身的会话。
这时你已经可以看到 Extension 的轮廓：它要接收 Pi 的事件，判断状态，再执行一个系统动作。
理解文件放在哪里
Pi 可以加载用户级或项目级的 Extension。初学时建议从独立练习项目开始，只让这个项目使用它。这样容易看清来源，出错时也容易停用。
项目信任提示不是多余的障碍。项目级 Extension 会运行代码，它能做什么取决于当前用户的权限。只有当你知道文件从哪里来、大致做什么，才应信任该项目。
官方当前的自动发现位置是用户级 ~/.pi/agent/extensions/ 和项目