koishi-plugin-media-luna 0.0.1

package/lib/plugins/index.js

@@ -0,0 +1,21 @@
+// Plugins Index - 导出所有插件
+// 功能插件
+export { default as cachePlugin } from './cache';
+export { default as presetPlugin } from './preset';
+export { default as billingPlugin } from './billing';
+export { default as taskPlugin } from './task';
+export { default as promptEncodingPlugin } from './prompt-encoding';
+export { default as webuiAuthPlugin } from './webui-auth';
+// 连接器插件
+export { default as dalleConnectorPlugin } from './connector-dalle';
+export { default as sdWebuiConnectorPlugin } from './connector-sd-webui';
+export { default as fluxConnectorPlugin } from './connector-flux';
+export { default as chatApiConnectorPlugin } from './connector-chat-api';
+// 导出服务
+export { CacheService } from './cache';
+export { PresetService, RemoteSyncService } from './preset';
+export { TaskService } from './task';
+export { WebuiAuthService } from './webui-auth';
+// 导出中间件工厂
+export { createPromptEncodingMiddleware } from './prompt-encoding';
+//# sourceMappingURL=index.js.map

package/lib/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AAEzB,OAAO;AACP,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAA;AAC9C,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,cAAc,CAAA;AAEzD,QAAQ;AACR,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAUxE,OAAO;AACP,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,UAAU;AACV,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAA"}

package/lib/plugins/preset/config.d.ts

@@ -0,0 +1,37 @@
+import type { ConfigField } from '../../core';
+/** 预设中间件配置 */
+export interface PresetMiddlewareConfig {
+    /** 默认预设名称 */
+    defaultPreset?: string;
+    /** 是否启用 */
+    enabled?: boolean;
+}
+/** 远程同步配置 */
+export interface RemoteSyncConfig {
+    /** 远程 API URL */
+    apiUrl: string;
+    /** 是否启用自动同步 */
+    autoSync: boolean;
+    /** 自动同步间隔（分钟） */
+    syncInterval: number;
+    /** 同步时是否删除远程已移除的预设 */
+    deleteRemoved: boolean;
+    /** 缩略图下载延迟（毫秒），用于限流 */
+    thumbnailDelay: number;
+    /** 上次同步的 ETag（用于 304 缓存） */
+    lastETag?: string;
+    /** 上次同步时间 */
+    lastSyncTime?: string;
+}
+/** 预设插件完整配置 */
+export interface PresetPluginConfig extends PresetMiddlewareConfig, RemoteSyncConfig {
+}
+/** 预设中间件配置字段 */
+export declare const presetMiddlewareConfigFields: ConfigField[];
+/** 远程同步配置字段 */
+export declare const remoteSyncConfigFields: ConfigField[];
+/** 全部配置字段 */
+export declare const presetConfigFields: ConfigField[];
+/** 默认配置 */
+export declare const defaultPresetConfig: PresetPluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/plugins/preset/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/plugins/preset/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,cAAc;AACd,MAAM,WAAW,sBAAsB;IACrC,aAAa;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,eAAe;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,iBAAiB;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,sBAAsB;IACtB,aAAa,EAAE,OAAO,CAAA;IACtB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,eAAe;AACf,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB,EAAE,gBAAgB;CAAG;AAEvF,gBAAgB;AAChB,eAAO,MAAM,4BAA4B,EAAE,WAAW,EAerD,CAAA;AAED,eAAe;AACf,eAAO,MAAM,sBAAsB,EAAE,WAAW,EAsC/C,CAAA;AAED,aAAa;AACb,eAAO,MAAM,kBAAkB,EAAE,WAAW,EAG3C,CAAA;AAED,WAAW;AACX,eAAO,MAAM,mBAAmB,EAAE,kBAQjC,CAAA"}

package/lib/plugins/preset/config.js

@@ -0,0 +1,74 @@
+// 预设插件配置字段定义
+/** 预设中间件配置字段 */
+export const presetMiddlewareConfigFields = [
+    {
+        key: 'enabled',
+        label: '启用预设处理',
+        type: 'boolean',
+        default: true,
+        description: '是否启用预设中间件'
+    },
+    {
+        key: 'defaultPreset',
+        label: '默认预设',
+        type: 'text',
+        placeholder: '留空则不使用默认预设',
+        description: '当用户未指定预设时使用的默认预设名称'
+    }
+];
+/** 远程同步配置字段 */
+export const remoteSyncConfigFields = [
+    {
+        key: 'apiUrl',
+        label: '在线预设api地址',
+        type: 'text',
+        default: 'https://prompt.vioaki.xyz/api/templates?per_page=-1',
+        placeholder: 'https://prompt.vioaki.xyz/api/templates?per_page=-1',
+        description: '项目地址：https://github.com/vioaki/Prompt-Manager'
+    },
+    {
+        key: 'autoSync',
+        label: '自动同步',
+        type: 'boolean',
+        default: false,
+        description: '启用后将定期从远程同步预设'
+    },
+    {
+        key: 'syncInterval',
+        label: '同步间隔',
+        type: 'number',
+        default: 60,
+        description: '自动同步间隔（分钟）',
+        showWhen: { field: 'autoSync', value: true }
+    },
+    {
+        key: 'deleteRemoved',
+        label: '删除已移除',
+        type: 'boolean',
+        default: false,
+        description: '同步时删除远程已移除的预设'
+    },
+    {
+        key: 'thumbnailDelay',
+        label: '下载限流',
+        type: 'number',
+        default: 100,
+        description: '缩略图下载间隔（毫秒），避免对远程服务器造成压力，0 表示不限制'
+    }
+];
+/** 全部配置字段 */
+export const presetConfigFields = [
+    ...presetMiddlewareConfigFields,
+    ...remoteSyncConfigFields
+];
+/** 默认配置 */
+export const defaultPresetConfig = {
+    enabled: true,
+    defaultPreset: '',
+    apiUrl: 'https://prompt.vioaki.xyz/api/templates?per_page=-1',
+    autoSync: false,
+    syncInterval: 60,
+    deleteRemoved: false,
+    thumbnailDelay: 100
+};
+//# sourceMappingURL=config.js.map

package/lib/plugins/preset/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/plugins/preset/config.ts"],"names":[],"mappings":"AAAA,aAAa;AAiCb,gBAAgB;AAChB,MAAM,CAAC,MAAM,4BAA4B,GAAkB;IACzD;QACE,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,WAAW;KACzB;IACD;QACE,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;QACzB,WAAW,EAAE,oBAAoB;KAClC;CACF,CAAA;AAED,eAAe;AACf,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD;QACE,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,qDAAqD;QAC9D,WAAW,EAAE,qDAAqD;QAClE,WAAW,EAAE,+CAA+C;KAC7D;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,eAAe;KAC7B;IACD;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE;KAC7C;IACD;QACE,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,eAAe;KAC7B;IACD;QACE,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,GAAG;QACZ,WAAW,EAAE,kCAAkC;KAChD;CACF,CAAA;AAED,aAAa;AACb,MAAM,CAAC,MAAM,kBAAkB,GAAkB;IAC/C,GAAG,4BAA4B;IAC/B,GAAG,sBAAsB;CAC1B,CAAA;AAED,WAAW;AACX,MAAM,CAAC,MAAM,mBAAmB,GAAuB;IACrD,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,EAAE;IACjB,MAAM,EAAE,qDAAqD;IAC7D,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,GAAG;CACpB,CAAA"}

package/lib/plugins/preset/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: import("../../core").PluginDefinition;
+export default _default;
+export { PresetService, PresetData } from './service';
+export { RemoteSyncService, SyncResult } from './remote-sync.service';
+export type { PresetPluginConfig, PresetMiddlewareConfig, RemoteSyncConfig } from './config';
+//# sourceMappingURL=index.d.ts.map

package/lib/plugins/preset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/preset/index.ts"],"names":[],"mappings":";AASA,wBAuDE;AAGF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACrE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA"}

package/lib/plugins/preset/index.js

@@ -0,0 +1,58 @@
+// 预设插件入口
+import { definePlugin } from '../../core';
+import { PresetService } from './service';
+import { RemoteSyncService } from './remote-sync.service';
+import { createPresetMiddleware } from './middleware';
+import { presetConfigFields, defaultPresetConfig } from './config';
+export default definePlugin({
+    id: 'preset',
+    name: '预设管理',
+    description: '预设模板和远程同步支持',
+    version: '1.0.0',
+    services: [
+        {
+            name: 'preset',
+            factory: (ctx) => new PresetService(ctx.ctx)
+        },
+        {
+            name: 'remote-sync',
+            factory: (ctx) => {
+                const presetService = ctx.getService('preset');
+                // 提供一个获取缓存服务的回调，避免直接访问 ctx.mediaLuna 导致的警告
+                const getCacheService = () => ctx.getService('cache');
+                return new RemoteSyncService(ctx.ctx, presetService, getCacheService);
+            }
+        }
+    ],
+    middlewares: [
+        createPresetMiddleware()
+    ],
+    configFields: presetConfigFields,
+    configDefaults: defaultPresetConfig,
+    settingsActions: [
+        {
+            name: 'sync',
+            label: '立即同步',
+            type: 'primary',
+            icon: 'sync',
+            apiEvent: 'media-luna/presets/sync'
+        }
+    ],
+    async onLoad(ctx) {
+        const remoteSyncService = ctx.getService('remote-sync');
+        // 启动自动同步
+        const config = ctx.getConfig();
+        if (config.autoSync && config.apiUrl) {
+            remoteSyncService.startAutoSync(config);
+        }
+        // 注册 dispose 回调
+        ctx.onDispose(() => {
+            remoteSyncService.dispose();
+        });
+        ctx.logger.info('Preset plugin loaded');
+    }
+});
+// 导出类型和服务
+export { PresetService } from './service';
+export { RemoteSyncService } from './remote-sync.service';
+//# sourceMappingURL=index.js.map

package/lib/plugins/preset/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/preset/index.ts"],"names":[],"mappings":"AAAA,SAAS;AAET,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAA2B,MAAM,UAAU,CAAA;AAG3F,eAAe,YAAY,CAAC;IAC1B,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,OAAO;IAEhB,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;SAC7C;QACD;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,MAAM,aAAa,GAAG,GAAG,CAAC,UAAU,CAAgB,QAAQ,CAAE,CAAA;gBAC9D,2CAA2C;gBAC3C,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAe,OAAO,CAAC,CAAA;gBACnE,OAAO,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,eAAe,CAAC,CAAA;YACvE,CAAC;SACF;KACF;IAED,WAAW,EAAE;QACX,sBAAsB,EAAE;KACzB;IAED,YAAY,EAAE,kBAAkB;IAChC,cAAc,EAAE,mBAAmB;IAEnC,eAAe,EAAE;QACf;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,yBAAyB;SACpC;KACF;IAED,KAAK,CAAC,MAAM,CAAC,GAAG;QACd,MAAM,iBAAiB,GAAG,GAAG,CAAC,UAAU,CAAoB,aAAa,CAAE,CAAA;QAE3E,SAAS;QACT,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAsB,CAAA;QAClD,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACrC,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QACzC,CAAC;QAED,gBAAgB;QAChB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,iBAAiB,CAAC,OAAO,EAAE,CAAA;QAC7B,CAAC,CAAC,CAAA;QAEF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;IACzC,CAAC;CACF,CAAC,CAAA;AAEF,UAAU;AACV,OAAO,EAAE,aAAa,EAAc,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAc,MAAM,uBAAuB,CAAA"}

package/lib/plugins/preset/middleware.d.ts

@@ -0,0 +1,6 @@
+import type { MiddlewareDefinition } from '../../core';
+/**
+ * 创建预设中间件
+ */
+export declare function createPresetMiddleware(): MiddlewareDefinition;
+//# sourceMappingURL=middleware.d.ts.map

package/lib/plugins/preset/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/plugins/preset/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,YAAY,CAAA;AAInB;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,oBAAoB,CAiE7D"}

package/lib/plugins/preset/middleware.js

@@ -0,0 +1,126 @@
+// 预设中间件
+/**
+ * 创建预设中间件
+ */
+export function createPresetMiddleware() {
+    return {
+        name: 'preset',
+        displayName: '预设处理',
+        description: '应用预设模板和参考图到生成请求',
+        category: 'preset',
+        phase: 'lifecycle-pre-request',
+        // 配置在 preset 插件的扩展插件面板中设置
+        async execute(context, next) {
+            const config = await context.getMiddlewareConfig('preset');
+            if (config?.enabled === false) {
+                return next();
+            }
+            // 从上下文获取 presetService
+            const presetService = context.getService('preset');
+            if (!presetService) {
+                return next();
+            }
+            const presetName = context.parameters.preset || config?.defaultPreset;
+            if (!presetName) {
+                return next();
+            }
+            const preset = await presetService.getByName(presetName);
+            if (!preset) {
+                return next();
+            }
+            if (!preset.enabled) {
+                return next();
+            }
+            // 注入预设参考图
+            if (preset.referenceImages && preset.referenceImages.length > 0) {
+                const presetFiles = await loadReferenceImages(context.ctx, preset.referenceImages);
+                context.files = [...presetFiles, ...context.files];
+            }
+            // 应用预设模板
+            const originalPrompt = context.prompt;
+            context.prompt = applyTemplate(preset.promptTemplate, originalPrompt);
+            // 应用参数覆盖
+            if (preset.parameterOverrides) {
+                context.parameters = {
+                    ...context.parameters,
+                    ...preset.parameterOverrides
+                };
+            }
+            context.setMiddlewareLog('preset', {
+                presetId: preset.id,
+                presetName: preset.name,
+                originalPrompt,
+                transformedPrompt: context.prompt,
+                referenceImagesInjected: preset.referenceImages?.length ?? 0
+            });
+            return next();
+        }
+    };
+}
+/** 加载参考图 */
+async function loadReferenceImages(ctx, urls) {
+    const files = [];
+    for (const url of urls) {
+        try {
+            if (url.startsWith('http://') || url.startsWith('https://')) {
+                const response = await ctx.http.get(url, {
+                    responseType: 'arraybuffer'
+                });
+                const mime = guessMimeFromUrl(url);
+                const filename = url.split('/').pop() || 'reference.png';
+                files.push({
+                    data: response,
+                    mime,
+                    filename
+                });
+            }
+            else if (url.startsWith('data:')) {
+                const matches = url.match(/^data:([^;]+);base64,(.+)$/);
+                if (matches) {
+                    const mime = matches[1];
+                    const base64 = matches[2];
+                    const buffer = Buffer.from(base64, 'base64');
+                    const parts = mime.split('/');
+                    const ext = parts[1] || 'png';
+                    files.push({
+                        data: buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength),
+                        mime,
+                        filename: `reference.${ext}`
+                    });
+                }
+            }
+        }
+        catch {
+            // 忽略加载失败的图片
+        }
+    }
+    return files;
+}
+/** 从 URL 推断 MIME 类型 */
+function guessMimeFromUrl(url) {
+    const ext = url.split('.').pop()?.toLowerCase();
+    switch (ext) {
+        case 'jpg':
+        case 'jpeg':
+            return 'image/jpeg';
+        case 'png':
+            return 'image/png';
+        case 'gif':
+            return 'image/gif';
+        case 'webp':
+            return 'image/webp';
+        default:
+            return 'image/png';
+    }
+}
+/** 应用模板替换 */
+function applyTemplate(template, userText) {
+    if (template.includes('{prompt}')) {
+        return template.replace(/\{prompt\}/g, userText);
+    }
+    if (template.includes('{{userText}}')) {
+        return template.replace(/\{\{userText\}\}/g, userText);
+    }
+    return `${template}\n\n${userText}`;
+}
+//# sourceMappingURL=middleware.js.map

package/lib/plugins/preset/middleware.js.map

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

package/lib/plugins/preset/remote-sync.service.d.ts

@@ -0,0 +1,84 @@
+import { Context } from 'koishi';
+import { PresetService, PresetData } from './service';
+import type { RemoteSyncConfig } from './config';
+import type { CacheService } from '../cache/service';
+/** 远程 API 返回的模板数据 */
+interface RemoteTemplate {
+    id: number;
+    title: string;
+    prompt: string;
+    type: string;
+    tags: string[];
+    category: string;
+    file_path: string;
+    thumbnail_path: string;
+    refs: Array<{
+        id: number;
+        file_path: string;
+        is_placeholder: boolean;
+        position: number;
+    }>;
+    created_at: string;
+    description?: string;
+    author?: string;
+    heat_score?: number;
+}
+/** 同步结果 */
+export interface SyncResult {
+    success: boolean;
+    added: number;
+    updated: number;
+    removed: number;
+    errors: string[];
+    /** 是否命中缓存（304 Not Modified） */
+    notModified?: boolean;
+}
+/** 拉取结果 */
+interface FetchResult {
+    templates: RemoteTemplate[];
+    notModified: boolean;
+    etag?: string;
+}
+/**
+ * 远程预设同步服务
+ */
+export declare class RemoteSyncService {
+    private _ctx;
+    private _logger;
+    private _presetService;
+    private _getCacheService;
+    private _syncDispose;
+    /** 存储每个 API URL 对应的 ETag */
+    private _etagCache;
+    constructor(ctx: Context, presetService: PresetService, getCacheService: () => CacheService | undefined);
+    /** 从远程 API 拉取模板列表（支持 ETag 缓存） */
+    fetchRemoteTemplates(apiUrl: string): Promise<FetchResult>;
+    /** 将远程模板转换为本地预设数据（不含缓存处理） */
+    transformToPreset(template: RemoteTemplate, remoteUrl: string): Omit<PresetData, 'id'>;
+    /**
+     * 缓存预设的图片资源（缩略图和参考图片）
+     * @param presetData 预设数据（需要包含 thumbnailRemote 和 referenceImagesRemote）
+     * @param thumbnailDelay 下载间隔（毫秒），用于限流
+     * @returns 更新后的预设数据（包含缓存后的 URL）
+     */
+    cachePresetImages(presetData: Omit<PresetData, 'id'>, thumbnailDelay?: number): Promise<Omit<PresetData, 'id'>>;
+    /** 执行同步 */
+    sync(apiUrl: string, deleteRemoved?: boolean, thumbnailDelay?: number): Promise<SyncResult>;
+    /**
+     * 判断是否需要重新缓存图片
+     * - 新预设需要缓存
+     * - 远程URL变化需要重新缓存
+     * - 本地缓存URL为空需要缓存
+     */
+    private _needsImageCaching;
+    /** 启动定时同步 */
+    startAutoSync(config: RemoteSyncConfig): void;
+    /** 停止定时同步 */
+    stopAutoSync(): void;
+    /** 清除 ETag 缓存（强制下次完整拉取） */
+    clearEtagCache(apiUrl?: string): void;
+    /** 销毁服务 */
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=remote-sync.service.d.ts.map

package/lib/plugins/preset/remote-sync.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-sync.service.d.ts","sourceRoot":"","sources":["../../../src/plugins/preset/remote-sync.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAGhC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,qBAAqB;AACrB,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,KAAK,CAAC;QACV,EAAE,EAAE,MAAM,CAAA;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,OAAO,CAAA;QACvB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAC,CAAA;IACF,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAcD,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,WAAW;AACX,UAAU,WAAW;IACnB,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,WAAW,EAAE,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,YAAY,CAA4B;IAChD,4BAA4B;IAC5B,OAAO,CAAC,UAAU,CAAiC;gBAGjD,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,MAAM,YAAY,GAAG,SAAS;IAQjD,iCAAiC;IAC3B,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2DhE,6BAA6B;IAC7B,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;IA2BtF;;;;;OAKG;IACG,iBAAiB,CACrB,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAClC,cAAc,GAAE,MAAY,GAC3B,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAoElC,WAAW;IACL,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,GAAE,OAAe,EAAE,cAAc,GAAE,MAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAiG7G;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAuB1B,aAAa;IACb,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IA2C7C,aAAa;IACb,YAAY,IAAI,IAAI;IAQpB,2BAA2B;IAC3B,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IASrC,WAAW;IACX,OAAO,IAAI,IAAI;CAIhB"}