@zaofan/dsh-qqbot 1.10.47 → 1.11.0

package/examples/ext-commands//346/211/251/345/261/225/347/244/272/344/276/213.mjs

@@ -0,0 +1,84 @@
+/**
+ * 扩展示例.mjs — `/扩展示例` 斜杠命令（2026-10-26 主人要求的验收示例）
+ *
+ * 演示点：一条命令同时读**两级配置**
+ *   · 文本1 → profile 级（全局一份，影响所有机器人）  ui/demo-settings 里改
+ *   · 文本2 → 数据根（每实例一份，只影响当前机器人）  ui/demo-dock 里改
+ *
+ * 放到 {dataRoot}/.qqbot-extensions/commands/ 后重启宿主生效（扩展命令需重启）。
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+/** 读一个 json，坏文件当空对象 */
+function readJson(p) {
+  try {
+    if (!existsSync(p)) return {};
+    const j = JSON.parse(readFileSync(p, 'utf8'));
+    return j && typeof j === 'object' ? j : {};
+  } catch {
+    return {};
+  }
+}
+
+/** profile 根：优先环境变量，退到 ~/.dsh/profiles/<第一个> */
+function profileRootOf() {
+  const envDir = process.env.DSH_PROFILE_DIR || process.env.DSH_PROFILE_ROOT;
+  if (envDir && existsSync(envDir)) return envDir;
+  try {
+    const base = join(homedir(), '.dsh', 'profiles');
+    if (existsSync(base)) {
+      const names = readdirSync(base).filter((n) => !n.startsWith('.'));
+      if (names.length) return join(base, names[0]);
+    }
+  } catch { /* ignore */ }
+  return join(homedir(), '.dsh', 'profiles', 'web');
+}
+
+export default {
+  name: '扩展示例',
+  description: '发一条（文本1）（文本2）—— 演示 profile/data 双源扩展配置',
+  handler: async (ctx) => {
+    // ★ 2026-10-27 修（主人实测：dock 里存了「哈哈我喜欢你」但命令读到默认值）：
+    //   ctx.cwd 是**工作区**（D:\...\鲸鱼娘），配置却在**数据根**
+    //   （D:\...\鲸鱼娘\dshqqbot\.qqbot-extensions\...）—— 差了 dshqqbot 一级，
+    //   于是读到不存在的路径、回退成默认提示。优先用能力包给的 dataRoot。
+    const caps = ctx?.caps ?? ctx;
+    let dataRoot = String(caps?.dataRoot || ctx?.dataRoot || '').trim();
+    if (!dataRoot) {
+      const base = String(ctx?.cwd || process.cwd());
+      const guess = join(base, 'dshqqbot');
+      dataRoot = existsSync(guess) ? guess : base;
+    }
+    const extId = 'demo';
+
+    // 文本1：**本实例优先 → 全局兜底**（2026-10-27 主人要求）
+    //   理由：设置页里那张卡片能切「改全局 / 改当前账号」，用户给某个机器人单独配了
+    //   文本1（如 3 号机配 666），那就该用他的；没配的机器人才用全局那份。
+    const profileCfg = readJson(join(profileRootOf(), '.qqbot-extensions', '.state', 'ext-config', extId + '.json'));
+    const dataCfg = readJson(join(dataRoot, '.qqbot-extensions', '.state', 'ext-config', extId + '.json'));
+
+    const t1 = String(dataCfg.text1 || '').trim()
+      || String(profileCfg.text1 || '').trim()
+      || '(文本1：还没在「通用设置」里改过)';
+    const t2 = String(dataCfg.text2 || '').trim() || '(文本2：还没在 dock 球里改过)';
+
+    const out = `（${t1}）（${t2}）`;
+
+    // ctx 是能力包平铺：text() 直接往当前会话发一条纯文本
+    try {
+      if (typeof ctx?.text === 'function') {
+        await ctx.text(out);
+        return { ok: true, msg: '已发送' };
+      }
+      if (typeof ctx?.markdown === 'function') {
+        await ctx.markdown(out);
+        return { ok: true, msg: '已发送（markdown）' };
+      }
+    } catch (e) {
+      return { ok: false, msg: '发送失败: ' + (e instanceof Error ? e.message : String(e)) };
+    }
+    return { ok: false, msg: '当前 ctx 没有发送能力' };
+  },
+};

package/examples/ext-hooks/demo-store.mjs

@@ -0,0 +1,75 @@
+/**
+ * demo-store.mjs — 扩展示例的**自有存储**后端（2026-10-26）
+ *
+ * 演示点：扩展不一定要用 ext-config 那套固定 JSON —— 可以自己挑存储位置和格式，
+ * 通过 env.registerRoute() 注册 HTTP 路由，让自己的 UI 卡片用 qqbotExt.api() 取。
+ *
+ * 这里用的存储：{dataRoot}/.qqbot/demo-store.json（自己挑的地方，跟插件数据放一起）
+ * 想换 SQLite / 别的目录，只改本文件的读写实现即可 —— 卡片侧完全不用动。
+ *
+ * 注册的路由：
+ *   GET  /store   → { ok, data: {...}, file }
+ *   POST /store   → 浅合并写回，返回新内容
+ *   GET  /ping    → 探活
+ *
+ * 卡片里（见 ui/demo-dock/card.js）：
+ *   qqbotExt.api('/store').then(r => r.data)
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+
+export default async function (env) {
+  const caps = env?.caps ?? env;
+  if (!caps || typeof caps.registerRoute !== 'function') {
+    env?.log?.('[demo-store] 这个版本的宿主没有 registerRoute，跳过了');
+    return;
+  }
+
+  const extId = 'demo';
+  // ★ 2026-10-27 修（主人实测：dock 在 3 号机里读到的还是鲸鱼娘那份文件）：
+  //   hooks 是「插件启动时跑一次」，env.dataRoot 是**插件级**的（主实例那份），
+  //   不是当前机器人实例的。所以数据根必须**随请求走** ——
+  //   卡片通过 api() 把 dataRoot 带上来，dispatch 会把它放进 query 交给 handler。
+  //   这里 env.dataRoot 只当兜底。
+  const defaultRoot = String(env?.dataRoot || env?.cwd || process.cwd());
+  const storeFileOf = (root) => join(root || defaultRoot, '.qqbot', 'demo-store.json');
+
+  function readStoreAt(file) {
+    try {
+      if (!existsSync(file)) return {};
+      const j = JSON.parse(readFileSync(file, 'utf8'));
+      return j && typeof j === 'object' ? j : {};
+    } catch {
+      return {};
+    }
+  }
+  function writeStoreAt(file, o) {
+    try {
+      mkdirSync(dirname(file), { recursive: true });
+      writeFileSync(file, JSON.stringify(o, null, 2), 'utf8');
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  const rootOf = (q) => String((q && q.dataRoot) || '').trim() || defaultRoot;
+  const fileOf = (q) => storeFileOf(rootOf(q));
+
+  // ── 注册路由（第 4 个参数是扩展 id，卡片用 api() 时会带上它）──
+  const r1 = caps.registerRoute('GET', '/store', async ({ query } = {}) => ({
+    ok: true, data: readStoreAt(fileOf(query)), file: fileOf(query), dataRoot: rootOf(query),
+  }), extId);
+  const r2 = caps.registerRoute('POST', '/store', async ({ query, body } = {}) => {
+    const f = fileOf(query);
+    const cur = readStoreAt(f);
+    const next = Object.assign({}, cur, body && typeof body === 'object' ? body : {});
+    return writeStoreAt(f, next)
+      ? { ok: true, data: next, file: f, dataRoot: rootOf(query) }
+      : { ok: false, reason: '写入失败：' + f };
+  }, extId);
+  const r3 = caps.registerRoute('GET', '/ping', async ({ query } = {}) => ({
+    ok: true, data: { at: Date.now(), dataRoot: rootOf(query), file: fileOf(query) },
+  }), extId);
+
+  env?.log?.('[demo-store] 已注册 3 条路由 (' + [r1, r2, r3].join(',') + ')，默认存储: ' + storeFileOf(defaultRoot));
+}

package/examples/ext-ui/README.md

@@ -0,0 +1,95 @@
+# 扩展 UI 卡片（ext-ui）
+
+给扩展一个**声明式 UI 入口** —— 不用改主包任何文件，就能往面板上加自己的卡片。
+
+> 起因：以前扩展想加界面，只能按字符串锚点往 `client/qqbot-settings.js`（535KB 手写 bundle）
+> 里塞代码。版本一换锚点就失效，而且只对写补丁的那台机器有效。
+
+---
+
+## 放哪儿
+
+任选其一（同名时**数据根优先**）：
+
+```
+{dataRoot}/.qqbot-extensions/ui/<extId>/card.html
+{dataRoot}/extension-packs/<包名>/ui/<extId>/card.html
+```
+
+`<extId>` 只能用 `[A-Za-z0-9_-]`，最长 64，且必须有 `card.html` 才会被扫到。
+
+三个文件（后两个可选）：
+
+```
+card.html   结构（必填，元信息写在这个文件的头部注释里）
+card.css    样式（可选，自动加进 Shadow DOM）
+card.js     逻辑（可选，ESM 风格的 IIFE 更稳）
+```
+
+---
+
+## 元信息
+
+`card.html` 的**前 2KB 内**放：
+
+```html
+<!-- qqbot-ui: { "slot": "settings", "title": "本地代答", "order": 10 } -->
+```
+
+| 字段 | 说明 |
+|---|---|
+| `slot` | `settings`（设置页底部卡片条）或 `dock`（悬浮台页签）。缺省 `settings` |
+| `title` | 卡片/页签标题。缺省用目录名 |
+| `order` | 排序，小的靠前。缺省 100 |
+
+---
+
+## 运行环境
+
+`card.js` 以 `new Function('qqbotExt', 'shadowRoot', 源码)` 执行，两个变量直接可用：
+
+```js
+qqbotExt.extId            自己的 id
+qqbotExt.api(path, opts)  调 /api/ext/<extId>/… （扩展自己注册的路由）
+qqbotExt.toast(msg)       轻提示
+shadowRoot                本卡片的 ShadowRoot
+```
+
+**注意事项**：
+
+- 用 `shadowRoot.getElementById()`，**不要**用 `document.getElementById()` —— 那查到的是外面页面。
+- 脚本抛错只让这张卡显示一行红字，不会影响设置页本体（外面套了 try/catch）。
+- CSS 完全隔离：你写 `button{...}` 碰不到面板，面板的样式也进不来。
+
+---
+
+## 横向滑动
+
+卡片条本身就是横向可滑的（`overflow-x:auto` + `scroll-snap` + 手机惯性滚动）。
+单卡默认宽 `220~320px`，挂多少张都不会挤爆布局。
+
+想控制宽度，在 `card.css` 里改 `:host`：
+
+```css
+:host { width: 300px; }   /* 固定宽；不给就跟随面板的 min/max */
+```
+
+---
+
+## 最小可用示例
+
+本目录就是 —— `local-llm/` 三个文件抄过去改改就能跑。
+
+测试（不用重启宿主，直接跑扫描器）：
+
+```bash
+node -e 'import("./dist/features/ext-ui.js").then(m=>console.log(m.listExtUi("你的数据根")))'
+```
+
+---
+
+## 相关
+
+- 扫描与安全校验：`src/features/ext-ui.ts`
+- 后端路由：`settings-host.js` 的 `/api/qqbot-settings/ext-ui/list` 与 `/ext-ui/file`
+- 设计稿：`参考文档/扩展UI挂载点_设计稿_20261026.md`

package/examples/ext-ui/demo/dock/card.css

@@ -0,0 +1,55 @@
+/* 扩展示例 · 两处卡片共用的样式（Shadow DOM 内，不影响面板其他地方） */
+:host { display: block; }
+.card {
+  background: #fff; border: 1px solid #e6e8ec; border-radius: 12px;
+  padding: 10px 12px; font: 13px -apple-system, 'PingFang SC', 'Microsoft YaHei', sans-serif;
+  color: #1f2329; box-shadow: 0 1px 2px rgba(20,30,60,.05);
+}
+.hd { display: flex; align-items: center; gap: 6px; font-weight: 700; margin-bottom: 8px; }
+.dot { width: 7px; height: 7px; border-radius: 50%; background: #bbb; flex: none; }
+.dot.on { background: #16a34a; }
+.dot.err { background: #dc2626; }
+.row { display: flex; align-items: center; gap: 6px; margin: 6px 0; font-size: 12px; }
+.lbl { color: #6b7280; flex: none; }
+.val { color: #1f2329; }
+.hint { color: #9aa0a8; font-size: 11px; line-height: 1.5; }
+.txt {
+  flex: 1; min-width: 160px; font: inherit; padding: 6px 9px;
+  border: 1px solid #d0d5dd; border-radius: 8px; outline: none; color: #1f2329;
+}
+.txt:focus { border-color: #7c6cf0; }
+.acts { display: flex; gap: 6px; margin-top: 10px; flex-wrap: wrap; }
+.btn {
+  font: inherit; font-size: 12px; padding: 5px 12px; border-radius: 8px;
+  border: 1px solid #d9c6ff; background: #f1ecff; color: #4a3a9f; cursor: pointer;
+}
+.btn:hover { background: #e9e1ff; }
+.btn:disabled { opacity: .5; cursor: default; }
+.btn.ghost { background: #fff; border-color: #d0d5dd; color: #4b5563; }
+
+/* dock 卡片专用：顶部一排子标签 */
+.subtabs { display: flex; gap: 4px; border-bottom: 1px solid #eee; margin-bottom: 10px; }
+.subtabs button {
+  font: inherit; font-size: 13px; padding: 6px 14px; border: none; background: none;
+  cursor: pointer; color: #666; border-bottom: 2px solid transparent;
+}
+.subtabs button.on { color: #4a3a9f; font-weight: 700; border-bottom-color: #7c6cf0; }
+.pane { display: none; }
+.pane.on { display: block; }
+pre.info {
+  background: #f6f7f9; border: 1px solid #e6e8ec; border-radius: 8px;
+  padding: 8px 10px; font-size: 11px; line-height: 1.6; max-height: 180px; overflow: auto;
+  white-space: pre-wrap; word-break: break-all; margin: 4px 0 0;
+}
+
+/* 说明块（2026-10-27）：告诉用户这两段文字会出现在 /扩展示例 里 */
+.tip {
+  background: #f4f7ff; border: 1px solid #dbe6ff; border-radius: 9px;
+  padding: 8px 10px; font-size: 11.5px; line-height: 1.65; color: #3a4a6b; margin: 2px 0 10px;
+}
+.tip b { color: #2b4a8f; }
+.code {
+  font-family: ui-monospace, Consolas, monospace; font-size: 11px;
+  background: #fff; border: 1px dashed #c9d8f5; border-radius: 6px;
+  padding: 3px 7px; margin: 5px 0; color: #1f3b73;
+}

package/examples/ext-ui/demo/dock/card.html

@@ -0,0 +1,95 @@
+<!-- qqbot-ui: { "id": "demo", "slot": "dock", "title": "🔌 扩展示例", "order": 5 } -->
+<!--
+  扩展示例 · dock 卡片（slot=dock → 放 **数据根**）
+    {dataRoot}/.qqbot-extensions/ui/demo-dock/card.html
+
+  ★ 元信息里的 "id": "demo" 是关键 —— 目录叫 demo-dock，但 cosplay 成 extId=demo，
+    这样才能和 settings 那张卡共用同一份配置 id（文本1 在 profile、文本2 在数据根）。
+
+  dock 卡片的独特之处：qqbotExt.dock.* 能拿到**当前实例 + 当前会话**的真实数据。
+-->
+<div class="card">
+  <div class="hd"><span class="dot" id="dot"></span><span>🔌 扩展示例 · 本实例</span></div>
+
+  <div class="subtabs">
+    <button data-p="set" class="on">✏ 改文本2</button>
+    <button data-p="ctx">📊 会话数据</button>
+    <button data-p="store">📝 自有存储</button>
+    <button data-p="silent">💤 静默注入</button>
+    <button data-p="file">📄 读写文件</button>
+  </div>
+
+  <!-- 子标签 1：改文本2（数据根级，只影响这个机器人） -->
+  <div class="pane on" data-pane="set">
+    <div class="row"><span class="lbl">文本2（本实例）</span></div>
+    <div class="row"><input class="txt" id="t2" placeholder="填一段文字，例如 我是本机文本" /></div>
+    <div class="tip">
+      这里填的文字会出现在 <b>/扩展示例</b> 的输出里 —— 去群里敲一下就能看到：
+      <div class="code">/扩展示例  →  （文本1）（文本2）</div>
+      本页改的是 <b>文本2</b>（只影响当前这个机器人）；<b>文本1</b> 在「通用设置 → QQ机器人 → 扩展示例 · 全局」里改（所有机器人共用）。
+    </div>
+    <div class="acts">
+      <button class="btn" id="save2">保存到本实例</button>
+      <button class="btn ghost" id="reload2">重新读取</button>
+    </div>
+    <div class="row"><span class="val" id="st2"></span></div>
+  </div>
+
+  <!-- 子标签 2：展示 dock 能拿到的会话数据（这是 dock 独有能力的演示） -->
+  <div class="pane" data-pane="ctx">
+    <div class="row"><span class="hint">下面这些是 dock 卡片独有的能力 —— 能直接读到当前实例和会话的真实数据。</span></div>
+    <div class="acts">
+      <button class="btn" id="ctxBtn">读上下文</button>
+      <button class="btn ghost" id="hisBtn">读最近消息</button>
+    </div>
+    <pre class="info" id="info">点上面按钮看看</pre>
+  </div>
+
+  <!-- 子标签 3：自有存储（不用 ext-config 那套，走 hooks 注册的 /store 路由） -->
+  <div class="pane" data-pane="store">
+    <div class="row"><span class="hint">这块数据存在 <b>hooks/demo-store.mjs</b> 自己挑的文件里，通过 <code>api('/store')</code> 读写 —— 想换 SQLite 只改后端，卡片不用动。</span></div>
+    <div class="row"><span class="lbl">键</span><input class="txt" id="sk" placeholder="note" style="max-width:120px" /></div>
+    <div class="row"><input class="txt" id="sv" placeholder="值，例如 你好自有存储" /></div>
+    <div class="acts">
+      <button class="btn" id="storeSave">写入自有存储</button>
+      <button class="btn ghost" id="storeLoad">读取</button>
+    </div>
+    <pre class="info" id="storeInfo">点「读取」看看</pre>
+  </div>
+
+  <!-- 子标签 4：静默注入（往当前会话塞一条消息，但不唤醒 AI） -->
+  <div class="pane" data-pane="silent">
+    <div class="tip">
+      往当前会话塞一条消息，但 <b>不唤醒 AI</b> —— 它 <b>不会</b> 立刻回复，
+      而是等下一次被叫到时才会在上下文里看到这条。<br />
+      用途：给 AI 留个备忘、埋个线索，或者悄悄改一下它下一轮的认知。
+    </div>
+    <div class="row"><input class="txt" id="silentText" placeholder="要静默注入的文本，例如：记住主人的猫叫豆豆" /></div>
+    <div class="acts">
+      <button class="btn" id="silentBtn">静默注入</button>
+    </div>
+    <pre class="info" id="silentInfo">还没试过</pre>
+  </div>
+
+  <!-- 子标签 5：读写电脑上任意文本文件（走 fs.read / fs.write 白名单） -->
+  <div class="pane" data-pane="file">
+    <div class="tip">
+      读 / 写本机任意文本文件（<b>只放行文本类扩展名</b>：txt / md / json / log / yml / csv / ini / js / ts / html / css，单文件 ≤2MB）。<br />
+      保存时会在旁边留一份 <code>.bak-时间戳</code> 备份，改坏了能捞回来。
+    </div>
+    <div class="row">
+      <input class="txt" id="filePath" placeholder="D:\某个目录\note.txt" />
+      <button class="btn ghost" id="filePick" style="flex:none">选择文件…</button>
+      <button class="btn ghost" id="filePicker2" style="flex:none" title="用系统对话框选文件，选完直接可读可写（不需要路径）">系统选择器</button>
+      <input type="file" id="fileInput" style="display:none" accept=".txt,.md,.json,.log,.yml,.yaml,.csv,.ini,.conf,.js,.ts,.mjs,.cjs,.html,.css" />
+    </div>
+    <div class="acts">
+      <button class="btn" id="fileRead">读取</button>
+      <button class="btn" id="fileSave">保存修改</button>
+    </div>
+    <div class="row">
+      <textarea class="txt" id="fileText" rows="8" placeholder="文件内容会显示在这里，可以直接改" style="width:100%;resize:vertical;font-family:ui-monospace,Consolas,monospace;font-size:12px"></textarea>
+    </div>
+    <pre class="info" id="fileInfo">先填路径再点「读取」</pre>
+  </div>
+</div>

package/examples/ext-ui/demo/dock/card.js

@@ -0,0 +1,261 @@
+/* 扩展示例 · dock 卡片逻辑
+   dock 卡片的 getConfig()/setConfig() 默认走 **数据根**（每实例一份）；
+   另外能用 qqbotExt.dock.* 读当前实例 / 会话的真实数据 —— 这是 dock 独有的。 */
+(function () {
+  var $ = function (id) { return shadowRoot.getElementById(id) };
+  var dot = $('dot');
+  var t2 = $('t2');
+  var st2 = $('st2');
+  var info = $('info');
+
+  function show(ok, msg) {
+    if (st2) { st2.textContent = msg; st2.style.color = ok ? '#2f9e44' : '#c33' }
+    if (dot) dot.className = 'dot ' + (ok ? 'on' : 'err')
+  }
+  function setInfo(o) {
+    if (!info) return
+    try { info.textContent = typeof o === 'string' ? o : JSON.stringify(o, null, 2) } catch (e) { info.textContent = String(o) }
+  }
+
+  // ── 子标签切换 ──────────────────────────────────────────
+  shadowRoot.querySelectorAll('.subtabs button').forEach(function (btn) {
+    btn.addEventListener('click', function () {
+      var p = btn.getAttribute('data-p')
+      shadowRoot.querySelectorAll('.subtabs button').forEach(function (b) { b.className = (b === btn ? 'on' : '') })
+      shadowRoot.querySelectorAll('.pane').forEach(function (el) {
+        el.className = 'pane' + (el.getAttribute('data-pane') === p ? ' on' : '')
+      })
+    })
+  })
+
+  // ── 子标签 1：文本2（数据根级） ─────────────────────────
+  function load2() {
+    show(true, '读取中…')
+    qqbotExt.getConfig().then(function (c) {
+      if (t2) t2.value = c.text2 || ''
+      show(true, c.text2 ? ('当前：' + c.text2) : '还没设置')
+    })
+  }
+  var save2 = $('save2');
+  if (save2) {
+    save2.addEventListener('click', function () {
+      save2.disabled = true
+      qqbotExt.setConfig({ text2: t2 ? t2.value : '' }).then(function (r) {
+        save2.disabled = false
+        if (r && r.ok) show(true, '已保存到本实例：' + ((r.config && r.config.text2) || ''))
+        else show(false, '保存失败：' + ((r && r.reason) || '未知'))
+      }).catch(function () { save2.disabled = false; show(false, '保存异常') })
+    })
+  }
+  var reload2 = $('reload2');
+  if (reload2) reload2.addEventListener('click', load2)
+
+  // ── 子标签 2：dock 独有能力 ─────────────────────────────
+  var ctxBtn = $('ctxBtn');
+  if (ctxBtn) {
+    ctxBtn.addEventListener('click', function () {
+      if (!qqbotExt.dock) return setInfo('这个卡片没有 dock 上下文（不是 dock 源？）')
+      setInfo('读取中…')
+      qqbotExt.dock.context().then(function (r) { setInfo(r || '(空)') })
+    })
+  }
+  var hisBtn = $('hisBtn');
+  if (hisBtn) {
+    hisBtn.addEventListener('click', function () {
+      if (!qqbotExt.dock) return setInfo('这个卡片没有 dock 上下文')
+      setInfo('读取中…')
+      qqbotExt.dock.history(8).then(function (r) {
+        if (!r || !r.ok) return setInfo(r || '(空)')
+        var rows = (r.messages || []).map(function (m) {
+          return '[' + (m.k || 'text') + '] ' + String(m.n || '') + ': ' + String(m.x || '').slice(0, 60)
+        })
+        setInfo(rows.length ? rows.join('\n') : '(这个会话还没有历史消息)')
+      })
+    })
+  }
+
+  // ── 子标签 3：自有存储（走 hooks 注册的 /store 路由）─────────────
+  var storeInfo = $('storeInfo');
+  var sk = $('sk');
+  var sv = $('sv');
+  function setStoreInfo(o) {
+    if (!storeInfo) return
+    try { storeInfo.textContent = typeof o === 'string' ? o : JSON.stringify(o, null, 2) } catch (e) { storeInfo.textContent = String(o) }
+  }
+  function loadStore() {
+    setStoreInfo('读取中…')
+    qqbotExt.api('/store').then(function (r) {
+      if (!r) return setStoreInfo('没有响应（hooks 里的 demo-store.mjs 没跑？）')
+      if (!r.ok) return setStoreInfo('失败：' + (r.reason || '未知'))
+      setStoreInfo('存储文件：' + (r.file || '?') + '\n\n' + JSON.stringify(r.data || {}, null, 2))
+    })
+  }
+  var storeLoad = $('storeLoad');
+  if (storeLoad) storeLoad.addEventListener('click', loadStore)
+  var storeSave = $('storeSave');
+  if (storeSave) {
+    storeSave.addEventListener('click', function () {
+      var key = (sk && sk.value ? sk.value : 'note').trim() || 'note'
+      var val = sv ? sv.value : ''
+      var patch = {}
+      patch[key] = val
+      storeSave.disabled = true
+      qqbotExt.api('/store', { method: 'POST', body: JSON.stringify(patch) }).then(function (r) {
+        storeSave.disabled = false
+        if (!r) return setStoreInfo('没有响应')
+        if (!r.ok) return setStoreInfo('失败：' + (r.reason || '未知'))
+        setStoreInfo('已写入 ' + key + ' = ' + val + '\n\n' + JSON.stringify(r.data || {}, null, 2))
+      }).catch(function () { storeSave.disabled = false; setStoreInfo('请求异常') })
+    })
+  }
+
+  // ── 子标签 4：静默注入（appendSilent，不唤醒 AI）──────────────
+  var silentInfo = $('silentInfo');
+  var silentText = $('silentText');
+  function setSilent(o) {
+    if (!silentInfo) return
+    try { silentInfo.textContent = typeof o === 'string' ? o : JSON.stringify(o, null, 2) } catch (e) { silentInfo.textContent = String(o) }
+  }
+  var silentBtn = $('silentBtn');
+  if (silentBtn) {
+    silentBtn.addEventListener('click', function () {
+      var t = silentText && silentText.value ? silentText.value.trim() : ''
+      if (!t) return setSilent('先填要注入的文本')
+      if (!qqbotExt.dock || !qqbotExt.dock.peer) {
+        return setSilent('当前没选中会话 —— 先在「聊天」里选一个目标')
+      }
+      silentBtn.disabled = true
+      // appendSilent 需要会话的 agent，后端会按 peer 去找
+      Promise.resolve(qqbotExt.cap('appendSilent', t)).then(function (r) {
+        silentBtn.disabled = false
+        setSilent(r === true
+          ? ('已静默注入（AI 不会立刻回复，下轮才看到）：' + t)
+          : ('没注入成功：' + JSON.stringify(r)))
+      }).catch(function (e) { silentBtn.disabled = false; setSilent('异常: ' + e) })
+    })
+  }
+
+  // ── 子标签 5：读写任意文本文件（fs.read / fs.write）────────────
+  var filePath = $('filePath');
+  var fileText = $('fileText');
+  var fileInfo = $('fileInfo');
+  function setFileInfo(o) {
+    if (!fileInfo) return
+    try { fileInfo.textContent = typeof o === 'string' ? o : JSON.stringify(o, null, 2) } catch (e) { fileInfo.textContent = String(o) }
+  }
+  // ── 文件选择器（2026-10-27 主人要求）──
+  //   Electron（DSH 桌面版）的 File 对象上有 **path** 属性 → 能直接拿到真实路径，
+  //   填进输入框后就能走 fs.read / fs.write（可改可存）。
+  //   纯浏览器（web 版）出于安全拿不到路径，只能读内容做预览；
+  //   这种情况退回"预览模式"：显示内容 + 提示去桌面版改。
+  var filePick = $('filePick');
+  var fileInput = $('fileInput');
+  if (filePick && fileInput) {
+    filePick.addEventListener('click', function () { fileInput.click() })
+    fileInput.addEventListener('change', function () {
+      var f = fileInput.files && fileInput.files[0]
+      if (!f) return
+      // Electron 专有属性；浏览器里是 undefined
+      var realPath = (typeof f.path === 'string' && f.path) || ''
+      if (realPath) {
+        if (filePath) filePath.value = realPath
+        setFileInfo('已选中：' + realPath + '，正在读取…')
+        if (fileRead) fileRead.click()
+      } else {
+        // 浏览器：拿不到路径，只能预览内容
+        var rd = new FileReader()
+        rd.onload = function () {
+          if (fileText) fileText.value = String(rd.result || '')
+          setFileInfo('已读取内容（浏览器拿不到真实路径，只能预览）\n文件名：' + f.name + '\n如果要修改并保存，请用桌面版，或手动把完整路径填进上面的输入框。')
+        }
+        rd.readAsText(f)
+      }
+      try { fileInput.value = '' } catch (e) { /* 允许重复选同一个 */ }
+    })
+  }
+
+  // ── 系统选择器（File System Access API，2026-10-27）─────────────
+  //   纯浏览器（Edge/Chrome 113+，localhost 算安全上下文）能弹**系统对话框**，
+  //   返回的是 FileSystemFileHandle —— **没有路径字符串**（浏览器安全模型就不给），
+  //   但 handle 本身可以直接读、直接写：
+  //     getFile().text()       读
+  //     createWritable().write() 写（用户授权过这个 handle）
+  //   所以这条路根本不需要路径，比填路径还省事，而且不会写错位置。
+  var filePicker2 = $('filePicker2');
+  var _pickedHandle = null;
+  if (filePicker2) {
+    filePicker2.addEventListener('click', function () {
+      if (typeof window.showOpenFilePicker !== 'function') {
+        return setFileInfo('这个浏览器不支持 File System Access API（需要 Edge/Chrome 113+，且是 localhost 或 https）')
+      }
+      window.showOpenFilePicker({
+        multiple: false,
+        types: [{
+          description: '文本文件',
+          accept: { 'text/plain': ['.txt', '.md', '.json', '.log', '.yml', '.yaml', '.csv', '.ini', '.conf', '.js', '.ts', '.html', '.css'] },
+        }],
+      }).then(function (handles) {
+        var h = handles && handles[0]
+        if (!h) return
+        _pickedHandle = h
+        if (filePath) filePath.value = '(系统选择器) ' + h.name   // 只有名字，没有路径
+        return h.getFile().then(function (f) {
+          if (f.size > 2 * 1024 * 1024) return setFileInfo('文件太大（>2MB）')
+          return f.text().then(function (txt) {
+            if (fileText) fileText.value = txt
+            setFileInfo('已通过系统选择器打开：' + h.name + '（' + f.size + ' 字节）\n现在点「保存修改」会直接写回这个文件（handle 已授权，不需要路径）。')
+          })
+        })
+      }).catch(function (e) {
+        if (e && e.name === 'AbortError') return setFileInfo('已取消选择')
+        setFileInfo('选择失败：' + (e && e.message ? e.message : e))
+      })
+    })
+  }
+
+  var fileRead = $('fileRead');
+  if (fileRead) {
+    fileRead.addEventListener('click', function () {
+      var p = filePath && filePath.value ? filePath.value.trim() : ''
+      if (!p) return setFileInfo('先填文件路径')
+      setFileInfo('读取中…')
+      qqbotExt.cap('fs.read', p).then(function (r) {
+        if (!r) return setFileInfo('没有响应（后端白名单里没有 fs.read？）')
+        if (!r.ok) return setFileInfo('读取失败：' + (r.reason || '未知'))
+        if (fileText) fileText.value = r.text || ''
+        setFileInfo('已读取：' + r.path + '（' + r.size + ' 字节）')
+      }).catch(function (e) { setFileInfo('异常: ' + e) })
+    })
+  }
+  var fileSave = $('fileSave');
+  if (fileSave) {
+    fileSave.addEventListener('click', function () {
+      var t = fileText ? fileText.value : ''
+      // ★ 优先用系统选择器拿到的 handle：直接写回原文件，不需要路径
+      if (_pickedHandle && typeof _pickedHandle.createWritable === 'function') {
+        fileSave.disabled = true
+        _pickedHandle.createWritable().then(function (w) {
+          return w.write(t).then(function () { return w.close() })
+        }).then(function () {
+          fileSave.disabled = false
+          setFileInfo('已写回：' + _pickedHandle.name + '（' + t.length + ' 字符，通过系统选择器授权）')
+        }).catch(function (e) {
+          fileSave.disabled = false
+          setFileInfo('写回失败：' + (e && e.message ? e.message : e))
+        })
+        return
+      }
+      var p = filePath && filePath.value ? filePath.value.trim() : ''
+      if (!p) return setFileInfo('先填文件路径，或用「系统选择器」选一个')
+      fileSave.disabled = true
+      qqbotExt.cap('fs.write', p, t).then(function (r) {
+        fileSave.disabled = false
+        if (!r) return setFileInfo('没有响应')
+        if (!r.ok) return setFileInfo('保存失败：' + (r.reason || '未知'))
+        setFileInfo('已保存：' + r.path + '（' + r.size + ' 字节）\n原文件已备份为 *.bak-时间戳')
+      }).catch(function (e) { fileSave.disabled = false; setFileInfo('异常: ' + e) })
+    })
+  }
+
+  load2()
+})();