@infimind/video-mcp-cli 1.0.11 → 1.0.13

package/dist/server.js

@@ -8,7 +8,17 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { readFileSync, existsSync, statSync } from "fs";
 import { extname, basename } from "path";
-import { MCP_SERVER_VERSION, getMcpDefaultTaskMode, getMcpEngineName, getMcpVideoStatusHint, isMcpRoute, isValidMcpTaskMode, isMcpModel, MCP_VIDEO_MODELS, } from "./videoRules.js";
+import { MCP_PUBLIC_MODELS, MCP_SERVER_VERSION, getMcpDefaultTaskMode, getMcpEngineName, getMcpVideoStatusHint, isMcpRoute, isRetiredSaModel, isRetiredSaRoute, isValidMcpTaskMode, resolveMcpEngine, isMcpModel, } from "./videoRules.js";
+import { MCP_CREATIVE_TOOLS } from "./creativeTools.js";
+const WAN3_OUTPUT_SECONDS = [5, 10, 15, 20, 25, 30];
+const WAN3_OUTPUT_SECONDS_LABEL = WAN3_OUTPUT_SECONDS.join("、");
+function isWan3OutputSeconds(value, mode) {
+    if (mode === "edit")
+        return value === -1;
+    return (typeof value === "number" &&
+        Number.isInteger(value) &&
+        WAN3_OUTPUT_SECONDS.includes(value));
+}
 class McpToolError extends Error {
     code;
     route;
@@ -21,10 +31,7 @@ class McpToolError extends Error {
         this.engineName = route ? getMcpEngineName(route) : undefined;
     }
 }
-/**
- * Create and configure the MCP Server
- */
-export function createServer(token, apiBaseUrl) {
+export function createServer(token, apiBaseUrl, options = {}) {
     const server = new Server({
         name: "sora-video-generator-mcp",
         version: MCP_SERVER_VERSION,
@@ -37,7 +44,7 @@ export function createServer(token, apiBaseUrl) {
      * List available tools
      */
     server.setRequestHandler(ListToolsRequestSchema, async () => {
-        const tools = [
+        const allTools = [
             {
                 name: "get_user_info",
                 title: "获取用户信息",
@@ -65,103 +72,177 @@ export function createServer(token, apiBaseUrl) {
             },
             {
                 name: "create_video_task",
-                title: "创建视频生成任务",
-                description: "创建视频生成任务。支持本地文件路径或公网 URL 作为参考图片。" +
-                    "支持极睿Sd专业版和极睿Ha专业版的多模态素材输入。",
+                title: "生成 AI 视频",
+                description: "根据提示词和可选的图片、视频或音频素材创建 AI 视频生成任务，可选择 WA、SD、SD25、HA 或 H3 专业版；素材可使用本地文件路径或公网 URL。" +
+                    "本工具返回 taskId，不直接返回最终视频；创建后请调用 get_video_status 并原样传入 taskId，轮询生成进度和结果。",
                 inputSchema: {
                     type: "object",
+                    title: "AI 视频生成参数",
+                    description: "创建 AI 视频生成任务所需的提示词、参考素材和生成配置。",
                     properties: {
                         prompt: {
                             type: "string",
-                            description: "视频生成提示词，描述你想要创建的内容",
+                            title: "视频生成提示词",
+                            description: "必填。描述希望生成的视频内容、主体、动作、场景、镜头和风格。",
                         },
                         sourceImage: {
                             type: "string",
-                            description: "可选的单张参考图片。S2 使用此字段；S6 标准模式可用作单图图生视频。可以是本地文件路径或公网 URL",
+                            title: "单张参考图片",
+                            description: "可选。本地图片路径或公网 URL；HA 专业版标准模式单图生成时使用。",
                         },
                         sourceImages: {
                             type: "array",
-                            description: "S5/S6 多张参考图片。本地文件路径或公网 URL 数组。S5 首尾帧模式下第1张为首帧、第2张为尾帧；S6 reference/edit 模式作为参考图",
-                            items: { type: "string" },
+                            title: "参考图片列表",
+                            description: "可选。本地图片路径或公网 URL 列表；SD 专业版首尾帧模式按首帧、尾帧顺序传入，HA 专业版图片参考或视频编辑模式按引用顺序传入。",
+                            items: {
+                                type: "string",
+                                title: "参考图片",
+                                description: "一张参考图片的本地路径或公网 URL。",
+                            },
                         },
                         sourceVideos: {
                             type: "array",
-                            description: "S5 全能参考或 S6 视频编辑模式的视频素材。本地文件路径或公网 URL 数组",
-                            items: { type: "string" },
+                            title: "参考视频列表",
+                            description: "可选。本地视频路径或公网 URL 列表；用于 SD 专业版全能参考模式或 HA 专业版视频编辑模式。",
+                            items: {
+                                type: "string",
+                                title: "参考视频",
+                                description: "一段参考视频的本地路径或公网 URL。",
+                            },
                         },
                         sourceAudios: {
                             type: "array",
-                            description: "S5 全能参考模式的音频素材。本地文件路径或公网 URL 数组",
-                            items: { type: "string" },
+                            title: "参考音频列表",
+                            description: "可选。本地音频路径或公网 URL 列表；用于 SD 专业版全能参考模式。",
+                            items: {
+                                type: "string",
+                                title: "参考音频",
+                                description: "一段参考音频的本地路径或公网 URL。",
+                            },
                         },
                         sourceVideoDurationSeconds: {
                             type: "array",
-                            description: "可选。dryRun 使用的视频素材时长秒数数组，顺序与 sourceVideos 一致；用于获得预估积分",
-                            items: { type: "number" },
+                            title: "参考视频时长列表",
+                            description: "可选。仅在 dryRun 预检时用于估算积分，单位为秒，顺序须与 sourceVideos 一致。",
+                            items: {
+                                type: "number",
+                                title: "参考视频时长",
+                                description: "对应参考视频的时长，单位为秒。",
+                            },
                         },
                         sourceAudioDurationSeconds: {
                             type: "array",
-                            description: "可选。dryRun 使用的音频素材时长秒数数组，顺序与 sourceAudios 一致；用于获得预估积分",
-                            items: { type: "number" },
+                            title: "参考音频时长列表",
+                            description: "可选。仅在 dryRun 预检时用于估算积分，单位为秒，顺序须与 sourceAudios 一致。",
+                            items: {
+                                type: "number",
+                                title: "参考音频时长",
+                                description: "对应参考音频的时长，单位为秒。",
+                            },
                         },
                         size: {
                             type: "string",
-                            description: "视频方向/比例。S2 支持横竖屏；S5/S6 还支持正方形、4:3、3:4（默认：1280x720）",
-                            enum: ["1280x720", "720x1280", "1024x1024", "1024x768", "768x1024"],
+                            title: "输出尺寸",
+                            description: "可选。视频的输出尺寸，默认 1280x720；可选择横屏、竖屏、正方形、4:3 或 3:4 尺寸。",
+                            enum: [
+                                "1280x720",
+                                "720x1280",
+                                "1024x1024",
+                                "1024x768",
+                                "768x1024",
+                            ],
                         },
                         seconds: {
                             type: "number",
-                            description: "视频时长（秒）。S2=10或15秒；S5极睿Sd专业版=5、10或15秒；S6极睿Ha专业版 standard/reference=5、10或15秒，edit 模式由输入视频决定",
-                            enum: [5, 10, 15],
+                            title: "视频时长",
+                            description: "可选。WA 普通模式仅支持 5、10、15、20、25、30 秒，默认 5 秒；WA edit 视频编辑仅支持 -1（智能时长），可省略；其他模型按各自规则。",
+                            // JSON Schema 无法在此共享字段上可靠表达按 model 分支的 enum。
+                            // 精确离散时长规则由 validateCreateVideoArgs 按模型统一校验。
+                            minimum: -1,
+                            maximum: 30,
+                            multipleOf: 1,
                         },
                         language: {
                             type: "string",
-                            description: "视频的目标语言（默认：zh-CN）",
-                            enum: ["zh-CN", "en-US", "ja-JP", "ko-KR", "es-ES", "fr-FR", "th-TH", "id-ID", "de-DE", "pt-PT", "bn-BD", "ru-RU", "ar-SA", "zh-HK", "hi-IN"],
+                            title: "提示词优化语言",
+                            description: "可选。用于理解和优化视频提示词的语言区域代码，默认 zh-CN。",
+                            enum: [
+                                "zh-CN",
+                                "en-US",
+                                "ja-JP",
+                                "ko-KR",
+                                "es-ES",
+                                "fr-FR",
+                                "th-TH",
+                                "id-ID",
+                                "de-DE",
+                                "pt-PT",
+                                "bn-BD",
+                                "ru-RU",
+                                "ar-SA",
+                                "zh-HK",
+                                "hi-IN",
+                            ],
                         },
                         count: {
                             type: "number",
-                            description: "生成的视频数量（1-12，默认：1）",
+                            title: "生成数量",
+                            description: "可选。需要生成的视频数量，范围 1–12，默认 1。",
                             minimum: 1,
                             maximum: 12,
                         },
                         model: {
                             type: "string",
-                            description: "生成引擎短码（推荐）：SA=极睿Sa专业版（默认，Sora 2，失败自动回退 S4）、SD=极睿Sd专业版（Seedance 2.0）、HA=极睿Ha专业版（HappyHorse 1.1）。注意：SD、HA 仅限 VIP 用户使用",
-                            enum: ["SA", "SD", "HA"],
+                            title: "生成模型",
+                            description: "可选。WA=极睿 WA 专业版（默认，非 VIP 可用），SD=极睿 SD 专业版，SD25=极睿 SD2.5 专业版，HA=极睿 HA 专业版，H3=极睿 H3 专业版；除 WA 外仅限 VIP 用户使用。",
+                            enum: [...MCP_PUBLIC_MODELS],
+                            default: "WA",
                         },
                         route: {
                             type: "string",
-                            description: "内部线路代码（已废弃，请改用 model）。兼容老客户端：S2=极睿Sa专业版、S5=极睿Sd专业版、S6=极睿Ha专业版",
-                            enum: ["S2", "S5", "S6"],
+                            title: "兼容模型参数",
+                            description: "已废弃的兼容参数，仅供旧客户端使用；新调用请使用 model。",
+                            enum: ["S5", "S6", "S7", "S8", "S9"],
                             deprecated: true,
                         },
                         taskMode: {
                             type: "string",
-                            description: "引擎模式。S5: allinone=全能参考、firstlast=首尾帧；S6: standard=标准模式、reference=图片参考、edit=视频编辑",
+                            title: "生成模式",
+                            description: "可选。allinone=全能参考，firstlast=首尾帧，standard=标准模式，reference=图片参考，edit=视频编辑；可用模式取决于所选模型。",
                             enum: ["allinone", "firstlast", "standard", "reference", "edit"],
                         },
                         resolution: {
                             type: "string",
-                            description: "S5/S6 输出清晰度（默认：720p）",
-                            enum: ["720p", "1080p"],
+                            title: "输出清晰度",
+                            description: "可选。SD/HA 支持 720p 或 1080p；SD2.5 与 WA 支持 480p、720p 或 1080p（WA 480p 仅管理员）；默认 720p。",
+                            enum: ["480p", "720p", "1080p"],
+                        },
+                        outputFormat: {
+                            type: "string",
+                            title: "输出格式",
+                            description: "可选。默认 mp4；mov 仅适用于 SD2.5 专业版。",
+                            enum: ["mp4", "mov"],
                         },
                         ratio: {
                             type: "string",
-                            description: "S6 图片参考或标准文生视频模式的宽高比，例如 9:16、16:9、1:1、4:3、3:4",
-                            enum: ["16:9", "9:16", "1:1", "4:3", "3:4"],
+                            title: "画面比例",
+                            description: "可选。WA 支持 adaptive、16:9、4:3、1:1、3:4、9:16，默认 adaptive。",
+                            enum: ["adaptive", "16:9", "9:16", "1:1", "4:3", "3:4"],
                         },
                         generateAudio: {
                             type: "boolean",
-                            description: "S5 极睿Sd专业版是否生成音频（默认：true）",
+                            title: "生成音频",
+                            description: "可选。SD / SD2.5 / WA 专业版是否同时生成音频，默认 true。",
                         },
                         webSearchEnabled: {
                             type: "boolean",
-                            description: "S5 极睿Sd专业版是否启用 Agent 增强（默认：false）",
+                            title: "启用内容增强",
+                            description: "可选。SD / SD2.5 专业版是否启用联网内容增强，默认 false。",
                         },
                         dryRun: {
                             type: "boolean",
-                            description: "仅执行参数、素材、权限和积分预检，不创建任务、不扣费。适合在正式创建前确认 S5/S6 参数是否可用",
+                            title: "仅预检",
+                            description: "可选。设为 true 时仅校验参数、素材、权限并估算积分，不创建任务且不扣费；默认 false。",
                         },
                     },
                     required: ["prompt"],
@@ -169,84 +250,303 @@ export function createServer(token, apiBaseUrl) {
                 },
                 outputSchema: {
                     type: "object",
+                    title: "AI 视频任务创建结果",
+                    description: "返回任务标识、所用配置、积分信息和后续查询提示；预检或失败时部分字段可能不返回。",
                     properties: {
-                        success: { type: "boolean" },
-                        taskId: { type: "number" },
-                        model: { type: "string" },
-                        route: { type: "string" },
-                        engineName: { type: "string" },
-                        usedRouteAlias: { type: "boolean" },
-                        taskMode: { type: "string" },
-                        videoCount: { type: "number" },
-                        dryRun: { type: "boolean" },
-                        estimatedCredits: { type: "number" },
-                        estimateSource: { type: "string" },
-                        remainingCredits: { type: "number" },
-                        statusHint: { type: "string" },
+                        success: {
+                            type: "boolean",
+                            title: "是否成功",
+                            description: "表示任务创建或预检请求是否成功。",
+                        },
+                        taskId: {
+                            type: "number",
+                            title: "任务 ID",
+                            description: "创建成功后返回的视频任务 ID；dryRun 或失败时可能不返回，请用于调用 get_video_status。",
+                        },
+                        model: {
+                            type: "string",
+                            title: "生成模型",
+                            description: "实际使用的模型短码：WA、SD、SD25、HA 或 H3。",
+                        },
+                        route: {
+                            type: "string",
+                            title: "兼容模型标识",
+                            description: "为旧客户端返回的兼容模型标识。",
+                        },
+                        engineName: {
+                            type: "string",
+                            title: "模型名称",
+                            description: "实际使用的极睿专业版模型名称。",
+                        },
+                        usedRouteAlias: {
+                            type: "boolean",
+                            title: "是否使用兼容参数",
+                            description: "表示本次调用是否通过已废弃的 route 参数选择模型。",
+                        },
+                        taskMode: {
+                            type: "string",
+                            title: "生成模式",
+                            description: "本次任务实际使用的生成模式。",
+                        },
+                        videoCount: {
+                            type: "number",
+                            title: "视频数量",
+                            description: "本次任务计划生成的视频数量。",
+                        },
+                        dryRun: {
+                            type: "boolean",
+                            title: "是否仅预检",
+                            description: "表示本次请求是否只进行了预检而未创建任务。",
+                        },
+                        creditEstimateKind: {
+                            type: "string",
+                            title: "积分估算类型",
+                            enum: ["reservation"],
+                            description: "WA 视频编辑返回 reservation，表示积分预留上限。",
+                        },
+                        reservationCeilingCredits: {
+                            type: "number",
+                            title: "积分预留上限",
+                            description: "积分预留上限；完成后按可信输入和实际输出时长结算。",
+                        },
+                        settlementDescription: {
+                            type: "string",
+                            title: "结算说明",
+                            description: "实际积分结算说明。",
+                        },
+                        estimatedCredits: {
+                            type: "number",
+                            title: "预估积分",
+                            description: "完成本次任务预计需要的积分；无法估算时可能不返回。",
+                        },
+                        estimateSource: {
+                            type: "string",
+                            title: "估算依据",
+                            description: "预估积分所依据的素材检测结果或时长提示。",
+                        },
+                        remainingCredits: {
+                            type: "number",
+                            title: "剩余积分",
+                            description: "请求处理后的账户剩余积分。",
+                        },
+                        statusHint: {
+                            type: "string",
+                            title: "后续操作提示",
+                            description: "提示是否应使用 taskId 调用 get_video_status 查询任务进度。",
+                        },
                         validationWarnings: {
                             type: "array",
-                            items: { type: "string" },
+                            title: "预检警告",
+                            description: "参数或素材预检产生的非阻断性提示列表。",
+                            items: {
+                                type: "string",
+                                title: "预检警告项",
+                                description: "一条需要关注但不阻断请求的预检提示。",
+                            },
+                        },
+                        code: {
+                            type: "string",
+                            title: "错误代码",
+                            description: "请求失败时返回的机器可读错误代码，成功时可能不返回。",
+                        },
+                        message: {
+                            type: "string",
+                            title: "结果消息",
+                            description: "请求结果或失败原因的可读说明。",
                         },
-                        code: { type: "string" },
-                        message: { type: "string" },
                     },
                     required: ["success"],
                 },
             },
             {
                 name: "get_video_status",
-                title: "查询视频生成状态",
-                description: "获取视频生成任务的状态，包括进度和视频 URL",
+                title: "查询 AI 视频生成结果",
+                description: "根据 create_video_task 返回的 taskId 查询 AI 视频生成进度和结果。任务未完成时请间隔一段时间后使用同一 taskId 再次调用；完成后返回视频链接，失败时返回原因。",
                 inputSchema: {
                     type: "object",
+                    title: "AI 视频任务查询参数",
+                    description: "指定需要查询的视频生成任务。",
                     properties: {
                         taskId: {
                             type: "number",
-                            description: "视频生成任务 ID",
+                            title: "任务 ID",
+                            description: "必填。由 create_video_task 返回的视频任务 ID，请原样传入并用于后续轮询。",
                         },
                     },
                     required: ["taskId"],
                 },
                 outputSchema: {
                     type: "object",
+                    title: "AI 视频生成状态与结果",
+                    description: "返回任务进度、生成结果和错误信息；任务未完成时结果链接和完成时间可能为空。",
                     properties: {
-                        success: { type: "boolean" },
-                        taskId: { type: "number" },
-                        status: { type: "string" },
-                        progress: { type: "number" },
-                        totalVideos: { type: "number" },
-                        completedVideos: { type: "number" },
-                        estimatedCredits: { type: "number" },
-                        taskMode: { type: ["string", "null"] },
-                        statusHint: { type: "string" },
-                        createdAt: { type: ["string", "null"] },
-                        updatedAt: { type: ["string", "null"] },
-                        completedAt: { type: ["string", "null"] },
-                        errorMessage: { type: "string" },
-                        errorCode: { type: "string" },
-                        errorCategory: { type: "string" },
-                        retryable: { type: "boolean" },
-                        code: { type: "string" },
-                        message: { type: "string" },
-                        route: { type: "string" },
-                        engineName: { type: "string" },
+                        success: {
+                            type: "boolean",
+                            title: "是否成功",
+                            description: "表示查询请求是否成功。",
+                        },
+                        taskId: {
+                            type: "number",
+                            title: "任务 ID",
+                            description: "当前查询的视频任务 ID。",
+                        },
+                        status: {
+                            type: "string",
+                            title: "任务状态",
+                            description: "视频任务当前的处理状态；未完成时应根据 statusHint 稍后重试。",
+                        },
+                        progress: {
+                            type: "number",
+                            title: "总体进度",
+                            description: "任务总体处理进度，通常为 0–100 的数值。",
+                        },
+                        totalVideos: {
+                            type: "number",
+                            title: "视频总数",
+                            description: "任务计划生成的视频总数。",
+                        },
+                        completedVideos: {
+                            type: "number",
+                            title: "已完成数量",
+                            description: "当前已经完成生成的视频数量。",
+                        },
+                        estimatedCredits: {
+                            type: "number",
+                            title: "预估积分",
+                            description: "任务预计消耗的积分；无法估算时可能不返回。",
+                        },
+                        taskMode: {
+                            type: ["string", "null"],
+                            title: "生成模式",
+                            description: "任务使用的生成模式；旧任务或尚未确定时可能为空。",
+                        },
+                        statusHint: {
+                            type: "string",
+                            title: "状态提示",
+                            description: "面向用户的当前状态和下一步轮询提示。",
+                        },
+                        createdAt: {
+                            type: ["string", "null"],
+                            title: "创建时间",
+                            description: "任务创建时间；不可用时为空。",
+                        },
+                        updatedAt: {
+                            type: ["string", "null"],
+                            title: "更新时间",
+                            description: "任务最近更新时间；不可用时为空。",
+                        },
+                        completedAt: {
+                            type: ["string", "null"],
+                            title: "完成时间",
+                            description: "任务完成时间；未完成时为空。",
+                        },
+                        errorMessage: {
+                            type: "string",
+                            title: "错误信息",
+                            description: "任务失败时的可读原因，未失败时可能不返回。",
+                        },
+                        errorCode: {
+                            type: "string",
+                            title: "错误代码",
+                            description: "任务失败时的机器可读错误代码，未失败时可能不返回。",
+                        },
+                        errorCategory: {
+                            type: "string",
+                            title: "错误分类",
+                            description: "任务失败时的错误类别，未失败时可能不返回。",
+                        },
+                        retryable: {
+                            type: "boolean",
+                            title: "是否可重试",
+                            description: "表示失败后是否建议重新发起任务，未失败时可能不返回。",
+                        },
+                        code: {
+                            type: "string",
+                            title: "查询错误代码",
+                            description: "查询请求失败时的机器可读错误代码，成功时可能不返回。",
+                        },
+                        message: {
+                            type: "string",
+                            title: "查询消息",
+                            description: "查询结果或失败原因的可读说明。",
+                        },
+                        route: {
+                            type: "string",
+                            title: "兼容模型标识",
+                            description: "任务对应的兼容模型标识。",
+                        },
+                        engineName: {
+                            type: "string",
+                            title: "模型名称",
+                            description: "任务实际使用的极睿专业版模型名称。",
+                        },
                         videos: {
                             type: "array",
+                            title: "视频结果列表",
+                            description: "每个待生成视频的状态和结果；单项未完成时链接可能为空。",
                             items: {
                                 type: "object",
+                                title: "视频结果",
+                                description: "一个视频生成结果及其状态、链接、时间和错误信息。",
                                 properties: {
-                                    id: { type: "number" },
-                                    status: { type: "string" },
-                                    videoUrl: { type: ["string", "null"] },
-                                    thumbnailUrl: { type: ["string", "null"] },
-                                    errorMessage: { type: ["string", "null"] },
-                                    errorCode: { type: ["string", "null"] },
-                                    errorCategory: { type: ["string", "null"] },
-                                    retryable: { type: ["boolean", "null"] },
-                                    createdAt: { type: ["string", "null"] },
-                                    completedAt: { type: ["string", "null"] },
+                                    id: {
+                                        type: "number",
+                                        title: "视频结果 ID",
+                                        description: "该视频结果在任务中的唯一标识。",
+                                    },
+                                    status: {
+                                        type: "string",
+                                        title: "视频状态",
+                                        description: "该视频当前的生成状态。",
+                                    },
+                                    videoUrl: {
+                                        type: ["string", "null"],
+                                        title: "视频 URL",
+                                        description: "生成完成后的视频访问 URL；未完成或失败时为空。",
+                                    },
+                                    thumbnailUrl: {
+                                        type: ["string", "null"],
+                                        title: "缩略图 URL",
+                                        description: "视频缩略图访问 URL；尚未生成时为空。",
+                                    },
+                                    errorMessage: {
+                                        type: ["string", "null"],
+                                        title: "错误信息",
+                                        description: "该视频生成失败时的可读原因；未失败时为空。",
+                                    },
+                                    errorCode: {
+                                        type: ["string", "null"],
+                                        title: "错误代码",
+                                        description: "该视频生成失败时的机器可读错误代码；未失败时为空。",
+                                    },
+                                    errorCategory: {
+                                        type: ["string", "null"],
+                                        title: "错误分类",
+                                        description: "该视频生成失败时的错误类别；未失败时为空。",
+                                    },
+                                    retryable: {
+                                        type: ["boolean", "null"],
+                                        title: "是否可重试",
+                                        description: "表示该视频失败后是否建议重新创建任务；未失败时为空。",
+                                    },
+                                    createdAt: {
+                                        type: ["string", "null"],
+                                        title: "创建时间",
+                                        description: "该视频结果的创建时间；不可用时为空。",
+                                    },
+                                    completedAt: {
+                                        type: ["string", "null"],
+                                        title: "完成时间",
+                                        description: "该视频的完成时间；未完成时为空。",
+                                    },
                                 },
-                                required: ["id", "status", "videoUrl", "thumbnailUrl", "errorMessage"],
+                                required: [
+                                    "id",
+                                    "status",
+                                    "videoUrl",
+                                    "thumbnailUrl",
+                                    "errorMessage",
+                                ],
                             },
                         },
                     },
@@ -255,70 +555,168 @@ export function createServer(token, apiBaseUrl) {
             },
             {
                 name: "create_video_analysis_task",
-                title: "创建视频拆解任务",
-                description: "创建视频拆解任务，将视频拆解为脚本、风格、卖点话术、爆款公式，并生成用于视频创作的提示词。" +
-                    "支持本地文件路径或公网 URL。",
+                title: "分析参考视频内容",
+                description: "分析本地视频或公网 URL，提取脚本、风格、卖点、创作公式并生成视频创作提示词；本工具不会生成最终视频。" +
+                    "本工具返回 analysisId，创建后请调用 get_video_analysis_status 并原样传入 analysisId，轮询分析进度和结果。",
                 inputSchema: {
                     type: "object",
+                    title: "参考视频分析参数",
+                    description: "指定需要分析的参考视频。",
                     properties: {
                         videoFile: {
                             type: "string",
-                            description: "要分析的视频文件，可以是本地文件路径或公网 URL",
+                            title: "参考视频",
+                            description: "必填。需要分析的视频本地文件路径或公网 URL。",
                         },
                     },
                     required: ["videoFile"],
                 },
                 outputSchema: {
                     type: "object",
+                    title: "视频分析任务创建结果",
+                    description: "返回分析任务标识、积分信息和后续查询提示；失败时部分字段可能不返回。",
                     properties: {
-                        success: { type: "boolean" },
-                        analysisId: { type: "number" },
-                        creditsUsed: { type: "number" },
-                        remainingCredits: { type: "number" },
-                        statusHint: { type: "string" },
-                        code: { type: "string" },
-                        message: { type: "string" },
+                        success: {
+                            type: "boolean",
+                            title: "是否成功",
+                            description: "表示视频分析任务是否创建成功。",
+                        },
+                        analysisId: {
+                            type: "number",
+                            title: "分析任务 ID",
+                            description: "创建成功后返回的分析任务 ID，请用于调用 get_video_analysis_status。",
+                        },
+                        creditsUsed: {
+                            type: "number",
+                            title: "消耗积分",
+                            description: "创建本次视频分析任务实际扣除的积分。",
+                        },
+                        remainingCredits: {
+                            type: "number",
+                            title: "剩余积分",
+                            description: "任务创建后的账户剩余积分。",
+                        },
+                        statusHint: {
+                            type: "string",
+                            title: "后续操作提示",
+                            description: "提示使用 analysisId 调用 get_video_analysis_status 查询分析进度。",
+                        },
+                        code: {
+                            type: "string",
+                            title: "错误代码",
+                            description: "创建失败时返回的机器可读错误代码，成功时可能不返回。",
+                        },
+                        message: {
+                            type: "string",
+                            title: "结果消息",
+                            description: "创建结果或失败原因的可读说明。",
+                        },
                     },
                     required: ["success"],
                 },
             },
             {
                 name: "get_video_analysis_status",
-                title: "查询视频拆解状态",
-                description: "获取视频拆解任务的状态和结果",
+                title: "查询视频分析结果",
+                description: "根据 create_video_analysis_task 返回的 analysisId 查询分析进度和结构化结果。任务未完成时请间隔一段时间后使用同一 analysisId 再次调用。",
                 inputSchema: {
                     type: "object",
+                    title: "视频分析任务查询参数",
+                    description: "指定需要查询的视频分析任务。",
                     properties: {
                         analysisId: {
                             type: "number",
-                            description: "视频拆解任务 ID",
+                            title: "分析任务 ID",
+                            description: "必填。由 create_video_analysis_task 返回的分析任务 ID，请原样传入并用于后续轮询。",
                         },
                     },
                     required: ["analysisId"],
                 },
                 outputSchema: {
                     type: "object",
+                    title: "视频分析状态与结果",
+                    description: "返回分析进度和结构化内容；任务未完成或失败时分析内容可能为空。",
                     properties: {
-                        success: { type: "boolean" },
-                        analysisId: { type: "number" },
-                        status: { type: "string" },
-                        conversionProgress: { type: ["number", "null"] },
-                        script: { type: ["string", "null"] },
-                        style: { type: ["string", "null"] },
-                        sellingPoints: { type: ["string", "null"] },
-                        viralFormula: { type: ["string", "null"] },
-                        generatedPrompt: { type: ["string", "null"] },
-                        errorMessage: { type: ["string", "null"] },
-                        originalVideoUrl: { type: ["string", "null"] },
-                        videoFileName: { type: ["string", "null"] },
-                        code: { type: "string" },
-                        message: { type: "string" },
+                        success: {
+                            type: "boolean",
+                            title: "是否成功",
+                            description: "表示查询请求是否成功。",
+                        },
+                        analysisId: {
+                            type: "number",
+                            title: "分析任务 ID",
+                            description: "当前查询的视频分析任务 ID。",
+                        },
+                        status: {
+                            type: "string",
+                            title: "分析状态",
+                            description: "视频分析任务当前的处理状态；未完成时应稍后继续查询。",
+                        },
+                        conversionProgress: {
+                            type: ["number", "null"],
+                            title: "处理进度",
+                            description: "视频转换和分析进度，通常为 0–100；尚未开始时可能为空。",
+                        },
+                        script: {
+                            type: ["string", "null"],
+                            title: "视频脚本",
+                            description: "从参考视频中提取的脚本内容；分析未完成时为空。",
+                        },
+                        style: {
+                            type: ["string", "null"],
+                            title: "视频风格",
+                            description: "识别出的视觉、叙事和表达风格；分析未完成时为空。",
+                        },
+                        sellingPoints: {
+                            type: ["string", "null"],
+                            title: "卖点分析",
+                            description: "从视频中识别出的商品或内容卖点；分析未完成时为空。",
+                        },
+                        viralFormula: {
+                            type: ["string", "null"],
+                            title: "创作公式",
+                            description: "总结的视频结构和内容创作公式；分析未完成时为空。",
+                        },
+                        generatedPrompt: {
+                            type: ["string", "null"],
+                            title: "生成提示词",
+                            description: "基于分析结果生成的后续视频创作提示词；分析未完成时为空。",
+                        },
+                        errorMessage: {
+                            type: ["string", "null"],
+                            title: "错误信息",
+                            description: "分析失败时的可读原因；未失败时为空。",
+                        },
+                        originalVideoUrl: {
+                            type: ["string", "null"],
+                            title: "原视频 URL",
+                            description: "本次分析所使用的视频访问 URL；不可用时为空。",
+                        },
+                        videoFileName: {
+                            type: ["string", "null"],
+                            title: "视频文件名",
+                            description: "参考视频的文件名；不可用时为空。",
+                        },
+                        code: {
+                            type: "string",
+                            title: "查询错误代码",
+                            description: "查询请求失败时返回的机器可读错误代码，成功时可能不返回。",
+                        },
+                        message: {
+                            type: "string",
+                            title: "查询消息",
+                            description: "查询结果或失败原因的可读说明。",
+                        },
                     },
                     required: ["success"],
                 },
             },
+            ...MCP_CREATIVE_TOOLS,
         ];
-        return { tools };
+        const filtered = options.filterTools
+            ? options.filterTools(allTools)
+            : allTools;
+        return { tools: filtered };
     });
     /**
      * Handle tool calls
@@ -337,6 +735,14 @@ export function createServer(token, apiBaseUrl) {
                     return await handleCreateVideoAnalysisTask(apiBaseUrl, token, args);
                 case "get_video_analysis_status":
                     return await handleGetVideoAnalysisStatus(apiBaseUrl, token, args);
+                case "create_motion_video_remake_task":
+                    return await handleCreateMotionVideoRemakeTask(apiBaseUrl, token, args);
+                case "get_motion_video_remake_status":
+                    return await handleGetMotionVideoRemakeStatus(apiBaseUrl, token, args);
+                case "create_ecommerce_storyboard_task":
+                    return await handleCreateEcommerceStoryboardTask(apiBaseUrl, token, args);
+                case "get_ecommerce_storyboard_status":
+                    return await handleGetEcommerceStoryboardStatus(apiBaseUrl, token, args);
                 default:
                     throw new Error(`Unknown tool: ${name}`);
             }
@@ -402,7 +808,7 @@ async function handleGetUserInfo(apiBaseUrl, token) {
  * 处理文件输入：支持本地文件路径或公网 URL
  * 对于本地文件，读取并转换为 base64
  */
-async function processFileInput(fileInput, expectedType) {
+async function processFileInput(fileInput, expectedType, maxBytes) {
     // 检查是否是公网 URL
     if (fileInput.startsWith("http://") || fileInput.startsWith("https://")) {
         return {
@@ -418,8 +824,6 @@ async function processFileInput(fileInput, expectedType) {
     if (!existsSync(filePath)) {
         throw new McpToolError(`文件不存在: ${filePath}`, "FILE_NOT_FOUND");
     }
-    // 读取文件
-    const buffer = readFileSync(filePath);
     // 获取文件扩展名并确定 MIME type
     const ext = extname(filePath).toLowerCase();
     let mimeType = "application/octet-stream";
@@ -442,12 +846,17 @@ async function processFileInput(fileInput, expectedType) {
         throw new McpToolError(`文件 ${basename(filePath)} 类型不匹配：当前是 ${mimeType}，但该字段需要 ${expectedType} 文件。`, "INVALID_FILE_TYPE");
     }
     const size = statSync(filePath).size;
-    if (expectedType === "video" && size > 50 * 1024 * 1024) {
-        throw new McpToolError(`视频文件 ${basename(filePath)} 超过 50MB 限制。`, "MEDIA_FILE_TOO_LARGE");
-    }
-    if (expectedType === "audio" && size > 15 * 1024 * 1024) {
-        throw new McpToolError(`音频文件 ${basename(filePath)} 超过 15MB 限制。`, "MEDIA_FILE_TOO_LARGE");
+    const effectiveMaxBytes = maxBytes ??
+        (expectedType === "video"
+            ? 50 * 1024 * 1024
+            : expectedType === "audio"
+                ? 15 * 1024 * 1024
+                : undefined);
+    if (effectiveMaxBytes !== undefined && size > effectiveMaxBytes) {
+        throw new McpToolError(`文件 ${basename(filePath)} 超过 ${Math.floor(effectiveMaxBytes / 1024 / 1024)}MB 限制。`, "MEDIA_FILE_TOO_LARGE");
     }
+    // 通过大小预检后再读取，避免将超限文件装入内存。
+    const buffer = readFileSync(filePath);
     // 转换为 base64
     const base64 = `data:${mimeType};base64,${buffer.toString("base64")}`;
     return {
@@ -467,109 +876,197 @@ async function processFileInputs(fileInputs, expectedType) {
     return processed.length > 0 ? processed : undefined;
 }
 function hasItems(value) {
-    return Array.isArray(value) && value.some((item) => typeof item === "string" && item.length > 0);
+    return (Array.isArray(value) &&
+        value.some(item => typeof item === "string" && item.length > 0));
 }
 function itemCount(value) {
-    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.length > 0).length : 0;
+    return Array.isArray(value)
+        ? value.filter(item => typeof item === "string" && item.length > 0).length
+        : 0;
 }
 function normalizeRoute(args) {
-    // 优先 model；若 model 未传或不是 SA/SD/HA，再看 route（route 现在是 deprecated alias）
-    if (args && typeof args === "object" && isMcpModel(args.model)) {
-        const m = args.model;
-        return {
-            route: MCP_VIDEO_MODELS[m].route,
-            model: m,
-            usedRouteAlias: false,
-        };
+    // CLI 只做本地预检；最终模型与线路由 HTTP 服务端裁定并在响应里回传，
+    // 避免双配置源发生漂移。
+    const model = args && typeof args === "object" ? args.model : undefined;
+    if (isRetiredSaModel(model)) {
+        throw new McpToolError("SA 模型（sora-2）已下线，请改用 WA。", "MODEL_RETIRED");
+    }
+    if (isMcpModel(model)) {
+        return resolveMcpEngine({ model });
+    }
+    if (model !== undefined && model !== null) {
+        throw new McpToolError("model 必须是 WA、SD、SD25、HA 或 H3。", "INVALID_ENGINE");
     }
     const raw = args && typeof args === "object" ? args.route : undefined;
-    const route = typeof raw === "string" ? raw : "S2";
-    if (!isMcpRoute(route)) {
-        throw new McpToolError("model 必须是 SA、SD 或 HA；route 只接受 S2、S5、S6（已废弃），请改用 model。", "INVALID_ENGINE");
+    if (isRetiredSaRoute(raw)) {
+        throw new McpToolError("SA 模型（sora-2）已下线，请改用 WA。", "MODEL_RETIRED");
     }
-    const m = route === "S2" ? "SA" : route === "S5" ? "SD" : "HA";
-    return {
-        route,
-        model: m,
-        usedRouteAlias: true,
-    };
+    if (raw === undefined || raw === null) {
+        // 省略 model/route 时统一回退到 WA，与 resolveMcpEngine 的默认值一致。
+        return resolveMcpEngine({});
+    }
+    if (typeof raw !== "string" || !isMcpRoute(raw)) {
+        throw new McpToolError("route 只接受 S5、S6、S7、S8、S9（已废弃），请改用 model。", "INVALID_ENGINE");
+    }
+    return resolveMcpEngine({ route: raw });
 }
 function normalizeTaskMode(route, value) {
     const mode = typeof value === "string" ? value : getMcpDefaultTaskMode(route);
-    if (route === "S2") {
-        if (value !== undefined) {
-            throw new McpToolError("taskMode 仅适用于极睿Sd专业版或极睿Ha专业版；S2 极睿Sa专业版无需传 taskMode。", "UNSUPPORTED_FIELD", route);
-        }
-        return getMcpDefaultTaskMode(route);
-    }
     if (!isValidMcpTaskMode(route, mode)) {
-        const allowedModes = route === "S5" ? "allinone 或 firstlast" : "standard、reference 或 edit";
+        const allowedModes = route === "S5" || route === "S8"
+            ? "allinone、firstlast 或 edit"
+            : route === "S9"
+                ? "allinone、firstlast 或 edit"
+                : route === "S7"
+                    ? "allinone、firstlast 或 reference"
+                    : "standard、reference 或 edit";
         throw new McpToolError(`${getMcpEngineName(route)} 的 taskMode 只能是 ${allowedModes}。`, "INVALID_TASK_MODE", route);
     }
     return mode;
 }
-function validateCreateVideoArgs(args) {
+export function validateCreateVideoArgs(args) {
     if (!args || typeof args !== "object") {
         throw new McpToolError("请提供视频生成参数。");
     }
     if (!args.prompt || typeof args.prompt !== "string" || !args.prompt.trim()) {
         throw new McpToolError("prompt 不能为空。");
     }
-    if (args.count !== undefined && (!Number.isInteger(args.count) || args.count < 1 || args.count > 12)) {
+    if (args.count !== undefined &&
+        (!Number.isInteger(args.count) || args.count < 1 || args.count > 12)) {
         throw new McpToolError("count 必须是 1-12 的整数。", "INVALID_COUNT");
     }
     const norm = normalizeRoute(args);
     const route = norm.route;
     const taskMode = normalizeTaskMode(route, args.taskMode);
     const resolution = typeof args.resolution === "string" ? args.resolution : "720p";
+    const outputFormat = typeof args.outputFormat === "string" ? args.outputFormat : "mp4";
     const dryRun = args.dryRun === true;
-    if ((route === "S5" || route === "S6") && resolution !== "720p" && resolution !== "1080p") {
+    if (route === "S8" &&
+        resolution !== "480p" &&
+        resolution !== "720p" &&
+        resolution !== "1080p") {
+        throw new McpToolError(`${getMcpEngineName(route)} 仅支持 480p、720p 或 1080p。`, "INVALID_RESOLUTION", route);
+    }
+    if (outputFormat !== "mp4" && outputFormat !== "mov") {
+        throw new McpToolError("outputFormat 只能是 mp4 或 mov。", "UNSUPPORTED_FIELD", route);
+    }
+    if (outputFormat === "mov" && route !== "S8") {
+        throw new McpToolError(`MOV 仅适用于${getMcpEngineName("S8")}。`, "UNSUPPORTED_FIELD", route);
+    }
+    if (route === "S9" &&
+        resolution !== "480p" &&
+        resolution !== "720p" &&
+        resolution !== "1080p") {
+        throw new McpToolError(`${getMcpEngineName(route)} 仅支持 480p、720p 或 1080p。`, "INVALID_RESOLUTION", route);
+    }
+    if ((route === "S5" || route === "S6") &&
+        resolution !== "720p" &&
+        resolution !== "1080p") {
         throw new McpToolError(`${getMcpEngineName(route)} 仅支持 720p 或 1080p。`, "INVALID_RESOLUTION", route);
     }
-    if (route === "S2" && args.seconds === 5) {
-        throw new McpToolError("极睿Sa专业版不支持 5 秒视频，请使用 10 或 15 秒。", "INVALID_SECONDS", route);
+    if (route === "S9" &&
+        args.seconds !== undefined &&
+        !isWan3OutputSeconds(args.seconds, taskMode)) {
+        throw new McpToolError(taskMode === "edit"
+            ? "WA 视频编辑仅支持智能时长（-1）。"
+            : `${getMcpEngineName(route)} 视频时长仅支持 ${WAN3_OUTPUT_SECONDS_LABEL} 秒。`, "INVALID_SECONDS", route);
     }
-    if (route === "S2") {
-        const unsupported = [
-            hasItems(args.sourceImages) ? "sourceImages" : undefined,
-            hasItems(args.sourceVideos) ? "sourceVideos" : undefined,
-            hasItems(args.sourceAudios) ? "sourceAudios" : undefined,
-            args.resolution !== undefined ? "resolution" : undefined,
-            args.ratio !== undefined ? "ratio" : undefined,
-            args.generateAudio !== undefined ? "generateAudio" : undefined,
-            args.webSearchEnabled !== undefined ? "webSearchEnabled" : undefined,
-        ].filter(Boolean);
-        if (unsupported.length > 0) {
-            throw new McpToolError(`这些字段不适用于极睿Sa专业版：${unsupported.join("、")}。S2 单图请使用 sourceImage。`, "UNSUPPORTED_FIELD", route);
+    // S5/S6/S7/S8 的 seconds 白名单
+    if (route === "S5" || route === "S6" || route === "S7" || route === "S8") {
+        if ((route === "S5" || route === "S8") && taskMode === "edit") {
+            const maxEditSeconds = route === "S8" ? 30 : 15;
+            if (args.seconds !== undefined &&
+                (!Number.isInteger(args.seconds) ||
+                    args.seconds < 4 ||
+                    args.seconds > maxEditSeconds)) {
+                throw new McpToolError(`${getMcpEngineName(route)} Edit 参考视频时长必须为 4–${maxEditSeconds} 秒。`, "INVALID_SECONDS", route);
+            }
+        }
+        else {
+            const allowedSeconds = route === "S8" ? [5, 10, 15, 20, 25, 30] : [5, 10, 15];
+            if (args.seconds !== undefined &&
+                !allowedSeconds.includes(args.seconds)) {
+                throw new McpToolError(route === "S8"
+                    ? `${getMcpEngineName(route)} 视频时长仅支持 5、10、15、20、25、30 秒。`
+                    : `${getMcpEngineName(route)} 视频时长仅支持 5、10、15 秒。`, "INVALID_SECONDS", route);
+            }
         }
     }
-    if (route === "S5") {
+    if (route === "S5" || route === "S8") {
+        // S8 = SD2.5 独立通道：素材上限放宽（30 图 / 10 视频 / 10 音频）。
+        const isSd25 = route === "S8";
+        const sdEngine = getMcpEngineName(route);
         if (args.sourceImage !== undefined) {
-            throw new McpToolError("sourceImage 不适用于极睿Sd专业版；请使用 sourceImages 传参考图或首尾帧。", "UNSUPPORTED_FIELD", route);
+            throw new McpToolError(`sourceImage 不适用于${sdEngine}；请使用 sourceImages 传参考图或首尾帧。`, "UNSUPPORTED_FIELD", route);
         }
         if (args.ratio !== undefined) {
-            throw new McpToolError("ratio 仅适用于极睿Ha专业版；极睿Sd专业版请使用 size 控制画面比例。", "UNSUPPORTED_FIELD", route);
+            throw new McpToolError(`ratio 仅适用于极睿HA专业版；${sdEngine}请使用 size 控制画面比例。`, "UNSUPPORTED_FIELD", route);
         }
         if (taskMode === "firstlast" && !hasItems(args.sourceImages)) {
-            throw new McpToolError("极睿Sd专业版首尾帧模式需要在 sourceImages 中提供至少 1 张首帧图片。", "MISSING_SOURCE_IMAGE", route);
+            throw new McpToolError(`${sdEngine}首尾帧模式需要在 sourceImages 中提供至少 1 张首帧图片。`, "MISSING_SOURCE_IMAGE", route);
         }
-        if (taskMode === "firstlast" && (hasItems(args.sourceVideos) || hasItems(args.sourceAudios))) {
-            throw new McpToolError("sourceVideos/sourceAudios 仅适用于极睿Sd专业版全能参考模式；首尾帧模式只使用 sourceImages。", "UNSUPPORTED_FIELD", route);
+        if (taskMode === "firstlast" &&
+            (hasItems(args.sourceVideos) || hasItems(args.sourceAudios))) {
+            throw new McpToolError(`sourceVideos/sourceAudios 仅适用于${sdEngine}全能参考模式；首尾帧模式只使用 sourceImages。`, "UNSUPPORTED_FIELD", route);
         }
         if (taskMode === "firstlast" && itemCount(args.sourceImages) > 2) {
-            throw new McpToolError("极睿Sd专业版首尾帧模式最多支持 2 张图片。", "MEDIA_COUNT_EXCEEDED", route);
+            throw new McpToolError(`${sdEngine}首尾帧模式最多支持 2 张图片。`, "MEDIA_COUNT_EXCEEDED", route);
         }
-        if (taskMode === "allinone" && itemCount(args.sourceImages) > 9) {
-            throw new McpToolError("极睿Sd专业版全能参考模式最多支持 9 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+        const maxImages = isSd25 ? 30 : 9;
+        const maxVideos = isSd25 ? 10 : 3;
+        const maxAudios = isSd25 ? 10 : 3;
+        if ((taskMode === "allinone" || taskMode === "edit") &&
+            itemCount(args.sourceImages) > maxImages) {
+            throw new McpToolError(`${sdEngine}全能参考模式最多支持 ${maxImages} 张参考图片。`, "MEDIA_COUNT_EXCEEDED", route);
         }
-        if (taskMode === "allinone" && itemCount(args.sourceVideos) > 3) {
-            throw new McpToolError("极睿Sd专业版全能参考模式最多支持 3 个参考视频。", "MEDIA_COUNT_EXCEEDED", route);
+        if ((taskMode === "allinone" || taskMode === "edit") &&
+            itemCount(args.sourceVideos) > maxVideos) {
+            throw new McpToolError(`${sdEngine}全能参考模式最多支持 ${maxVideos} 个参考视频。`, "MEDIA_COUNT_EXCEEDED", route);
         }
-        if (taskMode === "allinone" && itemCount(args.sourceAudios) > 3) {
-            throw new McpToolError("极睿Sd专业版全能参考模式最多支持 3 个参考音频。", "MEDIA_COUNT_EXCEEDED", route);
+        if ((taskMode === "allinone" || taskMode === "edit") &&
+            itemCount(args.sourceAudios) > maxAudios) {
+            throw new McpToolError(`${sdEngine}全能参考模式最多支持 ${maxAudios} 个参考音频。`, "MEDIA_COUNT_EXCEEDED", route);
         }
-        if (taskMode === "allinone" && hasItems(args.sourceAudios) && !hasItems(args.sourceImages) && !hasItems(args.sourceVideos)) {
-            throw new McpToolError("极睿Sd专业版全能参考模式中，音频素材必须搭配至少一张参考图片或一个参考视频。", "MISSING_VISUAL_REFERENCE", route);
+        // 纯音频参考：S5 2.0 要求音频搭配图片/视频；S8（SD2.5）支持纯音频参考，豁免
+        if (!isSd25 &&
+            taskMode === "allinone" &&
+            hasItems(args.sourceAudios) &&
+            !hasItems(args.sourceImages) &&
+            !hasItems(args.sourceVideos)) {
+            throw new McpToolError(`${sdEngine}全能参考模式中，音频素材必须搭配至少一张参考图片或一个参考视频。`, "MISSING_VISUAL_REFERENCE", route);
+        }
+        if (taskMode === "edit" && !hasItems(args.sourceVideos)) {
+            throw new McpToolError(`${sdEngine} Edit 至少 1 个参考视频。`, "MISSING_SOURCE_VIDEO", route);
+        }
+    }
+    if (route === "S9") {
+        if (args.sourceImage !== undefined) {
+            throw new McpToolError("sourceImage 不适用于极睿WA专业版；请使用 sourceImages。", "UNSUPPORTED_FIELD", route);
+        }
+        if (args.webSearchEnabled !== undefined) {
+            throw new McpToolError("webSearchEnabled 不适用于极睿WA专业版。", "UNSUPPORTED_FIELD", route);
+        }
+        if (args.ratio !== undefined &&
+            !["adaptive", "16:9", "4:3", "1:1", "3:4", "9:16"].includes(args.ratio)) {
+            throw new McpToolError("WA 不支持该画面比例。", "INVALID_RATIO", route);
+        }
+        if (taskMode === "firstlast") {
+            const images = itemCount(args.sourceImages);
+            if (images < 1 || images > 2) {
+                throw new McpToolError("WA 首尾帧模式必须提供 1 张首帧，最多再提供 1 张尾帧。", "MISSING_SOURCE_IMAGE", route);
+            }
+            if (hasItems(args.sourceVideos) || hasItems(args.sourceAudios)) {
+                throw new McpToolError("WA 参考素材与首尾帧模式严格互斥。", "UNSUPPORTED_FIELD", route);
+            }
+        }
+        if (taskMode === "edit" && !hasItems(args.sourceVideos)) {
+            throw new McpToolError("WA 视频编辑至少需要一个参考视频。", "MISSING_SOURCE_VIDEO", route);
+        }
+        if (taskMode !== "firstlast" && itemCount(args.sourceImages) > 10) {
+            throw new McpToolError("WA 参考图片最多支持 10 张。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+        if (itemCount(args.sourceVideos) > 5 || itemCount(args.sourceAudios) > 5) {
+            throw new McpToolError("WA 参考视频和参考音频各最多支持 5 个。", "MEDIA_COUNT_EXCEEDED", route);
         }
     }
     if (route === "S6") {
@@ -579,28 +1076,63 @@ function validateCreateVideoArgs(args) {
             args.webSearchEnabled !== undefined ? "webSearchEnabled" : undefined,
         ].filter(Boolean);
         if (unsupported.length > 0) {
-            throw new McpToolError(`这些字段仅适用于极睿Sd专业版，不能用于极睿Ha专业版：${unsupported.join("、")}。`, "UNSUPPORTED_FIELD", route);
+            throw new McpToolError(`这些字段仅适用于极睿SD专业版，不能用于极睿HA专业版：${unsupported.join("、")}。`, "UNSUPPORTED_FIELD", route);
         }
-        if (taskMode === "standard" && (hasItems(args.sourceImages) || hasItems(args.sourceVideos))) {
-            throw new McpToolError("极睿Ha专业版标准模式只支持 sourceImage 作为单图输入；多图请使用 reference 模式，视频请使用 edit 模式。", "UNSUPPORTED_FIELD", route);
+        if (taskMode === "standard" &&
+            (hasItems(args.sourceImages) || hasItems(args.sourceVideos))) {
+            throw new McpToolError("极睿HA专业版标准模式只支持 sourceImage 作为单图输入；多图请使用 reference 模式，视频请使用 edit 模式。", "UNSUPPORTED_FIELD", route);
         }
-        if ((taskMode === "reference" || taskMode === "edit") && args.sourceImage !== undefined) {
-            throw new McpToolError("sourceImage 仅适用于极睿Ha专业版标准模式；reference/edit 模式请使用 sourceImages。", "UNSUPPORTED_FIELD", route);
+        if ((taskMode === "reference" || taskMode === "edit") &&
+            args.sourceImage !== undefined) {
+            throw new McpToolError("sourceImage 仅适用于极睿HA专业版标准模式；reference/edit 模式请使用 sourceImages。", "UNSUPPORTED_FIELD", route);
         }
         if (taskMode === "reference" && !hasItems(args.sourceImages)) {
-            throw new McpToolError("极睿Ha专业版图片参考模式需要在 sourceImages 中提供至少 1 张参考图片。", "MISSING_SOURCE_IMAGE", route);
+            throw new McpToolError("极睿HA专业版图片参考模式需要在 sourceImages 中提供至少 1 张参考图片。", "MISSING_SOURCE_IMAGE", route);
         }
         if (taskMode === "edit" && !hasItems(args.sourceVideos)) {
-            throw new McpToolError("极睿Ha专业版视频编辑模式需要在 sourceVideos 中提供至少 1 个参考视频。", "MISSING_SOURCE_VIDEO", route);
+            throw new McpToolError("极睿HA专业版视频编辑模式需要在 sourceVideos 中提供至少 1 个参考视频。", "MISSING_SOURCE_VIDEO", route);
         }
         if (taskMode === "reference" && itemCount(args.sourceImages) > 9) {
-            throw new McpToolError("极睿Ha专业版图片参考模式最多支持 9 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+            throw new McpToolError("极睿HA专业版图片参考模式最多支持 9 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
         }
         if (taskMode === "edit" && itemCount(args.sourceVideos) > 1) {
-            throw new McpToolError("极睿Ha专业版视频编辑模式最多支持 1 个参考视频。", "MEDIA_COUNT_EXCEEDED", route);
+            throw new McpToolError("极睿HA专业版视频编辑模式最多支持 1 个参考视频。", "MEDIA_COUNT_EXCEEDED", route);
         }
         if (taskMode === "edit" && itemCount(args.sourceImages) > 5) {
-            throw new McpToolError("极睿Ha专业版视频编辑模式最多支持 5 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+            throw new McpToolError("极睿HA专业版视频编辑模式最多支持 5 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+    }
+    if (route === "S7") {
+        // S7 = H3（MiniMax V2）：固定 2K 输出；i2va/r2va 互斥；seconds 白名单 [5,10,15]（已在上方统一校验）。
+        if (args.resolution !== undefined) {
+            throw new McpToolError(`${getMcpEngineName(route)}固定 2K 输出，无需传 resolution。`, "UNSUPPORTED_FIELD", route);
+        }
+        if (args.sourceImage !== undefined) {
+            throw new McpToolError(`sourceImage 不适用于${getMcpEngineName(route)}；请使用 sourceImages 传参考图或首尾帧。`, "UNSUPPORTED_FIELD", route);
+        }
+        if (args.generateAudio !== undefined ||
+            args.webSearchEnabled !== undefined) {
+            throw new McpToolError(`generateAudio/webSearchEnabled 不适用于${getMcpEngineName(route)}。`, "UNSUPPORTED_FIELD", route);
+        }
+        if (taskMode === "firstlast") {
+            if (!hasItems(args.sourceImages)) {
+                throw new McpToolError(`${getMcpEngineName(route)}首尾帧模式需要在 sourceImages 中提供至少 1 张首帧图片。`, "MISSING_SOURCE_IMAGE", route);
+            }
+            if (hasItems(args.sourceVideos) || hasItems(args.sourceAudios)) {
+                throw new McpToolError(`sourceVideos/sourceAudios 仅适用于${getMcpEngineName(route)}全能参考模式；首尾帧模式只使用 sourceImages。`, "UNSUPPORTED_FIELD", route);
+            }
+            if (itemCount(args.sourceImages) > 2) {
+                throw new McpToolError(`${getMcpEngineName(route)}首尾帧模式最多支持 2 张图片（首帧 + 尾帧）。`, "MEDIA_COUNT_EXCEEDED", route);
+            }
+        }
+        else if (hasItems(args.sourceAudios) &&
+            !hasItems(args.sourceImages) &&
+            !hasItems(args.sourceVideos)) {
+            // r2va 不允许仅音频（与网页端 / 服务端校验一致）
+            throw new McpToolError(`${getMcpEngineName(route)}全能参考模式中，音频素材必须搭配至少一张参考图片或一个参考视频。`, "MISSING_VISUAL_REFERENCE", route);
+        }
+        if (itemCount(args.sourceImages) > 9) {
+            throw new McpToolError(`${getMcpEngineName(route)}最多支持 9 张参考图片。`, "MEDIA_COUNT_EXCEEDED", route);
         }
     }
     return {
@@ -609,6 +1141,7 @@ function validateCreateVideoArgs(args) {
         usedRouteAlias: norm.usedRouteAlias,
         taskMode,
         resolution,
+        outputFormat,
         dryRun,
         statusHint: getMcpVideoStatusHint(dryRun),
     };
@@ -618,7 +1151,11 @@ function validateCreateVideoArgs(args) {
  */
 async function handleCreateVideoTask(apiBaseUrl, token, args) {
     const normalized = validateCreateVideoArgs(args);
-    const isProfessionalRoute = normalized.route === "S5" || normalized.route === "S6";
+    const isProfessionalRoute = normalized.route === "S5" ||
+        normalized.route === "S6" ||
+        normalized.route === "S7" ||
+        normalized.route === "S8" ||
+        normalized.route === "S9";
     const requestBody = {
         token,
         prompt: args.prompt,
@@ -626,7 +1163,12 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
             ? (await processFileInput(args.sourceImage, "image")).data
             : undefined,
         size: args.size || "1280x720",
-        seconds: args.seconds || 10,
+        seconds: args.seconds ??
+            (normalized.route === "S9"
+                ? normalized.taskMode === "edit"
+                    ? -1
+                    : 5
+                : 10),
         language: args.language || "zh-CN",
         count: args.count || 1,
         model: normalized.model,
@@ -640,7 +1182,9 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
         requestBody.taskMode = normalized.taskMode;
         requestBody.isFirstLastMode = normalized.taskMode === "firstlast";
         requestBody.resolution = normalized.resolution;
-        requestBody.ratio = args.ratio || undefined;
+        requestBody.outputFormat = normalized.outputFormat;
+        requestBody.ratio =
+            args.ratio || (normalized.route === "S9" ? "adaptive" : undefined);
         requestBody.generateAudio = args.generateAudio;
         requestBody.webSearchEnabled = args.webSearchEnabled;
         if (normalized.dryRun) {
@@ -665,7 +1209,9 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
         `- **当前积分**: ${response.remainingCredits}`,
     ];
     if (typeof estimatedCredits === "number") {
-        result.splice(6, 0, `- **预估积分**: ${estimatedCredits}（视频完成后按成功扣费）`);
+        result.splice(6, 0, response.creditEstimateKind === "reservation"
+            ? `- **积分预留上限**: ${response.reservationCeilingCredits ?? estimatedCredits}（完成后按输入视频及实际时长结算）`
+            : `- **预估积分**: ${estimatedCredits}（视频完成后按成功扣费）`);
     }
     if (!dryRun && response.taskId !== undefined) {
         result.splice(4, 0, `- **任务 ID**: ${response.taskId}`);
@@ -692,6 +1238,13 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
             videoCount: response.videoCount,
             dryRun,
             estimatedCredits,
+            ...(response.creditEstimateKind === "reservation"
+                ? {
+                    creditEstimateKind: response.creditEstimateKind,
+                    reservationCeilingCredits: response.reservationCeilingCredits ?? estimatedCredits,
+                    settlementDescription: response.settlementDescription,
+                }
+                : {}),
             estimateSource: response.estimateSource,
             remainingCredits: response.remainingCredits,
             statusHint,
@@ -705,9 +1258,13 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
  */
 async function handleGetVideoStatus(apiBaseUrl, token, args) {
     const response = await callRestApi(apiBaseUrl, `/mcp/video/status/${args.taskId}`, { token }, "GET");
-    const statusText = response.status === "completed" ? "✅ 已完成" :
-        response.status === "processing" ? "🔄 处理中" :
-            response.status === "failed" ? "❌ 失败" : `⏳ ${response.status}`;
+    const statusText = response.status === "completed"
+        ? "✅ 已完成"
+        : response.status === "processing"
+            ? "🔄 处理中"
+            : response.status === "failed"
+                ? "❌ 失败"
+                : `⏳ ${response.status}`;
     let result = [
         `# 视频生成任务状态`,
         ``,
@@ -716,7 +1273,9 @@ async function handleGetVideoStatus(apiBaseUrl, token, args) {
         `- **进度**: ${response.progress}% (${response.completedVideos}/${response.totalVideos} 个视频)`,
         response.engineName ? `- **生成引擎**: ${response.engineName}` : undefined,
         response.taskMode ? `- **模式**: ${response.taskMode}` : undefined,
-        typeof response.estimatedCredits === "number" ? `- **预估积分**: ${response.estimatedCredits}` : undefined,
+        typeof response.estimatedCredits === "number"
+            ? `- **预估积分**: ${response.estimatedCredits}`
+            : undefined,
         ``,
     ].filter((line) => line !== undefined);
     if (response.errorMessage) {
@@ -729,9 +1288,13 @@ async function handleGetVideoStatus(apiBaseUrl, token, args) {
     if (response.videos && response.videos.length > 0) {
         result.push(`## 视频列表:`);
         response.videos.forEach((video, index) => {
-            const videoStatus = video.status === "completed" ? "✅" :
-                video.status === "processing" ? "🔄" :
-                    video.status === "failed" ? "❌" : "⏳";
+            const videoStatus = video.status === "completed"
+                ? "✅"
+                : video.status === "processing"
+                    ? "🔄"
+                    : video.status === "failed"
+                        ? "❌"
+                        : "⏳";
             result.push(``);
             result.push(`${index + 1}. ${videoStatus} 视频 ID: ${video.id}`);
             if (video.videoUrl) {
@@ -821,10 +1384,15 @@ async function handleCreateVideoAnalysisTask(apiBaseUrl, token, args) {
  */
 async function handleGetVideoAnalysisStatus(apiBaseUrl, token, args) {
     const response = await callRestApi(apiBaseUrl, `/mcp/video-analysis/status/${args.analysisId}`, { token }, "GET");
-    const statusText = response.status === "completed" ? "✅ 已完成" :
-        response.status === "processing" ? "🔄 处理中" :
-            response.status === "pending" ? "⏳ 等待中" :
-                response.status === "failed" ? "❌ 失败" : `⏳ ${response.status}`;
+    const statusText = response.status === "completed"
+        ? "✅ 已完成"
+        : response.status === "processing"
+            ? "🔄 处理中"
+            : response.status === "pending"
+                ? "⏳ 等待中"
+                : response.status === "failed"
+                    ? "❌ 失败"
+                    : `⏳ ${response.status}`;
     let result = [
         `# 视频拆解任务状态`,
         ``,
@@ -897,6 +1465,125 @@ async function handleGetVideoAnalysisStatus(apiBaseUrl, token, args) {
         },
     };
 }
+function creativeToolResult(output, lines) {
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        structuredContent: output,
+    };
+}
+async function handleCreateMotionVideoRemakeTask(apiBaseUrl, token, args) {
+    if (!args ||
+        typeof args.sourceImage !== "string" ||
+        typeof args.referenceVideo !== "string") {
+        throw new McpToolError("sourceImage 和 referenceVideo 不能为空。", "MISSING_PARAMETERS");
+    }
+    const sourceImage = await processFileInput(args.sourceImage, "image", 5 * 1024 * 1024);
+    const referenceVideo = await processFileInput(args.referenceVideo, "video", 100 * 1024 * 1024);
+    const response = await callRestApi(apiBaseUrl, "/mcp/motion-remake/create", {
+        token,
+        sourceImage: sourceImage.data,
+        referenceVideo: referenceVideo.data,
+        mode: args.mode,
+        quality: args.quality,
+        count: args.count,
+        referenceVideoDurationSeconds: args.referenceVideoDurationSeconds,
+        dryRun: args.dryRun === true,
+    }, "POST");
+    const lines = response.dryRun
+        ? [
+            "# 爆款视频复刻预检通过",
+            response.estimateSource === "duration_hint"
+                ? `- 时长提示: ${response.durationHintSeconds} 秒（正式创建将使用 OSS 真实检测值）`
+                : "- 时长提示: 未提供，正式创建后由 OSS 检测",
+            response.estimatedCredits === null ||
+                response.estimatedCredits === undefined
+                ? "- 预计积分: 暂不可用"
+                : `- 预计积分: ${response.estimatedCredits}`,
+            `- 当前余额: ${response.remainingCredits}`,
+            "- 未上传 OSS、未创建任务、未扣费",
+        ]
+        : [
+            "# 爆款视频复刻任务已创建",
+            `- 任务 ID: ${response.taskId}`,
+            `- 模式: ${response.mode}`,
+            `- 质量: ${response.quality}`,
+            `- 数量: ${response.count}`,
+            `- 已扣积分: ${response.creditsDeducted}`,
+            `- ${response.statusHint}`,
+        ];
+    return creativeToolResult(response, lines);
+}
+async function handleGetMotionVideoRemakeStatus(apiBaseUrl, token, args) {
+    if (!Number.isInteger(args?.taskId)) {
+        throw new McpToolError("taskId 必须是整数。", "BAD_REQUEST");
+    }
+    const response = await callRestApi(apiBaseUrl, `/mcp/motion-remake/status/${args.taskId}`, { token }, "GET");
+    const completed = Array.isArray(response.results)
+        ? response.results.filter((item) => item.status === "completed").length
+        : 0;
+    return creativeToolResult(response, [
+        "# 爆款视频复刻任务状态",
+        `- 任务 ID: ${response.taskId}`,
+        `- 状态: ${response.status}`,
+        `- 进度: ${response.progress}%`,
+        `- 已完成: ${completed}/${response.count}`,
+        ...(response.status === "completed"
+            ? ["- 视频链接已返回在 results 中"]
+            : []),
+    ]);
+}
+async function handleCreateEcommerceStoryboardTask(apiBaseUrl, token, args) {
+    if (!args ||
+        typeof args.productName !== "string" ||
+        typeof args.productDescription !== "string") {
+        throw new McpToolError("productName 和 productDescription 不能为空。", "MISSING_PARAMETERS");
+    }
+    const productImage = args.productImage
+        ? (await processFileInput(args.productImage, "image", 5 * 1024 * 1024)).data
+        : undefined;
+    const response = await callRestApi(apiBaseUrl, "/mcp/storyboard/create", {
+        token,
+        productName: args.productName,
+        productDescription: args.productDescription,
+        targetAudience: args.targetAudience,
+        videoStyle: args.videoStyle,
+        productImage,
+        targetDuration: args.targetDuration,
+        language: args.language,
+        orientation: args.orientation,
+        dryRun: args.dryRun === true,
+    }, "POST");
+    const lines = response.dryRun
+        ? [
+            "# 电商视频分镜预检通过",
+            `- 预计积分: ${response.estimatedCredits}`,
+            `- 当前余额: ${response.remainingCredits}`,
+            "- 未上传商品图、未创建任务、未扣费",
+        ]
+        : [
+            "# 电商视频分镜任务已创建",
+            `- 任务 ID: ${response.taskId}`,
+            `- 已扣积分: ${response.creditsDeducted}`,
+            `- ${response.statusHint}`,
+        ];
+    return creativeToolResult(response, lines);
+}
+async function handleGetEcommerceStoryboardStatus(apiBaseUrl, token, args) {
+    if (!Number.isInteger(args?.taskId)) {
+        throw new McpToolError("taskId 必须是整数。", "BAD_REQUEST");
+    }
+    const response = await callRestApi(apiBaseUrl, `/mcp/storyboard/status/${args.taskId}`, { token }, "GET");
+    return creativeToolResult(response, [
+        "# 电商视频分镜任务状态",
+        `- 任务 ID: ${response.taskId}`,
+        `- 状态: ${response.status}`,
+        `- 进度: ${response.progress}%`,
+        `- 分镜数量: ${Array.isArray(response.scenes) ? response.scenes.length : 0}`,
+        ...(response.status === "completed"
+            ? ["- 完整剧情和逐镜 Prompt/插图已返回在 structuredContent 中"]
+            : []),
+    ]);
+}
 /**
  * Call REST API
  *
@@ -908,7 +1595,9 @@ async function handleGetVideoAnalysisStatus(apiBaseUrl, token, args) {
  */
 async function callRestApi(apiBaseUrl, path, params, method = "GET") {
     // Build URL
-    const baseUrl = apiBaseUrl.endsWith("/") ? apiBaseUrl.slice(0, -1) : apiBaseUrl;
+    const baseUrl = apiBaseUrl.endsWith("/")
+        ? apiBaseUrl.slice(0, -1)
+        : apiBaseUrl;
     const fullPath = path.startsWith("/") ? path : "/" + path;
     let fullUrl = `${baseUrl}${fullPath}`;
     // For GET requests, add params as query string