sa2kit 1.2.0 → 1.3.0

package/dist/mmd/server/index.d.mts

@@ -0,0 +1,138 @@
+export { M as MmdPlaylist, f as MmdPlaylistNode, j as MmdPresetItem, h as MmdResourceOption, N as NewMmdPlaylist, g as NewMmdPlaylistNode, k as NewMmdPresetItem, i as NewMmdResourceOption, a as mmdPlaylistNodes, e as mmdPlaylistNodesRelations, m as mmdPlaylists, d as mmdPlaylistsRelations, c as mmdPresetItems, b as mmdResourceOptions } from '../../drizzle-schema-BNhqj2AZ.mjs';
+import { M as MMDPlaylistConfig } from '../../types-Bc_p-zAR.mjs';
+import { U as UniversalFileService } from '../../UniversalFileService-CGGzYeeF.mjs';
+import { F as FileMetadata } from '../../types-CK4We_aI.mjs';
+import 'drizzle-orm';
+import 'drizzle-orm/pg-core';
+import 'three';
+import 'events';
+
+type SupportedModelFormat = 'pmx' | 'pmd';
+interface ProcessMmdModelArchiveOptions {
+    /**
+     * 绝对路径，指向模型解压根目录，例如 /app/uploads/mmd/models
+     */
+    storageRoot: string;
+    /**
+     * 对外暴露的公共路径前缀，例如 /uploads/mmd/models
+     * 默认与 storageRoot 中的叶子目录一致
+     */
+    publicRoot?: string;
+    /**
+     * 自定义文件夹名称，默认使用随机 UUID
+     */
+    folderName?: string;
+}
+interface ProcessMmdModelArchiveResult {
+    /** 解压出来的目录（绝对路径） */
+    directory: string;
+    /** 与 storageRoot 相对的目录名 */
+    relativeDirectory: string;
+    /** 模型文件相对目录（包含子目录） */
+    modelRelativePath: string;
+    /** 可供前端使用的模型 URL */
+    modelUrl: string;
+    /** 模型格式 */
+    format: SupportedModelFormat;
+    /** 解压得到的文件数量 */
+    filesExtracted: number;
+}
+declare const MMD_MODEL_ARCHIVE_MIME_TYPES: readonly ["application/zip", "application/x-zip-compressed", "multipart/x-zip"];
+/**
+ * 解析上传的 MMD 模型压缩包，保留目录结构并返回模型路径
+ */
+declare function processMmdModelArchive(buffer: Buffer, options: ProcessMmdModelArchiveOptions): Promise<ProcessMmdModelArchiveResult>;
+
+interface PlaylistModelSource {
+    id: string | number;
+    name: string;
+    filePath: string;
+    thumbnailPath?: string | null;
+}
+interface PlaylistMotionSource {
+    id: string | number;
+    name?: string;
+    filePath: string;
+}
+interface BuildMmdPlaylistOptions {
+    playlistId: string;
+    playlistName?: string;
+    models: PlaylistModelSource[];
+    motions?: PlaylistMotionSource[];
+    limit?: number;
+    loop?: boolean;
+    preload?: 'none' | 'next' | 'all';
+    autoPlay?: boolean;
+    nodeDuration?: number;
+    normalizeUrl?: (pathOrUrl: string) => string;
+}
+/**
+ * 根据数据库中的模型/动作记录快速构建 MMDPlaylistConfig
+ */
+declare function buildMmdPlaylistFromSources(options: BuildMmdPlaylistOptions): MMDPlaylistConfig;
+
+/**
+ * MMD 资源上传辅助函数
+ *
+ * 整合 UniversalFileService 用于 MMD 资源上传
+ */
+
+declare const MMD_SUPPORTED_TYPES: {
+    model: ("application/zip" | "application/x-zip-compressed" | "multipart/x-zip")[];
+    animation: string[];
+    audio: string[];
+};
+declare const MMD_FILE_EXTENSIONS: {
+    model: string[];
+    animation: string[];
+    audio: string[];
+};
+interface MmdUploadOptions {
+    file: File;
+    resourceType: 'model' | 'animation' | 'audio';
+    name: string;
+    description?: string;
+    userId: string;
+}
+interface MmdUploadResult {
+    id: string;
+    name: string;
+    url: string;
+    filePath: string;
+    fileSize: number;
+    type: string;
+    format: string;
+    uploadTime: Date;
+    metadata?: FileMetadata;
+}
+/**
+ * 使用 UniversalFileService 上传 MMD 资源
+ *
+ * @param fileService - UniversalFileService 实例
+ * @param options - 上传选项
+ * @returns 上传结果
+ */
+declare function uploadMmdResource(fileService: UniversalFileService, options: MmdUploadOptions): Promise<MmdUploadResult>;
+/**
+ * 上传 MMD 模型 (ZIP 压缩包)
+ *
+ * @param fileService - UniversalFileService 实例
+ * @param options - 上传选项
+ * @returns 上传结果,包含解压后的模型路径
+ */
+declare function uploadMmdModel(fileService: UniversalFileService, options: MmdUploadOptions & {
+    storageRoot: string;
+    publicRoot: string;
+}): Promise<MmdUploadResult & {
+    extractedPath?: string;
+}>;
+/**
+ * 批量上传 MMD 资源
+ *
+ * @param fileService - UniversalFileService 实例
+ * @param uploads - 上传选项数组
+ * @returns 上传结果数组
+ */
+declare function batchUploadMmdResources(fileService: UniversalFileService, uploads: MmdUploadOptions[]): Promise<MmdUploadResult[]>;
+
+export { type BuildMmdPlaylistOptions, MMD_FILE_EXTENSIONS, MMD_MODEL_ARCHIVE_MIME_TYPES, MMD_SUPPORTED_TYPES, type MmdUploadOptions, type MmdUploadResult, type PlaylistModelSource, type PlaylistMotionSource, type ProcessMmdModelArchiveOptions, type ProcessMmdModelArchiveResult, type SupportedModelFormat, batchUploadMmdResources, buildMmdPlaylistFromSources, processMmdModelArchive, uploadMmdModel, uploadMmdResource };

package/dist/mmd/server/index.d.ts

@@ -0,0 +1,138 @@
+export { M as MmdPlaylist, f as MmdPlaylistNode, j as MmdPresetItem, h as MmdResourceOption, N as NewMmdPlaylist, g as NewMmdPlaylistNode, k as NewMmdPresetItem, i as NewMmdResourceOption, a as mmdPlaylistNodes, e as mmdPlaylistNodesRelations, m as mmdPlaylists, d as mmdPlaylistsRelations, c as mmdPresetItems, b as mmdResourceOptions } from '../../drizzle-schema-BNhqj2AZ.js';
+import { M as MMDPlaylistConfig } from '../../types-Bc_p-zAR.js';
+import { U as UniversalFileService } from '../../UniversalFileService-BuHN-jrR.js';
+import { F as FileMetadata } from '../../types-CK4We_aI.js';
+import 'drizzle-orm';
+import 'drizzle-orm/pg-core';
+import 'three';
+import 'events';
+
+type SupportedModelFormat = 'pmx' | 'pmd';
+interface ProcessMmdModelArchiveOptions {
+    /**
+     * 绝对路径，指向模型解压根目录，例如 /app/uploads/mmd/models
+     */
+    storageRoot: string;
+    /**
+     * 对外暴露的公共路径前缀，例如 /uploads/mmd/models
+     * 默认与 storageRoot 中的叶子目录一致
+     */
+    publicRoot?: string;
+    /**
+     * 自定义文件夹名称，默认使用随机 UUID
+     */
+    folderName?: string;
+}
+interface ProcessMmdModelArchiveResult {
+    /** 解压出来的目录（绝对路径） */
+    directory: string;
+    /** 与 storageRoot 相对的目录名 */
+    relativeDirectory: string;
+    /** 模型文件相对目录（包含子目录） */
+    modelRelativePath: string;
+    /** 可供前端使用的模型 URL */
+    modelUrl: string;
+    /** 模型格式 */
+    format: SupportedModelFormat;
+    /** 解压得到的文件数量 */
+    filesExtracted: number;
+}
+declare const MMD_MODEL_ARCHIVE_MIME_TYPES: readonly ["application/zip", "application/x-zip-compressed", "multipart/x-zip"];
+/**
+ * 解析上传的 MMD 模型压缩包，保留目录结构并返回模型路径
+ */
+declare function processMmdModelArchive(buffer: Buffer, options: ProcessMmdModelArchiveOptions): Promise<ProcessMmdModelArchiveResult>;
+
+interface PlaylistModelSource {
+    id: string | number;
+    name: string;
+    filePath: string;
+    thumbnailPath?: string | null;
+}
+interface PlaylistMotionSource {
+    id: string | number;
+    name?: string;
+    filePath: string;
+}
+interface BuildMmdPlaylistOptions {
+    playlistId: string;
+    playlistName?: string;
+    models: PlaylistModelSource[];
+    motions?: PlaylistMotionSource[];
+    limit?: number;
+    loop?: boolean;
+    preload?: 'none' | 'next' | 'all';
+    autoPlay?: boolean;
+    nodeDuration?: number;
+    normalizeUrl?: (pathOrUrl: string) => string;
+}
+/**
+ * 根据数据库中的模型/动作记录快速构建 MMDPlaylistConfig
+ */
+declare function buildMmdPlaylistFromSources(options: BuildMmdPlaylistOptions): MMDPlaylistConfig;
+
+/**
+ * MMD 资源上传辅助函数
+ *
+ * 整合 UniversalFileService 用于 MMD 资源上传
+ */
+
+declare const MMD_SUPPORTED_TYPES: {
+    model: ("application/zip" | "application/x-zip-compressed" | "multipart/x-zip")[];
+    animation: string[];
+    audio: string[];
+};
+declare const MMD_FILE_EXTENSIONS: {
+    model: string[];
+    animation: string[];
+    audio: string[];
+};
+interface MmdUploadOptions {
+    file: File;
+    resourceType: 'model' | 'animation' | 'audio';
+    name: string;
+    description?: string;
+    userId: string;
+}
+interface MmdUploadResult {
+    id: string;
+    name: string;
+    url: string;
+    filePath: string;
+    fileSize: number;
+    type: string;
+    format: string;
+    uploadTime: Date;
+    metadata?: FileMetadata;
+}
+/**
+ * 使用 UniversalFileService 上传 MMD 资源
+ *
+ * @param fileService - UniversalFileService 实例
+ * @param options - 上传选项
+ * @returns 上传结果
+ */
+declare function uploadMmdResource(fileService: UniversalFileService, options: MmdUploadOptions): Promise<MmdUploadResult>;
+/**
+ * 上传 MMD 模型 (ZIP 压缩包)
+ *
+ * @param fileService - UniversalFileService 实例
+ * @param options - 上传选项
+ * @returns 上传结果,包含解压后的模型路径
+ */
+declare function uploadMmdModel(fileService: UniversalFileService, options: MmdUploadOptions & {
+    storageRoot: string;
+    publicRoot: string;
+}): Promise<MmdUploadResult & {
+    extractedPath?: string;
+}>;
+/**
+ * 批量上传 MMD 资源
+ *
+ * @param fileService - UniversalFileService 实例
+ * @param uploads - 上传选项数组
+ * @returns 上传结果数组
+ */
+declare function batchUploadMmdResources(fileService: UniversalFileService, uploads: MmdUploadOptions[]): Promise<MmdUploadResult[]>;
+
+export { type BuildMmdPlaylistOptions, MMD_FILE_EXTENSIONS, MMD_MODEL_ARCHIVE_MIME_TYPES, MMD_SUPPORTED_TYPES, type MmdUploadOptions, type MmdUploadResult, type PlaylistModelSource, type PlaylistMotionSource, type ProcessMmdModelArchiveOptions, type ProcessMmdModelArchiveResult, type SupportedModelFormat, batchUploadMmdResources, buildMmdPlaylistFromSources, processMmdModelArchive, uploadMmdModel, uploadMmdResource };

package/dist/mmd/server/index.js

@@ -0,0 +1,245 @@
+'use strict';
+
+var chunkW35VTQAW_js = require('../../chunk-W35VTQAW.js');
+require('../../chunk-DGUM43GV.js');
+var AdmZip = require('adm-zip');
+var crypto = require('crypto');
+var promises = require('fs/promises');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var AdmZip__default = /*#__PURE__*/_interopDefault(AdmZip);
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+var MMD_MODEL_ARCHIVE_MIME_TYPES = [
+  "application/zip",
+  "application/x-zip-compressed",
+  "multipart/x-zip"
+];
+async function processMmdModelArchive(buffer, options) {
+  const folderName = options.folderName ?? crypto.randomUUID();
+  const targetDir = path__default.default.join(options.storageRoot, folderName);
+  await promises.mkdir(targetDir, { recursive: true });
+  const zip = new AdmZip__default.default(buffer);
+  const entries = zip.getEntries();
+  if (!entries.length) {
+    await promises.rm(targetDir, { recursive: true, force: true });
+    throw new Error("\u538B\u7F29\u5305\u4E3A\u7A7A\uFF0C\u8BF7\u68C0\u67E5\u4E0A\u4F20\u6587\u4EF6\u5185\u5BB9");
+  }
+  let modelRelativePath = null;
+  let filesExtracted = 0;
+  for (const entry of entries) {
+    if (!entry.entryName || entry.entryName.startsWith("__MACOSX") || entry.entryName.endsWith(".DS_Store")) {
+      continue;
+    }
+    const safeRelativePath = sanitizeEntryPath(entry.entryName);
+    if (!safeRelativePath) {
+      continue;
+    }
+    const destinationPath = path__default.default.join(targetDir, safeRelativePath);
+    if (entry.isDirectory) {
+      await promises.mkdir(destinationPath, { recursive: true });
+      continue;
+    }
+    await promises.mkdir(path__default.default.dirname(destinationPath), { recursive: true });
+    await promises.writeFile(destinationPath, entry.getData());
+    filesExtracted += 1;
+    const entryExt = path__default.default.extname(safeRelativePath).toLowerCase();
+    if (!modelRelativePath && (entryExt === ".pmx" || entryExt === ".pmd")) {
+      modelRelativePath = safeRelativePath.split(path__default.default.sep).join("/");
+    }
+  }
+  if (!modelRelativePath) {
+    await promises.rm(targetDir, { recursive: true, force: true });
+    throw new Error("\u538B\u7F29\u5305\u4E2D\u672A\u627E\u5230 PMX/PMD \u6A21\u578B\u6587\u4EF6\uFF0C\u8BF7\u786E\u8BA4\u76EE\u5F55\u7ED3\u6784\u662F\u5426\u6B63\u786E");
+  }
+  const format = path__default.default.extname(modelRelativePath).slice(1).toLowerCase();
+  const publicRoot = options.publicRoot ?? `/uploads/mmd/models`;
+  const modelUrl = joinPublicPath(publicRoot, folderName, modelRelativePath);
+  return {
+    directory: targetDir,
+    relativeDirectory: folderName,
+    modelRelativePath,
+    modelUrl,
+    format,
+    filesExtracted
+  };
+}
+function sanitizeEntryPath(entryName) {
+  const normalized = path__default.default.normalize(entryName).replace(/^(\.\.(\/|\\|$))+/, "");
+  if (!normalized || normalized === "." || normalized.startsWith("..") || path__default.default.isAbsolute(normalized)) {
+    return null;
+  }
+  return normalized;
+}
+function joinPublicPath(...segments) {
+  return segments.map((segment) => segment.replace(/\/+/g, "/").replace(/^\//, "").replace(/\/$/, "")).filter(Boolean).join("/").replace(/\/{2,}/g, "/").replace(/^/, "/");
+}
+
+// src/mmd/server/playlistBuilder.ts
+var defaultNormalizer = (value) => {
+  if (!value) return "";
+  if (value.startsWith("http://") || value.startsWith("https://")) {
+    return value;
+  }
+  return value.startsWith("/") ? value : `/${value}`;
+};
+function buildMmdPlaylistFromSources(options) {
+  if (!options.models.length) {
+    throw new Error("\u6784\u5EFA MMD \u64AD\u653E\u5217\u8868\u5931\u8D25\uFF1Amodels \u4E3A\u7A7A");
+  }
+  const limit = Math.max(1, Math.min(options.limit ?? options.models.length, options.models.length));
+  const normalizeUrl = options.normalizeUrl ?? defaultNormalizer;
+  const motions = options.motions ?? [];
+  const hasMotions = motions.length > 0;
+  const duration = options.nodeDuration ?? 30;
+  const nodes = options.models.slice(0, limit).map((model, index) => {
+    const motion = hasMotions ? motions[index % motions.length] : void 0;
+    return {
+      id: String(model.id ?? index),
+      name: model.name,
+      loop: options.loop ?? true,
+      duration,
+      thumbnail: model.thumbnailPath ? normalizeUrl(model.thumbnailPath) : void 0,
+      resources: {
+        modelPath: normalizeUrl(model.filePath),
+        motionPath: motion ? normalizeUrl(motion.filePath) : void 0,
+        cameraPath: void 0,
+        audioPath: void 0,
+        stageModelPath: void 0,
+        additionalMotions: void 0
+      }
+    };
+  });
+  return {
+    id: options.playlistId,
+    name: options.playlistName ?? `MMD \u64AD\u653E\u5217\u8868 - ${options.playlistId}`,
+    nodes,
+    loop: options.loop ?? true,
+    preload: options.preload ?? "next",
+    autoPlay: options.autoPlay ?? true
+  };
+}
+
+// src/mmd/server/mmdUpload.ts
+var MMD_SUPPORTED_TYPES = {
+  model: [...MMD_MODEL_ARCHIVE_MIME_TYPES],
+  animation: ["application/octet-stream", "animation/vmd"],
+  audio: ["audio/wav", "audio/mp3", "audio/mpeg", "audio/ogg"]
+};
+var MMD_FILE_EXTENSIONS = {
+  model: [".zip"],
+  animation: [".vmd"],
+  audio: [".wav", ".mp3", ".ogg"]
+};
+async function uploadMmdResource(fileService, options) {
+  const { file, resourceType, name, description, userId } = options;
+  const ext = `.${file.name.split(".").pop()?.toLowerCase()}`;
+  const allowedExtensions = MMD_FILE_EXTENSIONS[resourceType];
+  if (!allowedExtensions.includes(ext)) {
+    throw new Error(
+      `\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u6269\u5C55\u540D: ${ext}\u3002\u652F\u6301\u7684\u683C\u5F0F: ${allowedExtensions.join(", ")}`
+    );
+  }
+  const moduleId = `mmd-${resourceType}s`;
+  const metadata = await fileService.uploadFile({
+    file,
+    moduleId,
+    businessId: "default",
+    permission: "public",
+    metadata: {
+      uploadedBy: userId,
+      uploadedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      originalFileName: file.name,
+      resourceType,
+      name,
+      description: description || ""
+    },
+    needsProcessing: false
+  });
+  const format = ext.slice(1).toUpperCase();
+  const fileUrl = metadata.cdnUrl || metadata.storagePath;
+  return {
+    id: metadata.id,
+    name,
+    url: fileUrl,
+    filePath: metadata.storagePath,
+    fileSize: metadata.size,
+    type: resourceType,
+    format,
+    uploadTime: metadata.uploadTime,
+    metadata
+  };
+}
+async function uploadMmdModel(fileService, options) {
+  const { file, storageRoot, publicRoot } = options;
+  const baseResult = await uploadMmdResource(fileService, options);
+  try {
+    const fileBuffer = Buffer.from(await file.arrayBuffer());
+    const archiveResult = await processMmdModelArchive(fileBuffer, {
+      storageRoot,
+      publicRoot,
+      folderName: baseResult.id
+    });
+    return {
+      ...baseResult,
+      url: archiveResult.modelUrl,
+      filePath: archiveResult.modelUrl,
+      format: archiveResult.format.toUpperCase(),
+      extractedPath: archiveResult.modelUrl
+    };
+  } catch (extractError) {
+    console.error("\u6A21\u578B\u538B\u7F29\u5305\u5904\u7406\u5931\u8D25:", extractError);
+    throw new Error(
+      extractError instanceof Error ? extractError.message : "\u6A21\u578B\u538B\u7F29\u5305\u5904\u7406\u5931\u8D25"
+    );
+  }
+}
+async function batchUploadMmdResources(fileService, uploads) {
+  const results = [];
+  for (const uploadOptions of uploads) {
+    try {
+      const result = await uploadMmdResource(fileService, uploadOptions);
+      results.push(result);
+    } catch (error) {
+      console.error(`\u4E0A\u4F20\u5931\u8D25: ${uploadOptions.file.name}`, error);
+    }
+  }
+  return results;
+}
+
+Object.defineProperty(exports, "mmdPlaylistNodes", {
+  enumerable: true,
+  get: function () { return chunkW35VTQAW_js.mmdPlaylistNodes; }
+});
+Object.defineProperty(exports, "mmdPlaylistNodesRelations", {
+  enumerable: true,
+  get: function () { return chunkW35VTQAW_js.mmdPlaylistNodesRelations; }
+});
+Object.defineProperty(exports, "mmdPlaylists", {
+  enumerable: true,
+  get: function () { return chunkW35VTQAW_js.mmdPlaylists; }
+});
+Object.defineProperty(exports, "mmdPlaylistsRelations", {
+  enumerable: true,
+  get: function () { return chunkW35VTQAW_js.mmdPlaylistsRelations; }
+});
+Object.defineProperty(exports, "mmdPresetItems", {
+  enumerable: true,
+  get: function () { return chunkW35VTQAW_js.mmdPresetItems; }
+});
+Object.defineProperty(exports, "mmdResourceOptions", {
+  enumerable: true,
+  get: function () { return chunkW35VTQAW_js.mmdResourceOptions; }
+});
+exports.MMD_FILE_EXTENSIONS = MMD_FILE_EXTENSIONS;
+exports.MMD_MODEL_ARCHIVE_MIME_TYPES = MMD_MODEL_ARCHIVE_MIME_TYPES;
+exports.MMD_SUPPORTED_TYPES = MMD_SUPPORTED_TYPES;
+exports.batchUploadMmdResources = batchUploadMmdResources;
+exports.buildMmdPlaylistFromSources = buildMmdPlaylistFromSources;
+exports.processMmdModelArchive = processMmdModelArchive;
+exports.uploadMmdModel = uploadMmdModel;
+exports.uploadMmdResource = uploadMmdResource;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/mmd/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mmd/server/modelArchive.ts","../../../src/mmd/server/playlistBuilder.ts","../../../src/mmd/server/mmdUpload.ts"],"names":["randomUUID","path","mkdir","AdmZip","rm","writeFile"],"mappings":"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","file":"index.js","sourcesContent":["import AdmZip from 'adm-zip';\nimport { randomUUID } from 'crypto';\nimport { mkdir, rm, writeFile } from 'fs/promises';\nimport path from 'path';\n\nexport type SupportedModelFormat = 'pmx' | 'pmd';\n\nexport interface ProcessMmdModelArchiveOptions {\n  /**\n   * 绝对路径，指向模型解压根目录，例如 /app/uploads/mmd/models\n   */\n  storageRoot: string;\n  /**\n   * 对外暴露的公共路径前缀，例如 /uploads/mmd/models\n   * 默认与 storageRoot 中的叶子目录一致\n   */\n  publicRoot?: string;\n  /**\n   * 自定义文件夹名称，默认使用随机 UUID\n   */\n  folderName?: string;\n}\n\nexport interface ProcessMmdModelArchiveResult {\n  /** 解压出来的目录（绝对路径） */\n  directory: string;\n  /** 与 storageRoot 相对的目录名 */\n  relativeDirectory: string;\n  /** 模型文件相对目录（包含子目录） */\n  modelRelativePath: string;\n  /** 可供前端使用的模型 URL */\n  modelUrl: string;\n  /** 模型格式 */\n  format: SupportedModelFormat;\n  /** 解压得到的文件数量 */\n  filesExtracted: number;\n}\n\nexport const MMD_MODEL_ARCHIVE_MIME_TYPES = [\n  'application/zip',\n  'application/x-zip-compressed',\n  'multipart/x-zip',\n] as const;\n\n/**\n * 解析上传的 MMD 模型压缩包，保留目录结构并返回模型路径\n */\nexport async function processMmdModelArchive(\n  buffer: Buffer,\n  options: ProcessMmdModelArchiveOptions,\n): Promise<ProcessMmdModelArchiveResult> {\n  const folderName = options.folderName ?? randomUUID();\n  const targetDir = path.join(options.storageRoot, folderName);\n  await mkdir(targetDir, { recursive: true });\n\n  const zip = new AdmZip(buffer);\n  const entries = zip.getEntries();\n  if (!entries.length) {\n    await rm(targetDir, { recursive: true, force: true });\n    throw new Error('压缩包为空，请检查上传文件内容');\n  }\n\n  let modelRelativePath: string | null = null;\n  let filesExtracted = 0;\n\n  for (const entry of entries) {\n    if (!entry.entryName || entry.entryName.startsWith('__MACOSX') || entry.entryName.endsWith('.DS_Store')) {\n      continue;\n    }\n\n    const safeRelativePath = sanitizeEntryPath(entry.entryName);\n    if (!safeRelativePath) {\n      continue;\n    }\n\n    const destinationPath = path.join(targetDir, safeRelativePath);\n\n    if (entry.isDirectory) {\n      await mkdir(destinationPath, { recursive: true });\n      continue;\n    }\n\n    await mkdir(path.dirname(destinationPath), { recursive: true });\n    await writeFile(destinationPath, entry.getData());\n    filesExtracted += 1;\n\n    const entryExt = path.extname(safeRelativePath).toLowerCase();\n    if (!modelRelativePath && (entryExt === '.pmx' || entryExt === '.pmd')) {\n      modelRelativePath = safeRelativePath.split(path.sep).join('/');\n    }\n  }\n\n  if (!modelRelativePath) {\n    await rm(targetDir, { recursive: true, force: true });\n    throw new Error('压缩包中未找到 PMX/PMD 模型文件，请确认目录结构是否正确');\n  }\n\n  const format = path.extname(modelRelativePath).slice(1).toLowerCase() as SupportedModelFormat;\n  const publicRoot = options.publicRoot ?? `/uploads/mmd/models`;\n  const modelUrl = joinPublicPath(publicRoot, folderName, modelRelativePath);\n\n  return {\n    directory: targetDir,\n    relativeDirectory: folderName,\n    modelRelativePath,\n    modelUrl,\n    format,\n    filesExtracted,\n  };\n}\n\nfunction sanitizeEntryPath(entryName: string): string | null {\n  const normalized = path.normalize(entryName).replace(/^(\\.\\.(\\/|\\\\|$))+/, '');\n  if (!normalized || normalized === '.' || normalized.startsWith('..') || path.isAbsolute(normalized)) {\n    return null;\n  }\n  return normalized;\n}\n\nfunction joinPublicPath(...segments: string[]) {\n  return segments\n    .map((segment) => segment.replace(/\\/+/g, '/').replace(/^\\//, '').replace(/\\/$/, ''))\n    .filter(Boolean)\n    .join('/')\n    .replace(/\\/{2,}/g, '/')\n    .replace(/^/, '/');\n}\n\n","import type { MMDPlaylistConfig, MMDPlaylistNode } from '../types';\n\nexport interface PlaylistModelSource {\n  id: string | number;\n  name: string;\n  filePath: string;\n  thumbnailPath?: string | null;\n}\n\nexport interface PlaylistMotionSource {\n  id: string | number;\n  name?: string;\n  filePath: string;\n}\n\nexport interface BuildMmdPlaylistOptions {\n  playlistId: string;\n  playlistName?: string;\n  models: PlaylistModelSource[];\n  motions?: PlaylistMotionSource[];\n  limit?: number;\n  loop?: boolean;\n  preload?: 'none' | 'next' | 'all';\n  autoPlay?: boolean;\n  nodeDuration?: number;\n  normalizeUrl?: (pathOrUrl: string) => string;\n}\n\nconst defaultNormalizer = (value: string) => {\n  if (!value) return '';\n  if (value.startsWith('http://') || value.startsWith('https://')) {\n    return value;\n  }\n  return value.startsWith('/') ? value : `/${value}`;\n};\n\n/**\n * 根据数据库中的模型/动作记录快速构建 MMDPlaylistConfig\n */\nexport function buildMmdPlaylistFromSources(options: BuildMmdPlaylistOptions): MMDPlaylistConfig {\n  if (!options.models.length) {\n    throw new Error('构建 MMD 播放列表失败：models 为空');\n  }\n\n  const limit = Math.max(1, Math.min(options.limit ?? options.models.length, options.models.length));\n  const normalizeUrl = options.normalizeUrl ?? defaultNormalizer;\n  const motions = options.motions ?? [];\n  const hasMotions = motions.length > 0;\n  const duration = options.nodeDuration ?? 30;\n\n  const nodes: MMDPlaylistNode[] = options.models.slice(0, limit).map((model, index) => {\n    const motion = hasMotions ? motions[index % motions.length] : undefined;\n    return {\n      id: String(model.id ?? index),\n      name: model.name,\n      loop: options.loop ?? true,\n      duration,\n      thumbnail: model.thumbnailPath ? normalizeUrl(model.thumbnailPath) : undefined,\n      resources: {\n        modelPath: normalizeUrl(model.filePath),\n        motionPath: motion ? normalizeUrl(motion.filePath) : undefined,\n        cameraPath: undefined,\n        audioPath: undefined,\n        stageModelPath: undefined,\n        additionalMotions: undefined,\n      },\n    };\n  });\n\n  return {\n    id: options.playlistId,\n    name: options.playlistName ?? `MMD 播放列表 - ${options.playlistId}`,\n    nodes,\n    loop: options.loop ?? true,\n    preload: options.preload ?? 'next',\n    autoPlay: options.autoPlay ?? true,\n  };\n}\n\n","/**\n * MMD 资源上传辅助函数\n * \n * 整合 UniversalFileService 用于 MMD 资源上传\n */\n\nimport type { UniversalFileService } from '../../universalFile/server/UniversalFileService';\nimport type { FileMetadata } from '../../universalFile/types';\nimport { processMmdModelArchive, MMD_MODEL_ARCHIVE_MIME_TYPES } from './modelArchive';\n\nexport const MMD_SUPPORTED_TYPES = {\n  model: [...MMD_MODEL_ARCHIVE_MIME_TYPES],\n  animation: ['application/octet-stream', 'animation/vmd'],\n  audio: ['audio/wav', 'audio/mp3', 'audio/mpeg', 'audio/ogg'],\n};\n\nexport const MMD_FILE_EXTENSIONS = {\n  model: ['.zip'],\n  animation: ['.vmd'],\n  audio: ['.wav', '.mp3', '.ogg'],\n};\n\nexport interface MmdUploadOptions {\n  file: File;\n  resourceType: 'model' | 'animation' | 'audio';\n  name: string;\n  description?: string;\n  userId: string;\n}\n\nexport interface MmdUploadResult {\n  id: string;\n  name: string;\n  url: string;\n  filePath: string;\n  fileSize: number;\n  type: string;\n  format: string;\n  uploadTime: Date;\n  metadata?: FileMetadata;\n}\n\n/**\n * 使用 UniversalFileService 上传 MMD 资源\n * \n * @param fileService - UniversalFileService 实例\n * @param options - 上传选项\n * @returns 上传结果\n */\nexport async function uploadMmdResource(\n  fileService: UniversalFileService,\n  options: MmdUploadOptions\n): Promise<MmdUploadResult> {\n  const { file, resourceType, name, description, userId } = options;\n\n  // 验证文件扩展名\n  const ext = `.${file.name.split('.').pop()?.toLowerCase()}`;\n  const allowedExtensions = MMD_FILE_EXTENSIONS[resourceType];\n\n  if (!allowedExtensions.includes(ext)) {\n    throw new Error(\n      `不支持的文件扩展名: ${ext}。支持的格式: ${allowedExtensions.join(', ')}`\n    );\n  }\n\n  // 确定模块ID\n  const moduleId = `mmd-${resourceType}s`;\n\n  // 上传文件\n  const metadata = await fileService.uploadFile({\n    file,\n    moduleId,\n    businessId: 'default',\n    permission: 'public',\n    metadata: {\n      uploadedBy: userId,\n      uploadedAt: new Date().toISOString(),\n      originalFileName: file.name,\n      resourceType,\n      name,\n      description: description || '',\n    },\n    needsProcessing: false,\n  });\n\n  // 构建返回结果\n  const format = ext.slice(1).toUpperCase();\n  const fileUrl = metadata.cdnUrl || metadata.storagePath;\n\n  return {\n    id: metadata.id,\n    name,\n    url: fileUrl,\n    filePath: metadata.storagePath,\n    fileSize: metadata.size,\n    type: resourceType,\n    format,\n    uploadTime: metadata.uploadTime,\n    metadata,\n  };\n}\n\n/**\n * 上传 MMD 模型 (ZIP 压缩包)\n * \n * @param fileService - UniversalFileService 实例\n * @param options - 上传选项\n * @returns 上传结果,包含解压后的模型路径\n */\nexport async function uploadMmdModel(\n  fileService: UniversalFileService,\n  options: MmdUploadOptions & { storageRoot: string; publicRoot: string }\n): Promise<MmdUploadResult & { extractedPath?: string }> {\n  const { file, storageRoot, publicRoot } = options;\n\n  // 首先上传 ZIP 文件\n  const baseResult = await uploadMmdResource(fileService, options);\n\n  // 处理 ZIP 压缩包\n  try {\n    const fileBuffer = Buffer.from(await file.arrayBuffer());\n    const archiveResult = await processMmdModelArchive(fileBuffer, {\n      storageRoot,\n      publicRoot,\n      folderName: baseResult.id,\n    });\n\n    return {\n      ...baseResult,\n      url: archiveResult.modelUrl,\n      filePath: archiveResult.modelUrl,\n      format: archiveResult.format.toUpperCase(),\n      extractedPath: archiveResult.modelUrl,\n    };\n  } catch (extractError) {\n    console.error('模型压缩包处理失败:', extractError);\n    throw new Error(\n      extractError instanceof Error ? extractError.message : '模型压缩包处理失败'\n    );\n  }\n}\n\n/**\n * 批量上传 MMD 资源\n * \n * @param fileService - UniversalFileService 实例\n * @param uploads - 上传选项数组\n * @returns 上传结果数组\n */\nexport async function batchUploadMmdResources(\n  fileService: UniversalFileService,\n  uploads: MmdUploadOptions[]\n): Promise<MmdUploadResult[]> {\n  const results: MmdUploadResult[] = [];\n\n  for (const uploadOptions of uploads) {\n    try {\n      const result = await uploadMmdResource(fileService, uploadOptions);\n      results.push(result);\n    } catch (error) {\n      console.error(`上传失败: ${uploadOptions.file.name}`, error);\n      // 继续处理其他文件\n    }\n  }\n\n  return results;\n}\n\n"]}