SuperAPI AI 工具集

mesh

智能体与模型

查看项目

更新于 10-26 18:53

技能介绍

用途 该技能用于在多个 bro rig 之间进行联邦式工作协作。每个 rig 用 mesh://<org>/<repo> 标识,可由 origin 推导或在 mesh.rig 中固定。工作以 mesh/1 信封跨 rig 传递,即带有 mesh: 标签集合的普通 beads 记录,且只写入发送方自己的 beads 存储。不存在写入外部存储的路径——对等方将彼此的 refs/dolt/data 拉取到只读副本,主权是结构性的而非策略性的。所有机制位于 bro CLI 中,该技能仅为策略。

生命周期 请求方在自己存储中创建 request;工作方拉取到 inbox 后 claim,再 done 提交结果与证据;请求方给出 accept 或 reject 的最终裁决。两种裁决均为终态——被拒绝的线程即结束,不会进入重新提交队列;修订后的结果应作为新的请求线程发起。

主要命令

  • bro mesh me:显示本 rig 的 URI,优先使用 mesh.rig 固定值,否则由 origin 推导(无法解析时退出码为 2)。
  • bro mesh peers add <alias> <rig> <remote>:绑定对等方,文件系统路径视为 local(通过 bd -C 访问实时存储),git URL 视为 beads-remote(dolt 副本)。
  • bro mesh peers list / remove:查看或删除绑定。
  • bro mesh pull:刷新所有 beads-remote 副本。
  • bro mesh inbox [--json] [--no-pull]:查看发给本 rig 的请求,含来源信息与不匹配标记。
  • bro mesh request <rig> <title> [--for BEAD]:发布请求;--for 将本地 bead 阻塞在 external:<rig>:<id> 上。
  • bro mesh claim <thread>:工作方命令,将本 rig 绑定到该线程。
  • bro mesh done <thread> [--ev K:R]…:工作方命令,提交结果与证据引用。
  • bro mesh accept|reject <thread> [--body T]:请求方对已提交结果给出裁决。
  • bro mesh wait <thread> [--json] [--no-pull]:单点检查当前阶段及轮到哪一方,不做阻塞等待。

信任模型 对等绑定即来源凭证:从别名 x 的副本读到的记录视为来自 x 所声明的 rig。信封中的 from 仅用于展示;若不匹配,inbox 会标记出来,回复通过绑定解析,而不是依据声明。读取均为只读:local 对等方通过 bd -C list 查询;beads-remote 对等方是位于 <git-common>/bro/mesh/peers/<alias> 下的 dolt clone/pull 副本,通过 dolt sql 查询。mesh 层从不把副本合并进实时存储,也从不写入对等方远程。

策略 在 inbox/wait 上使用 --no-pull 可按已同步状态读取副本,适合高频循环;普通 pull 是同步点。对等方同步失败会输出错误行而非静默显示为空,应将 ! alias: … 输出视为信号而非噪音。bro mesh wait 是单点检查;监督循环应使用 bro review act wait 的预置监视器模式,而非 shell while 自旋。

适用场景 适用于需要在多个 bro rig 之间安全地传递任务、结果与证据,同时保持各方存储主权与只读隔离的协作流程。

限制 资料中未说明该技能的具体收费、价格、支持平台或其他环境要求,暂未提供。