@zaofan/dsh-qqbot 1.5.8 → 1.5.10

package/README.md

@@ -279,3 +279,32 @@ dsh: disabling profile plugin row "mcp-chrome": Plugin ... is incompatible with
 - 再按需勾「唤醒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

@@ -1734,8 +1734,13 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
       var badge = wrap.querySelector('#qqs-dock-badge')
       var panel = null
       var open = false
-      if (pos) { wrap.style.left = pos.x + 'px'; wrap.style.top = pos.y + 'px'; wrap.style.right = 'auto'; wrap.style.bottom = 'auto' }
-      // 拖拽(球上按住移动; 单击与拖拽区分)
+      // ⚠️ 2026-09-27 修复「拖到屏幕外后球永久消失」：拖拽时本来有 clamp(行1749)，
+      //   但**读取上次位置时没有** —— 窗口变小/换显示器后，存的坐标会落在可视区外，
+      //   球就再也点不到了（用户只能手动清 localStorage 才能找回）。这里读取时同样 clamp。
+      var _bw = 60, _bh = 60
+      var _x = Math.max(0, Math.min(Math.max(0, window.innerWidth - _bw), Number(pos.x) || 0))
+      var _y = Math.max(0, Math.min(Math.max(0, window.innerHeight - _bh), Number(pos.y) || 0))
+      wrap.style.left = _x + 'px'; wrap.style.top = _y + 'px'; wrap.style.right = 'auto'; wrap.style.bottom = 'auto'
       var dragState = null
       ball.addEventListener('mousedown', function (e) {
         dragState = { sx: e.clientX, sy: e.clientY, ox: wrap.offsetLeft, oy: wrap.offsetTop, moved: false }