第四節 隨行通訊命令
[!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 |
列出該工作區可投遞的工作階段 |