会话与话题模型#

理解 botmux 的关键是搞清"一条消息落到哪个会话"。

三种群形态#

形态	行为
话题群（THREAD）	每个新话题 = 一个独立 CLI 会话。同一话题内的消息进同一会话，不同话题互相隔离。最推荐。
普通群（DEFAULT）	默认不自动开话题；用 /t <prompt> 主动开新话题（弹仓库选择卡片）。
私聊	直接和机器人开聊，相当于一个长期会话。

Oncall 群 & chat-scope 群#

• Oncall 群：/oncall bind <path> 把整个群锚定到一个项目目录，跳过仓库选择，群内任何成员 @ 即问即答。见 Oncall 模式。
• chat-scope 群：/group <群名> 一键新建一个群，整个群作为一个独立会话。

会话状态机#

流式卡片顶部的状态指示：

• 🟡 启动中 — worker 正在拉起 CLI 进程
• 🔵 工作中 — CLI 正在思考/执行，输出实时刷新
• 🟢 就绪 — CLI 空闲，等你的下一条消息

每次回复创建新的流式卡片，上一轮卡片冻结在最后状态，便于回看历史。

权限模型（三层）#

层级	能力	由谁控制
对话权（canTalk）	提问、查日志、读代码	allowedChatGroups（群内全员）/ globalGrants（全局名单）/ /grant
操作权（canOperate）	切目录 /cd、/restart、/close、点卡片按钮	allowedUsers（owner 名单）
owner 专属	/grant /revoke 授权他人	owner

这套分层让你能放心把机器人拉进值班群：所有人能问，但只有 owner 能改会话状态，外部成员误点也不会把会话搞乱。