@zaofan/dsh-qqbot 0.6.0

package/dist/index.js

@@ -0,0 +1,187 @@
+import { ConfigSchema, EditableConfigSchema } from './config.js';
+import { bootstrapGateway } from './gateway/index.js';
+import { getProfileDir, resolveEnv } from './shared/index.js';
+import { runQrSetup, persistCredentialsToProfile } from './setup.js';
+// ⚠️ @deepseek-ai/dsh-settings 的"注册 Web 可视化设置"入口在 harness 各版本间有差异：
+//   - rc.2 及更早：模块顶层具名导出 installSettingsSection(ctx, ns, schema, entry, hooks)
+//   - alpha / 0.1.2 线：改为 ctx.settings 服务，方法 installSection(ctx, ns, schema, entry, hooks)
+// 直接 `import { installSettingsSection } from '@deepseek-ai/dsh-settings'` 是"静态具名导入"，
+// 一旦运行库没有该具名导出，模块一加载就抛 SyntaxError，会拖垮整棵插件树（dsh 都起不来）。
+// 因此这里不静态导入，而在运行时动态探测两条路径，缺一条也能优雅降级（见 installLiveSettings）。
+// ── Cordis 插件元数据 ──
+export const name = 'im-qqbot';
+export const inject = ['agents'];
+export const Config = ConfigSchema;
+// ── 插件主体 ──
+export async function apply(ctx, config) {
+    const agents = ctx.agents;
+    const logger = ctx.logger ?? console;
+    console.log('[im-qqbot] apply() called');
+    // 多账号实例身份: settingsNs 承担"实例 id"(账号页保存时写入, 默认 im-qqbot=主账号)。
+    const ns = (config.settingsNs ?? '').trim() || 'im-qqbot';
+    const isMain = ns === 'im-qqbot';
+    let appId = resolveEnv(config.appId, 'QQBOT_APPID');
+    let appSecret = resolveEnv(config.appSecret, 'QQBOT_SECRET');
+    // ── 凭据缺失 ──
+    if (!appId || !appSecret) {
+        // 非主实例: 绝不触发扫码/env 覆写(防把凭据写进主账号或污染全局 env)——
+        // 去 Web「账号与预设」用"扫码绑定"或手动填好 appId/appSecret 后保存, 重启生效。
+        if (!isMain) {
+            logger.error(`实例 ${ns}: 未配置 appId/appSecret——请在 Web「账号与预设」为该账号完成扫码绑定或填写凭据后保存(重启生效), 本实例本次不启动。`);
+            return;
+        }
+        logger.info('凭据未配置，尝试扫码绑定...');
+        const credentials = await runQrSetup();
+        if (!credentials) {
+            logger.error('无法获取 QQ Bot 凭据，插件未启动');
+            return;
+        }
+        // 写入环境变量（供热更新后的下次 apply 或本次直接启动读取）
+        process.env.QQBOT_APPID = credentials.appId;
+        process.env.QQBOT_SECRET = credentials.appSecret;
+        appId = credentials.appId;
+        appSecret = credentials.appSecret;
+        // 持久化到 profile：成功则等待热更新重载，失败则用 env 凭据直接启动
+        const persisted = persistCredentialsToProfile(credentials, getProfileDir() ?? undefined, logger);
+        if (persisted) {
+            // 写入 cordis.patch.yml 会触发 dsh 热更新，自动重新加载本插件。
+            // 直接返回，避免与热更新产生竞态。
+            logger.info('配置已保存，等待热更新重新加载...');
+            return;
+        }
+        logger.warn('凭据未能持久化，本次进程将使用环境变量凭据启动（重启后需重新绑定）');
+    }
+    const resolvedConfig = { ...config, appId, appSecret };
+    // ── Web 可视化设置: 注册 im-qqbot settings 命名空间(可编辑子集, live 生效) ──
+    // 用户层存 ~/.dsh/settings.yaml; 变更经 watch 原地覆盖 resolvedConfig 对应字段,
+    // 下游消费点(middleware/inbound)每次读取 config → 热生效。settings 服务缺失则跳过(纯 yml 模式)。
+    try {
+        await installLiveSettings(ctx, resolvedConfig, logger, ns);
+    }
+    catch (err) {
+        logger.warn?.(`im-qqbot: settings 注册跳过: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // ── 设置面板 host 桥(单包自含, 原 dsh-qqbot-settings 独立包合并而来) ──
+    // 桥是标准 cordis 插件(需要 settings/webServer/agentPresets 服务, 仅 web profile 有);
+    // 这里用 ctx.plugin 动态装载, 服务缺失时 fail-soft(纯 yml/非 web 环境跳过, 不拖垮插件树)。
+    try {
+        const bridgeUrl = new URL('../settings-host.js', import.meta.url).href;
+        const bridgeMod = (await import(bridgeUrl));
+        if (bridgeMod && typeof bridgeMod.apply === 'function') {
+            ctx.plugin({ name: bridgeMod.name ?? 'qqbot-settings', inject: bridgeMod.inject, apply: bridgeMod.apply });
+            logger.info('[im-qqbot] settings host 桥已装载(单包)');
+        }
+        else {
+            logger.warn('[im-qqbot] settings-host.js 缺少 apply, 桥跳过');
+        }
+    }
+    catch (err) {
+        logger.warn?.(`im-qqbot: settings host 桥装载跳过: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    await bootstrapGateway(ctx, agents, resolvedConfig, logger);
+}
+/** 把 settings 用户层合并进 live 运行时配置(原地字段替换; schema 解析值含默认, 可整体覆盖) */
+async function installLiveSettings(ctx, live, logger, nsOverride) {
+    const ns = nsOverride || (live.settingsNs ?? '').trim() || 'im-qqbot';
+    const entry = {
+        behavior: live.behavior,
+        sticker: {
+            gates: live.sticker.gates,
+            autoTagEnabled: live.sticker.autoTagEnabled,
+            visionCli: live.sticker.visionCli,
+        },
+        injectRules: live.injectRules,
+        groupPrompt: live.groupPrompt,
+        schedule: live.schedule,
+        groupAdmin: live.groupAdmin,
+        enableApprovals: live.enableApprovals,
+        approvalTimeoutMs: live.approvalTimeoutMs,
+    };
+    let source = () => entry;
+    const sync = () => {
+        try {
+            const next = source();
+            if (!next)
+                return;
+            if (next.behavior)
+                live.behavior = next.behavior;
+            if (next.sticker)
+                live.sticker = { ...live.sticker, ...next.sticker };
+            if (Array.isArray(next.injectRules))
+                live.injectRules = next.injectRules;
+            if (typeof next.groupPrompt === 'string')
+                live.groupPrompt = next.groupPrompt;
+            if (next.schedule)
+                live.schedule = next.schedule;
+            if (next.groupAdmin)
+                live.groupAdmin = next.groupAdmin;
+            if (typeof next.enableApprovals === 'boolean')
+                live.enableApprovals = next.enableApprovals;
+            if (typeof next.approvalTimeoutMs === 'number')
+                live.approvalTimeoutMs = next.approvalTimeoutMs;
+            logger.info('[im-qqbot] 设置已同步(live): behavior/sticker/injectRules/groupPrompt/schedule/groupAdmin/approvals');
+        }
+        catch (err) {
+            logger.warn?.(`im-qqbot: 设置同步失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+    const hooks = {
+        setSource: (s) => { source = s; sync(); },
+        onChange: () => sync(),
+    };
+    const installed = await registerSettingsSection(ctx, ns, EditableConfigSchema, entry, hooks, logger);
+    if (installed) {
+        logger.info(`[im-qqbot:${ns}] settings 命名空间已注册 (${ns})`);
+    }
+}
+/**
+ * 版本自适应注册。两条路径语义等价：
+ *   1) 新版(alpha / dsh-settings 0.1.2 线): ctx.inject(['settings'], sc => sc.settings.installSection(ctx, ns, schema, entry, hooks))
+ *      —— 官方样板(dsh-bash-local 等): 服务经 cordis 声明式注入, 直读 ctx.settings / ctx.get 拿不到!
+ *   2) 旧版(rc.2): @deepseek-ai/dsh-settings 的 installSettingsSection(ctx, ns, schema, entry, hooks)
+ * 优先新版(harness 自带服务)；旧版包在时兜底；都不可用则返回 false(纯 yml 模式, 不中断插件)。
+ */
+async function registerSettingsSection(ctx, ns, schema, entry, hooks, logger) {
+    // 1) 新版: ctx.inject(['settings'], …) 声明式注入(官方用法)
+    const injectable = ctx;
+    if (typeof injectable.inject === 'function') {
+        try {
+            injectable.inject(['settings'], (settingsCtx) => {
+                try {
+                    const svc = settingsCtx.settings;
+                    if (svc && typeof svc.installSection === 'function') {
+                        svc.installSection(ctx, ns, schema, entry, hooks);
+                        logger.info(`[im-qqbot:${ns}] settings 命名空间已注册 (${ns})`);
+                        return;
+                    }
+                }
+                catch (err) {
+                    logger.warn?.(`im-qqbot: settings 注入注册失败: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                void legacyRegister(ctx, ns, schema, entry, hooks, logger);
+            });
+            // inject 回调若为同步执行且已尝试, 视为已处理; 无法探测是否成功, 交由回调日志确认。
+            return true;
+        }
+        catch { /* inject 不可用则走下方 legacy */ }
+    }
+    return legacyRegister(ctx, ns, schema, entry, hooks, logger);
+}
+/** 旧版 @deepseek-ai/dsh-settings 具名导出(运行时动态探测, 避免静态导入拖垮启动) */
+async function legacyRegister(ctx, ns, schema, entry, hooks, logger) {
+    try {
+        const mod = (await import('@deepseek-ai/dsh-settings'));
+        if (typeof mod.installSettingsSection === 'function') {
+            const brandedNs = typeof mod.settingsNamespace === 'function' ? mod.settingsNamespace(ns) : ns;
+            mod.installSettingsSection(ctx, brandedNs, schema, entry, hooks);
+            logger.info(`[im-qqbot:${ns}] settings 命名空间已注册(legacy) (${String(brandedNs)})`);
+            return true;
+        }
+    }
+    catch (err) {
+        logger.warn?.(`im-qqbot: 旧版 dsh-settings 探测失败: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    logger.warn?.('im-qqbot: 当前 harness 未暴露可用的 settings 注册 API，跳过可视化设置(仍可用纯 yml/补丁配置)。');
+    return false;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/middleware/attachment.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 附件下载中间件 — 在中间件链中下载 file 附件
+ *
+ * 结果写入 ctx.state.downloadedFiles，供 handleInbound 读取。
+ * 下载失败不阻断消息（记录告警后放行），确保附件异常不影响正常文本处理。
+ */
+import type { MiddlewareContext } from '@tencent-connect/qqbot-nodejs';
+import type { ImQQBotConfig } from '../config.js';
+import type { Logger } from '../types.js';
+export declare function attachmentProcessor(config: ImQQBotConfig, logger: Logger): (ctx: MiddlewareContext, next: () => Promise<void>) => Promise<void>;
+//# sourceMappingURL=attachment.d.ts.map

package/dist/middleware/attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/middleware/attachment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAEzD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,IACzD,KAAK,iBAAiB,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC,CAchF"}

package/dist/middleware/attachment.js

@@ -0,0 +1,17 @@
+import { downloadFileAttachments } from '../transport/attachment.js';
+export function attachmentProcessor(config, logger) {
+    return async (ctx, next) => {
+        const msg = ctx.message;
+        const cwd = config.cwd || process.cwd();
+        const messageId = msg.messageId ?? 'unknown';
+        try {
+            const downloaded = await downloadFileAttachments(msg.attachments, cwd, messageId, logger);
+            ctx.state.downloadedFiles = downloaded;
+        }
+        catch (err) {
+            logger.warn(`im-qqbot: attachment download failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=attachment.js.map

package/dist/middleware/attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../src/middleware/attachment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAIrE,MAAM,UAAU,mBAAmB,CAAC,MAAqB,EAAE,MAAc;IACvE,OAAO,KAAK,EAAE,GAAsB,EAAE,IAAyB,EAAiB,EAAE;QAChF,MAAM,GAAG,GAAG,GAAG,CAAC,OAAgE,CAAC;QACjF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC;QAE7C,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YAC1F,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,yCAAyC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3G,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/middleware/media-history.d.ts

@@ -0,0 +1,30 @@
+/**
+ * media-history.ts — 增强版群历史缓冲（媒体 URL 可见）
+ *
+ * 替换 SDK 的 historyBuffer：SDK 版记历史时只存文本 content，
+ * 图片消息 content 为空 → 历史里的图对 AI 不可见（看不到图片链接）。
+ * 本中间件在记录时把带 URL 的附件折叠成 "[图片: <url>]" 等文本并入 content，
+ * 让冷却派发 / 下次 @ 打包群历史时，图片/媒体链接也进 AI 上下文。
+ *
+ * ⚠️ 本地手改功能（SDK 无此能力，重编译/换回 SDK 原版会丢）：
+ *    维护清单见工作区根《插件改动维护注意事项.md》。
+ */
+import type { Middleware, MiddlewareContext } from '@tencent-connect/qqbot-nodejs';
+import type { HistoryStore } from '@tencent-connect/qqbot-nodejs';
+export interface MediaHistoryOptions {
+    /** 每群保留的最大条数 */
+    limit: number;
+    /** 存储后端（共享单例，供回复后清空） */
+    store: HistoryStore;
+    /** 上游 stop 后仍记录（捕获未 @ 的闲聊） */
+    recordOnSkip: boolean;
+    /** 群 key 推导（带 appId 前缀） */
+    groupKey: (ctx: MiddlewareContext) => string | undefined;
+}
+/**
+ * 构建增强版群历史缓冲中间件（API 对齐 SDK historyBuffer）：
+ *   1. 把当前群消息(媒体 URL 折叠进 content)记入 store（去重按 messageId）；
+ *   2. 向下游暴露 ctx.state.history = 已缓冲历史（不含当前消息，旧→新）。
+ */
+export declare function mediaHistoryBuffer(options: MediaHistoryOptions): Middleware;
+//# sourceMappingURL=media-history.d.ts.map

package/dist/middleware/media-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-history.d.ts","sourceRoot":"","sources":["../../src/middleware/media-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IAClC,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,MAAM,GAAG,SAAS,CAAC;CAC1D;AAwBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,CA4B3E"}

package/dist/middleware/media-history.js

@@ -0,0 +1,54 @@
+/** 文本 + 带 URL 附件折叠为一行段（语音 URL 对纯文本模型无意义，跳过） */
+function foldMedia(msg) {
+    const parts = [];
+    const text = (msg.content ?? '').trim();
+    if (text)
+        parts.push(text);
+    for (const att of msg.attachments ?? []) {
+        if (!att.url)
+            continue;
+        if (att.content_type === 'voice')
+            continue; // 无 ASR 时链接无意义，避免刷屏
+        const label = att.content_type === 'image' ? '图片'
+            : att.content_type === 'video' ? '视频'
+                : att.content_type === 'file' ? '文件' : '附件';
+        parts.push(`[${label}: ${att.url}]`);
+    }
+    return parts.join('\n');
+}
+/**
+ * 构建增强版群历史缓冲中间件（API 对齐 SDK historyBuffer）：
+ *   1. 把当前群消息(媒体 URL 折叠进 content)记入 store（去重按 messageId）；
+ *   2. 向下游暴露 ctx.state.history = 已缓冲历史（不含当前消息，旧→新）。
+ */
+export function mediaHistoryBuffer(options) {
+    const { limit, store, recordOnSkip, groupKey } = options;
+    return async (ctx, next) => {
+        const key = groupKey(ctx);
+        if (!key) {
+            await next();
+            return;
+        }
+        const buffered = await store.list(key, limit);
+        ctx.state.history = buffered;
+        const raw = ctx.message;
+        const entry = {
+            senderId: ctx.message.senderId,
+            senderName: ctx.message.senderName,
+            content: foldMedia(raw),
+            timestamp: Date.parse(ctx.message.timestamp) || Date.now(),
+            messageId: ctx.message.messageId,
+        };
+        try {
+            await store.append(key, entry, limit);
+        }
+        catch (err) {
+            ctx.log.error?.(`[media-history] append failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (ctx.stopped && !recordOnSkip) {
+            return;
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=media-history.js.map

package/dist/middleware/media-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-history.js","sourceRoot":"","sources":["../../src/middleware/media-history.ts"],"names":[],"mappings":"AA+BA,+CAA+C;AAC/C,SAAS,SAAS,CAAC,GAAgB;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,GAAG;YAAE,SAAS;QACvB,IAAI,GAAG,CAAC,YAAY,KAAK,OAAO;YAAE,SAAS,CAAC,oBAAoB;QAChE,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI;YAC/C,CAAC,CAAC,GAAG,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI;gBACnC,CAAC,CAAC,GAAG,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACzD,OAAO,KAAK,EAAE,GAAsB,EAAE,IAAyB,EAAE,EAAE;QACjE,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9C,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,OAAiC,CAAC;QAClD,MAAM,KAAK,GAAiB;YAC1B,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ;YAC9B,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU;YAClC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC;YACvB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE;YAC1D,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS;SACjC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxG,CAAC;QACD,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/middleware/sticker-capture.d.ts

@@ -0,0 +1,17 @@
+/**
+ * sticker-capture.ts — 表情包自动收藏中间件（P0）
+ *
+ * 群消息里的图片 → fire-and-forget 收藏进本地表情包库（下载/去重/落盘在 sticker-store）。
+ *
+ * ⚠️ 时机关键：收藏调度必须放在 `await next()` 之前——
+ * 未@机器人的群消息会在下游被 mentionGate 截断(链不走到结尾)，
+ * 若收藏放在 next() 之后(finally)就永远不触发(线上已踩坑)。
+ * 下载本身 fire-and-forget 不 await，不拖慢主链。
+ *
+ * ⚠️ 本地手改功能（fork 新增）：维护清单见工作区根《插件改动维护注意事项.md》。
+ */
+import type { MiddlewareContext } from '@tencent-connect/qqbot-nodejs';
+import type { ImQQBotConfig } from '../config.js';
+import type { Logger } from '../types.js';
+export declare function stickerCapture(config: ImQQBotConfig, logger: Logger): (ctx: MiddlewareContext, next: () => Promise<void>) => Promise<void>;
+//# sourceMappingURL=sticker-capture.d.ts.map

package/dist/middleware/sticker-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticker-capture.d.ts","sourceRoot":"","sources":["../../src/middleware/sticker-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AA6EzD,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,IACpD,KAAK,iBAAiB,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC,CAiBhF"}

package/dist/middleware/sticker-capture.js

@@ -0,0 +1,97 @@
+import { join } from 'node:path';
+import { getStickerStore } from '../features/sticker-store.js';
+import { autoTagImage } from '../features/sticker-tagger.js';
+/** 同进程并发下载上限，防止群图轰炸时打爆连接 */
+let inflight = 0;
+const MAX_INFLIGHT = 2;
+/** 图片 URL 是否可收藏（仅 https + 看似 QQ 图片下载链接） */
+function isCollectableImage(url) {
+    return !!url && /^https:\/\//i.test(url) && /multimedia|qq\.com|download/i.test(url);
+}
+/**
+ * 类型粗筛：SDK 的 content_type 是 MIME(如 image/jpeg —— 已实测不是 'image')。
+ * 明确非图片(音/视频)的排除；未知/缺失交给 store 的魔数校验兜底(非图不入库)。
+ */
+function isNonImageContentType(ct) {
+    if (!ct)
+        return false;
+    const t = ct.toLowerCase();
+    return t.startsWith('audio/') || t.startsWith('video/') || t === 'voice';
+}
+/** 调度一次收藏（fire-and-forget，不阻塞调用方） */
+function scheduleCapture(url, contentType, ctx, config, logger) {
+    if (inflight >= MAX_INFLIGHT)
+        return;
+    inflight += 1;
+    const msg = ctx.message;
+    const dataDir = config.sticker.dataDir || join(config.cwd || process.cwd(), '表情包');
+    const store = getStickerStore(dataDir, logger);
+    const senderId = msg.senderId;
+    const senderName = msg.senderName;
+    const sourceGroup = ctx.message.kind === 'group' ? msg.groupOpenid : undefined;
+    const msgText = (msg.content ?? '').trim().slice(0, 120) || undefined;
+    void (async () => {
+        try {
+            const r = await store.capture(url, { sourceGroup, senderId, senderName, msgText, sourceUrl: url }, contentType);
+            if (r.status === 'new' && r.id) {
+                logger.info(`[sticker] captured #${r.id} (${url.slice(0, 60)}…)`);
+                // 候选区软上限: 超 300 张时最久未用的滚进回收站(防膨胀; 数值后续可设置化)
+                try {
+                    store.cleanupCandidates(300);
+                }
+                catch { /* ignore */ }
+                // 顺带物理清掉超 30 天的回收站条目
+                try {
+                    store.purgeTrashed();
+                }
+                catch { /* ignore */ }
+                // 后台自动打标(可配视觉CLI 生成 tags+desc; 无可用引擎则保持 needsDescribe 待 agent 视觉补)
+                try {
+                    if (config.sticker.autoTagEnabled !== false) {
+                        const p = store.pathOf(r.id);
+                        if (p) {
+                            const tag = await autoTagImage(p, config.sticker.visionCli ?? '', logger);
+                            if (tag) {
+                                store.setDescTags(r.id, tag.tags, tag.desc);
+                                logger.info(`[sticker] 自动打标 #${r.id}: tags=${tag.tags.join('/') || '(启发)'} desc=${tag.desc.slice(0, 40)}…`);
+                            }
+                        }
+                    }
+                }
+                catch (err) {
+                    logger.debug(`[sticker] autotag error: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            else if (r.status === 'error') {
+                logger.debug(`[sticker] capture failed: ${r.error}`);
+            }
+        }
+        catch (err) {
+            logger.debug(`[sticker] capture error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            inflight -= 1;
+        }
+    })();
+}
+export function stickerCapture(config, logger) {
+    return async (ctx, next) => {
+        // 先调度收藏（不等待下载），再走主链 —— 保证被后续截断(未@被门控吞)也照样收藏
+        if (config.sticker.collectEnabled) {
+            try {
+                const msg = ctx.message;
+                // content_type 是 MIME(image/jpeg 等)，不能 == 'image'（踩坑修正）
+                const images = (msg.attachments ?? [])
+                    .filter(a => isCollectableImage(a.url) && !isNonImageContentType(a.content_type));
+                for (const img of images.slice(0, 3)) {
+                    scheduleCapture(img.url, img.content_type, ctx, config, logger);
+                }
+            }
+            catch {
+                // 收藏调度失败不影响主链
+            }
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=sticker-capture.js.map

package/dist/middleware/sticker-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticker-capture.js","sourceRoot":"","sources":["../../src/middleware/sticker-capture.ts"],"names":[],"mappings":"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"}

package/dist/model/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 模型路由层
+ *
+ * 统一的模型发现、路由解析、per-peer 偏好管理。
+ */
+export { ModelResolver } from './model-resolver.js';
+export { PrefsStore } from './prefs-store.js';
+export { SettingsReader } from './settings-reader.js';
+export type { ModelRoute, ModelEntry } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/model/index.js

@@ -0,0 +1,9 @@
+/**
+ * 模型路由层
+ *
+ * 统一的模型发现、路由解析、per-peer 偏好管理。
+ */
+export { ModelResolver } from './model-resolver.js';
+export { PrefsStore } from './prefs-store.js';
+export { SettingsReader } from './settings-reader.js';
+//# sourceMappingURL=index.js.map

package/dist/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/model/model-resolver.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ModelResolver — 统一的模型发现与路由解析
+ *
+ * 职责：
+ *   1. 解析当前生效的默认模型路由
+ *   2. 列出可用 providers 和模型
+ *   3. 管理 per-peer 的模型偏好（委托 PrefsStore）
+ *
+ * 优先级（从高到低）：
+ *   per-peer 偏好（~/.dsh-qqbot/model-prefs.json）
+ *   > config 显式指定（cordis.yml 的 provider/model）
+ *   > settings.yaml 的 agent-default-model（只读，作为默认兜底）
+ *   > 宿主 agentDefaultModel 服务
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ImQQBotConfig } from '../config.js';
+import type { Logger } from '../types.js';
+import type { ModelRoute, ModelEntry } from './types.js';
+export declare class ModelResolver {
+    private readonly ctx;
+    private readonly config;
+    private readonly logger?;
+    private readonly prefs;
+    private readonly settings;
+    constructor(ctx: Context, config: ImQQBotConfig, logger?: Logger | undefined);
+    /**
+     * 获取指定 sessionKey 的有效模型路由（create 用）
+     *
+     * 优先级：per-peer 偏好 > config 显式指定 > settings.yaml > 宿主服务
+     */
+    getEffectiveRoute(sessionKey: string): ModelRoute | undefined;
+    /**
+     * 获取 resume 时覆盖 session 的模型路由
+     *
+     * 优先级：per-peer 偏好 > cordis.yml 显式配置 > 默认链（settings.yaml > host）
+     *
+     * 注意：不能像 dsh-TUI 那样返回 undefined 让 session 沿用 requestHeader。
+     * dsh-TUI 靠 installModelSelection 从 session.requestHeader 恢复 {{model}}，
+     * 而我们未装 installModelSelection，system-prompt 的 {{model}} 变量直接读
+     * agent.options.model（agent-loop index.ts:352）——若无值会抛
+     * "prompt variable {{model}} has no value for this assembly"。
+     * 因此这里兜底到默认链，确保 agent.options.model 始终有值。
+     */
+    getResumeRoute(sessionKey: string): ModelRoute | undefined;
+    /**
+     * 设置 per-peer 模型偏好并持久化到隔离文件
+     */
+    setOverride(sessionKey: string, route: ModelRoute): void;
+    /**
+     * 清除 per-peer 模型偏好并持久化
+     */
+    clearOverride(sessionKey: string): void;
+    /**
+     * 是否存在指定 session 的模型偏好
+     */
+    hasOverride(sessionKey: string): boolean;
+    /**
+     * 获取指定 sessionKey 的最新 sessionId（fork 后记录，重启恢复用）
+     */
+    getSessionId(sessionKey: string): string | undefined;
+    /**
+     * 记录指定 sessionKey 的最新 sessionId（fork 后调用）并持久化
+     */
+    setSessionId(sessionKey: string, sessionId: string): void;
+    /**
+     * 清除指定 sessionKey 的 sessionId 记录
+     */
+    clearSessionId(sessionKey: string): void;
+    /**
+     * 解析默认模型路由（不含 per-peer 偏好）
+     *
+     * 优先级：config 显式指定 > settings.yaml（只读） > 宿主 agentDefaultModel
+     * 最终兜底 deepseek-official/deepseek-v4-flash，确保 {{model}} 变量始终有值。
+     */
+    resolveDefault(): ModelRoute;
+    /**
+     * 列出所有可用模型
+     */
+    listModels(): ModelEntry[];
+    /**
+     * 列出可用 provider 名称
+     */
+    listProviders(): string[];
+    private readFromHost;
+    /** 统一的 Cordis 服务访问 */
+    private getService;
+}
+//# sourceMappingURL=model-resolver.d.ts.map

package/dist/model/model-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/model/model-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIzD,qBAAa,aAAa;IAKtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAN1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAGvB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,MAAM,YAAA;IAQlC;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI7D;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAW1D;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAIxD;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpD;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIzD;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC;;;;;OAKG;IACH,cAAc,IAAI,UAAU;IAc5B;;OAEG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAuBzB,OAAO,CAAC,YAAY;IAoBpB,sBAAsB;IACtB,OAAO,CAAC,UAAU;CAKnB"}