@zaofan/dsh-qqbot 1.5.12 → 1.5.14

package/docs/USER-GUIDE.md

@@ -72,6 +72,24 @@ npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 
 > 思路来源: wang-22-code/dsh-qqbot-bridge 的 QQ 审批设计(宿主 dsh `approval/request` 标准事件,官方 dsh-acp / Web 审批弹窗同款机制)。
 
+
+### 审批卡片：谁可以点（v1.5.12+）
+
+发起审批的卡片**发到发起者所在的会话**（群里就发到群里），但**只有下列人能点按钮**：
+
+1. **发起者本人**
+2. **主人白名单** —— `groupAdmin.owners`
+
+> ⚠️ **群聊场景一定要填白名单**：设置 → QQ 机器人 →「允许操作的主人 openid（逗号分隔，可留空=不校验）」。
+> 否则别人发起的审批，主人点了没反应（卡片只认发起者）。
+> 私聊场景不受影响（本就只有双方）。
+
+**这个白名单同时用于**：群管理工具的权限校验 + 审批卡片的可点名单（同一个"主人"概念）。
+
+**排障**：若点了按钮后"本轮运行失败"，且日志里有
+`SessionFormatError: format v4 message requires a producer-owned source kind` ——
+说明插件版本 < 1.5.12（旧代码用了 dsh V4 禁止的 `source.kind='plugin'`），升级即可。
+
 ## QQ 群管理(可选)
 
 机器人**为群管理员**时,可开启群管理能力:实时接收「入群申请」并自动提醒主人、按申请审批入群、查询/设置群成员禁言。所有操作走腾讯官方 GroupOpenMsg 接口,错误信息已做"人话"映射(如 11703=机器人不是该群管理员、40103004=不能禁言群主/管理员、11255=群已注销)。
@@ -183,6 +201,43 @@ Invoke-WebRequest "$base/config.json"               -OutFile "$dir\config.json"
 - **拦截边界**：被 @ 的永远放行；带图一律放行；**只有被拦在唤醒之前**（没花 token）的那次才会**回滚**本群的回复冷却 —— 冷却本来就是用来省 token 的，token 花了就不算白花。
 - **评分记录**：`{dataRoot}/.qqbot/value-scores.jsonl`，一行一条，字段 `score / worth / gate / min / conf / mention / img / lib / agg / top`。面板能直读，也可以让 AI 读它来维护样例库（`{dataRoot}/.qqbot/value-samples.jsonl`：`{"m":"消息文本","y":1|0}`，y=1 表示"她会想接话"）。
 
+
+## 🚫 无上下文模式（按会话省 token）(v1.5.11+)
+
+让某个 QQ 会话**每轮只记得最近几条对话**，更早的历史自动折叠 —— 群聊省 token 利器。
+
+### 怎么开
+
+1. 打开 dock 面板（右下角 🛡）→「⚙ **单会话设置**」→ 子标签「🚫 **无上下文**」
+2. 确认面板上显示的"作用对象"是你想设的那个群
+3. 勾选「无上下文模式」，填「带 @ 前 N 条」，点「💾 保存(本会话)」
+   - 保存成功会显示「✅ 已保存并回读确认: 开启 / 带 N 条」
+
+### 行为说明（几个容易误解的地方）
+
+| 现象 | 说明 |
+|---|---|
+| **web 上还能翻到旧对话** | ✅ 正常。折叠的只是「模型视野」，**会话记录本身不删**；web 里会多一行「上下文已压缩 · 已压缩 N 条历史记录」的折叠标记 |
+| **N 条 ≠ N 条 QQ 消息** | ⚠️ N 计的是 **dsh 侧的消息条数**。插件入站时会把"群历史 + 当前消息"**聚合成一条**，所以 1 条可能含多条 QQ 消息（群历史缓冲上限由 `historyLimit` 控制，默认 10） |
+| **群守则每轮都重新注入** | ✅ 正常且必要。压缩会把旧的守则一起折叠，所以每轮补一份；**改了群守则会立刻生效**（去重按内容比较） |
+| **什么时候生效** | 压缩发生在**回合开始**，所以**从下一轮起**才看不到更早的对话（当轮她已经装好上下文了） |
+| **会调额外的模型吗** | ❌ 不会。替身文本是写死的，**零 LLM 调用**（比 dsh 自带 compaction"生成摘要"更省） |
+
+### 全局开启（可选）
+
+不逐会话设置也可以开全局：
+
+```yaml
+contextlessMode: true     # 所有会话都启用
+contextlessWindow: 5      # 保留最近 5 条
+```
+
+### 存储位置
+
+`{dataRoot}/.qqbot/contextless.json` —— 键是会话（`qqbot:<appId>:group:<群openid>`），值 `{ enabled, window }`。
+
+> ⚠️ 别手改这个文件（面板保存会回读校验）；想全关就把每个 key 的 `enabled` 改成 `false`。
+
 ## 💗 好感度与熟识度（v1.5.0+）
 
 两个维度**分开算、互不干扰**：
@@ -434,6 +489,64 @@ sessionKey: `qqbot:${appId}:${scope}:${peerId}`，由 SHA-256 确定性派生 Se
 
 解析策略：进程内复用 → 持久化恢复 → 全新创建。
 
+
+## 常见问题（详解）
+
+### Q: 升级 dsh 0.1.7 后，恢复会话报「预设缺失」/ 机器人不理人？
+
+**原因**：0.1.7 把「Agent 预设」从"目录里的文件"改成了"profile 里的声明行"，旧的预设目录不再被扫描。
+
+**处理**：用插件自带的迁移脚本把预设迁到 profile 声明里（或重新在「Agent 预设」页里建一次），然后重启 dsh。
+
+### Q: 升级 dsh 0.1.7 后，某些插件被「禁用 / 跳过」？
+
+**原因**：0.1.7 起按 `peerDependencies` 校验插件与宿主兼容性，声明不匹配的会被跳过（打印 `skipping profile bundle ...`）。
+
+**处理**：升级该插件，或按提示用 `dsh plugin allow-version` 显式豁免。
+
+### Q: 升级后我自定义的配置（群守则 / 注入规则 / 互动事件）被默认值顶掉了，能找回吗？
+
+**能。** 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、进群暗号等），**发布/分享/截图时记得剔除**。
+
+### Q: 设置页保存后，为什么 patch 里看不到我的改动？
+
+**这是有意设计**。设置页保存**不写 profile 的 `cordis.patch.yml`**，而是写插件自己的存储：
+`{DSH_HOME}/qqbot-settings/<实例 id>.json`。
+
+**为什么**：写 patch 会被宿主当成热更新提交 → 插件重新加载 → 若凭据无效又会写 → 形成死循环（实测能把 dsh 启动刷死）。
+另外手拼 YAML 也保不住字段类型（已实测出 `expected string` / `expected array` 等问题）。
+
+**读取顺序**：patch 值 + 自有存储覆盖（后者优先）。
+
+### Q: 面板上「实时入群事件」开关是干什么的？打开后机器人连不上了？
+
+**原因**：这个开关会订阅 QQ 的 `GROUP_JOIN_REQUEST` 事件（intent `1<<24`）。
+**若开放平台没有开通该事件，网关会拒绝连接（close 4914/4915）→ 机器人直接离线**。
+
+**正确处理顺序**：**① 平台开通事件 → ② 打开开关 → ③ 重启**。
+
+**不想折腾平台**：用「轮询入群申请」（不需要任何授权）：
+- `轮询入群申请` 是**总开关**，不勾它，下面的选项都不生效
+- 「唤醒 AI」与「注入群管会话」**互斥且唤醒优先** —— 两个都勾只会唤醒 AI，不会注入群管会话
+- 想要静默注入群管会话，就**只勾「注入群管会话」**
+
+### Q: 为什么自有存储里不要出现空对象（`{}`）？
+
+**原因**：合并是递归深合并，但**空对象会把整块默认配置顶掉**。
+例如 `sticker: {}` 会顶掉 patch 里的整个 `sticker` 块 → `collectEnabled` 变成 `undefined` → **图片自动下载静默停摆**
+（症状：最后一张自动下载的图停在某个时刻，之后入站图片只剩 QQ 长 URL）。
+
+**处理**：**想恢复默认就删掉该字段，不要写 `{}`**。
+
 ## 设计原则
 
 - **纯 Cordis 插件** — 遵循 dsh "Plugins, not loop changes" 原则

package/entry.js

@@ -0,0 +1,57 @@
+/**
+ * 包入口守卫（永远随包发布，不参与编译）。
+ *
+ * 为什么需要它：
+ *   仓库不提交编译产物 `dist/`，而 dsh 的插件页支持"填 GitHub 仓库地址安装"。
+ *   从 git 直装时若 pnpm 没有执行 `prepare`（新版 pnpm 默认拦截 git 依赖的构建脚本：
+ *   `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`），装出来的包里就没有 `dist/`，
+ *   宿主只会打印一句很难懂的 `failed to import`。
+ *
+ *   这里在入口处先自检，把"真正的原因 + 怎么办"直接打到控制台。
+ */
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const missing = [];
+for (const rel of ['dist/index.js', 'client/qqbot-settings.js', 'settings-host.js', 'cordis.patch.yml']) {
+  if (!existsSync(join(here, rel))) missing.push(rel);
+}
+
+if (missing.length > 0) {
+  const isDistMissing = missing.includes('dist/index.js');
+  console.error('');
+  console.error('  ┌──────────────────────────────────────────────────────────────┐');
+  console.error('  │  dsh-qqbot 安装不完整，无法启动                              │');
+  console.error('  └──────────────────────────────────────────────────────────────┘');
+  console.error('  缺少文件: ' + missing.join(', '));
+  console.error('  安装目录: ' + here);
+  console.error('');
+  if (isDistMissing) {
+    console.error('  【最可能的原因】你是用 "GitHub 仓库地址" 安装的。');
+    console.error('   仓库不提交编译产物 dist/，而新版 pnpm 默认不允许 git 依赖执行构建脚本');
+    console.error('   （报错类似 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED），于是 dist/ 没被编译出来。');
+    console.error('');
+    console.error('  【最简单的解决办法】');
+    console.error('   把依赖换成本包在 npm 上的发布版（自带 dist，不需要任何构建）：');
+    console.error('     pnpm add @zaofan/dsh-qqbot');
+    console.error('   或者在 dsh 插件页里填【包名】 @zaofan/dsh-qqbot （而不是 GitHub 地址）。');
+    console.error('');
+    console.error('  【想继续用 git 源的化】');
+    console.error('   在上面那个安装目录里手动编译一次：');
+    console.error('     npm install && npm run build');
+    console.error('   如果报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED，需要在 profile 的');
+    console.error('   pnpm-workspace.yaml 里允许它执行脚本（错误信息里会给出确切的 allowBuilds 写法）。');
+  }
+  console.error('');
+  throw new Error('dsh-qqbot: 安装不完整（缺少 ' + missing.join(', ') + '），请按上面的提示处理');
+}
+
+// 自检通过 → 正常导出
+// ⚠️ 2026-09-28 修：原来这里多写了一句 `export { default } from './dist/index.js'`，
+//   但 dist/index.js 并没有 default 导出 → 触发
+//     SyntaxError: The requested module './dist/index.js' does not provide an export named 'default'
+//   → 整个插件 import 失败（宿主只报一句难懂的 "failed to import"）。
+//   这是个语法级错误：哪怕自检全过，插件也永远加载不起来。
+export * from './dist/index.js';

package/package.json

@@ -1,125 +1,136 @@
-{
-  "name": "@zaofan/dsh-qqbot",
-  "version": "1.5.12",
-  "description": "QQ Bot IM channel plugin for deepseek-harness (dsh)",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./channel-tools": {
-      "types": "./dist/channel-tools.d.ts",
-      "import": "./dist/channel-tools.js"
-    },
-    "./sticker-store": {
-      "types": "./dist/features/sticker-store.d.ts",
-      "import": "./dist/features/sticker-store.js"
-    },
-    "./schedule-store": {
-      "types": "./dist/features/schedule-store.d.ts",
-      "import": "./dist/features/schedule-store.js"
-    },
-    "./client": "./client/qqbot-settings.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "prepublishOnly": "npm run build && node scripts/check-package.mjs",
-    "check:package": "node scripts/check-package.mjs",
-    "lint": "eslint src/",
-    "test": "vitest run",
-    "clean": "rm -rf dist",
-    "ci:prepare-test-pkg": "node scripts/prepare-test-pkg.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gcry13067381632-jpg/dsh-qqbot.git"
-  },
-  "homepage": "https://github.com/gcry13067381632-jpg/dsh-qqbot#readme",
-  "bugs": {
-    "url": "https://github.com/gcry13067381632-jpg/dsh-qqbot/issues"
-  },
-  "keywords": [
-    "deepseek-harness",
-    "dsh",
-    "dsh-plugin",
-    "qqbot",
-    "qq-bot",
-    "chatbot",
-    "ai-agent",
-    "cordis",
-    "plugin",
-    "llm"
-  ],
-  "license": "MIT",
-  "files": [
-    "dist",
-    "docs/USER-GUIDE.md",
-    "client",
-    "cordis.patch.yml",
-    "settings-host.js",
-    "README.md",
-    "README_EN.md",
-    "LICENSE",
-    "voice-convert.mjs",
-    "scripts/download-model.mjs",
-    "scripts/fix-dsh-016-presets.ps1"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": { "platform": "web", "inject": ["@deepseek-ai/dsh-client-ui-settings", "@deepseek-ai/dsh-client-ui-slots"], "immediately": true },
-    "engines": {
-      "dsh": "0.1.5-rc.2 || 0.1.6-alpha.2 || 0.1.7-rc.1"
-    }
-  },
-  "dependencies": {
-    "@tencent-connect/qqbot-connector": "1.2.0",
-    "@tencent-connect/qqbot-nodejs": "^1.0.4",
-    "js-yaml": "^4.1.0",
-    "silk-wasm": "^3.7.1",
-    "lamejs-fixed": "^1.2.2"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": ">=4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
-    "@deepseek-ai/schemastery": ">=3.18.1",
-    "@tencent-connect/qqbot-connector": "1.2.0"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": {
-      "optional": false
-    },
-    "@deepseek-ai/schemastery": {
-      "optional": false
-    },
-    "@deepseek-ai/dsh-agent": {
-      "optional": false
-    },
-    "@deepseek-ai/dsh-session": {
-      "optional": false
-    },
-    "@deepseek-ai/dsh-llm": {
-      "optional": false
-    }
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
-    "@deepseek-ai/schemastery": "3.18.1",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^26.2.0",
-    "typescript": "^5.5.0",
-    "vitest": "^4.1.8"
-  }
-}
+{
+  "name": "@zaofan/dsh-qqbot",
+  "version": "1.5.14",
+  "description": "QQ Bot IM channel plugin for deepseek-harness (dsh)",
+  "type": "module",
+  "main": "./entry.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./entry.js"
+    },
+    "./channel-tools": {
+      "types": "./dist/channel-tools.d.ts",
+      "import": "./dist/channel-tools.js"
+    },
+    "./sticker-store": {
+      "types": "./dist/features/sticker-store.d.ts",
+      "import": "./dist/features/sticker-store.js"
+    },
+    "./schedule-store": {
+      "types": "./dist/features/schedule-store.d.ts",
+      "import": "./dist/features/schedule-store.js"
+    },
+    "./client": "./client/qqbot-settings.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build && node scripts/check-package.mjs",
+    "check:package": "node scripts/check-package.mjs",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "ci:prepare-test-pkg": "node scripts/prepare-test-pkg.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gcry13067381632-jpg/dsh-qqbot.git"
+  },
+  "homepage": "https://github.com/gcry13067381632-jpg/dsh-qqbot#readme",
+  "bugs": {
+    "url": "https://github.com/gcry13067381632-jpg/dsh-qqbot/issues"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "qqbot",
+    "qq-bot",
+    "chatbot",
+    "ai-agent",
+    "cordis",
+    "plugin",
+    "llm"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist",
+    "docs/USER-GUIDE.md",
+    "client",
+    "cordis.patch.yml",
+    "settings-host.js",
+    "README.md",
+    "README_EN.md",
+    "LICENSE",
+    "voice-convert.mjs",
+    "scripts/download-model.mjs",
+    "scripts/fix-dsh-016-presets.ps1",
+    "entry.js"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "immediately": true
+    },
+    "engines": {
+      "dsh": "0.1.5-rc.2 || 0.1.6-alpha.2 || 0.1.7-rc.1"
+    },
+    "manifestVersion": 1
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "3.18.4",
+    "@tencent-connect/qqbot-connector": "1.2.0",
+    "@tencent-connect/qqbot-nodejs": "^1.0.4",
+    "js-yaml": "^4.1.0",
+    "lamejs-fixed": "^1.2.2",
+    "silk-wasm": "^3.7.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1",
+    "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@tencent-connect/qqbot-connector": "1.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": false
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": false
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": false
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": false
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^26.2.0",
+    "typescript": "^5.5.0",
+    "vitest": "^4.1.8"
+  }
+}

package/settings-host.js

@@ -836,18 +836,26 @@ export function apply(ctx) {
       writeJson(res, 200, {
         hasFile,
         instances: bots.map((b) => {
-          const cwd = b.cfg?.cwd || '';
+          // ⚠️ 2026-09-28 修：保存时 cwd/preset/appId 只写【自有存储】(见 saveInstances 的 2026-09-24 注释)，
+          //   但回显原先只读 patch → 界面上填过的 cwd/preset 保存后就"变空"了（前端拿到空串）。
+          //   这里把自有存储的值一并合并，与写路径对称（patch 优先，其次自有存储）。
+          let ownCfg = {};
+          try { ownCfg = readOwnSettings(String(b.id)) || {}; } catch { ownCfg = {}; }
+          const cwd = b.cfg?.cwd || ownCfg.cwd || '';
+          const presetMerged = b.cfg?.preset || ownCfg.preset || '';
+          const appIdMerged = b.cfg?.appId || ownCfg.appId || '';
+          const hasSecretMerged = !!(b.cfg?.appSecret || ownCfg.appSecret);
           // 数据根与 dist 侧 dataRootOf 对齐: 未配 dataRoot → `{cwd}/dshqqbot`(2026-09-12 新默认)
           const droot = b.cfg?.dataRoot || (cwd ? join(cwd, 'dshqqbot') : '');
           return {
             id: b.id,
             ns: b.id, // settings 命名空间 = 实例 id(主 im-qqbot; 非主实例 render 已写 settingsNs=id)
-            appId: b.cfg?.appId || '',
-            appSecret: b.cfg?.appSecret ? SECRET_MASK : '', // 掩码回显(借鉴 panel: masked)
-            hasSecret: !!b.cfg?.appSecret,
-            preset: b.cfg?.preset || '',
+            appId: appIdMerged,
+            appSecret: hasSecretMerged ? SECRET_MASK : '', // 掩码回显(借鉴 panel: masked)
+            hasSecret: hasSecretMerged,
+            preset: presetMerged,
             cwd,
-            disabled: !!b.disabled,
+            disabled: !!b.disabled || ownCfg.disabled === true,
             online: typeof reg.isBotOnline === 'function' ? reg.isBotOnline(b.id) : false, // 在线状态(bot ws ready 事件驱动)
             // 账号数据目录(各号各库各定时): 图库={cwd}/表情包, 定时={cwd}/.qqbot
             dataDir: droot ? join(droot, '表情包') : '',
@@ -1732,16 +1740,50 @@ export function apply(ctx) {
   // ── ⑥QQ 群管理面板(P3, 2026-09-05): 多群管理 host 路由(读/写走 GroupAdminClient; 面板=主人直发免 QQ 审批) ──
   // 数据: {cwd}/.qqbot/{groups.json 群注册表, join-pending.json 待审, group-audit.jsonl 审计日志}
   // 鉴权: 与全路由一致走 route() 同源 loopback fence; 面板主人级鉴权(P4 加强)。
+  /**
+   * 把【插件自有存储】的值合并进 patch 解析出的实例列表。
+   *
+   * ⚠️ 2026-09-28 根治同类问题：
+   *   自 2026-09-24 起，已有账号的 appId / appSecret / preset / cwd 只写自有存储、不写 patch
+   *   （避免多条目 insert 时块边界写歪 YAML）。但桥里有若干地方**只读 patch** 取账号配置，
+   *   于是用户存进自有存储的值读不到 —— 表现为：
+   *     · 账号页填了「工作目录」保存后回显为空
+   *     · nsBot() 返回 null → 群管理/图库/无上下文/Excel 导出全部走错路径
+   *   这里统一合并（patch 优先，其次自有存储），所有取账号配置的入口都应走它。
+   */
+  function mergeOwnIntoCfg(cfg, nsLike) {
+    let own = {};
+    try { own = readOwnSettings(String(nsLike)) || {}; } catch { own = {}; }
+    const pick = (k) => (cfg && cfg[k] !== undefined && cfg[k] !== '' ? cfg[k] : (own[k] !== undefined && own[k] !== '' ? own[k] : (cfg ? cfg[k] : undefined)));
+    return {
+      ...cfg,
+      appId: pick('appId'),
+      appSecret: pick('appSecret'),
+      preset: pick('preset'),
+      cwd: pick('cwd'),
+      dataRoot: pick('dataRoot'),
+    };
+  }
+
   function nsBot(ns) {
     const { bots } = parsePatch();
     const id = ns && ns !== 'im-qqbot' ? String(ns) : 'im-qqbot';
     const b = bots.find((x) => x.id === id);
     if (!b) return null;
-    const appId = b.cfg?.appId || '';
-    const appSecret = b.cfg?.appSecret || '';
+    // ⚠️ 2026-09-28 修（同类问题根治）：自 2026-09-24 起，已有账号的 appId/appSecret/preset/cwd
+    //   只写【插件自有存储】，不再写 profile patch（避免多条目 insert 时块边界写歪 YAML）。
+    //   但这里原先只读 patch → 用户存进自有存储的 cwd 读不到 → 数据目录算成空 →
+    //   群管理 / 图库 / 无上下文 / Excel 导出 等**所有**依赖 nsBot 的接口全部走错路径
+    //   （症状：报"找不到该账号实例(请先在账号页配置 appId/appSecret)"、图库与定时目录消失）。
+    //   现在先合并自有存储（patch 优先，其次自有存储），与写路径对称。
+    let own = {};
+    try { own = readOwnSettings(String(b.cfg?.settingsNs || id)) || {}; } catch { own = {}; }
+    const appId = b.cfg?.appId || own.appId || '';
+    const appSecret = b.cfg?.appSecret || own.appSecret || '';
     // 数据根: dataRoot(新) > `{cwd}/dshqqbot`(**2026-09-12 新默认**, 与 dist 侧 dataRootOf 对齐);
     // nsBot 的 cwd 字段按数据根返回(全为数据目录用途) —— 未配 dataRoot 的实例不再落到工作目录。
-    const cwd = (b.cfg?.dataRoot || (b.cfg?.cwd ? join(b.cfg.cwd, 'dshqqbot') : ''));
+    const cwdCfg = b.cfg?.cwd || own.cwd || '';
+    const cwd = (b.cfg?.dataRoot || own.dataRoot || (cwdCfg ? join(cwdCfg, 'dshqqbot') : ''));
     if (!appId || !appSecret) return null;
     return { id, appId, appSecret, cwd, ns: id };
   }
@@ -1854,8 +1896,11 @@ export function apply(ctx) {
       const { bots } = parsePatch();
       const botByNs = new Map();
       for (const bot of bots) {
-        if (bot.disabled || !bot.cfg?.appId || !bot.cfg?.cwd) continue;
-        botByNs.set(bot.id, bot);
+        // ⚠️ 2026-09-28：appId/cwd 可能只在【自有存储】里（2026-09-24 起的保存策略），
+        //   合并后再判断，否则这类账号会被误跳过。
+        const mcfg = mergeOwnIntoCfg(bot.cfg || {}, bot.cfg?.settingsNs || bot.id);
+        if (bot.disabled || !mcfg.appId || !mcfg.cwd) continue;
+        botByNs.set(bot.id, { ...bot, cfg: mcfg });
       }
       const hits = [];
       const seen = new Set();
@@ -2038,20 +2083,20 @@ export function apply(ctx) {
       req.setTimeout(180000, () => req.destroy(new Error('下载超时(180s)')));
     });
   }
-  // ── 本地小模型：强制重置加载状态（面板「🔄 重新检测」调用）──
-  // 背景：local-embed 曾有"一次失败永久关闭"的缺陷，用户点重新检测时希望能立刻再试一次。
-  // ⚠️ 桥与插件在同进程：动态 import 同一份 dist 模块，拿到的就是插件正在用的那个实例表。
-  route(ctx, 'POST', '/api/qqbot-settings/local-model/reset', async (req, res) => {
-    try {
-      const mod = await import('./dist/features/local-embed.js');
-      let n = 0;
-      try { n = typeof mod.resetAllEmbedders === 'function' ? mod.resetAllEmbedders() : 0; } catch (e) { n = -1; }
-      return writeJson(res, 200, { ok: true, reset: n });
-    } catch (e) {
-      return writeJson(res, 500, { error: String((e && e.message) || e) });
-    }
-  });
-
+  // ── 本地小模型：强制重置加载状态（面板「🔄 重新检测」调用）──
+  // 背景：local-embed 曾有"一次失败永久关闭"的缺陷，用户点重新检测时希望能立刻再试一次。
+  // ⚠️ 桥与插件在同进程：动态 import 同一份 dist 模块，拿到的就是插件正在用的那个实例表。
+  route(ctx, 'POST', '/api/qqbot-settings/local-model/reset', async (req, res) => {
+    try {
+      const mod = await import('./dist/features/local-embed.js');
+      let n = 0;
+      try { n = typeof mod.resetAllEmbedders === 'function' ? mod.resetAllEmbedders() : 0; } catch (e) { n = -1; }
+      return writeJson(res, 200, { ok: true, reset: n });
+    } catch (e) {
+      return writeJson(res, 500, { error: String((e && e.message) || e) });
+    }
+  });
+
   route(ctx, 'GET', '/api/qqbot-settings/local-model/status', async (req, res) => {
     try {
       const u = new URL(req.url ?? '/', 'http://x');
@@ -3746,6 +3791,8 @@ const WHY_MAP = { busy: '目标会话回合活跃,已等待至回合结束仍超
       const { bots } = parsePatch();
       const out = [];
       for (const bot of bots) {
+        // ⚠️ 2026-09-28：凭据可能只在【自有存储】里（2026-09-24 起的保存策略），合并后再判断。
+        bot.cfg = mergeOwnIntoCfg(bot.cfg || {}, bot.cfg?.settingsNs || bot.id);
         if (bot.disabled || !bot.cfg?.appId || !bot.cfg?.appSecret) continue;
         try {
           const ns = bot.id;