Repository navigation
v0.11.7
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