@zaofan/dsh-qqbot 1.5.7 → 1.5.9

package/README.md

@@ -241,3 +241,70 @@ dsh: disabling profile plugin row "mcp-chrome": Plugin ... is incompatible with
 ## License
 
 [MIT](./LICENSE)
+
+### Q: 升级到 dsh 0.1.7 后，我以前设置的群守则（groupPrompt）不见了？
+
+**A：这是 0.1.7 一次性导入设置时的已知坑，内容没丢，可以找回。**
+
+0.1.7 会把旧的 `~/.dsh/settings.yaml` 整体导入 profile，但导入**不一定落到 entry config 里**；
+插件的设置页读不到自定义值 → 拿到默认值 → 保存时把默认值写回 → 你的自定义内容就被顶掉了。
+
+**找回步骤**：
+1. 打开 `~/.dsh/settings.yaml.imported`（宿主留档的原件，同目录通常还有 `.bak`）
+2. 找到你实例对应的 section（例如 `im-qqbot-2:`），再往下找 `groupPrompt:` 那一行
+3. 复制它的内容（`|-` 或 `>-` 块标量，注意去掉块缩进）
+4. 回到 Web 设置页的「群聊常驻守则」，粘贴回去并**保存**
+   — 1.5.8 起设置保存在插件自有存储（`~/.dsh/qqbot-settings/<实例>.json`），不会再丢
+
+> ⚠️ **群守则里常含私人信息**（主人 openid、进群暗号等）。**发布、分享配置或截图时请务必剔除 `groupPrompt`。**
+
+### Q: 设置页保存后，为什么 patch 里看不到我的改动？
+
+**A：1.5.8 起，设置页保存写在插件自有存储，**故意不写** `cordis.patch.yml`。**
+
+- 位置：`~/.dsh/qqbot-settings/<实例名>.json`（例如 `im-qqbot-2.json`）
+- 为什么不写 patch：写 patch 会触发宿主热更新 → 插件重新 apply → 若此时凭据无效又会写配置，
+  **形成死循环**（实测把 dsh 启动刷死）；而且手拼 YAML 保不住字段类型、也不支持新增键。
+- 生效优先级：**自有存储覆盖 patch**。所以两份不一致时，以自有存储为准。
+
+### Q: 面板上「实时入群事件」开关是干什么的？打开后机器人连不上了？
+
+**A：它订阅 `GROUP_JOIN_REQUEST`（群成员事件，intent `1<<24`），需要 QQ 开放平台**先开通**该事件。**
+
+未开通时打开会导致**机器人连不上**（网关拒绝 Identify，close `4914`/`4915`）。
+正确顺序：**① 平台开通事件 → ② 打开开关 → ③ 重启**。
+
+**只想收通知、不想折腾平台？** 用「轮询审批」即可（不需要任何事件授权）：
+- 勾「轮询审批」= 定时拉取各群审批列表
+- 再按需勾「唤醒AI」/「注入群管会话」/「通知普通群」决定拿到申请后做什么
+- ⚠️ 注意：`唤醒AI` 与 `注入群管会话` **互斥且唤醒优先** —— 两个都勾时只会唤醒 AI，不会注入会话。
+  想要「静默注入群管会话」就**只勾「注入群管会话」**。
+
+### Q: 为什么自有存储里不要出现空对象（`{}`）？
+
+**A：空对象会把 patch 里的整块配置顶掉，导致依赖它的功能静默失效。**
+
+插件读取配置时会把「自有存储」(`~/.dsh/qqbot-settings/<实例>.json`) 与 profile 的 patch 合并。
+如果自有存储里某个字段是**空对象**，浅合并会把 patch 里该字段的**整块配置顶掉**。
+
+**真实案例**：`sticker: {}` 让 `config.sticker.collectEnabled` 变成 `undefined`
+→ **图片自动下载停摆**（现象：最后一张自动下载的图停在某个时刻，之后入站图片只剩 QQ 长 URL）。
+
+1.5.9 起已改为**递归合并**（空对象不再覆盖），但如果你手动编辑过那份 JSON：
+- **想恢复默认**：直接**删掉该字段**，不要写 `{}`
+- 只写你**真正改过**的键
+
+### Q: 升级后我自定义的配置（群守则 / 注入规则 / 互动事件）被默认值顶掉了，能找回吗？
+
+**A：能。宿主把旧的 `settings.yaml` 留档了。**
+
+0.1.7 会把 `~/.dsh/settings.yaml` 一次性导入 profile，但**导入不一定落到 entry config 里**；
+插件读不到自定义值时就会用默认值回写，把你的配置顶掉。
+
+**找回步骤**：
+1. 打开 `~/.dsh/settings.yaml.imported`（同目录通常还有 `.bak`）
+2. 找到你实例的 section（如 `im-qqbot-2:`），再找对应字段（`groupPrompt:` / `injectRules:` / `botplayEvents:` …）
+3. 复制内容，回到 Web 设置页粘回去并保存
+   （1.5.9 起配置存在插件自有存储，不会再被默认值覆盖）
+
+> ⚠️ 群守则里常含私人信息（主人 openid、进群暗号等），**发布/分享/截图时记得剔除**。

package/client/qqbot-settings.js

@@ -2703,6 +2703,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
             return isNaN(v) || v < 1 ? dft : v
           }
           state.gaEnabled = read('#dk-ga-enabled')
+    state.gaWatch = read('#dk-ga-watch')
           state.gaPoll = read('#dk-ga-poll')
           state.gaPollWake = read('#dk-ga-pollwake')
           state.gaHubNotify = read('#dk-ga-hubnotify')
@@ -2737,6 +2738,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
           // ⚙ 群组设置: 载入轮询/开关当前值
           var poll = ga.pollJoinRequests || {}
           state.gaEnabled = ga.enabled === true
+      state.gaWatch = ga.watchJoinRequests === true   // 实时入群事件（需平台开通，重启生效）
           state.gaPoll = poll.enabled === true
           state.gaPollWake = poll.wakeLlm !== false
           state.gaHubNotify = poll.hubNotify !== false
@@ -2745,6 +2747,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
           state.gaInterval = poll.intervalMin || 5
           state.gaMinCount = poll.minCount || 1
           var e1 = panel && panel.querySelector('#dk-ga-enabled'); if (e1) e1.checked = state.gaEnabled
+      var ew = panel && panel.querySelector('#dk-ga-watch'); if (ew) ew.checked = state.gaWatch
           var e2 = panel && panel.querySelector('#dk-ga-poll'); if (e2) e2.checked = state.gaPoll
           var e3 = panel && panel.querySelector('#dk-ga-pollwake'); if (e3) e3.checked = state.gaPollWake
           var e4 = panel && panel.querySelector('#dk-ga-hubnotify'); if (e4) e4.checked = state.gaHubNotify
@@ -2766,6 +2769,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
             var patch = Object.assign({}, cur || {})
             var ga = Object.assign({}, (cur && cur.groupAdmin) || {}, {
               enabled: state.gaEnabled,
+          watchJoinRequests: state.gaWatch === true,
               pollJoinRequests: {
                 enabled: state.gaPoll,
                 intervalMin: state.gaInterval,
@@ -3452,6 +3456,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
             + '<span class="dk-msg" style="flex:1" id="dk-ga-hint"></span></div>'
             + '<div class="dk-row" style="gap:8px;flex-wrap:wrap">'
             + '<label style="display:inline-flex;align-items:center;gap:4px;cursor:pointer;font-size:12px"><input type="checkbox" id="dk-ga-enabled"' + (state.gaEnabled ? ' checked' : '') + '> 群管理</label>'
+  + '<label style="display:inline-flex;align-items:center;gap:4px;cursor:pointer;font-size:12px" title="实时接收入群申请事件(GROUP_JOIN_REQUEST)；需先在 QQ 开放平台开通该事件，否则机器人会连不上；打开后需重启生效"><input type="checkbox" id="dk-ga-watch"' + (state.gaWatch ? ' checked' : '') + '>实时入群事件(需平台开通·重启生效)</label>'
             + '<label style="display:inline-flex;align-items:center;gap:4px;cursor:pointer;font-size:12px"><input type="checkbox" id="dk-ga-poll"' + (state.gaPoll ? ' checked' : '') + '> 轮询审批</label>'
             + '<label style="display:inline-flex;align-items:center;gap:4px;cursor:pointer;font-size:12px"><input type="checkbox" id="dk-ga-pollwake"' + (state.gaPollWake ? ' checked' : '') + '> 唤醒AI</label>'
             + '<label style="display:inline-flex;align-items:center;gap:4px;cursor:pointer;font-size:12px"><input type="checkbox" id="dk-ga-hubnotify"' + (state.gaHubNotify ? ' checked' : '') + '> 注入群管会话</label>'