@zaofan/dsh-qqbot 1.10.2 → 1.10.4

package/docs/USER-GUIDE.md

@@ -168,6 +168,35 @@ npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 - **怎么看有没有生效**：`session_watch action=list` 里每条盯梢末尾的 **`最近被引用=月-日 时:分`**，
   就是最近一次引用回流的落点时间；从没被引用过则不显示。
 
+**会话列表 · `/会话列表` 命令**(v1.10.3+): 三步向导选一个会话，**绑定它**并给你一行**可复制的路由模板**。
+不需要是子会话 —— 选一个**任意已有会话**（哪怕是很早以前建、早就休眠的）都能绑。
+
+- **三步**（每步一页 20 个，点字母选；可翻页 / 取消）：
+  1. **工作区** —— 显示**真实文件夹路径**（如 `D:\newwenjianjia\aiwork\鲸鱼娘`）+ 该区会话数，多的在前；
+  2. **该区会话** —— 每行 `🟢/⚪ 标题 · 短id · 创建时间`。**🟢 = 宿主里正在跑，⚪ = 已休眠**（都能绑，休眠的会被唤醒）。
+     ⚠️ **只有正在跑的会话才拿得到标题** —— 宿主**没给已结束会话存标题**，那些只能靠短 id + 时间认；
+  3. **回灌档位** —— `一档 / 二档 / 三档`，含义同 `/子会话`。
+- **选完吐出模板**：
+  ```
+  [s:xxxxxxxx] 在这里写你要发给这个会话的内容
+  ```
+  **复制这行、改掉后半句**，直接发到群里，这句话就被投进那个会话 ——
+  于是你也能**先引用一张图 / 一段别的内容，再补上这行标记**，把图片一起路由过去。
+- **别名**：`/sessionlist`、`/sessions`。
+- **怎么取数的**：直接问宿主服务（`sessionPersistence.list()` 给全部会话 + 真实 `cwd`；
+  `sessions.list()` 给 live 会话的标题）—— **不解压任何 `.zstd`**，所以一秒出结果、也不会卡。
+
+**通用路由 · 正文里带 `[s:会话id]` 就投给那个会话**(v1.10.3+)
+
+- **怎么写**：群里任何一条消息，只要**正文**里有 **`[s:8位短id]`**（或 `【会话 完整id】`），
+  这条消息就会被**投递进那个会话**，标记本身会被自动剥掉、不会出现在对方看到的内容里。
+- **和「引用回流」什么关系**：**回流**是"回"—— 必须**引用子会话发的那条转发消息**；
+  **路由**是"去"—— **任意会话、不用先绑过、不用是子会话**，只要正文里有那个 id。
+- **能带东西**：你的正文 + **这条消息自带的附件**（图片 / 文件会一并进去）——
+  所以"引用一张图 + 一行 `[s:xxxx]`"就能把图路由给对方。
+- **忙 / 闲两种处理**：目标会话**正在跑** → 当**插话**送进去；**空闲** → **唤醒**它。
+- **⚠️ 前提**：目标会话**必须是活着的**（宿主里有它的 agent）。没活着就**静默跳过**，绝不猜、也绝不新建。
+
 ### 🔨 锤子面板: 禁言 / 踢人 (v1.6.2+，2026-10-04 补充)
 
 dock 里的「🔨 锤子」（原「🔇 禁言」）下面分两页：**🔇 禁言**（走官方接口，机器人为管理员即可，无需任何登录）和 **👢 踢人**（**官方至今未开放踢人接口**，改走**你自己的 QQ 号** + 群官网 `qun.qq.com`）。