SuperAPI AI 工具集

topology-mutation-and-seat-management

通用与其它

查看项目

更新于 10-16 01:33

技能介绍

用途:在 rig 存活期间平滑地变更拓扑,添加或回收容量、收养已有会话、挂接终端,避免为改动重建整个拓扑。

主要能力:seat 管理涉及稳定标识、边、角色和启动上下文。命令包括 rig grow <rig-id> <member...>(简单添加席位,支持 --pod、--new-pod、--runtime、--cwd、--json)、rig expand <rig-id> <pod-fragment-path>、rig add <rig> <pod-namespace> <member-fragment-path>、rig shrink、rig remove、rig launch、rig discover [--draft]、rig bind <discoveredId> --rig <rigId>、rig adopt <path> --bind <logicalId=tmuxSessionOrDiscoveryId>、rig attach --self --rig <rigId> --node <logicalId>,还有 rig unclaim 与 rig release。需要显式模型、权限策略、不同 agent spec、按席位运行目录或启动文件时,改用片段方式。

使用方式:改动后需核对拓扑投影,如用 rig ps --nodes 反映当前真实状态,而非变更前缓存;验证新席位的队列、启动上下文与角色,确认 rig whoami 能解析,清理陈旧引用与边、权限。

适用场景:给运行中的 rig 加席位、缩容、重启节点、把发现到的会话绑定进已有逻辑节点、收养拓扑并绑定活动会话、将 shell 或 agent 挂入节点。

限制与失败模式:新席位可能缺少队列、启动上下文或角色文件;增删席位时边与权限可能未更新;adopt/bind 可能在 tmux 层成功但 OpenRig 身份层未记录;shrink/remove 可能留下陈旧引用。验证应覆盖活动 rig,而非仅干净测试夹具;运行时超时属不确定状态,需先核对持久与进程影响,不要盲目重试。新建 rig 请用 rig up;专门扩缩容或替换稳定席位上的占用者,分别参见 seat-scaling-and-specialization 与 seat-continuity-and-handover。跨主机拓扑变更暂缓。详情以资料为限,其余暂未提供。