PiP进阶指南:如何训练这个AI助手启动会话、跟进任务并汇报结果

原创2026-11-02 11:14:161,624 阅读

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 并自动行动。

Pi Pocket 桌面端与会话时间线,展示 Pi 修复问题并通过 48 项测试的完整记录

它的行为准则由内置系统提示词定义(见 src/server/extensions/pip.ts):先回答、后行动;没查过的事明说没查;给 agent 的任务必须自包含、可独立执行。

如何打开 PiP 面板:5 种快捷入口

PiP 平时很安静,只有在工作或"有新鲜事"时,右下角才会出现一个小标记。你有 5 种方式召唤它:

  1. 快捷键 Alt+A(最常用);
  2. 侧栏的 PiP 球体按钮;
  3. 菜单(⋯)→ PiP 图块;
  4. 启动器:Ctrl/⌘+K 后输入 "PiP";
  5. 在任意输入框输入 /pip 命令。

在宽屏上,它以带阴影的圆角小窗固定在右下角 16px 处;手机上则从底部升起一个圆角抽屉。关闭很简单:Esc、返回键或向下滑动。

💡 小技巧:输入 /pip what needs me?("什么事需要我?"),PiP 会立刻盘点所有等待你处理的事项——审批、报错、需要你决策的任务,一次说清。

PiP 面板在桌面右下角展开,展示跟进会话、推送命令与 Needs you 待办

面板源码在 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 的看家本领。一次"跟进"是持久化任务:

  1. PiP 把任务发给某个会话后,等这次运行结束(或会话空闲);
  2. 会话产出的报告自动回传给 PiP;
  3. 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 拦下、等待人批准的瞬间:

git push 命令被 Lancet Guard 拦截,等待人工点击 Allow 才执行

  • 先看清再动手:操作某个会话(发消息、停止、跟进等)前,它必须在最近 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 的价值随你的委托习惯而增长。建议从今天起,把任何"帮我盯着,好了告诉我"的需求都交给它试试。

登录后查看全文
pi-pocket