@zaofan/dsh-qqbot 1.10.1 → 1.10.2

package/docs/USER-GUIDE.md

@@ -152,6 +152,22 @@ npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 - **配套工具**：`session_create`（建会话）、`session_send`（往会话投递）、`session_watch`（看/改档/取消盯梢）、
   `sessions_list`（列工作区）、`session_children`（看会话血缘）。
 
+**引用回流 · 在群里「引用」它的输出，就能接着跟它聊**
+
+「回灌」是**子会话 → 父会话**的单向通报；**引用回流**是**反方向** —— 你在群里**引用子会话发的那条输出**，
+这条引用会被**路由回那个子会话**，让它接着答。
+
+- **怎么用**：子会话跑完一轮后，群里会出现一条**行首带 `【子会话 xxxx】` 的转发消息**；
+  你**引用那条消息**（QQ 的引用功能）再说一句，这句话就送进了那个子会话。
+- **它收到什么**：`【群里有人引用了你发到 QQ 的那段输出】` + 你的原话 + `（这是群里的引用互动，按需回应即可。）`
+- **忙 / 闲两种处理**：子会话**正在跑** → 当**插话**送进去（不另起一轮）；**空闲** → **唤醒**它来处理这条引用。
+- **认路方式**：只看引用文本里**行首的归属短 id**（`【子会话 fc871e99】` 里的 `fc871e99`），
+  **当场解析**成完整会话 id、**不依赖任何台账**；解析不到就**静默放弃**（绝不猜是哪个会话）。
+- **⚠️ 前提**：那个子会话**必须是活着的**（宿主里有它的 agent）。没活着就**静默跳过** ——
+  所以宿主重启后，**先让它动一下**（`session_send` 投一句、或它在被盯梢期间再跑一轮）才会恢复响应。
+- **怎么看有没有生效**：`session_watch action=list` 里每条盯梢末尾的 **`最近被引用=月-日 时:分`**，
+  就是最近一次引用回流的落点时间；从没被引用过则不显示。
+
 ### 🔨 锤子面板: 禁言 / 踢人 (v1.6.2+，2026-10-04 补充)
 
 dock 里的「🔨 锤子」（原「🔇 禁言」）下面分两页：**🔇 禁言**（走官方接口，机器人为管理员即可，无需任何登录）和 **👢 踢人**（**官方至今未开放踢人接口**，改走**你自己的 QQ 号** + 群官网 `qun.qq.com`）。