koishi-plugin-media-luna 0.0.1

package/lib/plugins/cache/middleware.js

@@ -0,0 +1,194 @@
+// 存储中间件 - 将输入文件和生成结果上传到存储后端
+import { uploadToS3, uploadToWebDav, getExtensionFromMime } from './utils';
+// ============ 配置转换 ============
+function toS3Config(config) {
+    return {
+        endpoint: config.s3Endpoint,
+        region: config.s3Region,
+        accessKeyId: config.s3AccessKeyId,
+        secretAccessKey: config.s3SecretAccessKey,
+        bucket: config.s3Bucket,
+        publicBaseUrl: config.s3PublicBaseUrl,
+        forcePathStyle: config.s3ForcePathStyle,
+        acl: config.s3Acl
+    };
+}
+function toWebDavConfig(config) {
+    return {
+        endpoint: config.webdavEndpoint,
+        username: config.webdavUsername,
+        password: config.webdavPassword,
+        basePath: config.webdavBasePath,
+        publicBaseUrl: config.webdavPublicBaseUrl
+    };
+}
+// ============ 工具函数 ============
+async function downloadAsset(url) {
+    const resp = await fetch(url);
+    if (!resp.ok)
+        throw new Error(`下载失败: ${resp.status}`);
+    const arrayBuffer = await resp.arrayBuffer();
+    const mime = resp.headers.get('content-type') || 'application/octet-stream';
+    return { buffer: Buffer.from(arrayBuffer), mime };
+}
+/**
+ * 上传文件到指定后端
+ */
+async function uploadToBackend(buffer, filename, mime, config, mctx) {
+    switch (config.backend) {
+        case 'local': {
+            const cacheService = mctx.getService('cache');
+            if (!cacheService) {
+                throw new Error('本地缓存服务不可用');
+            }
+            const cached = await cacheService.cache(buffer, mime, filename);
+            const url = cacheService.getUrl(cached.id);
+            if (!url) {
+                throw new Error('无法获取缓存 URL，请检查 selfUrl 配置');
+            }
+            return { url, key: cached.id };
+        }
+        case 's3':
+            return uploadToS3(buffer, filename, mime, toS3Config(config));
+        case 'webdav':
+            return uploadToWebDav(buffer, filename, mime, toWebDavConfig(config));
+        default:
+            throw new Error(`未知的存储后端: ${config.backend}`);
+    }
+}
+// ============ 中间件定义 ============
+/**
+ * 输入文件存储中间件
+ * 在 lifecycle-prepare 阶段将输入文件上传到存储后端
+ */
+export function createStorageInputMiddleware() {
+    return {
+        name: 'storage-input',
+        displayName: '输入文件存储',
+        description: '将输入文件上传到存储后端（本地/S3/WebDAV）',
+        category: 'cache',
+        phase: 'lifecycle-prepare',
+        // 配置在 cache 插件的"扩展插件"面板中设置
+        async execute(mctx, next) {
+            const cacheService = mctx.getService('cache');
+            if (!cacheService) {
+                return next();
+            }
+            const config = cacheService.getConfig();
+            // 没有文件或配置为 none 时跳过
+            if (!mctx.files || mctx.files.length === 0 || config.backend === 'none') {
+                return next();
+            }
+            const uploadLogs = [];
+            const uploadedUrls = [];
+            for (let i = 0; i < mctx.files.length; i++) {
+                const file = mctx.files[i];
+                if (!file.data || file.data.byteLength === 0) {
+                    continue;
+                }
+                try {
+                    const buffer = Buffer.from(file.data);
+                    const ext = getExtensionFromMime(file.mime);
+                    const filename = `input-${i}${ext}`;
+                    const result = await uploadToBackend(buffer, filename, file.mime, config, mctx);
+                    uploadedUrls.push(result.url);
+                    uploadLogs.push({ index: i, filename: file.filename, url: result.url });
+                }
+                catch (error) {
+                    uploadLogs.push({
+                        index: i,
+                        filename: file.filename,
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            }
+            if (uploadedUrls.length > 0) {
+                mctx.store.set('inputFileUrls', uploadedUrls);
+            }
+            mctx.setMiddlewareLog('storage-input', {
+                backend: config.backend,
+                total: mctx.files.length,
+                uploaded: uploadLogs.filter(l => l.url).length,
+                failed: uploadLogs.filter(l => l.error).length,
+                urls: uploadedUrls,
+                logs: uploadLogs
+            });
+            return next();
+        }
+    };
+}
+/**
+ * 输出存储中间件
+ * 在 lifecycle-post-request 阶段将生成结果上传到存储后端
+ */
+export function createStorageMiddleware() {
+    return {
+        name: 'storage',
+        displayName: '存储缓存',
+        description: '将生成结果上传到存储后端（本地/S3/WebDAV）',
+        category: 'cache',
+        phase: 'lifecycle-post-request',
+        // 配置在 cache 插件的"扩展插件"面板中设置
+        async execute(mctx, next) {
+            const cacheService = mctx.getService('cache');
+            if (!cacheService) {
+                return next();
+            }
+            const config = cacheService.getConfig();
+            // 没有输出或配置为 none 时跳过
+            if (!mctx.output || mctx.output.length === 0 || config.backend === 'none') {
+                return next();
+            }
+            const uploadedAssets = [];
+            const uploadLogs = [];
+            for (let i = 0; i < mctx.output.length; i++) {
+                const asset = mctx.output[i];
+                // 跳过文本类型或没有 URL 的资产
+                if (asset.kind === 'text' || !asset.url) {
+                    uploadedAssets.push(asset);
+                    continue;
+                }
+                try {
+                    const { buffer, mime } = await downloadAsset(asset.url);
+                    const filename = `output-${asset.kind}-${i}`;
+                    const result = await uploadToBackend(buffer, filename, mime, config, mctx);
+                    const isBase64 = asset.url.startsWith('data:');
+                    uploadedAssets.push({
+                        ...asset,
+                        url: result.url,
+                        meta: {
+                            ...asset.meta,
+                            ...(isBase64 ? {} : { originalUrl: asset.url }),
+                            storageKey: result.key,
+                            storageBackend: config.backend
+                        }
+                    });
+                    uploadLogs.push({
+                        index: i,
+                        originalUrl: isBase64 ? '[base64 data]' : asset.url,
+                        newUrl: result.url
+                    });
+                }
+                catch (error) {
+                    uploadedAssets.push(asset);
+                    const isBase64 = asset.url.startsWith('data:');
+                    uploadLogs.push({
+                        index: i,
+                        originalUrl: isBase64 ? '[base64 data]' : asset.url,
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            }
+            mctx.output = uploadedAssets;
+            mctx.setMiddlewareLog('storage', {
+                backend: config.backend,
+                total: mctx.output.length,
+                uploaded: uploadLogs.filter(l => l.newUrl).length,
+                failed: uploadLogs.filter(l => l.error).length,
+                logs: uploadLogs
+            });
+            return next();
+        }
+    };
+}
+//# sourceMappingURL=middleware.js.map

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

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

package/lib/plugins/cache/service.d.ts

@@ -0,0 +1,106 @@
+import { Context } from 'koishi';
+import type { CachePluginConfig } from './config';
+/** 缓存文件元数据（兼容旧接口） */
+export interface CachedFile {
+    id: string;
+    filename: string;
+    mime: string;
+    size: number;
+    createdAt: Date;
+    accessedAt: Date;
+    localPath: string;
+    /** 可访问的 URL */
+    url?: string;
+}
+/** 缓存统计 */
+export interface CacheStats {
+    totalFiles: number;
+    totalSizeMB: number;
+    maxSizeMB: number;
+    oldestAccess: Date | null;
+    newestAccess: Date | null;
+}
+/**
+ * 本地缓存服务
+ * 提供文件缓存和 HTTP 访问支持
+ * 使用数据库存储元数据，支持 sourceHash 和 contentHash 两级去重
+ */
+export declare class CacheService {
+    private logger;
+    private ctx;
+    private cacheRoot;
+    private publicPath;
+    private publicBaseUrl;
+    private config;
+    /** 基础URL（从 selfUrl 获取），用于生成访问链接 */
+    private baseUrl;
+    /** 内存缓存（加速查询） */
+    private memoryCache;
+    /** 是否已初始化 */
+    private initialized;
+    constructor(ctx: Context, config: CachePluginConfig);
+    /** 异步初始化 */
+    private initialize;
+    /** 从数据库加载缓存元数据到内存 */
+    private loadFromDatabase;
+    /** 更新配置 */
+    updateConfig(config: Partial<CachePluginConfig>): void;
+    /** 设置基础URL */
+    setBaseUrl(url: string): void;
+    /** 获取基础URL */
+    getBaseUrl(): string;
+    /** 检查缓存是否启用 */
+    isEnabled(): boolean;
+    /** 获取完整配置（供中间件使用） */
+    getConfig(): CachePluginConfig;
+    /**
+     * 缓存文件到本地
+     * @param data 文件数据
+     * @param mime MIME 类型
+     * @param filename 文件名
+     * @param sourceUrl 可选的源 URL（用于 sourceHash 去重）
+     */
+    cache(data: Buffer | ArrayBuffer, mime: string, filename?: string, sourceUrl?: string): Promise<CachedFile>;
+    /**
+     * 从 URL 下载并缓存
+     * 支持 sourceHash 去重：相同 URL 不会重复下载
+     */
+    cacheFromUrl(url: string): Promise<CachedFile>;
+    /** 获取缓存文件的访问URL */
+    getUrl(id: string): string | null;
+    /** 获取缓存文件信息 */
+    get(id: string): Promise<CachedFile | null>;
+    /** 读取缓存文件内容 */
+    read(id: string): Promise<Buffer | null>;
+    /** 读取为 Data URL */
+    readAsDataUrl(id: string): Promise<string | null>;
+    /** 删除缓存文件 */
+    delete(id: string): Promise<boolean>;
+    /** 获取统计信息 */
+    getStats(): Promise<CacheStats>;
+    /** 清空所有缓存 */
+    clearAll(): Promise<void>;
+    /** 通过 sourceHash 查找缓存 */
+    private findBySourceHash;
+    /** 通过 contentHash 查找缓存 */
+    private findByContentHash;
+    /** 更新访问时间 */
+    private updateAccessTime;
+    /** 从数据库删除 */
+    private deleteFromDatabase;
+    /** 将数据库记录转换为 CachedFile */
+    private dbRecordToCachedFile;
+    private ensureDir;
+    /** 生成内容哈希（基于文件内容） */
+    private generateContentHash;
+    /** 生成源哈希（基于 URL） */
+    private generateSourceHash;
+    private getExtension;
+    private getExtensionFromMime;
+    private guessMimeFromUrl;
+    /** 构建访问 URL */
+    private buildUrl;
+    private ensureCacheSpace;
+    private cleanupExpired;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/plugins/cache/service.d.ts.map

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