@zaofan/dsh-qqbot 1.0.0 → 1.1.0

package/README.md

@@ -53,6 +53,7 @@
 - QQ 会话内可直接调用的标准工具：发图/撤图/查库/打标/查未整理/定时（`send_media`/`recall_message`/`list_stickers`/`sticker_tag`/`sticker_untagged`/`schedule_timer`/`schedule_cancel`…），会话按账号精确路由
 - **群管理工具**（`group_join_requests`/`group_approve_join`/`group_mute_state`/`group_mute_member`…）：入群审批与禁言，需机器人为该群管理员；对话内管当前群，web/非群会话用配置的 `manageGroup`
 - **纯文本也能发图撤消息**：让 AI 在回复里写 `[MEDIA:image|图片路径或网址]` 就自动变成真图发出去（`voice`/`video`/`file` 同理）；写 `[RECALL]` 撤回自己刚发的那条
+- **跨会话通信（通用插件能力，v1.1.0+）**：`session_list` 列出全部会话（含潜在群，重启后仍可靠）；`session_wake` 向指定会话/群发送消息并唤醒对方 LLM（web 注入给 AI 看），同时可走 QQBot 通道发到绑定的群/私聊（给人看），自动带 `【来自会话 xxx…】` 来源标注，支持 `media` 跨群发图。寻址走 module 级 session-registry（跨实例精确命中），会话未创建时懒创建/宿主 resume 恢复——**重启后也能找到并唤醒任何会话**
 - 会话归属、工作区挂载等宿主问题已按官方机制修好（移植上游 PR #21，幂等、全 fail-soft）
 
 > 🛡️ 仓库**不含**任何机器人凭据、图库数据、日志与个人路径（发布前已清理）。AppID/AppSecret 请走环境变量或 Web 面板注入，**不要提交进 git**。
@@ -211,6 +212,11 @@ npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 
 **入群审批怎么用**: 事件到达 → bot 在群里发一条提醒(含申请人昵称/验证语)→ 你在对话里说"通过/拒绝"(AI 调 `group_approve_join`)→ 官方落库审批。也可以在设置面板「⑥ QQ 群管理 → 入群审批」页看待审批清单手动批。
 
+**跨群/跨会话工具**(v1.1.0+): 
+- `group_join_requests(gid=…)` / `group_approve_join(member_openids=…)`: 传 `gid` 可查询/审批**指定群**的入群申请(不限于当前会话群), 支持一次批量审批多人;
+- `session_list`: 列出全部会话(含群注册表里的"潜在群", 重启后仍可靠), 给出每个会话/群的 sessionId 供寻址;
+- `session_wake(session_id 或 scope+peer_id, text, send_qq?, media?)`: 向指定会话/群发消息并唤醒对方 LLM, 同时可走 QQBot 通道发到绑定的群/私聊(带 `【来自会话 xxx…】` 来源标注), `media` 支持跨群发图。
+
 **配置项**(Web 面板 ⑥ 可改, 见下表 `groupAdmin.*`)
 
 ## 配置项
@@ -266,15 +272,21 @@ npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 
 ## 用户扩展(自定义斜杠命令 / QQ 工具)(v0.9.8+)
 
-> 给"用户自己 + AI 自己"写扩展用的。写在**账号工作目录的扩展区**, 不碰插件本体——
+> 给"用户自己 + AI 自己"写扩展用的。写在**账号数据目录的扩展区**(默认=账号工作目录 cwd;
+> 若账号配置了 `dataRoot`, 则在 `{dataRoot}/.qqbot-extensions`), 不碰插件本体——
 > 以后升级插件(换 node_modules)不会覆盖你的扩展。扩展=可执行 JS, 只在你自己的机器上跑。
+> 查看当前目录: dock 账号列表会显示该账号的"数据目录"。
 
-### 目录结构(每账号独立, 在账号的 cwd 下)
+### 目录结构(每账号独立)
 ```
-.qqbot-extensions/
-├── commands/    # 自定义斜杠命令(重启后生效)
-└── tools/       # 自定义 QQ 通道工具(AI 可调; 写完用 /tools-reload 或让 AI 调 tools_reload 热刷)
+<数据目录>/
+├── 表情包/                 # 图库(若配置了 dataRoot, 如 cwd/dshqqbot/表情包)
+├── .qqbot/                 # 台账/定时/审批(如 cwd/dshqqbot/.qqbot)
+└── .qqbot-extensions/
+    ├── commands/    # 自定义斜杠命令(重启后生效)
+    └── tools/       # 自定义 QQ 通道工具(AI 可调; 写完用 /tools-reload 或让 AI 调 tools_reload 热刷)
 ```
+数据目录 = `dataRoot`(已配置, 例 `D:\...\鲸鱼娘\dshqqbot`)或账号 cwd(未配置时, 向后兼容)。
 
 ### 自定义斜杠命令: .qqbot-extensions/commands/xxx.mjs
 ```js
@@ -305,7 +317,7 @@ export default {
 写完在 QQ 里发 `/tools-reload`(或直接让 AI 调 `tools_reload` 工具)即可用, 无需重启。
 
 ### 给 AI 的要点(让 AI 帮用户写扩展时照此办)
-1. 命令/工具文件都放账号 cwd 的 `.qqbot-extensions/` 下, 别放插件包内。
+1. 命令/工具文件都放**账号数据目录**的 `.qqbot-extensions/` 下(dataRoot 优先, 无则 cwd), 别放插件包内。
 2. 工具入参 schema 用 JSON Schema 风格; **可选参数不带 required 字段**。
 3. 写完后告知用户: 命令需重启, 工具发 `/tools-reload` 或调 tools_reload。
 4. 返回统一 `{ ok, msg }`(工具)或纯文本(命令)。