koishi-plugin-ai-video 0.0.3 → 0.0.5

package/lib/index.d.ts

@@ -21,28 +21,32 @@ export declare const Config: Schema<Schemastery.ObjectS<{
     pollTimeout: Schema<number, number>;
     collectTimeout: Schema<number, number>;
 }> | Schemastery.ObjectS<{
-    proxyEnabled: Schema<boolean, boolean>;
-    proxyProtocol: Schema<"http" | "https", "http" | "https">;
-    proxyHost: Schema<string, string>;
-    proxyPort: Schema<number, number>;
-    proxyAuth: Schema<boolean, boolean>;
-    proxyUsername: Schema<string, string>;
-    proxyPassword: Schema<string, string>;
-}> | Schemastery.ObjectS<{
-    useCustomApi: Schema<boolean, boolean>;
-    apiEndpoint: Schema<string, string>;
-    apiKey: Schema<string, string>;
-    model: Schema<string, string>;
-    img2videoModel: Schema<string, string>;
-    videoDuration: Schema<number, number>;
-    videoResolution: Schema<string, string>;
-    txt2videoPrompt: Schema<string, string>;
-    img2videoPrompt: Schema<string, string>;
-    customHeaders: Schema<string, string>;
+    imageCompression: Schema<Schemastery.ObjectS<{
+        enable: Schema<boolean, boolean>;
+        maxWidth: Schema<number, number>;
+        maxHeight: Schema<number, number>;
+        quality: Schema<number, number>;
+    }>, Schemastery.ObjectT<{
+        enable: Schema<boolean, boolean>;
+        maxWidth: Schema<number, number>;
+        maxHeight: Schema<number, number>;
+        quality: Schema<number, number>;
+    }>>;
+    imageInputAsBase64: Schema<boolean, boolean>;
+    presetPrompts: Schema<Schemastery.ObjectS<{
+        name: Schema<string, string>;
+        keywords: Schema<string[], string[]>;
+        template: Schema<string, string>;
+    }>[], Schemastery.ObjectT<{
+        name: Schema<string, string>;
+        keywords: Schema<string[], string[]>;
+        template: Schema<string, string>;
+    }>[]>;
 }> | Schemastery.ObjectS<{
     apiStrategy: Schema<"sequence" | "roundrobin", "sequence" | "roundrobin">;
-    customApiList: Schema<Schemastery.ObjectS<{
+    primaryApiList: Schema<Schemastery.ObjectS<{
         enable: Schema<boolean, boolean>;
+        adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
         endpoint: Schema<string, string>;
         apiKey: Schema<string, string>;
         model: Schema<string, string>;
@@ -55,6 +59,7 @@ export declare const Config: Schema<Schemastery.ObjectS<{
         bodyTemplate: Schema<string, string>;
     }>[], Schemastery.ObjectT<{
         enable: Schema<boolean, boolean>;
+        adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
         endpoint: Schema<string, string>;
         apiKey: Schema<string, string>;
         model: Schema<string, string>;
@@ -66,6 +71,76 @@ export declare const Config: Schema<Schemastery.ObjectS<{
         customHeaders: Schema<string, string>;
         bodyTemplate: Schema<string, string>;
     }>[]>;
+}> | Schemastery.ObjectS<{
+    secondaryApi: Schema<Schemastery.ObjectS<{
+        enable: Schema<boolean, boolean>;
+        strategy: Schema<"sequence" | "roundrobin", "sequence" | "roundrobin">;
+        list: Schema<Schemastery.ObjectS<{
+            enable: Schema<boolean, boolean>;
+            adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
+            endpoint: Schema<string, string>;
+            apiKey: Schema<string, string>;
+            model: Schema<string, string>;
+            img2videoModel: Schema<string, string>;
+            videoDuration: Schema<number, number>;
+            videoResolution: Schema<string, string>;
+            txt2videoPrompt: Schema<string, string>;
+            img2videoPrompt: Schema<string, string>;
+            customHeaders: Schema<string, string>;
+            bodyTemplate: Schema<string, string>;
+        }>[], Schemastery.ObjectT<{
+            enable: Schema<boolean, boolean>;
+            adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
+            endpoint: Schema<string, string>;
+            apiKey: Schema<string, string>;
+            model: Schema<string, string>;
+            img2videoModel: Schema<string, string>;
+            videoDuration: Schema<number, number>;
+            videoResolution: Schema<string, string>;
+            txt2videoPrompt: Schema<string, string>;
+            img2videoPrompt: Schema<string, string>;
+            customHeaders: Schema<string, string>;
+            bodyTemplate: Schema<string, string>;
+        }>[]>;
+    }>, Schemastery.ObjectT<{
+        enable: Schema<boolean, boolean>;
+        strategy: Schema<"sequence" | "roundrobin", "sequence" | "roundrobin">;
+        list: Schema<Schemastery.ObjectS<{
+            enable: Schema<boolean, boolean>;
+            adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
+            endpoint: Schema<string, string>;
+            apiKey: Schema<string, string>;
+            model: Schema<string, string>;
+            img2videoModel: Schema<string, string>;
+            videoDuration: Schema<number, number>;
+            videoResolution: Schema<string, string>;
+            txt2videoPrompt: Schema<string, string>;
+            img2videoPrompt: Schema<string, string>;
+            customHeaders: Schema<string, string>;
+            bodyTemplate: Schema<string, string>;
+        }>[], Schemastery.ObjectT<{
+            enable: Schema<boolean, boolean>;
+            adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
+            endpoint: Schema<string, string>;
+            apiKey: Schema<string, string>;
+            model: Schema<string, string>;
+            img2videoModel: Schema<string, string>;
+            videoDuration: Schema<number, number>;
+            videoResolution: Schema<string, string>;
+            txt2videoPrompt: Schema<string, string>;
+            img2videoPrompt: Schema<string, string>;
+            customHeaders: Schema<string, string>;
+            bodyTemplate: Schema<string, string>;
+        }>[]>;
+    }>>;
+}> | Schemastery.ObjectS<{
+    proxyEnabled: Schema<boolean, boolean>;
+    proxyProtocol: Schema<"http" | "https", "http" | "https">;
+    proxyHost: Schema<string, string>;
+    proxyPort: Schema<number, number>;
+    proxyAuth: Schema<boolean, boolean>;
+    proxyUsername: Schema<string, string>;
+    proxyPassword: Schema<string, string>;
 }> | Schemastery.ObjectS<{
     blacklistAdmins: Schema<string[], string[]>;
 }> | Schemastery.ObjectS<{
@@ -142,28 +217,23 @@ export declare const Config: Schema<Schemastery.ObjectS<{
     pollTimeout: number;
     collectTimeout: number;
 } & import("cosmokit").Dict & {
-    proxyEnabled: boolean;
-    proxyProtocol: "http" | "https";
-    proxyHost: string;
-    proxyPort: number;
-    proxyAuth: boolean;
-    proxyUsername: string;
-    proxyPassword: string;
-} & {
-    useCustomApi: boolean;
-    apiEndpoint: string;
-    apiKey: string;
-    model: string;
-    img2videoModel: string;
-    videoDuration: number;
-    videoResolution: string;
-    txt2videoPrompt: string;
-    img2videoPrompt: string;
-    customHeaders: string;
+    imageCompression: Schemastery.ObjectT<{
+        enable: Schema<boolean, boolean>;
+        maxWidth: Schema<number, number>;
+        maxHeight: Schema<number, number>;
+        quality: Schema<number, number>;
+    }>;
+    imageInputAsBase64: boolean;
+    presetPrompts: Schemastery.ObjectT<{
+        name: Schema<string, string>;
+        keywords: Schema<string[], string[]>;
+        template: Schema<string, string>;
+    }>[];
 } & {
     apiStrategy: "sequence" | "roundrobin";
-    customApiList: Schemastery.ObjectT<{
+    primaryApiList: Schemastery.ObjectT<{
         enable: Schema<boolean, boolean>;
+        adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
         endpoint: Schema<string, string>;
         apiKey: Schema<string, string>;
         model: Schema<string, string>;
@@ -175,6 +245,46 @@ export declare const Config: Schema<Schemastery.ObjectS<{
         customHeaders: Schema<string, string>;
         bodyTemplate: Schema<string, string>;
     }>[];
+} & {
+    secondaryApi: Schemastery.ObjectT<{
+        enable: Schema<boolean, boolean>;
+        strategy: Schema<"sequence" | "roundrobin", "sequence" | "roundrobin">;
+        list: Schema<Schemastery.ObjectS<{
+            enable: Schema<boolean, boolean>;
+            adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
+            endpoint: Schema<string, string>;
+            apiKey: Schema<string, string>;
+            model: Schema<string, string>;
+            img2videoModel: Schema<string, string>;
+            videoDuration: Schema<number, number>;
+            videoResolution: Schema<string, string>;
+            txt2videoPrompt: Schema<string, string>;
+            img2videoPrompt: Schema<string, string>;
+            customHeaders: Schema<string, string>;
+            bodyTemplate: Schema<string, string>;
+        }>[], Schemastery.ObjectT<{
+            enable: Schema<boolean, boolean>;
+            adapterType: Schema<"" | "chat" | "flat", "" | "chat" | "flat">;
+            endpoint: Schema<string, string>;
+            apiKey: Schema<string, string>;
+            model: Schema<string, string>;
+            img2videoModel: Schema<string, string>;
+            videoDuration: Schema<number, number>;
+            videoResolution: Schema<string, string>;
+            txt2videoPrompt: Schema<string, string>;
+            img2videoPrompt: Schema<string, string>;
+            customHeaders: Schema<string, string>;
+            bodyTemplate: Schema<string, string>;
+        }>[]>;
+    }>;
+} & {
+    proxyEnabled: boolean;
+    proxyProtocol: "http" | "https";
+    proxyHost: string;
+    proxyPort: number;
+    proxyAuth: boolean;
+    proxyUsername: string;
+    proxyPassword: string;
 } & {
     blacklistAdmins: string[];
 } & {

package/lib/index.js

@@ -16,6 +16,91 @@ exports.inject = {
     optional: ['assets'],
 };
 const logger = new koishi_1.Logger('ai-video');
+let sharp;
+try {
+    sharp = require('sharp');
+}
+catch { }
+function guessAdapterType(endpoint) {
+    try {
+        const url = new URL(endpoint);
+        const port = url.port;
+        if (port === '7860' || port === '5000' || port === '8888')
+            return 'flat';
+    }
+    catch { }
+    return 'chat';
+}
+function compressImage(buffer, cfg) {
+    if (!sharp || !cfg.imageCompression?.enable)
+        return Promise.resolve(buffer);
+    const { maxWidth, maxHeight, quality } = cfg.imageCompression;
+    return sharp(buffer)
+        .resize({
+        width: maxWidth,
+        height: maxHeight,
+        fit: 'inside',
+        withoutEnlargement: true,
+    })
+        .jpeg({ quality: quality || 80 })
+        .toBuffer()
+        .catch(() => buffer);
+}
+async function downloadAndCompress(url, cfg) {
+    try {
+        const res = await axios_1.default.get(url, { responseType: 'arraybuffer', timeout: 30000 });
+        let buffer = Buffer.from(res.data);
+        const contentType = typeof res.headers['content-type'] === 'string' ? res.headers['content-type'] : '';
+        let mime = 'image/png';
+        if (/^image\/[a-zA-Z0-9.+-]+/.test(contentType)) {
+            mime = contentType.split(';')[0].trim();
+        }
+        else {
+            const ext = url.replace(/[?#].*$/, '').split('.').pop()?.toLowerCase() || 'png';
+            const mimeMap = {
+                png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg',
+                gif: 'image/gif', webp: 'image/webp', bmp: 'image/bmp',
+                svg: 'image/svg+xml', ico: 'image/x-icon', tiff: 'image/tiff',
+                tif: 'image/tiff', avif: 'image/avif', heic: 'image/heic', heif: 'image/heif',
+            };
+            mime = mimeMap[ext] || 'image/png';
+        }
+        buffer = await compressImage(buffer, cfg);
+        return `data:${mime};base64,${buffer.toString('base64')}`;
+    }
+    catch (e) {
+        logger.warn('下载或压缩图片失败', url, e);
+        return null;
+    }
+}
+const apiEntrySchema = koishi_1.Schema.object({
+    enable: koishi_1.Schema.boolean().default(true).description('启用'),
+    adapterType: koishi_1.Schema.union([
+        koishi_1.Schema.const('').description('自动'),
+        koishi_1.Schema.const('chat').description('Chat格式'),
+        koishi_1.Schema.const('flat').description('平铺格式'),
+    ]).default('').description('接口类型（留空自动根据端口判断）'),
+    endpoint: koishi_1.Schema.string().default('https://apihub.agnes-ai.com/v1/videos').description('端点'),
+    apiKey: koishi_1.Schema.string().role('secret').default('').description('密钥'),
+    model: koishi_1.Schema.string().default('agnes-video-v2.0').description('模型'),
+    img2videoModel: koishi_1.Schema.string().default('').description('图生视频模型'),
+    videoDuration: koishi_1.Schema.number().default(0).description('默认视频时长（秒）'),
+    videoResolution: koishi_1.Schema.string().default('').description('默认视频分辨率（宽x高）'),
+    txt2videoPrompt: koishi_1.Schema.string().default('').description('文生视频模板'),
+    img2videoPrompt: koishi_1.Schema.string().default('').description('图生视频模板'),
+    customHeaders: koishi_1.Schema.string().role('textarea')
+        .default('{"Authorization":"Bearer {apiKey}","Content-Type":"application/json"}')
+        .description('自定义请求头（JSON）'),
+    bodyTemplate: koishi_1.Schema.string().role('textarea')
+        .default(JSON.stringify({
+        txt2videoBody: { model: '{model}', prompt: '{prompt}', height: 768, width: 1152, num_frames: 121, frame_rate: 24 },
+        img2videoBody: { model: '{model}', prompt: '{prompt}', image: '{url}', height: 768, width: 1152, num_frames: 121, frame_rate: 24 },
+        responseVideoPath: 'remixed_from_video_id',
+        pollUrlTemplate: 'https://apihub.agnes-ai.com/agnesapi?video_id={task_id}',
+        taskIdPath: 'video_id',
+    }, null, 2))
+        .description('自定义请求体（JSON）'),
+});
 exports.Config = koishi_1.Schema.intersect([
     koishi_1.Schema.object({
         debug: koishi_1.Schema.boolean().default(false).description('开启调试模式'),
@@ -37,6 +122,37 @@ exports.Config = koishi_1.Schema.intersect([
         pollTimeout: koishi_1.Schema.number().default(600000).description('轮询超时（毫秒）'),
         collectTimeout: koishi_1.Schema.number().default(120).description('收集模式超时（秒）'),
     }).description('基本设置'),
+    koishi_1.Schema.object({
+        imageCompression: koishi_1.Schema.object({
+            enable: koishi_1.Schema.boolean().default(false).description('启用图片压缩'),
+            maxWidth: koishi_1.Schema.number().default(1024).description('最大宽度'),
+            maxHeight: koishi_1.Schema.number().default(1024).description('最大高度'),
+            quality: koishi_1.Schema.number().default(80).description('压缩质量(0-100)'),
+        }).description('图片压缩设置'),
+        imageInputAsBase64: koishi_1.Schema.boolean().default(false).description('图生视频输入转为Base64'),
+        presetPrompts: koishi_1.Schema.array(koishi_1.Schema.object({
+            name: koishi_1.Schema.string().required().description('预设名称'),
+            keywords: koishi_1.Schema.array(String).default([]).description('触发关键词'),
+            template: koishi_1.Schema.string().default('{prompt}').description('提示词模板，支持 {prompt} {keyword}'),
+        })).default([]).description('预置提示词列表'),
+    }).description('扩展功能'),
+    koishi_1.Schema.object({
+        apiStrategy: koishi_1.Schema.union([
+            koishi_1.Schema.const('sequence').description('顺序'),
+            koishi_1.Schema.const('roundrobin').description('轮询'),
+        ]).default('roundrobin').description('调度策略'),
+        primaryApiList: koishi_1.Schema.array(apiEntrySchema).default([]).description('主模型API列表'),
+    }).description('主模型设置'),
+    koishi_1.Schema.object({
+        secondaryApi: koishi_1.Schema.object({
+            enable: koishi_1.Schema.boolean().default(false).description('启用副模型'),
+            strategy: koishi_1.Schema.union([
+                koishi_1.Schema.const('sequence').description('顺序'),
+                koishi_1.Schema.const('roundrobin').description('轮询'),
+            ]).default('roundrobin').description('调度策略'),
+            list: koishi_1.Schema.array(apiEntrySchema).default([]).description('副模型API列表（留空则使用主模型列表）'),
+        }).description('副模型配置（启用后 video2 使用此配置）'),
+    }).description('副模型设置'),
     koishi_1.Schema.object({
         proxyEnabled: koishi_1.Schema.boolean().default(false).description('启用代理'),
         proxyProtocol: koishi_1.Schema.union([koishi_1.Schema.const('http'), koishi_1.Schema.const('https')]).default('http').description('代理协议'),
@@ -46,79 +162,38 @@ exports.Config = koishi_1.Schema.intersect([
         proxyUsername: koishi_1.Schema.string().default('').description('代理用户名'),
         proxyPassword: koishi_1.Schema.string().role('secret').default('').description('代理密码'),
     }).description('代理设置'),
-    koishi_1.Schema.object({
-        useCustomApi: koishi_1.Schema.boolean().default(false).description('使用自定义API'),
-        apiEndpoint: koishi_1.Schema.string().default('https://apihub.agnes-ai.com/v1/videos').description('API端点'),
-        apiKey: koishi_1.Schema.string().role('secret').default('').description('API密钥'),
-        model: koishi_1.Schema.string().default('agnes-video-v2.0').description('模型'),
-        img2videoModel: koishi_1.Schema.string().default('').description('图生视频模型'),
-        videoDuration: koishi_1.Schema.number().default(0).description('默认视频时长（秒）'),
-        videoResolution: koishi_1.Schema.string().default('').description('默认视频分辨率（宽x高）'),
-        txt2videoPrompt: koishi_1.Schema.string().default('').description('文生视频提示模板'),
-        img2videoPrompt: koishi_1.Schema.string().default('').description('图生视频提示模板'),
-        customHeaders: koishi_1.Schema.string().role('textarea').default('{}').description('自定义请求头(JSON)'),
-    }).description('内置API'),
-    koishi_1.Schema.object({
-        apiStrategy: koishi_1.Schema.union([
-            koishi_1.Schema.const('sequence').description('顺序使用'),
-            koishi_1.Schema.const('roundrobin').description('轮询使用')
-        ]).default('roundrobin').description('API调用策略'),
-        customApiList: koishi_1.Schema.array(koishi_1.Schema.object({
-            enable: koishi_1.Schema.boolean().default(true).description('启用'),
-            endpoint: koishi_1.Schema.string().default('https://apihub.agnes-ai.com/v1/videos').description('API端点'),
-            apiKey: koishi_1.Schema.string().role('secret').default('').description('API密钥'),
-            model: koishi_1.Schema.string().default('agnes-video-v2.0').description('模型'),
-            img2videoModel: koishi_1.Schema.string().default('').description('图生视频模型'),
-            videoDuration: koishi_1.Schema.number().default(0).description('默认视频时长（秒）'),
-            videoResolution: koishi_1.Schema.string().default('').description('默认视频分辨率（宽x高）'),
-            txt2videoPrompt: koishi_1.Schema.string().default('').description('文生视频提示模板'),
-            img2videoPrompt: koishi_1.Schema.string().default('').description('图生视频提示模板'),
-            customHeaders: koishi_1.Schema.string().role('textarea')
-                .default('{"Authorization":"Bearer {apiKey}","Content-Type":"application/json"}')
-                .description('自定义请求头(JSON)'),
-            bodyTemplate: koishi_1.Schema.string().role('textarea')
-                .default(JSON.stringify({
-                txt2videoBody: { model: '{model}', prompt: '{prompt}', height: 768, width: 1152, num_frames: 121, frame_rate: 24 },
-                img2videoBody: { model: '{model}', prompt: '{prompt}', image: '{url}', height: 768, width: 1152, num_frames: 121, frame_rate: 24 },
-                responseVideoPath: 'remixed_from_video_id',
-                pollUrlTemplate: 'https://apihub.agnes-ai.com/agnesapi?video_id={task_id}',
-                taskIdPath: 'video_id',
-            }, null, 2))
-                .description('自定义请求体(JSON模板)'),
-        })).default([]).description('自定义API列表'),
-    }).description('自定义API配置'),
     koishi_1.Schema.object({
         blacklistAdmins: koishi_1.Schema.array(String).default([]).description('管理员QQ号'),
     }).description('权限管理'),
     koishi_1.Schema.object({
         messages: koishi_1.Schema.object({
-            generating: koishi_1.Schema.string().default('视频生成中，请耐心等待...'),
-            enterCollect: koishi_1.Schema.string().default('已进入收集模式，请继续发送图片/文字。发送「开始」触发生成，发送「取消」退出。当前已收集: 0 张图片, 0 段文字'),
-            collectUpdate: koishi_1.Schema.string().default('当前已收集: {images} 张图片, 文字已更新'),
-            collectTimeout: koishi_1.Schema.string().default('收集超时，已自动退出'),
-            empty: koishi_1.Schema.string().default('[提示] 请输入提示词或上传图片'),
-            noApi: koishi_1.Schema.string().default('[提示] 未配置可用API'),
-            fail: koishi_1.Schema.string().default('[提示] 视频生成失败'),
-            noContent: koishi_1.Schema.string().default('（未返回任何视频内容）'),
-            templateError: koishi_1.Schema.string().default('（模板配置错误）'),
-            txt2videoDisabled: koishi_1.Schema.string().default('[提示] 文生视频功能未启用'),
-            img2videoDisabled: koishi_1.Schema.string().default('[提示] 图生视频功能未启用'),
-            rateLimit: koishi_1.Schema.string().default('[提示] 调用次数已达上限'),
-            needAssets: koishi_1.Schema.string().default('[提示] 图生视频需要正确配置 assets 服务'),
-            blacklisted: koishi_1.Schema.string().default('[提示] 你已被加入黑名单'),
-            noPermission: koishi_1.Schema.string().default('[提示] 无权限管理黑名单'),
-            blacklistAddSuccess: koishi_1.Schema.string().default('已将 {targets} 加入黑名单'),
-            blacklistRemoveSuccess: koishi_1.Schema.string().default('已将 {targets} 移出黑名单'),
-            blacklistAddFail: koishi_1.Schema.string().default('{targets} 已在黑名单或无效'),
-            blacklistRemoveFail: koishi_1.Schema.string().default('{targets} 不在黑名单'),
-            invalidUserId: koishi_1.Schema.string().default('无效QQ号：{targets}'),
-            blacklistListEmpty: koishi_1.Schema.string().default('黑名单为空'),
-            blacklistListTitle: koishi_1.Schema.string().default('当前黑名单：'),
-            noLastTask: koishi_1.Schema.string().default('没有上一次记录，无法重绘'),
-            redrawing: koishi_1.Schema.string().default('正在重绘上一次文生视频...'),
-            redrawImg2Video: koishi_1.Schema.string().default('[提示] 重绘仅支持文生视频'),
-            cancelCollect: koishi_1.Schema.string().default('已取消收集模式'),
-            pollWaiting: koishi_1.Schema.string().default('视频生成中（异步轮询），请稍后...'),
+            generating: koishi_1.Schema.string().default('视频生成中，请耐心等待...').description('生成中提示'),
+            enterCollect: koishi_1.Schema.string().default('已进入收集模式，请继续发送图片/文字。发送「开始」触发生成，发送「取消」退出。当前已收集: 0 张图片, 0 段文字').description('进入收集模式提示'),
+            collectUpdate: koishi_1.Schema.string().default('当前已收集: {images} 张图片, 文字已更新').description('收集更新提示'),
+            collectTimeout: koishi_1.Schema.string().default('收集超时，已自动退出').description('收集超时提示'),
+            empty: koishi_1.Schema.string().default('[提示] 请输入提示词或上传图片').description('空输入提示'),
+            noApi: koishi_1.Schema.string().default('[提示] 未配置可用API').description('无API提示'),
+            fail: koishi_1.Schema.string().default('[提示] 视频生成失败').description('生成失败提示'),
+            noContent: koishi_1.Schema.string().default('（未返回任何视频内容）').description('无内容提示'),
+            templateError: koishi_1.Schema.string().default('（模板配置错误）').description('模板错误提示'),
+            txt2videoDisabled: koishi_1.Schema.string().default('[提示] 文生视频功能未启用').description('文生视频禁用提示'),
+            img2videoDisabled: koishi_1.Schema.string().default('[提示] 图生视频功能未启用').description('图生视频禁用提示'),
+            rateLimit: koishi_1.Schema.string().default('[提示] 调用次数已达上限').description('频率限制提示'),
+            needAssets: koishi_1.Schema.string().default('[提示] 图生视频需要正确配置 assets 服务').description('需要Assets提示'),
+            blacklisted: koishi_1.Schema.string().default('[提示] 你已被加入黑名单').description('黑名单提示'),
+            noPermission: koishi_1.Schema.string().default('[提示] 无权限管理黑名单').description('无权限提示'),
+            blacklistAddSuccess: koishi_1.Schema.string().default('已将 {targets} 加入黑名单').description('添加黑名单成功提示'),
+            blacklistRemoveSuccess: koishi_1.Schema.string().default('已将 {targets} 移出黑名单').description('移除黑名单成功提示'),
+            blacklistAddFail: koishi_1.Schema.string().default('{targets} 已在黑名单或无效').description('添加黑名单失败提示'),
+            blacklistRemoveFail: koishi_1.Schema.string().default('{targets} 不在黑名单').description('移除黑名单失败提示'),
+            invalidUserId: koishi_1.Schema.string().default('无效QQ号：{targets}').description('无效用户ID提示'),
+            blacklistListEmpty: koishi_1.Schema.string().default('黑名单为空').description('黑名单为空提示'),
+            blacklistListTitle: koishi_1.Schema.string().default('当前黑名单：').description('黑名单标题提示'),
+            noLastTask: koishi_1.Schema.string().default('没有上一次记录，无法重绘').description('无上一次任务提示'),
+            redrawing: koishi_1.Schema.string().default('正在重绘上一次文生视频...').description('重绘中文生视频提示'),
+            redrawImg2Video: koishi_1.Schema.string().default('[提示] 重绘仅支持文生视频').description('重绘图生视频提示'),
+            cancelCollect: koishi_1.Schema.string().default('已取消收集模式').description('取消收集提示'),
+            pollWaiting: koishi_1.Schema.string().default('视频生成中（异步轮询），请稍后...').description('轮询等待提示'),
         }).description('消息文本'),
     }).description('消息文本'),
 ]);
@@ -132,7 +207,8 @@ async function apply(ctx, cfg) {
     catch { }
     const collectSessions = new Map();
     const lastTaskMap = new Map();
-    let apiRoundRobinIdx = 0;
+    let primaryRoundRobinIdx = 0;
+    let secondaryRoundRobinIdx = 0;
     const apiCallTimestamps = [];
     ctx.model.extend('ai_video_blacklist', { id: 'string', createdAt: 'date' }, { primary: 'id' });
     ctx.on('dispose', () => {
@@ -165,6 +241,13 @@ async function apply(ctx, cfg) {
             }
             catch { }
         }
+        let adapterType;
+        if (entry.adapterType && entry.adapterType !== '') {
+            adapterType = entry.adapterType;
+        }
+        else {
+            adapterType = guessAdapterType(entry.endpoint);
+        }
         let txt2videoBody, img2videoBody, responseVideoPath, pollUrlTemplate, taskIdPath;
         if (entry.bodyTemplate) {
             try {
@@ -200,56 +283,38 @@ async function apply(ctx, cfg) {
             img2videoPrompt: entry.img2videoPrompt || '',
             model: entry.model,
             img2videoModel: entry.img2videoModel || '',
+            adapterType,
         };
     }
-    function buildBuiltinApi() {
-        const headers = { 'Content-Type': 'application/json' };
-        if (cfg.apiKey)
-            headers['Authorization'] = `Bearer ${cfg.apiKey}`;
-        if (cfg.customHeaders) {
-            try {
-                const custom = JSON.parse(cfg.customHeaders);
-                for (const [k, v] of Object.entries(custom))
-                    headers[k] = typeof v === 'string' ? v.replace(/\{apiKey\}/g, cfg.apiKey || '') : String(v);
-            }
-            catch { }
-        }
-        return {
-            endpoint: cfg.apiEndpoint || 'https://apihub.agnes-ai.com/v1/videos',
-            headers,
-            txt2videoBody: { model: '{model}', prompt: '{prompt}', duration: '{duration}', size: '{size}' },
-            img2videoBody: { model: '{model}', prompt: '{prompt}', duration: '{duration}', size: '{size}', image_url: '{url}' },
-            responseVideoPath: 'video_url',
-            pollUrlTemplate: '',
-            taskIdPath: '',
-            method: 'POST',
-            videoDuration: cfg.videoDuration || 0,
-            videoResolution: cfg.videoResolution || '',
-            txt2videoPrompt: cfg.txt2videoPrompt || '',
-            img2videoPrompt: cfg.img2videoPrompt || '',
-            model: cfg.model || 'agnes-video-v2.0',
-            img2videoModel: cfg.img2videoModel || '',
-        };
-    }
-    function getApi() {
-        if (cfg.useCustomApi) {
-            const entries = cfg.customApiList.filter(e => e.enable);
+    function getApi(secondary = false) {
+        if (secondary && cfg.secondaryApi?.enable) {
+            const list = cfg.secondaryApi.list?.length ? cfg.secondaryApi.list : cfg.primaryApiList;
+            if (!list?.length)
+                return null;
+            const entries = list.filter(e => e.enable);
             if (!entries.length)
                 return null;
             const apis = entries.map(parseApiEntry).filter(Boolean);
             if (!apis.length)
                 return null;
-            if (cfg.apiStrategy === 'sequence')
+            const strategy = cfg.secondaryApi.strategy || 'roundrobin';
+            if (strategy === 'sequence')
                 return apis[0];
-            const api = apis[apiRoundRobinIdx % apis.length];
-            apiRoundRobinIdx++;
+            const api = apis[secondaryRoundRobinIdx % apis.length];
+            secondaryRoundRobinIdx++;
             return api;
         }
-        else {
-            if (!cfg.apiEndpoint && !cfg.apiKey)
-                return null;
-            return buildBuiltinApi();
-        }
+        const entries = cfg.primaryApiList.filter(e => e.enable);
+        if (!entries.length)
+            return null;
+        const apis = entries.map(parseApiEntry).filter(Boolean);
+        if (!apis.length)
+            return null;
+        if (cfg.apiStrategy === 'sequence')
+            return apis[0];
+        const api = apis[primaryRoundRobinIdx % apis.length];
+        primaryRoundRobinIdx++;
+        return api;
     }
     function resolveTemplate(templateObj, vars) {
         if (templateObj === null || templateObj === undefined)
@@ -370,15 +435,38 @@ async function apply(ctx, cfg) {
             return obj;
         }
     }
-    async function customGenerateVideo(session, api, prompt, imageUrl = '') {
+    function applyPresetPrompts(prompt, presetName) {
+        if (!prompt)
+            return prompt;
+        if (presetName && cfg.presetPrompts) {
+            const preset = cfg.presetPrompts.find(p => p.name === presetName);
+            if (preset) {
+                return preset.template.replace(/\{prompt\}/g, prompt).replace(/\{keyword\}/g, preset.keywords?.[0] || '');
+            }
+        }
+        if (cfg.presetPrompts && cfg.presetPrompts.length) {
+            for (const preset of cfg.presetPrompts) {
+                if (preset.keywords?.length) {
+                    for (const kw of preset.keywords) {
+                        if (prompt.toLowerCase().includes(kw.toLowerCase())) {
+                            return preset.template.replace(/\{prompt\}/g, prompt).replace(/\{keyword\}/g, kw);
+                        }
+                    }
+                }
+            }
+        }
+        return prompt;
+    }
+    async function customGenerateVideo(session, api, prompt, imageUrl = '', presetName) {
         const isImg2Video = !!imageUrl;
         const model = isImg2Video ? (api.img2videoModel || api.model) : api.model;
         const duration = api.videoDuration || cfg.videoDuration || 5;
         const resolution = api.videoResolution || cfg.videoResolution || '1024x576';
         const promptTemplate = isImg2Video ? api.img2videoPrompt : api.txt2videoPrompt;
-        let finalPrompt = prompt;
+        let processedPrompt = applyPresetPrompts(prompt, presetName);
+        let finalPrompt = processedPrompt;
         if (promptTemplate)
-            finalPrompt = promptTemplate.replace('{prompt}', prompt).replace('{url}', imageUrl);
+            finalPrompt = promptTemplate.replace('{prompt}', processedPrompt).replace('{url}', imageUrl);
         const bodyTemplate = isImg2Video ? api.img2videoBody : api.txt2videoBody;
         const vars = {
             model,
@@ -386,8 +474,15 @@ async function apply(ctx, cfg) {
             duration,
             size: resolution,
         };
-        if (isImg2Video)
-            vars.url = imageUrl;
+        if (isImg2Video) {
+            if (cfg.imageInputAsBase64 && imageUrl) {
+                const b64 = await downloadAndCompress(imageUrl, cfg);
+                vars.url = b64 || imageUrl;
+            }
+            else {
+                vars.url = imageUrl;
+            }
+        }
         let body;
         try {
             body = resolveTemplate(bodyTemplate, vars);
@@ -429,20 +524,20 @@ async function apply(ctx, cfg) {
             return null;
         }
     }
-    async function generateVideos(session, prompt, imageUrl, count) {
+    async function generateVideos(session, prompt, imageUrl, count, presetName, secondary = false) {
         const videoUrls = [];
         for (let i = 0; i < count; i++) {
             if (!checkRateLimit()) {
                 await safeSend(session, cfg.messages.rateLimit);
                 break;
             }
-            const api = getApi();
+            const api = getApi(secondary);
             if (!api) {
                 await safeSend(session, cfg.messages.noApi);
                 break;
             }
             recordApiCall();
-            const url = await customGenerateVideo(session, api, prompt, imageUrl);
+            const url = await customGenerateVideo(session, api, prompt, imageUrl, presetName);
             if (url)
                 videoUrls.push(url);
             if (i < count - 1)
@@ -478,7 +573,62 @@ async function apply(ctx, cfg) {
             safeSend(session, cfg.messages.collectTimeout);
         }, cfg.collectTimeout * 1000);
     }
-    ctx.command('video [text]', 'AI视频生成')
+    ctx.command('video [text]', 'AI视频生成（主模型）')
+        .option('preset', '-p <preset:string>')
+        .action(async ({ session, options }, text) => {
+        if (!session)
+            return;
+        if (await isBlacklisted(session.userId))
+            return safeSend(session, cfg.messages.blacklisted);
+        const preset = options?.preset || undefined;
+        const hasImage = koishi_1.h.select(session.elements, 'img').length > 0;
+        if (preset && text) {
+            if (!cfg.enableTxt2Video && !hasImage)
+                return safeSend(session, cfg.messages.txt2videoDisabled);
+            if (hasImage && !cfg.enableImg2Video)
+                return safeSend(session, cfg.messages.img2videoDisabled);
+            let imageUrl = '';
+            if (hasImage) {
+                const assets = ctx.assets;
+                if (!assets)
+                    return safeSend(session, cfg.messages.needAssets);
+                const img = koishi_1.h.select(session.elements, 'img')[0];
+                try {
+                    const up = await assets.upload(img.attrs.src, 'ref_image.jpg');
+                    if (/^https?:\/\//.test(up))
+                        imageUrl = up;
+                }
+                catch { }
+            }
+            await safeSend(session, cfg.messages.generating);
+            return generateVideos(session, text, imageUrl, cfg.maxVideos, preset, false);
+        }
+        const key = `${session.guildId || 'private'}-${session.userId}`;
+        if (collectSessions.has(key))
+            return safeSend(session, '你已在收集模式中');
+        if (!hasImage && !cfg.enableTxt2Video)
+            return safeSend(session, cfg.messages.txt2videoDisabled);
+        if (hasImage && !cfg.enableImg2Video)
+            return safeSend(session, cfg.messages.img2videoDisabled);
+        let imageUrl = '';
+        if (hasImage) {
+            const assets = ctx.assets;
+            if (!assets)
+                return safeSend(session, cfg.messages.needAssets);
+            const img = koishi_1.h.select(session.elements, 'img')[0];
+            try {
+                const up = await assets.upload(img.attrs.src, 'ref_image.jpg');
+                if (/^https?:\/\//.test(up))
+                    imageUrl = up;
+            }
+            catch { }
+        }
+        const collect = { prompt: text || '', imageUrl, timer: null, presetName: preset };
+        collect.timer = startTimer(session, key, collect);
+        collectSessions.set(key, collect);
+        await safeSend(session, cfg.messages.enterCollect);
+    });
+    ctx.command('video2 [text]', '使用副模型生成视频')
         .action(async ({ session }, text) => {
         if (!session)
             return;
@@ -531,8 +681,13 @@ async function apply(ctx, cfg) {
             collectSessions.delete(key);
             if (!collect.prompt && !collect.imageUrl)
                 return safeSend(session, cfg.messages.empty);
+            if (!cfg.enableTxt2Video && !collect.imageUrl)
+                return safeSend(session, cfg.messages.txt2videoDisabled);
+            if (!cfg.enableImg2Video && collect.imageUrl)
+                return safeSend(session, cfg.messages.img2videoDisabled);
+            const isVideo2 = session.content?.startsWith('video2') ?? false;
             await safeSend(session, cfg.messages.generating);
-            return generateVideos(session, collect.prompt || '默认', collect.imageUrl, cfg.maxVideos);
+            return generateVideos(session, collect.prompt || '默认', collect.imageUrl, cfg.maxVideos, collect.presetName, isVideo2);
         }
         if (imgs.length > 0 && !collect.imageUrl) {
             const assets = ctx.assets;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-ai-video",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Koishi AI 视频生成插件，支持文生视频、图生视频",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/readme.md

@@ -4,210 +4,140 @@
 
 ### 中文
 一款为 Koishi 聊天机器人框架开发的 AI 视频生成插件，支持**文生视频 + 图生视频**，**兼容 OpenAI 标准接口的同时支持自定义 API 端点**，可接入任意视频生成服务。  
-内置多 API 负载均衡、调试日志、超时机制、异步轮询、全配置化提示文案（含自定义提示模板），配置灵活、开箱即用、稳定可靠。  
-图生视频支持附带参考图片，自动切换模式。  
-提供**黑名单管理**功能，数据持久化到数据库，管理员可通过指令添加、移除用户及查看黑名单。  
+内置多 API 负载均衡、图片压缩、Base64 自动转换、预置提示词、主/副模型分离、端口自动适配、异步轮询、调试日志、超时等待机制，配置灵活、开箱即用、稳定可靠。  
+图生视频支持附带参考图片，并可选择将图片压缩后转为 Base64 发送以兼容更多后端。  
+提供**黑名单管理**功能，数据持久化到数据库，管理员可通过指令添加、移除用户及查看黑名单。
 
 ### English
 An AI video generation plugin for the Koishi chatbot framework, supporting **text-to-video & image-to-video**.  
 Compatible with OpenAI‑standard APIs, and also supports **custom API endpoints** for any video generation service.  
-Built‑in multi‑API load balancing, debug logging, timeout mechanism, async polling, fully configurable messages and prompt templates.  
-Image‑to‑video works by attaching a reference image, automatic mode switching.  
-**Blacklist management** with database persistence.  
+Built‑in multi‑API load balancing, image compression, automatic Base64 conversion, preset prompts, primary/secondary model separation, port auto-detection, async polling, debug logging, and timeout mechanism.  
+Image‑to‑video supports attaching a reference image, with optional compression and Base64 conversion for compatibility with more backends.  
+**Blacklist management** with database persistence.
+
+## 核心指令 (Core Commands)
+
+| 指令 (Command) | 说明 (Description) | 示例 (Example) |
+|----------------|--------------------|----------------|
+| `video <提示词>` | 进入收集模式：可发送文字/图片，输入「开始」生成，「取消」退出。支持 `-p <预设>` 直接应用预置提示词模板。 (Enter collection mode: send text/images, then "start" to generate. Use `-p <preset>` to apply a preset prompt template.) | `video 海上日出 -p 电影风格` |
+| `video2 <提示词>` | 使用副模型进入收集模式，操作同 `video`。 (Same as `video` but using the secondary model.) | `video2 一只猫` |
+| `redraw` / `rd` / `重绘` | 重绘上一次的文生视频结果。 (Redraw the last text-to-video result.) | `redraw` |
+| `blacklist list` | 查看当前黑名单（仅管理员）。 (Show current blacklist, admin only.) | `blacklist list` |
+| `blacklist add <QQ号...>` | 将指定 QQ 号加入黑名单（仅管理员）。 (Add QQ numbers to blacklist, admin only.) | `blacklist add 123456` |
+| `blacklist remove <QQ号...>` | 将指定 QQ 号移出黑名单（仅管理员）。 (Remove QQ numbers from blacklist, admin only.) | `blacklist remove 123456` |
+
+## 配置项说明 (Configuration)
+
+### 基本设置 (Basic Settings)
+
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `debug` | boolean | false | 调试模式，输出完整请求/响应日志 (Debug mode, logs full request/response) |
+| `timeout` | number | 600000 | API 请求超时时间（毫秒） (Request timeout in ms) |
+| `rateLimit` | number | 50 | 每小时调用次数上限 (Hourly call limit) |
+| `maxVideos` | number | 1 | 单次生成最多视频数量 (Max videos per generation) |
+| `videoDuration` | number | 5 | 默认视频时长（秒） (Default video duration in seconds) |
+| `videoResolution` | string | 1024x576 | 默认视频分辨率（宽x高） (Default video resolution WxH) |
+| `enableForward` | boolean | true | 多视频结果是否使用合并转发 (Use forward message for multiple videos) |
+| `enableTxt2Video` | boolean | true | 启用文生视频功能 (Enable txt2video) |
+| `enableImg2Video` | boolean | true | 启用图生视频功能 (Enable img2video) |
+| `videoSendMode` | string | video | 视频发送方式：`video`（仅视频） / `url`（仅链接） / `both`（视频+链接） (Send mode: `video`, `url`, `both`) |
+| `pollEnabled` | boolean | false | 启用异步轮询 (Enable async polling) |
+| `pollInterval` | number | 3000 | 轮询间隔（毫秒） (Polling interval in ms) |
+| `pollTimeout` | number | 600000 | 轮询超时（毫秒） (Polling timeout in ms) |
+| `collectTimeout` | number | 120 | 收集模式等待用户输入的超时秒数 (Collection mode wait timeout in seconds) |
+
+### 扩展功能 (Extended Features)
+
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `imageCompression.enable` | boolean | false | 启用图片压缩（需安装 `sharp` 模块） (Enable image compression, requires `sharp`) |
+| `imageCompression.maxWidth` | number | 1024 | 压缩后最大宽度 (Max width after compression) |
+| `imageCompression.maxHeight` | number | 1024 | 压缩后最大高度 (Max height after compression) |
+| `imageCompression.quality` | number | 80 | JPEG 压缩质量 0-100 (JPEG quality 0-100) |
+| `imageInputAsBase64` | boolean | false | 图生视频时将参考图片转为 Base64 发送 (Convert reference image to Base64 for img2video) |
+| `presetPrompts` | array | [] | 预置提示词列表，每项包含 `name`（名称）、`keywords`（触发关键词数组）、`template`（提示词模板，支持 `{prompt}` `{keyword}` 变量） (List of preset prompts: `name`, `keywords` array, `template` with `{prompt}` and `{keyword}` variables) |
+
+### 主模型设置 (Primary Model)
+
+主模型始终使用自定义 API 列表，支持多个端点与负载均衡。  
+The primary model always uses a custom API list with multiple endpoints and load balancing.
+
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `apiStrategy` | string | roundrobin | 主模型调度策略：`sequence`（顺序） / `roundrobin`（轮询） (Load balancing strategy for primary model) |
+| `primaryApiList` | array | [] | 主模型 API 条目列表，每个条目包含以下配置 (List of primary API entries, each with the following fields) |
+
+**API 条目公共配置 (API Entry Common Fields)**（主模型与副模型通用）
+
+| 字段 (Field) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|--------------|-------------|-------------------|---------------------|
+| `enable` | boolean | true | 是否启用此 API (Enable this API) |
+| `adapterType` | string | (空) | 接口类型：`chat` / `flat`；留空则根据端口自动判断（7860/5000/8888 → flat，其余 → chat） (Adapter type; auto-detect by port if empty) |
+| `endpoint` | string | https://apihub.agnes-ai.com/v1/videos | API 端点 (Endpoint) |
+| `apiKey` | string | (空) | API 密钥 (API key) |
+| `model` | string | agnes-video-v2.0 | 模型名称 (Model name) |
+| `img2videoModel` | string | (空) | 图生视频专用模型 (Img2video model) |
+| `videoDuration` | number | 0 | 视频时长（秒），0 则使用全局默认 (Video duration in seconds, 0 = use global) |
+| `videoResolution` | string | (空) | 视频分辨率，留空使用全局默认 (Video resolution, falls back to global) |
+| `txt2videoPrompt` | string | (空) | 文生视频提示词模板 (Prompt template for txt2video) |
+| `img2videoPrompt` | string | (空) | 图生视频提示词模板 (Prompt template for img2video) |
+| `customHeaders` | string | 预设 (Preset) | 自定义请求头 JSON，支持 `{apiKey}` 变量 (Custom headers JSON) |
+| `bodyTemplate` | string | 预设 (Preset) | 自定义请求体 JSON，包含 `txt2videoBody`、`img2videoBody`、`responseVideoPath`、`pollUrlTemplate`、`taskIdPath` 等字段 (Custom request body template JSON) |
+
+### 副模型设置 (Secondary Model)
+
+副模型通过 `video2` 指令调用，其 API 列表完全独立于主模型；若副模型列表为空，则自动回退到主模型的 `primaryApiList`。  
+The secondary model is invoked via the `video2` command. Its API list is completely independent; if empty, it falls back to the primary `primaryApiList`.
+
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `secondaryApi.enable` | boolean | false | 启用副模型功能 (Enable secondary model) |
+| `secondaryApi.strategy` | string | roundrobin | 副模型调度策略：`sequence` / `roundrobin` (Load balancing strategy for secondary model) |
+| `secondaryApi.list` | array | [] | 副模型 API 条目列表，结构与主模型条目**完全相同**（留空则使用主模型列表） (Secondary API entry list, same structure as primary entries; if empty, uses primary list) |
+
+> 副模型列表的每个条目配置项与主模型 API 条目完全一致，详见上方 **API 条目公共配置** 表格。  
+> Each entry in the secondary list has the same fields as a primary API entry; see the **API Entry Common Fields** table above.
+
+### 代理设置 (Proxy Settings)
+
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `proxyEnabled` | boolean | false | 启用 HTTP/HTTPS 代理 (Enable proxy) |
+| `proxyProtocol` | string | http | 代理协议：`http` / `https` (Proxy protocol) |
+| `proxyHost` | string | (空) | 代理地址 (Proxy host) |
+| `proxyPort` | number | 8080 | 代理端口 (Proxy port) |
+| `proxyAuth` | boolean | false | 代理是否需要认证 (Proxy requires auth) |
+| `proxyUsername` | string | (空) | 代理用户名 (Proxy username) |
+| `proxyPassword` | string | (空) | 代理密码 (Proxy password) |
+
+### 权限管理 (Permissions)
+
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `blacklistAdmins` | array | [] | 黑名单管理员 QQ 号列表 (Admin QQ number list) |
+
+### 消息文本 (Messages)
+
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `messages.*` | object | 见配置页 (See schema) | 所有提示文案均可自定义，支持模板变量 (All messages customizable, supports template variables) |
 
-## 使用说明 (Usage)
-
-### 中文
-
-| 命令 (Command)                     | 功能说明 (Description) |
-|------------------------------------|------------------------|
-| `video <提示词>`                  | **AI 视频生成**：根据提示词生成视频；若消息中同时附带了图片，则自动切换为图生视频模式。 |
-| `redraw` / `rd` / `重绘`         | 重绘：重新生成上一次的文生视频结果 |
-| `blacklist list`                 | 查看当前黑名单（仅管理员） |
-| `blacklist add <QQ号> [QQ号 ...]`  | 将指定 QQ 号加入黑名单（仅管理员） |
-| `blacklist remove <QQ号> [QQ号 ...]` | 将指定 QQ 号移出黑名单（仅管理员） |
-
-### English
-
-| Command                             | Description |
-|-------------------------------------|-------------|
-| `video <prompt>`                   | **AI Video Generation**: Generate video from prompt. If an image is attached, automatically switches to image-to-video mode. |
-| `redraw` / `rd` / `重绘`         | Redraw: Re-generate the last text-to-video result |
-| `blacklist list`                  | Show current blacklist (admin only) |
-| `blacklist add <QQ_number> [QQ_number ...]` | Add QQ number(s) to blacklist (admin only) |
-| `blacklist remove <QQ_number> [QQ_number ...]` | Remove QQ number(s) from blacklist (admin only) |
-
-## 配置说明 (Configuration)
-
-### 中文
-
-| 配置项 | 说明 | 默认值 |
-|--------|------|--------|
-| **基本设置** | | |
-| `debug` | 调试模式，输出完整请求/响应日志 | `false` |
-| `timeout` | API 请求超时时间（毫秒），视频生成较慢建议加大 | `600000` |
-| `rateLimit` | 每小时调用次数上限 | `50` |
-| `maxVideos` | 单次生成最多视频数量 | `1` |
-| `videoDuration` | 默认视频时长（秒） | `5` |
-| `videoResolution` | 默认视频分辨率（宽x高） | `1024x576` |
-| `enableForward` | 多视频结果是否使用合并转发 | `true` |
-| `enableTxt2Video` | 启用文生视频功能 | `true` |
-| `enableImg2Video` | 启用图生视频功能 | `true` |
-| `videoSendMode` | 视频发送方式：`video`（仅视频文件）、`url`（仅链接）、`both`（视频文件+链接） | `video` |
-| `pollEnabled` | 是否启用异步轮询（若 API 返回任务 ID 则自动轮询至完成） | `false` |
-| `pollInterval` | 轮询间隔（毫秒） | `3000` |
-| `pollTimeout` | 轮询总超时时间（毫秒） | `600000` |
-| **代理设置** | | |
-| `proxyEnabled` | 是否启用 HTTP/HTTPS 代理 | `false` |
-| `proxyProtocol` | 代理协议：`http` / `https` | `http` |
-| `proxyHost` | 代理地址 | (空) |
-| `proxyPort` | 代理端口 | `8080` |
-| `proxyAuth` | 代理是否需要认证 | `false` |
-| `proxyUsername` | 代理用户名 | (空) |
-| `proxyPassword` | 代理密码 | (空) |
-| **内置 API 设置** | 简单模式，使用 OpenAI 格式 | |
-| `useCustomApi` | 是否启用自定义 API（开启后下方自定义列表生效） | `false` |
-| `apiEndpoint` | API 端点地址 | `https://api.openai.com/v1/video/generations` |
-| `apiKey` | API 密钥 | (空) |
-| `model` | 模型名称 | `video-generation-model` |
-| `img2videoModel` | 图生视频专用模型（留空使用上方模型） | (空) |
-| `videoDuration` | 视频时长（秒，留空使用全局默认） | `0` |
-| `videoResolution` | 视频分辨率（留空使用全局默认） | (空) |
-| `txt2videoPrompt` | 文生视频提示词模板（留空直接使用用户输入） | (空) |
-| `img2videoPrompt` | 图生视频提示词模板（留空直接使用用户输入） | (空) |
-| `customHeaders` | 自定义请求头 JSON（合并到默认请求头） | `{}` |
-| **自定义 API 配置** | 高级模式，每个条目独立配置 | `[]` |
-| `apiStrategy` | API 调度策略：`sequence` / `roundrobin` | `roundrobin` |
-| `customApiList[].enable` | 是否启用此 API | `true` |
-| `customApiList[].endpoint` | API 端点地址 | `https://api.openai.com/v1/video/generations` |
-| `customApiList[].apiKey` | API 密钥 | (空) |
-| `customApiList[].model` | 模型名称 | `video-generation-model` |
-| `customApiList[].img2videoModel` | 图生视频专用模型（留空使用上方模型） | (空) |
-| `customApiList[].videoDuration` | 视频时长（秒，留空使用全局默认） | `0` |
-| `customApiList[].videoResolution` | 视频分辨率（留空使用全局默认） | (空) |
-| `customApiList[].txt2videoPrompt` | 文生视频提示词模板 | (空) |
-| `customApiList[].img2videoPrompt` | 图生视频提示词模板 | (空) |
-| `customApiList[].customHeaders` | 自定义请求头 JSON，支持 `{apiKey}` 变量 | 见预设 |
-| `customApiList[].bodyTemplate` | 自定义请求体 JSON（高级，留空使用内置） | 见预设 |
-| **权限管理** | | |
-| `blacklistAdmins` | 黑名单管理员 QQ 号列表 | `[]` |
-| **消息文本** | 所有提示文案均可自定义，支持模板变量 | 见配置页 |
-
-> 指令名称（`video`、`redraw`、`blacklist`）为固定注册名，可在 Koishi 的指令管理页面中单独配置别名。
-
-#### 请求范式 JSON (`bodyTemplate` 字段)
-
-`bodyTemplate` 是高级选项，用于完全自定义请求体。留空时插件使用内置模板。
-
-| 字段 | 说明 | 默认值 |
-|------|------|--------|
-| `txt2videoBody` | 文生视频请求体 JSON 模板，支持变量 `{model}` `{prompt}` `{duration}` `{size}` | 内置 |
-| `img2videoBody` | 图生视频请求体 JSON 模板，支持变量 `{model}` `{prompt}` `{duration}` `{size}` `{url}` | 内置 |
-| `responseVideoPath` | 响应 JSON 中视频 URL 的字段路径，如 `video_url` | `video_url` |
-| `pollUrlTemplate` | 轮询地址模板，如 `{endpoint}/{task_id}` | 无 |
-| `taskIdPath` | 返回的任务 ID 字段路径，如 `task_id` | 无 |
-| `method` | HTTP 方法 | `POST` |
-
-**变量说明**  
-- `{model}`：模型名称（取自配置中的全局模型或专用模型）  
-- `{prompt}`：用户输入的提示词（经过提示模板处理后的最终文本）  
-- `{duration}`：视频时长（秒）  
-- `{size}`：视频分辨率（宽x高）  
-- `{url}`：图生视频时参考图片的链接（字符串）  
-- `{apiKey}`：API 密钥，仅用于 `headers` 字段  
-
-**异步轮询说明**  
-当 `pollEnabled` 开启且 API 返回任务 ID 时，插件会根据 `pollUrlTemplate` 和 `taskIdPath` 自动轮询任务状态，直到完成或超时。  
-
-**视频 URL 自动扫描**  
-当 `responseVideoPath` 未命中时，插件会自动扫描响应 JSON 中**第一个包含视频扩展名（.mp4/.mov/.avi/.webm/.mkv）的 HTTP/HTTPS URL** 作为视频地址。  
-
----
-
-### English
+## 功能特性 (Features)
+- 文生视频 / 图生视频，支持附带参考图片 (Txt2video & img2video, with reference image)
+- 多视频合并转发 / 单视频发送灵活切换 (Flexible multi-video sending: forward or single)
+- 主/副模型独立，均可配置多端点负载均衡（顺序 / 轮询）(Independent primary & secondary models, each with multi-endpoint load balancing)
+- 预置提示词模板，关键词自动匹配 (Preset prompts with keyword auto-matching)
+- 图片压缩与 Base64 输入转换，兼容更多后端 (Image compression & Base64 conversion)
+- 端口自动适配（7860/5000/8888 → flat 格式）(Port auto-detect for adapter type)
+- 支持同步返回与异步轮询两种视频生成模式 (Supports both synchronous and async polling modes)
+- 黑名单管理（持久化到数据库）(Blacklist with database persistence)
+- 全配置化提示文案，调试日志，超时控制，频率限制 (Fully configurable messages, debug log, timeout, rate limit)
 
-| Config Item | Description | Default |
-|-------------|-------------|---------|
-| **Basic** | | |
-| `debug` | Debug mode, logs full request/response | `false` |
-| `timeout` | Request timeout (ms), video generation usually slower | `600000` |
-| `rateLimit` | Hourly call limit | `50` |
-| `maxVideos` | Max number of videos per generation | `1` |
-| `videoDuration` | Default video duration (seconds) | `5` |
-| `videoResolution` | Default video resolution (WxH) | `1024x576` |
-| `enableForward` | Use forward message for multiple videos | `true` |
-| `enableTxt2Video` | Enable text-to-video | `true` |
-| `enableImg2Video` | Enable image-to-video | `true` |
-| `videoSendMode` | Video send mode: `video`, `url`, `both` | `video` |
-| `pollEnabled` | Enable async polling (polls until completion if task ID returned) | `false` |
-| `pollInterval` | Polling interval (ms) | `3000` |
-| `pollTimeout` | Polling total timeout (ms) | `600000` |
-| **Proxy** | | |
-| `proxyEnabled` | Enable HTTP/HTTPS proxy | `false` |
-| `proxyProtocol` | Proxy protocol: `http` / `https` | `http` |
-| `proxyHost` | Proxy host | (empty) |
-| `proxyPort` | Proxy port | `8080` |
-| `proxyAuth` | Proxy requires authentication | `false` |
-| `proxyUsername` | Proxy username | (empty) |
-| `proxyPassword` | Proxy password | (empty) |
-| **Built-in API** | Simple mode, uses OpenAI format | |
-| `useCustomApi` | Enable custom API (below list takes effect) | `false` |
-| `apiEndpoint` | API endpoint URL | `https://api.openai.com/v1/video/generations` |
-| `apiKey` | API key | (empty) |
-| `model` | Model name | `video-generation-model` |
-| `img2videoModel` | Image-to-video model (falls back to model) | (empty) |
-| `videoDuration` | Video duration (seconds, 0 = use global) | `0` |
-| `videoResolution` | Video resolution (empty = use global) | (empty) |
-| `txt2videoPrompt` | Prompt template (empty = raw user input) | (empty) |
-| `img2videoPrompt` | Prompt template (empty = raw user input) | (empty) |
-| `customHeaders` | Custom headers JSON (merged into default) | `{}` |
-| **Custom API Config** | Advanced mode, per-entry configuration | `[]` |
-| `apiStrategy` | API strategy: `sequence` / `roundrobin` | `roundrobin` |
-| `customApiList[].enable` | Enable this API | `true` |
-| `customApiList[].endpoint` | API endpoint URL | `https://api.openai.com/v1/video/generations` |
-| `customApiList[].apiKey` | API key | (empty) |
-| `customApiList[].model` | Model name | `video-generation-model` |
-| `customApiList[].img2videoModel` | Image-to-video model (falls back to model) | (empty) |
-| `customApiList[].videoDuration` | Video duration (seconds, 0 = use global) | `0` |
-| `customApiList[].videoResolution` | Video resolution (empty = use global) | (empty) |
-| `customApiList[].txt2videoPrompt` | Prompt template | (empty) |
-| `customApiList[].img2videoPrompt` | Prompt template | (empty) |
-| `customApiList[].customHeaders` | Custom headers JSON, supports `{apiKey}` | preset |
-| `customApiList[].bodyTemplate` | Custom request body JSON (advanced) | preset |
-| **Permissions** | | |
-| `blacklistAdmins` | Admin QQ number list | `[]` |
-| **Messages** | All messages customizable with template vars | see schema |
-
-> Command names (`video`, `redraw`, `blacklist`) are fixed; aliases can be configured via Koishi's command management page.
-
-#### Request Template JSON (`bodyTemplate` field)
-
-`bodyTemplate` is the advanced option for full custom request bodies. Leave empty to use built-in templates.
-
-| Field | Description | Default |
-|-------|-------------|---------|
-| `txt2videoBody` | Txt2video request body template, vars `{model}` `{prompt}` `{duration}` `{size}` | built-in |
-| `img2videoBody` | Img2video request body template, vars `{model}` `{prompt}` `{duration}` `{size}` `{url}` | built-in |
-| `responseVideoPath` | JSON path to video URL, e.g. `video_url` | `video_url` |
-| `pollUrlTemplate` | Polling URL template, e.g. `{endpoint}/{task_id}` | none |
-| `taskIdPath` | JSON path to task ID, e.g. `task_id` | none |
-| `method` | HTTP method | `POST` |
-
-**Variable placeholders**  
-- `{model}` — Model name  
-- `{prompt}` — Processed user prompt after template expansion  
-- `{duration}` — Video duration in seconds  
-- `{size}` — Video resolution (WxH)  
-- `{url}` — Reference image URL for image-to-video  
-- `{apiKey}` — API key, used only in `headers`
-
-**Async Polling**  
-When `pollEnabled` is on and the API returns a task ID, the plugin will automatically poll using `pollUrlTemplate` and `taskIdPath` until completion or timeout.  
-
-**Auto Video URL Scanning**  
-When `responseVideoPath` fails, the plugin scans the response JSON for the **first HTTP/HTTPS URL with a video extension (.mp4/.mov/.avi/.webm/.mkv)** as the video address.  
-
----
+## 依赖 (Dependencies)
+- **数据库 (database)**：必须启用，用于黑名单持久化。 (Required for blacklist persistence)
+- **图生视频 (img2video)**：需要 `assets` 服务及正确的 `selfUrl` 配置。 (Requires `assets` service and correct `selfUrl`)
+- **图片压缩 (optional)**：需要安装 `sharp` 模块。 (Optional: `sharp` module for compression)
 
 ## 自定义 API 端点示例 (Custom Endpoint Examples)
 
@@ -221,7 +151,6 @@ When `responseVideoPath` fails, the plugin scans the response JSON for the **fir
   "img2videoBody": "{\"model\":\"{model}\",\"prompt\":\"{prompt}\",\"duration\":{duration},\"size\":\"{size}\",\"image_url\":\"{url}\"}",
   "responseVideoPath": "video_url"
 }
-```
 
 ### 异步轮询 API（返回任务 ID）
 ```json
@@ -237,25 +166,13 @@ When `responseVideoPath` fails, the plugin scans the response JSON for the **fir
 }
 ```
 
-## 依赖 (Dependencies)
-- **数据库 (database)**：必须启用，用于黑名单持久化。
-- **图生视频 (img2video)**：需要 `assets` 服务及正确的 `selfUrl` 配置。
-
-## 功能特性 (Features)
-- 文生视频 / 图生视频（自动识别消息中是否附带图片）
-- 多 API 轮询与负载均衡（sequence / roundrobin）
-- 支持同步返回与异步轮询两种模式，适配不同视频生成服务
-- 灵活的请求体模板系统，变量自动替换，一套配置兼容任意平台
-- 视频结果支持文件发送和链接发送
-- 黑名单管理（持久化到数据库）
-- 全配置化提示文案，支持模板变量
-- 调试日志、超时控制、频率限制
-
 ## 项目贡献者 (Contributors)
 | 贡献者 (Contributor) | 贡献内容 (Contribution) |
 | --- | --- |
-| Minecraft-1314 | 插件完整开发（从绘图插件改造） |
+| Minecraft-1314 | 插件完整开发 (Complete plugin development) |
+| xiaochuqiangda | 参考了 koishi-plugin-imagedraw-selfuse 插件的功能 (This feature references the koishi-plugin-imagedraw-selfuse plugin) |
 | （欢迎提交 PR / Issues 加入贡献者列表） |
+| (Welcome to join the contributor list via PR or Issues) |
 
 ## 许可协议 (License)
 本项目采用 MIT 许可证，详情参见 LICENSE 文件。