@zaofan/dsh-qqbot 1.5.10 → 1.5.14

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.10",
-  "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

@@ -380,6 +380,66 @@ export function apply(ctx) {
   // 台账文件 {store.dataDir}/known-chats.jsonl 由 dsh-qqbot 中间件 append(见 dsh-qqbot src/features/chat-ledger.ts)。
   // 用途: Web 设置④区下拉点选目标(免抄 openid)——群无群名, 用最近发言者昵称帮主人辨认。
   // 多账号: ?dataDir= 指定账号图库目录(台账与之同目录); 缺省 primary。
+  // ── 推断本插件的 dataRoot（与插件 src/gateway/data-root.ts 的算法保持一致）──
+  //   为什么要这么做：桥和插件在运行时可能是**两份模块实例**（各自的模块级变量不共享）。
+  //   插件在 bootstrap 里 initContextlessStore(dataRoot) 用的是正确路径；桥若没 init，
+  //   contextless-store 的 ensurePath() 只能兜底到 {DSH_HOME}，于是"面板保存"写一个文件、
+  //   "插件实际读取"读另一个文件 → 表现为保存无效 / 开关显示不一致（2026-09-27 实测）。
+  function resolveContextlessDataRoot() {
+    try {
+      const parsed = parsePatch();
+      const bots = (parsed && Array.isArray(parsed.bots)) ? parsed.bots : [];
+      // 优先取"未禁用"的实例，其次任意一个有 cwd 的
+      const pick = bots.filter((b) => b && !b.disabled && b.cfg && (b.cfg.cwd || b.cfg.dataRoot));
+      const list = pick.length ? pick : bots.filter((b) => b && b.cfg && (b.cfg.cwd || b.cfg.dataRoot));
+      for (const b of list) {
+        const cfg = b.cfg || {};
+        if (cfg.dataRoot) return String(cfg.dataRoot);
+        if (cfg.cwd) return join(String(cfg.cwd), 'dshqqbot');   // 与 DEFAULT_DATA_SUBDIR 一致
+      }
+    } catch { /* 推不出来就交给 ensurePath 兜底 */ }
+    return '';
+  }
+  /** 确保 contextless-store 绑定到正确的数据根（幂等；路径变了会重新绑定） */
+  async function loadContextlessStore() {
+    const mod = await import('./dist/features/contextless-store.js');   // ← 函数体内用真正的动态 import（不能调自己）
+    try {
+      const dr = resolveContextlessDataRoot();
+      if (dr) mod.initContextlessStore(dr);
+    } catch { /* ignore */ }
+    return mod;
+  }
+
+  // ── 无上下文模式（2026-09-27 主人定）──
+  //   会话级开关：dock 面板里对**某个会话**开启；开启后该会话每轮只带
+  //   「@ 之前 N 条群消息 + 系统规则」，历史对话全部丢弃（大幅省 token）。
+  //   开关存 {dataRoot}/.qqbot/contextless.json（由插件在 bootstrap 时初始化）。
+  route(ctx, 'GET', '/api/qqbot-settings/contextless', async (req, res) => {
+    try {
+      const u = new URL(req.url ?? '/', 'http://x');
+      const key = (u.searchParams.get('sessionKey') || '').trim();
+      const mod = await loadContextlessStore();   // 先 init 到同一个 dataRoot，避免两份模块实例各写一个文件
+      if (key) return writeJson(res, 200, mod.getContextless(key));
+      return writeJson(res, 200, { list: mod.listContextless() });
+    } catch (e) {
+      return writeJson(res, 500, { error: String((e && e.message) || e) });
+    }
+  });
+  route(ctx, 'POST', '/api/qqbot-settings/contextless', async (req, res) => {
+    try {
+      const body = await readJsonBody(req);
+      if (!body || typeof body !== 'object') return writeJson(res, 400, { error: 'body must be JSON object' });
+      const key = String(body.sessionKey || '').trim();
+      if (!key) return writeJson(res, 400, { error: 'sessionKey required' });
+      const mod = await loadContextlessStore();   // 先 init 到同一个 dataRoot，避免两份模块实例各写一个文件
+      if (body.remove === true) { mod.clearContextless(key); return writeJson(res, 200, { ok: true, removed: true }); }
+      const next = mod.setContextless(key, { enabled: body.enabled, window: body.window });
+      return writeJson(res, 200, { ok: true, value: next });
+    } catch (e) {
+      return writeJson(res, 500, { error: String((e && e.message) || e) });
+    }
+  });
+
   route(ctx, 'GET', '/api/qqbot-settings/known-chats', async (req, res) => {
     try {
       const u = new URL(req.url ?? '/', 'http://x');
@@ -776,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, '表情包') : '',
@@ -1672,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 };
   }
@@ -1794,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();
@@ -1978,6 +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) });
+    }
+  });
+
   route(ctx, 'GET', '/api/qqbot-settings/local-model/status', async (req, res) => {
     try {
       const u = new URL(req.url ?? '/', 'http://x');
@@ -3672,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;