PiP进阶指南:如何训练这个AI助手启动会话、跟进任务并汇报结果
PiP进阶指南:如何训练这个AI助手启动会话、跟进任务并汇报结果
Pi Pocket 是一款自托管、移动优先的 Pi 编码智能体 Web 应用,其内置的 PiP(Pi in Pocket,口袋里的 Pi)是专属你的 AI 助手:它悬浮在所有屏幕之上,可以替你启动新会话、跟进正在运行的任务、盯守 GitHub 仓库,并在一切结束时主动汇报结果。本文带你快速掌握 PiP 面板的 5 种打开方式,以及用一句自然语言"训练"它干活、汇报、看仓库的完整方法。
什么是 PiP:替你管理所有会话的 AI 助手
PiP 是 Pi Pocket 中只有所有者能使用的助手,它是自己独立的一段对话,不出现在会话列表里,谁也无法打开或写入。它不直接改文件、不执行命令,而是像一个调度员:
- 列出并阅读你的所有会话,随时掌握进展;
- 启动新会话(指定文件夹、worktree、模型)、给会话发消息、停止或归档会话;
- 跟进任务(follow):盯住一次运行直到结束,然后向你汇报结果;
- 定时消息与仓库监控:按计划提醒,或盯守 GitHub 上的 issue、CI、PR 并自动行动。
它的行为准则由内置系统提示词定义(见 src/server/extensions/pip.ts):先回答、后行动;没查过的事明说没查;给 agent 的任务必须自包含、可独立执行。
如何打开 PiP 面板:5 种快捷入口
PiP 平时很安静,只有在工作或"有新鲜事"时,右下角才会出现一个小标记。你有 5 种方式召唤它:
- 快捷键 Alt+A(最常用);
- 侧栏的 PiP 球体按钮;
- 菜单(⋯)→ PiP 图块;
- 启动器:
Ctrl/⌘+K后输入 "PiP"; - 在任意输入框输入
/pip命令。
在宽屏上,它以带阴影的圆角小窗固定在右下角 16px 处;手机上则从底部升起一个圆角抽屉。关闭很简单:Esc、返回键或向下滑动。
💡 小技巧:输入 /pip what needs me?("什么事需要我?"),PiP 会立刻盘点所有等待你处理的事项——审批、报错、需要你决策的任务,一次说清。
面板源码在 web/pip.js,它叠加在任何打开的页面上方,背后的会话保持原状。
如何让 PiP 替你启动一个新会话
这是 PiP 最"进阶"的用法:你不需要说出"启动会话",只要把事说清楚,请求本身就等于授权。比如直接对它说:
"在 shop-web 里建一个 worktree 会话,为 Safari 重定向问题加一个回归测试,完成后告诉我。"
PiP 会调用 session_start 工具(定义于 src/server/extensions/pip.ts),在指定文件夹或 git worktree 中开一个新会话,把任务以自包含的简报发给那个会话的 Pi,并开始跟进。
训练 PiP 时记住几个要点:
- 任务要具体:写清目标、路径、验收标准。PiP 转发给会话的 Pi 时,"看到的就是这些",不会看到你们之间的对话;
- 模型由你说了算:PiP 永远不会替你挑模型。你想用哪个,就在话里写明全称(如 "用 o3 on openai"),或者在会话里自己选;
- 限额保底:每小时最多启动 20 个会话,防止它"加班过度"。
如何配置任务跟进:让 PiP 盯到跑完再汇报
session_follow 工具(src/server/pip.ts 描述的 durable follow)是 PiP 的看家本领。一次"跟进"是持久化任务:
- PiP 把任务发给某个会话后,等这次运行结束(或会话空闲);
- 会话产出的报告自动回传给 PiP;
- PiP 用一两句话向你总结:做了什么、是否验证通过、还需不需要你。
关键优势:
- 重启不丢:follow 任务随 Pi Durable 持久化,服务器中途重启,跟进照样生效;
- 推送通知:你没在看 PiP 时,汇报会作为推送弹出,点开通知直接打开 PiP 面板;
- 限额:每小时最多 60 次跟进/定时/监控操作,含它给自己的提醒。
如何接收 PiP 的汇报结果
PiP 的汇报风格被系统提示词严格约束:答案先行,不写标题,不写废话,一两句或一个短列表。
- 它提到的每个会话都是可点击的链接,点一下就打开;
- 汇报显示为可展开的圆角卡片,步骤完成后带绿色对勾;
- 点 Open as a conversation(作为对话打开)可以看它每一步的完整过程;Start fresh 给它一个全新上下文,避免被旧话题带偏;
- 面板顶部的上下文条实时显示占用量,快满时对它输入
/compact即可压缩旧消息; - 它的花费独立计入你的 Spend 报表(菜单 → Spend)。
进阶训练:让 PiP 看守 GitHub 仓库与 PR
这是 PiP 从"助手"升级为"值班员"的一步。用大白话下达监控指令,例如:
"watch acme/api:当 main 分支 CI 失败时,修好它并告诉我。"
PiP 会调用 repo_watch 工具(src/server/pip.ts 中的 watch 逻辑),每几分钟用服务器上已登录的 gh 检查仓库:新 issue、新 PR、CI 失败、发版、有人在评论里 @pi——事件到达后,它会带着你当初的指令开始行动:开会话、发任务、跟进、汇报。
针对单个 PR,它还能调用 session_watch_pr 盯到合并为止:检查失败会附上 Actions 日志尾部,冲突会提示,新评审会转达。Webhook 也可指向 PiP,详见 docs/features.md 的 "Watch a repository" 与 "Webhooks" 章节。
PiP 的安全边界:为什么可以放手让它干
PiP 的设计哲学是"可靠优先于快速",边界清晰:
- 只读、不执行:它读文件、读会话,但从不修改文件、不跑命令——所有动手的活都委派给会话,由 Lancet Guard 等机制照管。下图正是推送命令被 Guard 拦下、等待人批准的瞬间:
- 先看清再动手:操作某个会话(发消息、停止、跟进等)前,它必须在最近 15 分钟内查看过该会话;
- 审批只可否、不可批:它可以拒绝一个等待批准的调用,但永远不能批准——放行权永远在人手里;
- 防提示注入:会话、访客、GitHub 里出现的文字(标题、报错、PR 名)一律作为"数据"引用,不作为指令执行,只有你的话算数;
- 随时可关:菜单 → Extensions → 关闭 PiP 后,它立即停手,跟进报告和定时消息会排队等它回来。
常用命令与设置速查
| 操作 | 方式 |
|---|---|
| 打开 PiP 面板 | Alt+A / 侧栏球体 / /pip |
| 盘点待办 | /pip what needs me? |
| 压缩上下文 | 对 PiP 输入 /compact |
| 自选压缩阈值 | Extensions → PiP(40k / 60k / 100k,配置项 pipCompactAt) |
| 单独更换 PiP 的模型 | 点击面板顶部的模型徽章 |
| 关闭 PiP | 菜单 → Extensions → PiP |
| 查看 PiP 花费 | 菜单 → Spend |
更多细节可参阅完整功能清单 docs/features.md、代码地图 docs/map.md,以及 PiP 服务端核心实现 src/server/pip.ts。
从"一句话开任务"到"仓库出事自动修",PiP 的价值随你的委托习惯而增长。建议从今天起,把任何"帮我盯着,好了告诉我"的需求都交给它试试。


