@zaofan/dsh-qqbot 1.7.7 → 1.7.9

package/README.md

@@ -4,7 +4,7 @@
 
 基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 QQ Bot IM 插件**增强 fork**：将 QQ 消息平台作为 dsh agent 的前端协议驱动，并加入表情包图库、富媒体收发、定时任务、多实例人格、好感度系统、可视化设置面板等能力。
 
-📦 仓库: [gcry13067381632-jpg/dsh-qqbot](https://github.com/gcry13067381632-jpg/dsh-qqbot)（fork 自 [tencent-connect/dsh-qqbot](https://github.com/tencent-connect/dsh-qqbot)；改动都在这一侧，升级/重装上游会被冲掉）
+📦 仓库: [zaofan-make/dsh-qqbot](https://github.com/zaofan-make/dsh-qqbot)（fork 自 [tencent-connect/dsh-qqbot](https://github.com/tencent-connect/dsh-qqbot)；改动都在这一侧，升级/重装上游会被冲掉）
 
 > ⭐ **用得顺手的话，麻烦点一下右上角的 Star** —— 它是这个项目"有人在用"的唯一可见信号，也是继续更新的动力。
 
@@ -124,7 +124,7 @@ npx @deepseek-ai/dsh plugin --profile web add @zaofan/dsh-qqbot
 
 > 尚未发布到 npm 前，请用下面的方式二。
 
-> ⚠️ **从 GitHub 直装（`github:gcry13067381632-jpg/dsh-qqbot`）需要编译产物 `dist/`，而仓库不提交 `dist`。**
+> ⚠️ **从 GitHub 直装（`github:zaofan-make/dsh-qqbot`）需要编译产物 `dist/`，而仓库不提交 `dist`。**
 > 包已声明 `prepare` 脚本，pnpm 安装时会自动编译；
 > 若你的包管理器没自动跑（或报 `failed to import` / 找不到 `dist/index.js`），
 > 手动在插件目录执行一次 `npm run build` 即可。**最省事的做法是用 npm 上的发布版**（`@zaofan/dsh-qqbot`）。
@@ -134,7 +134,7 @@ npx @deepseek-ai/dsh plugin --profile web add @zaofan/dsh-qqbot
 **Windows（一键脚本）**：
 
 ```powershell
-git clone https://github.com/gcry13067381632-jpg/dsh-qqbot.git
+git clone https://github.com/zaofan-make/dsh-qqbot.git
 cd dsh-qqbot
 .\install.ps1          # 自动 install/build → pack → add tarball → 输出重启指引
 ```
@@ -144,7 +144,7 @@ cd dsh-qqbot
 **macOS / Linux（手动）**：
 
 ```bash
-git clone https://github.com/gcry13067381632-jpg/dsh-qqbot.git
+git clone https://github.com/zaofan-make/dsh-qqbot.git
 cd dsh-qqbot
 npm install && npm run build
 pnpm pack --pack-destination /tmp
@@ -434,7 +434,7 @@ AI 侧的工具叫 **`qq_group_admin`**：
 
 ## 支持这个项目
 
-如果这个插件帮你省了 token、或者让你家的鲸鱼更活蹦乱跳 —— **给个 ⭐ Star** 就是最实在的支持；有 bug / 想要的功能，欢迎开 [Issue](https://github.com/gcry13067381632-jpg/dsh-qqbot/issues)。
+如果这个插件帮你省了 token、或者让你家的鲸鱼更活蹦乱跳 —— **给个 ⭐ Star** 就是最实在的支持；有 bug / 想要的功能，欢迎开 [Issue](https://github.com/zaofan-make/dsh-qqbot/issues)。
 
 ## License
 

package/README_EN.md

@@ -2,7 +2,7 @@
 
 An **enhanced fork** of the QQ Bot IM plugin for [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh): it drives the dsh agent loop with the QQ messaging platform as the frontend protocol, adding a local sticker library, rich media send/recall, scheduled tasks, multi-instance personas, and a visual settings panel.
 
-📦 Repo: [gcry13067381632-jpg/dsh-qqbot](https://github.com/gcry13067381632-jpg/dsh-qqbot) (forked from [tencent-connect/dsh-qqbot](https://github.com/tencent-connect/dsh-qqbot))
+📦 Repo: [zaofan-make/dsh-qqbot](https://github.com/zaofan-make/dsh-qqbot) (forked from [tencent-connect/dsh-qqbot](https://github.com/tencent-connect/dsh-qqbot))
 
 > ⭐ **If it works well for you, please star the repo** — it is the only visible signal that someone is using it, and it keeps the project going.
 
@@ -142,7 +142,7 @@ npx @deepseek-ai/dsh plugin --profile web add @zaofan/dsh-qqbot
 **Windows (one-click script)**:
 
 ```powershell
-git clone https://github.com/gcry13067381632-jpg/dsh-qqbot.git
+git clone https://github.com/zaofan-make/dsh-qqbot.git
 cd dsh-qqbot
 .\install.ps1          # npm install/build -> pack -> add tarball -> prints restart steps
 ```
@@ -152,7 +152,7 @@ cd dsh-qqbot
 **macOS / Linux (manual)**:
 
 ```bash
-git clone https://github.com/gcry13067381632-jpg/dsh-qqbot.git
+git clone https://github.com/zaofan-make/dsh-qqbot.git
 cd dsh-qqbot
 npm install && npm run build
 pnpm pack --pack-destination /tmp
@@ -463,7 +463,7 @@ npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 
 ## Support
 
-If this plugin saved you some tokens — or made your QQ bot feel alive — a **⭐ Star** is the most concrete way to say thanks. Bugs and feature requests: [Issues](https://github.com/gcry13067381632-jpg/dsh-qqbot/issues).
+If this plugin saved you some tokens — or made your QQ bot feel alive — a **⭐ Star** is the most concrete way to say thanks. Bugs and feature requests: [Issues](https://github.com/zaofan-make/dsh-qqbot/issues).
 
 ## License
 

package/dist/channel-tools.d.ts

@@ -89,4 +89,24 @@ export declare function syncContextTools(agentCtx: unknown, shouldHave: boolean,
     dataRoot?: string;
     sessionKey?: string;
 }, reminderText?: string): void;
+/**
+ * 把"三个上下文工具 + QQ 群管理工具"**全局注册一次、永不注销**。
+ *
+ * 幂等靠 globalThis 记句柄：跨热刷（模块重新 import）依然有效，避免热刷后重复注册被宿主判重名。
+ * ⚠️ 可见性不在这里决定 —— 交给 {@link restrictContextTools} 按会话剪枝。
+ */
+export declare function ensureContextToolsGlobal(globalCtx: unknown): void;
+/**
+ * 按会话**实时剪枝**三个上下文工具的可见性（2026-10-09，主人要的"实时变更"）。
+ *
+ * 语义：**开了「无上下文模式 + 智能判断」**的会话 → 看得见那三个工具；
+ * 否则该会话**连工具名都看不到**（模型清单里没有 = 零 token），而**注册表纹丝不动**。
+ * 面板一改开关 → 下一次 pre-step（下一回合/下一 step）即生效；撤销限制是立即的。
+ *
+ * 幂等：同一作用域状态没变化就直接 return，不重复设/撤 restriction（避免无谓的变更通知与抖动）。
+ */
+export declare function restrictContextTools(agentCtx: unknown, shouldHave: boolean, env?: {
+    dataRoot?: string;
+    sessionKey?: string;
+}): void;
 //# sourceMappingURL=channel-tools.d.ts.map

package/dist/channel-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../src/channel-tools.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AA4FlE,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAI1C,eAAO,MAAM,MAAM,UAAY,CAAC;AAWhC,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAiC;AAkD5F,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAErH;AACD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAE9E;AACD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAI/D;AAkFD,mDAAmD;AACnD,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA67DvD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,GAAG,KAAK,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBvC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,GAAG,KAAK,EACtB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA+BvC;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM;;;;;;;;;IAE1C;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAExF;AAYD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExD;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAKxI;AA4RD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAyI;AACzL,wBAAgB,eAAe,IAAI,MAAM,CAA2F;AA8CpI;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CA+CtJ"}
+{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../src/channel-tools.ts"],"names":[],"mappings":"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"}

package/dist/channel-tools.js

@@ -2214,10 +2214,15 @@ export async function apply(ctx) {
     //   ⛔ 别再改回 true：那等于给所有会话开后门。
     //   代价：插件作用域不再"提前"备一份，开启的会话若在极早期回合看不到工具，等下一个 step
     //   （pre-step 每个 step 都跑）即出现 —— 比"人人都有"划算得多。
-    try {
-        syncContextTools(ctx, false);
-    }
-    catch { /* ignore */ }
+    // ⚠️ 2026-10-09 **第二次修正**（实测抓到；主人定的"注册不动 + 实时剪枝"要落地必须这样）：
+    //   ⛔ **不要在这里注册那三个上下文工具** —— 本函数是"每会话"被调用的
+    //      （session-manager 传进来的是 **agentCtx**），在这儿 register 等于注册进**该 agent 作用域**；
+    //      而 `restrict({deny})` 按宿主文档**只过滤"继承来的"（全局层 + 祖先层）工具，
+    //      管不到本作用域自己注册的** ⇒ 剪枝永远打空
+    //      （trace 原话：`restrict 失败: names unknown global tools "context_memo","context_compact","context_drop"`）。
+    //   ✅ 全局注册统一交给 session-manager 的 pre-step 用**插件根 ctx** 做：
+    //      `ensureContextToolsGlobal(this.ctx)` —— 它内部用 `ctx.get('tools')` 取服务，绕开 inject 限制。
+    //   这里只保留下面 ②段"QQ 群管理工具"的按会话注册（那本来就是会话级工具）。
     const toolDefs = [
         { name: 'send_media', tool: sendMediaTool },
         { name: 'recall_message', tool: recallTool },
@@ -2960,4 +2965,123 @@ export function syncContextTools(agentCtx, shouldHave, env, reminderText) {
         traceToolReg('[ctxtool-reg] 异常: ' + String(e?.message ?? e).slice(0, 160));
     }
 }
+// ══════════════════════════════════════════════════════════════════════════
+// 2026-10-09 架构微调（主人定）：**注册不动 + 按会话实时剪枝可见性**
+// ══════════════════════════════════════════════════════════════════════════
+// 旧做法是 pre-step 每步都 `syncContextTools()`：内部"先注销、再重新注册"，
+// 于是**每一步都动一次工具表** → 宿主每步都发"工具已更新 · 移除/新增"（还进上下文，纯烧 token），
+// 多会话并存时更是"你挂我卸"来回抖。
+//
+// 主人的判断是对的：不该用"注册/注销"表达"这个会话要不要有"，而该
+// **注册只做一次，可见性按会话实时剪枝** —— 宿主正好提供了这个接口：
+// `ctx.tools.restrict({ allow | deny })`，**per-scope**（只作用于调用方那一个 agent 作用域），
+// 且"只过滤**继承**来的工具（全局层+祖先层），不动该作用域自己注册的"。
+//
+// 于是现在的分工：
+//   · {@link ensureContextToolsGlobal} —— 全局注册一次（永不注销），幂等；
+//   · {@link restrictContextTools}   —— 每个会话每次 pre-step 声明"我要不要看得到那三个"，
+//                                      状态没变就一根手指都不动（不产生任何变更通知）。
+// =========================================================================
+/** 三个上下文工具的名字（restrict 用；必须与 ctxToolsRef() 里的 name 完全一致） */
+const CTX_TOOL_NAMES = ['context_memo', 'context_compact', 'context_drop'];
+/**
+ * 把"三个上下文工具 + QQ 群管理工具"**全局注册一次、永不注销**。
+ *
+ * 幂等靠 globalThis 记句柄：跨热刷（模块重新 import）依然有效，避免热刷后重复注册被宿主判重名。
+ * ⚠️ 可见性不在这里决定 —— 交给 {@link restrictContextTools} 按会话剪枝。
+ */
+export function ensureContextToolsGlobal(globalCtx) {
+    try {
+        if (!globalCtx || typeof globalCtx !== 'object')
+            return;
+        // ⚠️ 2026-10-09 修（实测抓到）：apply 的注入列表是 `["settings","webServer"]`，**没有 `tools`** ⇒
+        //   直接读 `ctx.tools` 会被宿主拒（`cannot get property "tools" without inject`），异常被 catch 吞掉，
+        //   表现就是"全局注册压根没发生"（trace 里只有别的报错、没有"全局注册 N 件"）。
+        //   正解：**用 cordis 的运行时取服务 `ctx.get('tools')`**（不需要 inject 声明）——
+        //   本插件别处也是这个姿势（见 ext-capabilities 给扩展工具的 kernel 文档：`ctx.get('tools')`）。
+        const ctxObj = globalCtx;
+        let toolsObj;
+        try {
+            toolsObj = ctxObj.tools;
+        }
+        catch { /* 未声明 inject 时会抛 —— 忽略，下面改走 get */ }
+        if (!toolsObj || typeof toolsObj.register !== 'function') {
+            try {
+                toolsObj = ctxObj.get?.('tools');
+            }
+            catch { /* ignore */ }
+        }
+        const reg = toolsObj?.register;
+        if (!toolsObj || typeof reg !== 'function') {
+            traceToolReg('[ctxtool-reg] 全局注册跳过: 拿不到 tools 服务（ctx.tools 被拒 且 ctx.get("tools") 为空）');
+            return;
+        }
+        const g = globalThis;
+        if (Array.isArray(g.__qqbotCtxToolsGlobal) && g.__qqbotCtxToolsGlobal.length > 0)
+            return;
+        const ds = [];
+        for (const t of [...ctxToolsRef(), ...qunAdminRef()]) {
+            try {
+                const d = reg.call(toolsObj, t);
+                if (typeof d === 'function')
+                    ds.push(d);
+            }
+            catch { /* 单个失败不影响其它 */ }
+        }
+        g.__qqbotCtxToolsGlobal = ds;
+        traceToolReg(`[ctxtool-reg] 全局注册 ${ds.length} 件（永不注销；可见性改由 per-scope restrict 控制）`);
+    }
+    catch (e) {
+        traceToolReg('[ctxtool-reg] 全局注册异常: ' + String(e?.message ?? e).slice(0, 160));
+    }
+}
+/** 每个 agent 作用域当前的可见性状态（幂等用：状态没变就不动） */
+const ctxRestrictState = new WeakMap();
+/**
+ * 按会话**实时剪枝**三个上下文工具的可见性（2026-10-09，主人要的"实时变更"）。
+ *
+ * 语义：**开了「无上下文模式 + 智能判断」**的会话 → 看得见那三个工具；
+ * 否则该会话**连工具名都看不到**（模型清单里没有 = 零 token），而**注册表纹丝不动**。
+ * 面板一改开关 → 下一次 pre-step（下一回合/下一 step）即生效；撤销限制是立即的。
+ *
+ * 幂等：同一作用域状态没变化就直接 return，不重复设/撤 restriction（避免无谓的变更通知与抖动）。
+ */
+export function restrictContextTools(agentCtx, shouldHave, env) {
+    try {
+        if (!agentCtx || typeof agentCtx !== 'object')
+            return;
+        const key = agentCtx;
+        // 会话坐标每次都刷新（工具执行时靠它定位数据根/会话）
+        if (env && env.dataRoot) {
+            ctxEnvMap.set(key, { dataRoot: String(env.dataRoot), sessionKey: String(env.sessionKey ?? '') });
+        }
+        const st = ctxRestrictState.get(key);
+        if (st && st.shouldHave === shouldHave)
+            return; // ← 状态一致：不动（这是"不抖"的关键）
+        if (st?.dispose) {
+            try {
+                st.dispose();
+            }
+            catch { /* ignore */ }
+        }
+        const toolsObj = agentCtx.tools;
+        const restrict = toolsObj?.restrict;
+        let dispose;
+        if (!shouldHave && typeof restrict === 'function') {
+            try {
+                const d = restrict.call(toolsObj, { deny: [...CTX_TOOL_NAMES] });
+                if (typeof d === 'function')
+                    dispose = d;
+            }
+            catch (e) {
+                traceToolReg('[ctxtool-reg] restrict 失败: ' + String(e?.message ?? e).slice(0, 160));
+            }
+        }
+        ctxRestrictState.set(key, dispose ? { shouldHave, dispose } : { shouldHave });
+        traceToolReg(`[ctxtool-reg] ${shouldHave ? '放开(本会话继承全局三个工具)' : '剪枝(本会话看不到三个工具)'} dataRoot=${String(env?.dataRoot ?? '')} sk=${String(env?.sessionKey ?? '')}`);
+    }
+    catch (e) {
+        traceToolReg('[ctxtool-reg] 剪枝异常: ' + String(e?.message ?? e).slice(0, 160));
+    }
+}
 //# sourceMappingURL=channel-tools.js.map