@tencent-connect/dsh-qqbot 0.4.0 → 0.5.0

package/dist/media/vision-tool.js

@@ -0,0 +1,241 @@
+/**
+ * 内置 qqbot_describe_image 视觉工具。
+ *
+ * 复用 dsh 生态的 llm + attachments 服务：
+ *   1. 加载图片（本地绝对路径 / http URL）→ magic bytes 嗅探 mediaType
+ *   2. attachments.saveImage → ImageAttachmentRef（字节不进 session log）
+ *   3. createUserMessage(ImageBlock + text) → llm.stream → BlockAssembler 收集文本
+ *
+ * 手写 ToolDefinition（标准 JSON Schema），避免引入 dsh-tools 的 8 个 peer 依赖。
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, join, resolve } from 'node:path';
+import yaml from 'js-yaml';
+import { BlockAssembler, createUserMessage } from '@deepseek-ai/dsh-llm';
+/** 工具名（qqbot 前缀避免与外部 describe-image 包的同名工具冲突） */
+export const DESCRIBE_IMAGE_TOOL_NAME = 'qqbot_describe_image';
+const DESCRIPTION = 'Inspect one image and return the text the user needs. The image is a local absolute path '
+    + '(downloaded by the QQ bot) or an http(s) URL. Use this when the user references an image, '
+    + 'or when a task needs OCR, chart/diagram reading, screenshot or UI analysis, translation of '
+    + 'image text, or photo understanding. Always pass an explicit `prompt` with a precise '
+    + 'instruction (e.g. "transcribe all text", "extract the table as CSV", "translate the text '
+    + 'into Chinese") instead of relying on the generic default.';
+/** 图片 magic bytes 嗅探 → 标准 MIME（不信声明，安全底线） */
+function sniffImageMediaType(bytes) {
+    if (bytes.length < 12)
+        return null;
+    // PNG: 89 50 4E 47
+    if (bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47)
+        return 'image/png';
+    // JPEG: FF D8 FF
+    if (bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return 'image/jpeg';
+    // GIF: 47 49 46 38
+    if (bytes[0] === 0x47 && bytes[1] === 0x49 && bytes[2] === 0x46 && bytes[3] === 0x38)
+        return 'image/gif';
+    // WEBP: 52 49 46 46 .. 57 45 42 50
+    if (bytes[0] === 0x52 && bytes[1] === 0x49 && bytes[2] === 0x46 && bytes[3] === 0x46
+        && bytes[8] === 0x57 && bytes[9] === 0x45 && bytes[10] === 0x42 && bytes[11] === 0x50)
+        return 'image/webp';
+    return null;
+}
+/** 加载图片字节（本地路径 / http URL），校验大小 + 嗅探 MIME */
+async function loadImageBytes(image, maxBytes, signal) {
+    let data;
+    if (/^https?:\/\//i.test(image)) {
+        const resp = await fetch(image, { signal, redirect: 'error' });
+        if (!resp.ok)
+            throw new Error(`qqbot_describe_image: download failed (HTTP ${resp.status})`);
+        const buf = Buffer.from(await resp.arrayBuffer());
+        if (buf.length > maxBytes)
+            throw new Error(`qqbot_describe_image: image too large (${buf.length} bytes)`);
+        data = new Uint8Array(buf);
+    }
+    else {
+        const info = await stat(image).catch(() => null);
+        if (!info?.isFile())
+            throw new Error(`qqbot_describe_image: image file not found: ${image}`);
+        if (info.size > maxBytes)
+            throw new Error(`qqbot_describe_image: image too large (${info.size} bytes)`);
+        data = new Uint8Array(await readFile(image));
+    }
+    const mediaType = sniffImageMediaType(data);
+    if (mediaType === null)
+        throw new Error('qqbot_describe_image: unrecognized image format (png/jpeg/gif/webp only)');
+    return { data, mediaType };
+}
+/** 将终端 finish reason 转成辅助调用失败 */
+function finishError(finish) {
+    switch (finish.kind) {
+        case 'error':
+        case 'aborted':
+            return new Error(finish.failure.message);
+        default:
+            return undefined;
+    }
+}
+/** 调视觉模型描述图片，返回纯文本 */
+async function callVision(llm, vision, prompt, imageRef, signal) {
+    const message = createUserMessage({
+        content: [
+            { type: 'image', attachment: imageRef },
+            { type: 'text', text: prompt },
+        ],
+        source: { kind: 'plugin', plugin: 'dsh-im-qqbot' },
+    });
+    const options = {
+        provider: vision.provider,
+        model: vision.model,
+        messages: [message],
+        maxTokens: vision.maxTokens,
+        signal,
+    };
+    const assembler = new BlockAssembler();
+    for await (const chunk of llm.stream(options)) {
+        assembler.push(chunk);
+    }
+    const terminalError = finishError(assembler.finish);
+    if (terminalError !== undefined)
+        throw terminalError;
+    const text = assembler.blocks()
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join(' ')
+        .trim();
+    if (text.length === 0)
+        throw new Error('qqbot_describe_image: vision model returned no text');
+    return text;
+}
+/** 展开 `~`/`~/`/`~\` 前缀 */
+function expandHomePath(path) {
+    if (path === '~')
+        return homedir();
+    if (path.startsWith('~/') || path.startsWith('~\\'))
+        return join(homedir(), path.slice(2));
+    return path;
+}
+/**
+ * 解析 DSH_HOME 的优先级与跨平台处理：
+ * 显式配置 > `$DSH_HOME`（空/空白视为未设置）> `~/.dsh`，展开 `~` 后 resolve 为绝对路径。
+ */
+function resolveDshHome() {
+    const fromEnv = process.env.DSH_HOME;
+    const selected = fromEnv !== undefined && fromEnv.trim().length > 0
+        ? fromEnv
+        : join(homedir(), '.dsh');
+    return resolve(expandHomePath(selected));
+}
+/**
+ * 启动时检查 settings.yaml 里 vision 模型的 input 模态是否声明了 image。
+ *
+ * 模型配置界面不暴露 `input` 字段，用户通过界面配置的视觉模型默认是纯文本，
+ * 会导致 pi-ai adapter 拒绝图片输入。这里在启动时兜底：未声明 image 时自动补 `[text, image]`。
+ * 幂等（已声明则跳过），解析/写入失败仅 warn 不阻断启动。
+ */
+export function ensureVisionInputModal(vision, logger) {
+    if (!vision.enabled || !vision.provider || !vision.model)
+        return;
+    const settingsPath = resolve(resolveDshHome(), 'settings.yaml');
+    try {
+        if (!existsSync(settingsPath))
+            return;
+        // YAML 禁止 tab 缩进（配置界面/编辑器可能写入），读入时把行首 tab 规范化为空格
+        const raw = readFileSync(settingsPath, 'utf8');
+        const normalized = raw.replace(/^\t+/gm, (tabs) => '  '.repeat(tabs.length));
+        const doc = yaml.load(normalized);
+        if (doc === null || typeof doc !== 'object')
+            return;
+        const piAi = doc['llm-pi-ai'];
+        const provider = piAi?.providers?.[vision.provider];
+        const models = provider?.models;
+        if (!Array.isArray(models)) {
+            logger.warn(`im-qqbot: settings.yaml 未找到 llm-pi-ai.providers.${vision.provider}.models，请手动确认 vision 模型已声明 image 输入`);
+            return;
+        }
+        const model = models.find((m) => typeof m === 'object' && m !== null && m.id === vision.model);
+        if (model === undefined) {
+            logger.warn(`im-qqbot: settings.yaml 未找到 vision 模型 ${vision.model}，请手动确认已声明 image 输入`);
+            return;
+        }
+        const input = model.input;
+        if (Array.isArray(input) && input.includes('image'))
+            return; // 已声明，幂等跳过
+        model.input = ['text', 'image'];
+        writeFileSync(settingsPath, yaml.dump(doc), 'utf8');
+        logger.info(`im-qqbot: 已为 vision 模型补充 input: [text, image] (${vision.provider}/${vision.model})`);
+    }
+    catch (err) {
+        logger.warn(`im-qqbot: 检查 settings.yaml vision input 失败: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** 注册 qqbot_describe_image 工具（服务缺失时优雅降级，不阻断插件启动） */
+export function registerDescribeImageTool(ctx, vision, logger) {
+    if (!vision.enabled)
+        return;
+    if (!vision.provider || !vision.model) {
+        logger.warn('im-qqbot: vision.provider/model 未配置，qqbot_describe_image 工具未注册');
+        return;
+    }
+    const tools = ctx.get('tools');
+    const llm = ctx.get('llm');
+    const attachments = ctx.get('attachments');
+    if (!tools?.register || !llm?.stream || !attachments?.saveImage) {
+        logger.warn('im-qqbot: tools/llm/attachments 服务不可用，qqbot_describe_image 工具未注册');
+        return;
+    }
+    const definition = {
+        name: DESCRIBE_IMAGE_TOOL_NAME,
+        description: DESCRIPTION,
+        parameters: {
+            type: 'object',
+            properties: {
+                image: {
+                    type: 'string',
+                    description: 'Absolute path to a local image file, or an http(s) URL of the image.',
+                },
+                prompt: {
+                    type: 'string',
+                    description: 'Your precise instruction for the vision model about this image.',
+                },
+            },
+            required: ['image'],
+            additionalProperties: false,
+        },
+        output: {
+            schema: {
+                type: 'object',
+                properties: {
+                    text: { type: 'string' },
+                    model: { type: 'string' },
+                    image: { type: 'string' },
+                    mimeType: { type: 'string', enum: ['image/png', 'image/jpeg', 'image/gif', 'image/webp'] },
+                    bytes: { type: 'integer' },
+                },
+                required: ['text', 'model', 'image', 'mimeType', 'bytes'],
+                additionalProperties: false,
+            },
+            render: (_args, value) => [
+                { type: 'text', text: value.text },
+            ],
+        },
+        async execute(args, exec) {
+            const { image, prompt } = args;
+            if (typeof image !== 'string' || image.length === 0) {
+                throw new Error('qqbot_describe_image: `image` must be a non-empty string');
+            }
+            const loaded = await loadImageBytes(image, vision.maxBytes, exec.signal);
+            const ref = await attachments.saveImage({
+                data: loaded.data,
+                mediaType: loaded.mediaType,
+                name: /^https?:\/\//i.test(image) ? undefined : basename(image),
+            });
+            const text = await callVision(llm, vision, prompt ?? vision.defaultPrompt, ref, exec.signal);
+            return { text, model: vision.model, image, mimeType: loaded.mediaType, bytes: loaded.data.length };
+        },
+    };
+    tools.register(definition);
+    logger.info(`im-qqbot: qqbot_describe_image 工具已注册 (provider=${vision.provider} model=${vision.model})`);
+}
+//# sourceMappingURL=vision-tool.js.map

package/dist/media/vision-tool.js.map

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

package/dist/middleware/attachment.d.ts

@@ -1,11 +1,11 @@
 /**
- * 附件下载中间件 — 在中间件链中下载 file 附件
+ * 富媒体下载中间件 — 在中间件链中下载 image/video/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';
+import type { ImQQBotConfig } from '../config.ts';
+import type { Logger } from '../types.ts';
 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

@@ -1 +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"}
+{"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,EAAmC,MAAM,aAAa,CAAC;AAE3E,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,CA4BhF"}

package/dist/middleware/attachment.js

@@ -1,12 +1,25 @@
-import { downloadFileAttachments } from '../transport/attachment.js';
+import { downloadMediaAttachments } 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);
+            // 当前消息附件
+            const downloaded = await downloadMediaAttachments(msg.attachments, config.media, logger);
             ctx.state.downloadedFiles = downloaded;
+            // 引用消息附件：转成 RawAttachment 结构复用下载（voice 由 downloadMediaAttachments 自动跳过）
+            const quoteAttachments = ctx.state.quote?.attachments;
+            if (quoteAttachments && quoteAttachments.length > 0) {
+                const rawQuote = quoteAttachments
+                    .filter(a => a.url)
+                    .map((a) => ({
+                    content_type: a.contentType ?? '',
+                    filename: a.filename ?? '',
+                    size: 0,
+                    url: a.url,
+                }));
+                const downloadedQuote = await downloadMediaAttachments(rawQuote, config.media, logger);
+                ctx.state.downloadedQuoteFiles = downloadedQuote;
+            }
         }
         catch (err) {
             logger.warn(`im-qqbot: attachment download failed: ${err instanceof Error ? err.message : String(err)}`);

package/dist/middleware/attachment.js.map

@@ -1 +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"}
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../src/middleware/attachment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAItE,MAAM,UAAU,mBAAmB,CAAC,MAAqB,EAAE,MAAc;IACvE,OAAO,KAAK,EAAE,GAAsB,EAAE,IAAyB,EAAiB,EAAE;QAChF,MAAM,GAAG,GAAG,GAAG,CAAC,OAA4C,CAAC;QAE7D,IAAI,CAAC;YACH,SAAS;YACT,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACzF,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC;YAEvC,wEAAwE;YACxE,MAAM,gBAAgB,GAAI,GAAG,CAAC,KAA0D,CAAC,KAAK,EAAE,WAAW,CAAC;YAC5G,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpD,MAAM,QAAQ,GAAG,gBAAgB;qBAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;qBAClB,GAAG,CAAC,CAAC,CAAC,EAAiB,EAAE,CAAC,CAAC;oBAC1B,YAAY,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;oBACjC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;oBAC1B,IAAI,EAAE,CAAC;oBACP,GAAG,EAAE,CAAC,CAAC,GAAa;iBACrB,CAAC,CAAC,CAAC;gBACN,MAAM,eAAe,GAAG,MAAM,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACvF,GAAG,CAAC,KAAK,CAAC,oBAAoB,GAAG,eAAe,CAAC;YACnD,CAAC;QACH,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/question-answer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 待答问题截获中间件 — 在中间件链中截获 ask_user_question 的答案
+ *
+ * 必须放在 concurrencyGuard 之前：答案消息需绕过并发守卫的 merge 缓冲，
+ * 否则会被排队而无法到达 tryAnswer，导致「turn 等答案 ↔ 答案被缓冲」死锁。
+ */
+import type { MiddlewareContext } from '@tencent-connect/qqbot-nodejs';
+import type { SessionManager } from '../session/index.ts';
+export declare function questionAnswer(manager: SessionManager): (ctx: MiddlewareContext, next: () => Promise<void>) => Promise<void>;
+//# sourceMappingURL=question-answer.d.ts.map

package/dist/middleware/question-answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-answer.d.ts","sourceRoot":"","sources":["../../src/middleware/question-answer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,IACtC,KAAK,iBAAiB,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC,CAehF"}

package/dist/middleware/question-answer.js

@@ -0,0 +1,19 @@
+import { cacheMsgId } from "../transport/msgid-cache.js";
+export function questionAnswer(manager) {
+    return async (ctx, next) => {
+        const questionChannel = manager.questionChannel;
+        if (!questionChannel) {
+            await next();
+            return;
+        }
+        if (questionChannel.tryAnswer(ctx.replyTarget.scope, ctx.replyTarget.targetId, ctx.message.content.trim())) {
+            // 答案消息被截获（不再走到 bot.on('message')），在此补录其 msgId，
+            // 供被动回复超限时切换到缓存的最近 msgId。
+            cacheMsgId(ctx.replyTarget.scope, ctx.replyTarget.targetId, ctx.replyTarget.msgId);
+            ctx.stop('question-answer');
+            return;
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=question-answer.js.map

package/dist/middleware/question-answer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-answer.js","sourceRoot":"","sources":["../../src/middleware/question-answer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,KAAK,EAAE,GAAsB,EAAE,IAAyB,EAAiB,EAAE;QAChF,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAChD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,IAAI,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3G,+CAA+C;YAC/C,0BAA0B;YAC1B,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACnF,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/model/index.d.ts

@@ -3,8 +3,8 @@
  *
  * 统一的模型发现、路由解析、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';
+export { ModelResolver } from './model-resolver.ts';
+export { PrefsStore } from './prefs-store.ts';
+export { SettingsReader } from './settings-reader.ts';
+export type { ModelRoute, ModelEntry } from './types.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/model/index.js

@@ -3,7 +3,7 @@
  *
  * 统一的模型发现、路由解析、per-peer 偏好管理。
  */
-export { ModelResolver } from './model-resolver.js';
-export { PrefsStore } from './prefs-store.js';
-export { SettingsReader } from './settings-reader.js';
+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/model-resolver.d.ts

@@ -13,16 +13,16 @@
  *   > 宿主 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';
+import type { ImQQBotConfig } from '../config.ts';
+import type { Logger } from '../types.ts';
+import type { ModelRoute, ModelEntry } from './types.ts';
 export declare class ModelResolver {
+    private readonly prefs;
+    private readonly settings;
     private readonly ctx;
     private readonly config;
     private readonly logger?;
-    private readonly prefs;
-    private readonly settings;
-    constructor(ctx: Context, config: ImQQBotConfig, logger?: Logger | undefined);
+    constructor(ctx: Context, config: ImQQBotConfig, logger?: Logger);
     /**
      * 获取指定 sessionKey 的有效模型路由（create 用）
      *
@@ -34,12 +34,10 @@ export declare class ModelResolver {
      *
      * 优先级：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）——若无值会抛
+     * 这里不返回 undefined，因为未装 installModelSelection，system-prompt 的
+     * {{model}} 变量直接读 agent.options.model——若无值会抛
      * "prompt variable {{model}} has no value for this assembly"。
-     * 因此这里兜底到默认链，确保 agent.options.model 始终有值。
+     * 因此兜底到默认链，确保 agent.options.model 始终有值。
      */
     getResumeRoute(sessionKey: string): ModelRoute | undefined;
     /**
@@ -66,6 +64,18 @@ export declare class ModelResolver {
      * 清除指定 sessionKey 的 sessionId 记录
      */
     clearSessionId(sessionKey: string): void;
+    /**
+     * 获取指定 sessionKey 的 per-peer preset 覆盖
+     */
+    getPreset(sessionKey: string): string | undefined;
+    /**
+     * 设置 per-peer preset 覆盖并持久化
+     */
+    setPreset(sessionKey: string, presetId: string): void;
+    /**
+     * 清除 per-peer preset 覆盖并持久化
+     */
+    clearPreset(sessionKey: string): boolean;
     /**
      * 解析默认模型路由（不含 per-peer 偏好）
      *
@@ -75,14 +85,18 @@ export declare class ModelResolver {
     resolveDefault(): ModelRoute;
     /**
      * 列出所有可用模型
+     *
+     * 优先走 ctx.llm 服务动态发现，服务不可用或失败时回退 settings.yaml 静态配置。
      */
-    listModels(): ModelEntry[];
+    listModels(): Promise<ModelEntry[]>;
     /**
      * 列出可用 provider 名称
      */
     listProviders(): string[];
     private readFromHost;
-    /** 统一的 Cordis 服务访问 */
+    /** 统一的 Cordis 服务访问（可选获取：服务未注入时静默返回 undefined，避免 Proxy 抛错） */
     private getService;
+    /** 获取 ctx.llm 服务（最小接口收窄，不可用时返回 undefined） */
+    private getLlmService;
 }
 //# sourceMappingURL=model-resolver.d.ts.map

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

@@ -1 +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"}
+{"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;AAUzD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAG/B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,MAAM;IAWjB;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI7D;;;;;;;;;OASG;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;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIjD;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIrD;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;;OAKG;IACH,cAAc,IAAI,UAAU;IAc5B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IA+BzC;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAgBzB,OAAO,CAAC,YAAY;IAoBpB,6DAA6D;IAC7D,OAAO,CAAC,UAAU;IASlB,6CAA6C;IAC7C,OAAO,CAAC,aAAa;CAatB"}

package/dist/model/model-resolver.js

@@ -1,11 +1,11 @@
-import { PrefsStore } from './prefs-store.js';
-import { SettingsReader } from './settings-reader.js';
+import { PrefsStore } from "./prefs-store.js";
+import { SettingsReader } from "./settings-reader.js";
 export class ModelResolver {
+    prefs;
+    settings;
     ctx;
     config;
     logger;
-    prefs;
-    settings;
     constructor(ctx, config, logger) {
         this.ctx = ctx;
         this.config = config;
@@ -26,12 +26,10 @@ export class ModelResolver {
      *
      * 优先级：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）——若无值会抛
+     * 这里不返回 undefined，因为未装 installModelSelection，system-prompt 的
+     * {{model}} 变量直接读 agent.options.model——若无值会抛
      * "prompt variable {{model}} has no value for this assembly"。
-     * 因此这里兜底到默认链，确保 agent.options.model 始终有值。
+     * 因此兜底到默认链，确保 agent.options.model 始终有值。
      */
     getResumeRoute(sessionKey) {
         const override = this.prefs.getOverride(sessionKey);
@@ -78,6 +76,24 @@ export class ModelResolver {
     clearSessionId(sessionKey) {
         this.prefs.clearSessionId(sessionKey);
     }
+    /**
+     * 获取指定 sessionKey 的 per-peer preset 覆盖
+     */
+    getPreset(sessionKey) {
+        return this.prefs.getPreset(sessionKey);
+    }
+    /**
+     * 设置 per-peer preset 覆盖并持久化
+     */
+    setPreset(sessionKey, presetId) {
+        this.prefs.setPreset(sessionKey, presetId);
+    }
+    /**
+     * 清除 per-peer preset 覆盖并持久化
+     */
+    clearPreset(sessionKey) {
+        return this.prefs.clearPreset(sessionKey);
+    }
     /**
      * 解析默认模型路由（不含 per-peer 偏好）
      *
@@ -98,29 +114,51 @@ export class ModelResolver {
     }
     /**
      * 列出所有可用模型
+     *
+     * 优先走 ctx.llm 服务动态发现，服务不可用或失败时回退 settings.yaml 静态配置。
      */
-    listModels() {
+    async listModels() {
+        const llm = this.getLlmService();
+        if (!llm)
+            return this.settings.readModels();
+        try {
+            const providers = llm.listProviders();
+            const entries = [];
+            for (const provider of providers) {
+                const providerId = typeof provider === 'string' ? provider : provider.id;
+                try {
+                    const models = await llm.listModels(providerId);
+                    for (const model of models) {
+                        entries.push({ provider: providerId, id: model.id, name: model.name });
+                    }
+                }
+                catch (err) {
+                    // 单个 provider 失败，跳过
+                    this.logger?.debug(`ModelResolver: provider ${providerId} 模型列表获取失败: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            if (entries.length > 0)
+                return entries;
+        }
+        catch (err) {
+            this.logger?.warn(`ModelResolver: 动态发现模型失败，回退 settings.yaml: ${err instanceof Error ? err.message : String(err)}`);
+        }
         return this.settings.readModels();
     }
     /**
      * 列出可用 provider 名称
      */
     listProviders() {
-        try {
-            const llm = this.getService('llm');
-            if (llm && typeof llm.listProviders === 'function') {
-                const providers = llm.listProviders();
-                if (providers.length > 0) {
-                    const first = providers[0];
-                    if (typeof first === 'string')
-                        return providers;
-                    return providers.map((p) => p.id);
-                }
+        const llm = this.getLlmService();
+        if (llm) {
+            const providers = llm.listProviders();
+            if (providers.length > 0) {
+                const first = providers[0];
+                if (typeof first === 'string')
+                    return providers;
+                return providers.map((p) => p.id);
             }
         }
-        catch {
-            // 忽略
-        }
         return this.settings.readProviders();
     }
     // ── 私有方法 ──
@@ -141,11 +179,28 @@ export class ModelResolver {
         }
         return undefined;
     }
-    /** 统一的 Cordis 服务访问 */
+    /** 统一的 Cordis 服务访问（可选获取：服务未注入时静默返回 undefined，避免 Proxy 抛错） */
     getService(name) {
-        const ctxAny = this.ctx;
-        return ctxAny[name] ??
-            (typeof ctxAny.get === 'function' ? ctxAny.get(name) : undefined);
+        try {
+            const ctxAny = this.ctx;
+            return typeof ctxAny.get === 'function' ? ctxAny.get(name) : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** 获取 ctx.llm 服务（最小接口收窄，不可用时返回 undefined） */
+    getLlmService() {
+        try {
+            const llm = this.getService('llm');
+            if (llm && typeof llm.listProviders === 'function' && typeof llm.listModels === 'function') {
+                return llm;
+            }
+        }
+        catch (err) {
+            this.logger?.warn(`ModelResolver: ctx.llm 服务访问失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return undefined;
     }
 }
 //# sourceMappingURL=model-resolver.js.map