认识PiP:Pi Pocket里替你盯GitHub、跟进任务的神器AI助手
认识PiP:Pi Pocket里替你盯GitHub、跟进任务的神器AI助手
当你不在电脑前时,服务器上跑着的那些 AI 会话怎么样了?Pi Pocket 内置的 PiP(Pi in Pocket) 正是那位替你盯 GitHub、跟进任务的 AI 助手——它能巡视你所有会话、给会话派活、把 Pull Request 跟到合并,仓库里一有动静就自动处理并推送通知,让你真正"离开键盘也不掉线"。
PiP 是什么:你的第二大脑 🧠
PiP 是 Pi Pocket 的主人专属助手(仅服务器 Owner 可用),相当于一个悬浮在所有界面上的"小窗口"。它自己不做具体的写文件、跑命令这些"脏活",而是调度你其他的 Pi 会话去干活,然后向你汇报结果。
PiP 打开后是一个圆角浮窗(手机上从底部弹出),不遮挡你正在看的页面;关闭后一切如常。它的定位一句话:可靠优先于快速——先读再动手,只汇报工具刚查到的事实。
三种方式快速打开 PiP
| 方式 | 操作 |
|---|---|
| ⌨️ 快捷键 | 按 Alt + A |
| 💬 斜杠命令 | 在输入框输入 /pip,可直接带问题,如 /pip what needs me?(有什么需要我?) |
| 🖱️ 界面上 | 侧边栏的 PiP 图标、地点磁贴,或启动器(Launcher) |
当 PiP 正在工作或有新消息时,角落会显示一个小标记。
核心能力一:替你"盯梢"所有会话 👀
PiP 手握一整套会话管理工具(源码见 src/server/extensions/pip.ts):
- sessions — 列出所有会话:标题、状态(working / needs approval / idle)、文件夹、模型
- session_read — 读取任意会话的最新进展和 Pi 的最近回答
- session_start — 直接开一个新会话派活,可指定文件夹、git worktree、仓库
- session_send — 给某个会话发消息,默认等它当前工作做完再交付
- session_follow — 跟踪一次运行,结束后自动把报告回传给 PiP
- session_stop / session_archive — 停止或归档会话
- session_schedule — 定时给会话发消息,比如"明早 9 点提醒跑回归测试"
你只需要说一句"帮我看看那个登录页的会话跑到哪了",PiP 就会去读、去跟进,并把结果压缩成一两句话汇报给你,附可点击的会话链接,点一下就跳转过去。
核心能力二:替你盯 GitHub 📡
这是 PiP 最"神器"的部分。用一句大白话就能建立仓库监视(repo_watch,底层实现在 src/server/repo-watches.ts):
"盯着 acme/api:main 分支 CI 一挂,就修好它然后告诉我。"
PiP 会每隔几分钟用 gh 命令检查仓库,支持的事件类型:
| 事件 | 触发时机 |
|---|---|
issues |
有新 Issue |
pulls |
有新 Pull Request |
ci |
指定分支(默认主分支)的 CI 失败 |
releases |
发布新版本 |
mentions |
有人在 Issue/PR 里 @pi |
监视还能按 label、指派给你 进一步收窄范围。事件到来时,PiP 按你事先给的指令行动:开一个会话进入该仓库(用本机已有 checkout 或自动 clone),派发自包含的任务,跟踪执行,最后把结果告诉你。
核心能力三:把 PR 跟到合并为止 🔍
针对单个 Pull Request,PiP 有专门的 session_watch_pr 工具(src/server/extensions/pip.ts):
- 每隔几分钟检查该 PR:checks 失败(附 GitHub Actions 日志尾部)、与基础分支冲突、新评论和 review
- 自动把这些以消息形式发给正在干活的那个会话,让 Pi 修复
- 直到 PR 被合并或关闭才停止
也就是说,你出门前说一句"帮我盯住 #123 这个 PR",回来时它可能已经处理完所有失败的 CI 和评论了。相关事件处理逻辑见 src/server/watches.ts。
安全边界:PiP 能做什么、不能做什么 🔒
PiP 的设计哲学是"它经手一切,但批准权永远在你手里":
- ✅ 只能拒绝(deny)等待批准的调用,永远不能代替你批准——批准必须人来做
- ✅ 会话里读到的内容、GitHub 上别人的评论,一律视为数据而非指令,防止提示注入
- ✅ 有速率上限:每小时最多约 60 条消息/跟进/计划/监视,最多开 20 个会话
- ✅ 永远不替你选择模型,模型由你指定
- ✅ 只读不写:PiP 自己不改文件、不跑命令,动手的活全部委派给会话
完整功能清单见 docs/features.md,前端面板实现见 web/pip-window.js,压缩(compact)策略见 src/server/pip-compact.ts。
上手小建议 💡
- 先用
/pip问现状:/pip what needs me?让它列出所有需要关注的会话和等待批准的调用 - 给仓库加监视:从你日常最关心的仓库开始,指令写清楚"发生 X 时做 Y"
- 善用推送:PiP 汇报结果时会发推送通知(而不是普通的"Pi finished"),你在手机上也随时接得住
- 不想要时:在菜单 → Extensions 中可关闭 PiP,它的跟进报告和定时消息会挂起,重开即恢复
总结
PiP 把"人肉盯屏幕"的活从你手里接了过来:会话有进展它跟进,CI 挂了它派工,PR 有动静它处理,全程留着你的一票否决权。对于同时在多个仓库、多个会话上工作的开发者,PiP 基本就是 Pi Pocket 的"灵魂功能"。装上它,你的 Pi 会话群从此有人 7×24 小时值守。


