认识PiP:Pi Pocket里替你盯GitHub、跟进任务的神器AI助手

原创2026-11-01 19:14:471,423 阅读

认识PiP:Pi Pocket里替你盯GitHub、跟进任务的神器AI助手

当你不在电脑前时,服务器上跑着的那些 AI 会话怎么样了?Pi Pocket 内置的 PiP(Pi in Pocket) 正是那位替你盯 GitHub、跟进任务的 AI 助手——它能巡视你所有会话、给会话派活、把 Pull Request 跟到合并,仓库里一有动静就自动处理并推送通知,让你真正"离开键盘也不掉线"。

PiP 是什么:你的第二大脑 🧠

PiP 是 Pi Pocket 的主人专属助手(仅服务器 Owner 可用),相当于一个悬浮在所有界面上的"小窗口"。它自己不做具体的写文件、跑命令这些"脏活",而是调度你其他的 Pi 会话去干活,然后向你汇报结果。

Pi Pocket 桌面与手机端整体界面,PiP 助手管理多个会话并自动处理任务

PiP 打开后是一个圆角浮窗(手机上从底部弹出),不遮挡你正在看的页面;关闭后一切如常。它的定位一句话:可靠优先于快速——先读再动手,只汇报工具刚查到的事实。

三种方式快速打开 PiP

方式 操作
⌨️ 快捷键 按 Alt + A
💬 斜杠命令 在输入框输入 /pip,可直接带问题,如 /pip what needs me?(有什么需要我?)
🖱️ 界面上 侧边栏的 PiP 图标、地点磁贴,或启动器(Launcher)

当 PiP 正在工作或有新消息时,角落会显示一个小标记。

桌面端界面右侧的 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),派发自包含的任务,跟踪执行,最后把结果告诉你。

PiP 面板展示 GitHub 仓库监视与 PR 跟踪,自动跟进 CI 失败并派发修复任务

核心能力三:把 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。

上手小建议 💡

  1. 先用 /pip 问现状:/pip what needs me? 让它列出所有需要关注的会话和等待批准的调用
  2. 给仓库加监视:从你日常最关心的仓库开始,指令写清楚"发生 X 时做 Y"
  3. 善用推送:PiP 汇报结果时会发推送通知(而不是普通的"Pi finished"),你在手机上也随时接得住
  4. 不想要时:在菜单 → Extensions 中可关闭 PiP,它的跟进报告和定时消息会挂起,重开即恢复

总结

PiP 把"人肉盯屏幕"的活从你手里接了过来:会话有进展它跟进,CI 挂了它派工,PR 有动静它处理,全程留着你的一票否决权。对于同时在多个仓库、多个会话上工作的开发者,PiP 基本就是 Pi Pocket 的"灵魂功能"。装上它,你的 Pi 会话群从此有人 7×24 小时值守。

登录后查看全文
pi-pocket