第四节 随行通讯命令
[!ref] 详解见用户手册「随行通讯」节。
4.1 命令清单
| 命令 | 参数 | 作用域 | 说明 |
|---|---|---|---|
/bind |
<6 位配对码> |
单聊 / 群 | 绑定该 IM 对端到工作区 |
/ws |
<工作区名> |
单聊 / 群 | 持久切换本对端绑定的工作区（落盘，重启后仍生效）；切换后下一条消息在新工作区开启新会话；名字未命中时回执可用工作区名单。单条消息临时切换用 [ws:<工作区名>] 前缀 |
/sessions |
无 | 单聊 / 群 | 列出最近会话（含短 id） |
/new |
[文本] |
单聊 / 群 | 新建会话；可附首条消息 |
/s |
<短 id> |
单聊 / 群 | 切到指定会话（≥4 字符前缀） |
/approve |
<审批号> |
单聊 / 群 | 允许本次 |
/always |
<审批号> |
单聊 / 群 | 始终允许（写白名单） |
/deny |
<审批号> |
单聊 / 群 | 拒绝 |
/stop |
无 | 单聊 / 群 | 暂停本对端的 Agent 响应并终止在跑任务；后续消息不再转给 Agent。暂停态持久化，重启仍生效 |
/resume |
无 | 单聊 / 群 | 解除 /stop 的暂停（未暂停时也回同一句，幂等） |
/help |
无 | 单聊 / 群 | 列出所有命令 |
单条临时覆盖（前缀标签）
| 前缀 | 作用 |
|---|---|
[ws:<工作区名>] 消息正文 |
该条消息单次切换工作区，下条恢复 |
[s:<短 id>] 消息正文 |
该条消息单次切到指定会话，下条恢复 |
4.2 入站路由优先级
会话选择（按以下顺序匹配，前者命中即停）：
- 明确的
/new [文本]新建 - 明确的
/s <短id>切换（行内前缀[s:<短id>]等价） - 当前对端绑定的最近活跃会话
- 首次入站兜底：按绑定 / 工作区 + 发送人稳定生成
工作区选择：[ws:<工作区名>] 行内覆盖 > 对端绑定的工作区 > 全局默认工作区；三者皆无时回执提示先 /bind。
4.3 出站节流
| 参数 | 默认 | 说明 |
|---|---|---|
| 最小批量 | 200 字 | 累积到该长度才发出 |
| 空闲触发 | 3 秒 | 无新增字符即立即发出 |
| 最大单段 | 3800 字 | 避免触达 IM 单条上限 |
| Markdown 过滤 | 开 | 自动转纯文本，避免 IM 渲染错乱 |
| Typing 指示 | 开 | 处理中显示「输入中」 |
4.4 出站工具
下列工具可被助手主动调用，把信息推到 IM。
| 工具 | 参数 | 用途 |
|---|---|---|
channels.notify |
workspace_id, text |
广播到该工作区所有绑定 |
channels.reply |
session_id, text |
回到触发该会话的原对端 |
channels.send_to |
binding_id（或 account+peer）, text |
精确直发到指定对端 |
channels.list_bindings |
无 | 列出该工作区所有绑定 |
channels.list_sessions |
workspace_id |
列出该工作区可投递的会话 |