@zaofan/dsh-qqbot 1.10.14 → 1.10.16

package/README.md

@@ -728,3 +728,28 @@ autoRecall:
 ## License
 
 [MIT](./LICENSE)
+
+---
+
+## 正文图组：markdown 图片直接发
+
+DSH 前端会把**回复正文里的 markdown 图片**渲染成图；本插件把同一段文本**原样转发到 QQ** ——
+本地路径会自动上传成 `qqbot-media` 引用（读文件头补真实宽高，配额满 100 张自动删最早），不需要调用任何工具。
+
+```markdown
+![干饭女王 #400px](D:/pics/a.jpg)
+
+第一幕：本鲸宣布今晚不睡了
+
+![何意味 #400px](D:/pics/b.jpg)
+```
+
+**一行一张、连续几行就是图组**（小剧场 / 分镜 / 图文并排），QQ 侧按顺序渲染成一屏。
+
+| DSH 前端 | QQ 群 |
+| :---: | :---: |
+| ![DSH 前端显示](docs/images/dsh-md-images.png) | ![QQ 群显示](docs/images/qq-md-images.jpg) |
+
+配合表情包库最顺手：`list_stickers` 搜到图 → 把本地路径写进正文 → 图组直接出来，比连发 `send_media` 更像翻漫画。
+
+失败策略：图传不上去时会**原样留在文字里**（不阻断本条，不会吞掉正文）。

package/dist/channel-tools.d.ts

@@ -111,13 +111,16 @@ export declare function syncContextTools(agentCtx: unknown, shouldHave: boolean,
 export declare function ensureExtToolsGlobal(globalCtx: unknown): void;
 export declare function ensureContextToolsGlobal(globalCtx: unknown): void;
 /**
- * 按会话**实时剪枝**三个上下文工具的可见性（2026-10-09，主人要的"实时变更"）。
+ * 按会话**实时剪枝**三个上下文工具的可见性（2026-10-09 起；2026-10-21 按 `dsh-computer-use` 的实测修）。
  *
  * 语义：**开了「无上下文模式 + 智能判断」**的会话 → 看得见那三个工具；
  * 否则该会话**连工具名都看不到**（模型清单里没有 = 零 token），而**注册表纹丝不动**。
- * 面板一改开关 → 下一次 pre-step（下一回合/下一 step）即生效；撤销限制是立即的。
+ * 面板一改开关 → 下一次 pre-step（下一回合 / 下一 step）即生效。
  *
- * 幂等：同一作用域状态没变化就直接 return，不重复设/撤 restriction（避免无谓的变更通知与抖动）。
+ * 2026-10-21 修两处（对齐 `dsh-plugins/dsh-computer-use/internal/schema-visibility.mjs`）：
+ *   ① `ctx.tools` 在未 inject 时会抛 ⇒ 必须退化到 `ctx.get('tools')`，否则"剪枝"整段被 catch 吞掉；
+ *   ② `restrict()` 的返回值是**函数**，释放必须走 {@link liftRestriction}。
+ * 幂等：同一作用域状态没变化就直接 return，不重复设/撤 restriction（避免无谓变更通知与抖动）。
  */
 export declare function restrictContextTools(agentCtx: unknown, shouldHave: boolean, env?: {
     dataRoot?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../src/channel-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../src/channel-tools.ts"],"names":[],"mappings":"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"}

package/dist/channel-tools.js

@@ -8,6 +8,8 @@
  * 复制进共享 node_modules，也不得在 dependencies 里自带 dsh-tools(避免双包)。
  */
 import { defineTool } from '@deepseek-ai/dsh-tools';
+import { uploadMarkdownImage, listMarkdownImages, deleteMarkdownImage } from './features/md-media.js';
+import { setMaterialTargetFactory } from './features/md-media-rewrite.js';
 import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
@@ -169,6 +171,19 @@ function findChannelByTag(tag) {
  * @param tag       人设 id（如 whale）
  * @param dataRoot  插件数据根（群台账在这里）
  */
+// 2026-10-21: 出站自动传图需要 groupAdmin 句柄；取**任一**桥（不依赖当前会话）
+setMaterialTargetFactory(() => {
+    try {
+        // 2026-10-21 修：channelBridges 实测是空的（同文件 204 行注释也写了），要用 managersOf()
+        for (const m of managersOf()) {
+            const cc = m.groupAdmin;
+            if (cc)
+                return { apiCall: cc.apiCall.bind(cc) };
+        }
+    }
+    catch { /* ignore */ }
+    return undefined;
+});
 function buildWorkspaceQqPack(tag, dataRoot) {
     const hit = findChannelByTag(tag);
     if (!hit)
@@ -290,9 +305,63 @@ function buildWorkspaceQqPack(tag, dataRoot) {
         },
         sendMarkdown: (scope, id, md) => (typeof sender?.sendMarkdown === 'function' && id ? Promise.resolve(sender.sendMarkdown(toTarget(scope, id), String(md))).then(() => true).catch(() => false) : Promise.resolve(false)),
         sendImage: (scope, id, src) => (typeof sender?.sendMedia === 'function' && id ? Promise.resolve(sender.sendMedia(toTarget(scope, id), 'image', src)).then(() => true).catch(() => false) : Promise.resolve(false)),
-        apiCall: typeof mgr?.groupAdmin?.apiCall === 'function'
-            ? (m, p, b) => mgr.groupAdmin.apiCall(m, p, b)
-            : undefined,
+        // 2026-10-22（主人定）：素材上传等本来**不需要群管理权限** —— 这里直接用机器人自己的
+        //   access_token 通道（与 api/group-admin.ts 同源），不再借 groupAdmin，也不依赖本实例是否启用群管理。
+        apiCall: (() => {
+            const cred = globalThis.__qqbotAppCred;
+            const appId = String(mgr?.config?.appId || cred?.appId || '');
+            const appSecret = String(mgr?.config?.appSecret || cred?.appSecret || '');
+            if (!appId || !appSecret)
+                return undefined;
+            const g = globalThis;
+            if (!g.__qqbotBotToken)
+                g.__qqbotBotToken = new Map();
+            const cache = g.__qqbotBotToken;
+            const token = async () => {
+                const hit = cache.get(appId);
+                if (hit && Date.now() < hit.at)
+                    return hit.t;
+                try {
+                    const res = await fetch('https://bots.qq.com/app/getAppAccessToken', {
+                        method: 'POST',
+                        headers: { 'content-type': 'application/json' },
+                        body: JSON.stringify({ appId, clientSecret: appSecret }),
+                    });
+                    const j = (await res.json());
+                    if (!j.access_token)
+                        return undefined;
+                    cache.set(appId, { t: j.access_token, at: Date.now() + ((j.expires_in ?? 7200) - 60) * 1000 });
+                    return j.access_token;
+                }
+                catch {
+                    return undefined;
+                }
+            };
+            return async (method, path, body) => {
+                const tk = await token();
+                if (!tk)
+                    return { ok: false, err: { code: 'no-token', human: '取不到 access_token（appId/appSecret 缺失或网络失败）' } };
+                try {
+                    const res = await fetch('https://api.sgroup.qq.com' + path, {
+                        method,
+                        headers: { Authorization: 'QQBot ' + tk, 'content-type': 'application/json' },
+                        body: body === undefined ? undefined : JSON.stringify(body),
+                    });
+                    const text = await res.text();
+                    let data = {};
+                    try {
+                        data = text ? JSON.parse(text) : {};
+                    }
+                    catch {
+                        data = { raw: text };
+                    }
+                    return { ok: res.ok, data, err: res.ok ? undefined : { code: res.status, human: text.slice(0, 200) } };
+                }
+                catch (e) {
+                    return { ok: false, err: { code: 'net', human: e?.message ?? String(e) } };
+                }
+            };
+        })(),
     };
 }
 /** 全局「智能判断」开关（由 session-manager 初始化时注入；照 setChannelBridge 同款做法） */
@@ -2336,6 +2405,91 @@ export async function apply(ctx) {
             }
         },
     });
+    /** 素材管理（2026-10-21 新接口 /v2/media-images/*：本地图 → qqbot-media:// 引用串） */
+    function anyAdminOf(exec) {
+        try {
+            const s = findSessionRec(channelOf(exec), exec);
+            const client = s?.ch?.manager?.groupAdmin;
+            const root = String(s?.ch?.manager?.config?.dataRoot ?? '');
+            if (client)
+                return { client, dataRoot: root };
+            for (const b of channelBridges) {
+                try {
+                    const c = b.manager.groupAdmin;
+                    if (c)
+                        return { client: c, dataRoot: String(b.manager.config?.dataRoot ?? '') };
+                }
+                catch { /* 跳过坏桥 */ }
+            }
+            return undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const materialTool = defineTool({
+        name: 'qq_material',
+        description: 'QQ 素材管理(Markdown 图片): 把**本地图片**传到 QQ 平台换 qqbot-media:// 引用串，可直接写进 markdown 消息（不再需要公网图床）。限制: 单张 ≤10MB、png/jpeg/gif/webp、单机器人最多 100 张、图片滑动过期 90 天(每次被引用顺延)。action=upload 传图 / list 看已传列表 / delete 删除释放配额。',
+        parameters: {
+            action: { type: 'string', enum: ['upload', 'list', 'delete'], description: '默认 upload' },
+            image: { type: 'string', description: 'upload: 本地图片绝对路径' },
+            image_id: { type: 'string', description: 'delete: 图片 ID（list 里能看到）' },
+            cursor: { type: 'string', description: 'list: 翻页游标（首页不传）' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                properties: { ok: { type: 'boolean' }, msg: { type: 'string' }, url: { type: 'string' }, markdown: { type: 'string' } },
+                additionalProperties: false,
+            },
+            render: (_a, v) => [{ type: 'text', text: String(v.msg || (v.ok ? 'ok' : '失败')) }],
+        },
+        execute: async (args, exec) => {
+            const mat = anyAdminOf(exec);
+            if (!mat)
+                return { ok: false, msg: '拿不到机器人实例（没有已连接的本）' };
+            const target = { apiCall: mat.client.apiCall.bind(mat.client) };
+            const action = String(args.action ?? 'upload').trim() || 'upload';
+            if (action === 'upload') {
+                const r = await uploadMarkdownImage(target, String(args.image ?? '').trim());
+                if (!r.ok)
+                    return { ok: false, msg: '上传失败: ' + String(r.msg || '') };
+                const name = String(args.image ?? '').split(/[\\/]/).pop() || 'image';
+                const dim = r.width && r.height ? ' #' + r.width + 'px #' + r.height + 'px' : '';
+                const markdown = '![' + name + dim + '](' + String(r.url) + ')';
+                const head = (r.cached ? '✅ 命中本地缓存，未重复上传' : '✅ 已上传')
+                    + '（' + Math.round((r.bytes ?? 0) / 1024) + 'KB'
+                    + (r.width ? '，' + r.width + '×' + r.height : '') + '）';
+                return { ok: true, url: String(r.url), markdown, msg: head + '\n' + markdown };
+            }
+            if (action === 'list') {
+                const r = await listMarkdownImages(target, String(args.cursor ?? ''));
+                if (!r.ok)
+                    return { ok: false, msg: '查询失败: ' + String(r.msg || '') };
+                const d = (r.data ?? {});
+                const list = Array.isArray(d.images) ? d.images : [];
+                const lines = list.slice(0, 20).map((x, i) => {
+                    const exp = x.expires_at ? ' | 到期 ' + new Date(Number(x.expires_at) * 1000).toISOString().slice(0, 10) : '';
+                    return i + 1 + '. ' + String(x.file_name || '?') + ' | ' + String(x.image_id || '') + exp;
+                });
+                const more = d.next_cursor ? '（还有下一页，cursor=' + d.next_cursor + '）' : '';
+                return {
+                    ok: true,
+                    msg: '共 ' + String(d.total ?? list.length) + ' 张' + more + (lines.length ? '\n' + lines.join('\n') : '\n（列表为空）'),
+                };
+            }
+            if (action === 'delete') {
+                const id = String(args.image_id ?? '').trim();
+                if (!id)
+                    return { ok: false, msg: 'delete 需要 image_id' };
+                const r = await deleteMarkdownImage(target, id);
+                return r.ok
+                    ? { ok: true, msg: '✅ 已删除 ' + id + '（配额已释放；已发出的消息不受影响）' }
+                    : { ok: false, msg: '删除失败: ' + String(r.msg || '') };
+            }
+            return { ok: false, msg: '未知 action: ' + action + '（可选 upload / list / delete）' };
+        },
+    });
     const recallBatchTool = defineTool({
         name: 'group_recall_batch',
         description: '群管理(写,危险): 批量撤回消息 + 可选批量禁言发送者。'
@@ -2760,6 +2914,7 @@ export async function apply(ctx) {
         { name: 'group_recall_batch', tool: recallBatchTool },
         { name: 'recall_keywords', tool: recallKeywordsTool },
         { name: 'group_kick', tool: kickMemberTool },
+        { name: 'qq_material', tool: materialTool },
         { name: 'id_lookup', tool: idLookupTool },
         { name: 'session_list', tool: sessionListTool },
         { name: 'session_wake', tool: sessionWakeTool },
@@ -3717,6 +3872,11 @@ export function ensureExtToolsGlobal(globalCtx) {
     })();
 }
 export function ensureContextToolsGlobal(globalCtx) {
+    // 2026-10-21 修（trace 实证）：restrict 报 "names unknown global tools" => 我们注册的层不是「全局层」。
+    //   cordis 的 ctx.root 才是根作用域；拿不到就退回传入值（行为不变）。
+    const rootOfGlobal = (globalCtx.root ?? globalCtx);
+    if (rootOfGlobal !== globalCtx)
+        traceToolReg('[ctxtool-reg] 用 root ctx 注册（不同于传入的 ctx）');
     try {
         if (!globalCtx || typeof globalCtx !== 'object')
             return;
@@ -3725,7 +3885,7 @@ export function ensureContextToolsGlobal(globalCtx) {
         //   表现就是"全局注册压根没发生"（trace 里只有别的报错、没有"全局注册 N 件"）。
         //   正解：**用 cordis 的运行时取服务 `ctx.get('tools')`**（不需要 inject 声明）——
         //   本插件别处也是这个姿势（见 ext-capabilities 给扩展工具的 kernel 文档：`ctx.get('tools')`）。
-        const ctxObj = globalCtx;
+        const ctxObj = rootOfGlobal;
         let toolsObj;
         try {
             toolsObj = ctxObj.tools;
@@ -3763,14 +3923,55 @@ export function ensureContextToolsGlobal(globalCtx) {
 }
 /** 每个 agent 作用域当前的可见性状态（幂等用：状态没变就不动） */
 const ctxRestrictState = new WeakMap();
+/** 释放 restriction 的唯一正确姿势（2026-10-21，抄 dsh-computer-use/internal/schema-visibility.mjs）：
+ *  cordis 的 `ctx.effect(fn)` 返回的是**函数**（`Disposable<T> = () => T`），
+ *  对函数调 `.dispose?.()` 会**静默变成空操作** —— 限制挂上去、再也没摘下来。
+ *  所以函数优先，`.dispose()` 只作兼容。
+ */
+function liftRestriction(disposable) {
+    if (typeof disposable === 'function') {
+        try {
+            disposable();
+        }
+        catch { /* ignore */ }
+        return;
+    }
+    const d = disposable;
+    if (d && typeof d.dispose === 'function') {
+        try {
+            d.dispose();
+        }
+        catch { /* ignore */ }
+    }
+}
+/** 取某作用域的 tools 服务：`ctx.tools` 在未声明 inject 时会抛，退化到 cordis 运行时 `ctx.get('tools')`。 */
+function toolsOfScope(agentCtx) {
+    const c = agentCtx;
+    try {
+        const t = c?.tools;
+        if (t && typeof t === 'object')
+            return t;
+    }
+    catch { /* 未 inject 时读 ctx.tools 会抛 */ }
+    try {
+        const t = c?.get?.('tools');
+        if (t && typeof t === 'object')
+            return t;
+    }
+    catch { /* ignore */ }
+    return undefined;
+}
 /**
- * 按会话**实时剪枝**三个上下文工具的可见性（2026-10-09，主人要的"实时变更"）。
+ * 按会话**实时剪枝**三个上下文工具的可见性（2026-10-09 起；2026-10-21 按 `dsh-computer-use` 的实测修）。
  *
  * 语义：**开了「无上下文模式 + 智能判断」**的会话 → 看得见那三个工具；
  * 否则该会话**连工具名都看不到**（模型清单里没有 = 零 token），而**注册表纹丝不动**。
- * 面板一改开关 → 下一次 pre-step（下一回合/下一 step）即生效；撤销限制是立即的。
+ * 面板一改开关 → 下一次 pre-step（下一回合 / 下一 step）即生效。
  *
- * 幂等：同一作用域状态没变化就直接 return，不重复设/撤 restriction（避免无谓的变更通知与抖动）。
+ * 2026-10-21 修两处（对齐 `dsh-plugins/dsh-computer-use/internal/schema-visibility.mjs`）：
+ *   ① `ctx.tools` 在未 inject 时会抛 ⇒ 必须退化到 `ctx.get('tools')`，否则"剪枝"整段被 catch 吞掉；
+ *   ② `restrict()` 的返回值是**函数**，释放必须走 {@link liftRestriction}。
+ * 幂等：同一作用域状态没变化就直接 return，不重复设/撤 restriction（避免无谓变更通知与抖动）。
  */
 export function restrictContextTools(agentCtx, shouldHave, env) {
     try {
@@ -3784,27 +3985,34 @@ export function restrictContextTools(agentCtx, shouldHave, env) {
         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;
+        if (st?.dispose)
+            liftRestriction(st.dispose);
         let dispose;
-        if (!shouldHave && typeof restrict === 'function') {
+        if (!shouldHave) {
+            const toolsObj = toolsOfScope(agentCtx);
+            const restrict = toolsObj?.restrict;
+            if (typeof restrict !== 'function') {
+                traceToolReg('[ctxtool-reg] 剪枝失败: 拿不到 tools.restrict（ctx.tools 与 ctx.get("tools") 都取不到）');
+                ctxRestrictState.set(key, { shouldHave });
+                return;
+            }
             try {
                 const d = restrict.call(toolsObj, { deny: [...CTX_TOOL_NAMES] });
                 if (typeof d === 'function')
                     dispose = d;
+                else if (d && typeof d.dispose === 'function') {
+                    const dd = d;
+                    dispose = () => { dd.dispose(); };
+                }
+                traceToolReg('[ctxtool-reg] 剪枝已挂 deny=' + CTX_TOOL_NAMES.join(',') + ' 返回形态=' + (typeof d));
             }
             catch (e) {
-                traceToolReg('[ctxtool-reg] restrict 失败: ' + String(e?.message ?? e).slice(0, 160));
+                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 ?? '')}`);
+        traceToolReg(`[ctxtool-reg] ${shouldHave ? '放开(本会话继承全局三个工具)' : '剪枝(本会话看不到三个工具)'}`
+            + ` dispose=${dispose ? '有' : '无'} dataRoot=${String(env?.dataRoot ?? '')} sk=${String(env?.sessionKey ?? '')}`);
     }
     catch (e) {
         traceToolReg('[ctxtool-reg] 剪枝异常: ' + String(e?.message ?? e).slice(0, 160));