Skip to content

v0.11.7

Choose a tag to compare

@github-actions github-actions released this 21 Nov 02:06
· 24 commits to main since this release
dd93e27

Agent Bridge 菜单栏 app + bridge CLI,已打包成一个 DMG。

  • 版本:0.11.7
  • 要求:macOS 13 或更新(universal:Apple Silicon 与 Intel)
  • SHA-256:073d38c51e6dccbf99ed1f3e0d70e45a36aa4b68b561b3ba94724fd059621303

本版改动

Fixed

  • 文件枚举收口成一道闸门(fs-scope.ts):枚举/realpath/stat 只能落在已经授权过的根里(托管白名单、工程目录、状态目录),以及 CLI 自己的主目录数据目录(~/.pi、~/.claude、~/Library/Application Support)。~/桌面、~/文档、~/下载、~/音乐、~/照片、iCloud/~/Library/CloudStorage、/Volumes/* 一律在碰文件系统之前拒绝并记一行 fs-scope: 拒绝越界访问(同一路径每分钟最多一条)。判定只用字符串与 lstat/readlink(读链接本身、不进目标),所以 /tmp/link -> ~/下载 这类符号链接绕不过去,也不会因为判定本身触发授权弹窗。
  • 文件浏览(fs.read / fs.list)与 hosted.create 改成先按字符串判越界再 realpath:以前只要客户端把路径指到受保护目录,就会真的去 realpath,弹一次 macOS「文件与文件夹」授权;弹窗不点掉,那个系统调用一直挂着,整个 Bridge 就跟着停住。
  • 停掉托管会话后子代理还在跑:pi-subagents 的后台 async runner 是 detached 起的(自成一个进程组),kill(-pgid) 收不到;主进程一死它还会 re-parent 到 pid 1,ppid 线索也断了。现在会话运行期间把后代 pid 登记下来,停止时先 SIGSTOP 冻住整棵树再逐个收(SIGTERM → 2 秒 → SIGKILL),收完核对;收不掉的 pid 通过 hosted.stop 新增的 leftover 报出来,不再默默返回成功。会话进程自己退出(正常收尾、崩溃、换模型或换参数重启)也走同一套清扫。
  • 「执行过程」折叠块改成固定排在回合末尾:以前它插在第一个工具调用处,长回合(尤其派了子代理的)会被后面的正文顶到卡片上部 —— 停在最新输出上既看不出回合还在跑,也得先往上滚才能展开。现在折叠标题就在输出下方,进行中 / 已中断 / 已完成 状态灯挂在标题上,展开也是原地展开。
  • 托管记录的工作目录在列会话、发消息、自动续跑、hosted.create 之前都先过闸门再 stat:白名单改掉之后,旧记录可能指着 ~/下载、~/音乐,以前每次刷新会话列表就是一次授权弹窗,Bridge 重启还会按这个目录自动拉进程。白名单目录本身按「~ 展开值 + realpath 值」两种写法登记,符号链接的白名单目录不会被误判成「工作目录已不存在」。
  • 各 CLI 适配器发消息时不再把「工作目录不存在」退回主目录或 process.cwd()(dsh、Antigravity、pi、claude-code-cli、codex-cli):那等于让子 CLI 把整个 ~ 或 Bridge 自己的目录当工程根去扫,而 ~/下载、~/音乐 正好在授权门禁后面。现在直接报错。会话 cwd 来自转录,stat 之前也过同一道闸门(含 Claude Code 读 .git/HEAD 推分支名)。

Added

  • 托管目录加进来时就当场申请 macOS 的文件访问授权:白名单目录会在添加那一刻用子进程真读一次(readdir),把「文件与文件夹」授权弹窗提前到人在 Mac 前的时候,结果记在 hosted/dir-auth.json,菜单栏设置里显示「等待授权…」/「未授权」。以前加目录只做 realpath/stat,这两种调用不触发授权,于是「目录加好了」和「真能用」之间隔着一层系统弹窗:人不在机器前时那次弹窗没人点,读目录的调用就挂在那里,整个会话卡住。探测走子进程,弹窗没人点也不占 Bridge 主线程,20 秒超时算「等待授权」,不会被当成可用;探测严格排队,一次只放一个弹窗出去(加目录本来就是一个一个加的动作,不会同时糊五个框)。

  • 白名单目录读不了时(EPERM/EACCES)文件浏览明确报「macOS 没有授予这个目录的访问权限」,不再混成「路径不存在」或内部错误。

  • 目录授权状态的四个漏子:菜单栏读的 /hosted 管理接口原来把 auth 丢掉了(等待授权…/未授权 和「重新添加一次」的救济路径全是死代码);探测子进程被外部杀掉时队列会永久停摆;「移除后立刻加回」会让同一路径弹两次框;ok 一旦落盘就永不失效(系统撤销授权后仍显示正常)。现在 auth 一路透传到菜单栏、队列按登记号收尾不会错杀新的探测、启动 30 秒后复核一遍已授权目录(撤销了就降级成 denied),并且只有显式 probe 才重探已存在的目录(删一个目录不会再让其它未授权目录挨个弹框)。

  • 探测子进程接进退出流程:SIGTERM 时一并收掉,不再留下等授权弹窗的 node -e。

  • 安全审计(cso)发现的回归:管理接口 probe 里的路径原来会被直接 realpath,等于给客户端开了「让 Bridge 碰任意路径」的口子(违反 #216 定的「先按字符串判越界、越界一次 fs 调用都不做」),而且数组没有上限(5000 条同步 realpath 阻塞主线程 135 毫秒)。现在 probe 只做字符串比对、最多取前 64 条,越界路径连一次 realpath 都不会发生。探测子进程同时改成 env: {} + cwd: "/":不继承 Bridge 的环境变量(可能含 token),也不继承它的 cwd。

  • 托管会话的「疑似卡住」状态:一轮忙超过 2 分钟没有任何输出,会话摘要带 stalledSince,Bridge 日志写一行原因,网页侧栏显示 疑似卡住 徽标;子进程一有输出就自动清掉。「忙」的判定与侧栏一致(含 pi 后台子代理),等网页回答权限的轮次不算卡住。只做检测与提示,绝不替用户点掉系统弹窗。

安装

打开 DMG,把 AgentBridge.app 拖进「应用程序」。首次启动后在菜单栏点菱形图标,
选择「初始化 Bridge…」填入中继地址即可配对。

Gatekeeper

这是未签名构建,首次打开会被系统拦下:

  • macOS 15 及以后:关掉拦截弹窗,打开「系统设置 → 隐私与安全性」,在底部点「仍要打开」。(右键 → 打开这条捷径从 15 起被系统去掉了。)
  • macOS 14 及更早:在「应用程序」里右键 AgentBridge → 打开 → 再点「打开」。

也可以在终端里执行:

xattr -dr com.apple.quarantine /Applications/AgentBridge.app