Upload 21 files

LTX2.3-1.0.4/API issues-API问题办法.txt

@@ -0,0 +1,50 @@
+1. 复制LTX桌面版的快捷方式到LTX_Shortcut
+
+2. 运行run.bat
+----
+1. Copy the LTX desktop shortcut to LTX_Shortcut
+
+2. Run run.bat
+----
+
+
+
+【问题描述 / Problem】
+系统强制使用 FAL API 生成图片，即使本地有 GPU 可用。
+System forces FAL API generation even when local GPU is available.
+
+【原因 / Cause】
+LTX 强制要求 GPU 有 31GB VRAM 才会使用本地显卡，低于此值会强制走 API 模式。
+LTX requires 31GB VRAM to use local GPU. Below this, it forces API mode.
+
+================================================================================
+【修复方法 / Fix Method】
+================================================================================
+
+运行: API issues.bat.bat (以管理员身份)
+Run: API issues.bat.bat (as Administrator)
+
+================================================================================
+================================================================================
+
+【或者手动 / Or Manual】
+
+1. 修改 VRAM 阈值 / Modify VRAM Threshold
+   文件路径 / File: C:\Program Files\LTX Desktop\resources\backend\runtime_config\runtime_policy.py
+   第16行 / Line 16:
+   原 / Original: return vram_gb < 31
+   改为 / Change:  return vram_gb < 6
+
+2. 清空 API Key / Clear API Key
+   文件路径 / File: C:\Users\<用户名>\AppData\Local\LTXDesktop\settings.json
+   原 / Original: "fal_api_key": "xxxxx"
+   改为 / Change:  "fal_api_key": ""
+
+【说明 / Note】
+- VRAM 阈值改为 6GB，意味着 6GB 及以上显存都会使用本地显卡
+- VRAM threshold set to 6GB means 6GB+ VRAM will use local GPU
+- 清空 fal_api_key 避免系统误判为已配置 API
+- Clear fal_api_key to avoid system thinking API is configured
+- 修改后重启程序即可生效
+- Restart LTX Desktop after changes
+================================================================================

LTX2.3-1.0.4/UI/i18n.js

@@ -0,0 +1,438 @@
+/**
+ * LTX UI i18n — 与根目录「中英文.html」思路类似，但独立脚本、避免坏 DOM/错误路径。
+ * 仅维护文案映射；动态节点由 index.js 在语言切换后刷新。
+ */
+(function (global) {
+    const STORAGE_KEY = 'ltx_ui_lang';
+
+    const STR = {
+        zh: {
+            tabVideo: '视频生成',
+            tabBatch: '智能多帧',
+            tabUpscale: '视频增强',
+            tabImage: '图像生成',
+            promptLabel: '视觉描述词 (Prompt)',
+            promptPlaceholder: '在此输入视觉描述词 (Prompt)...',
+            promptPlaceholderUpscale: '输入画面增强引导词 (可选)...',
+            clearVram: '释放显存',
+            clearingVram: '清理中...',
+            settingsTitle: '系统高级设置',
+            langToggleAriaZh: '切换为 English',
+            langToggleAriaEn: 'Switch to 中文',
+            sysScanning: '正在扫描 GPU...',
+            sysBusy: '运算中...',
+            sysOnline: '在线 / 就绪',
+            sysStarting: '启动中...',
+            sysOffline: '未检测到后端 (Port 3000)',
+            advancedSettings: '高级设置',
+            deviceSelect: '工作设备选择',
+            gpuDetecting: '正在检测 GPU...',
+            outputPath: '输出与上传存储路径',
+            outputPathPh: '例如: D:\\LTX_outputs',
+            savePath: '保存路径',
+            outputPathHint:
+                '系统默认会在 C 盘保留输出文件。请输入新路径后点击保存按钮。',
+            lowVram: '低显存优化',
+            lowVramDesc:
+                '尽量关闭 fast 超分、在加载管线后尝试 CPU 分层卸载（仅当引擎提供 Diffusers 式 API 才可能生效）。每次生成结束会卸载管线。说明：整模型常驻 GPU 时占用仍可能接近满配（例如约 24GB），要明显降占用需更短时长/更低分辨率或 FP8 等小权重。',
+            vramLimitLabel: '可用最高显存上限 (GB, 0为全开优先显存)',
+            vramLimitPh: '例如: 12 (0表示无限制)',
+            saveLabel: '保存',
+            modelLoraSettings: '模型与LoRA设置',
+            modelFolder: '模型文件夹',
+            modelFolderPh: '例如: F:\\LTX2.3\\models',
+            loraFolder: 'LoRA文件夹',
+            loraFolderPh: '例如: F:\\LTX2.3\\loras',
+            loraFolderPath: 'LoRA 文件夹路径',
+            loraFolderPathPlaceholder: '留空使用默认路径',
+            saveScan: '保存并扫描',
+            loraPlacementHintWithDir:
+                '将 LoRA 文件放到默认模型目录: <code>{dir}</code>\\loras',
+            basicEngine: '基础画面 / Basic EngineSpecs',
+            qualityLevel: '清晰度级别',
+            aspectRatio: '画幅比例',
+            ratio169: '16:9 电影宽幅',
+            ratio916: '9:16 移动竖屏',
+            resPreviewPrefix: '最终发送规格',
+            fpsLabel: '帧率 (FPS)',
+            durationLabel: '时长 (秒)',
+            cameraMotion: '镜头运动方式',
+            motionStatic: 'Static (静止机位)',
+            motionDollyIn: 'Dolly In (推近)',
+            motionDollyOut: 'Dolly Out (拉远)',
+            motionDollyLeft: 'Dolly Left (向左)',
+            motionDollyRight: 'Dolly Right (向右)',
+            motionJibUp: 'Jib Up (升臂)',
+            motionJibDown: 'Jib Down (降臂)',
+            motionFocus: 'Focus Shift (焦点)',
+            audioGen: '生成 AI 环境音 (Audio Gen)',
+            selectModel: '选择模型',
+            selectLora: '选择 LoRA',
+            defaultModel: '使用默认模型',
+            noLora: '不使用 LoRA',
+            loraStrength: 'LoRA 强度',
+            genSource: '生成媒介 / Generation Source',
+            startFrame: '起始帧 (首帧)',
+            endFrame: '结束帧 (尾帧)',
+            uploadStart: '上传首帧',
+            uploadEnd: '上传尾帧 (可选)',
+            refAudio: '参考音频 (A2V)',
+            uploadAudio: '点击上传音频',
+            sourceHint:
+                '💡 若仅上传首帧 = 图生视频/音视频；若同时上传首尾帧 = 首尾插帧。',
+            imgPreset: '预设分辨率 (Presets)',
+            imgOptSquare: '1:1 Square (1024x1024)',
+            imgOptLand: '16:9 Landscape (1280x720)',
+            imgOptPort: '9:16 Portrait (720x1280)',
+            imgOptCustom: 'Custom 自定义...',
+            width: '宽度',
+            height: '高度',
+            samplingSteps: '采样步数 (Steps)',
+            upscaleSource: '待超分视频 (Source)',
+            upscaleUpload: '拖入低分辨率视频片段',
+            targetRes: '目标分辨率',
+            upscale1080: '1080P Full HD (2x)',
+            upscale720: '720P HD',
+            smartMultiFrameGroup: '智能多帧',
+            workflowModeLabel: '工作流模式（点击切换）',
+            wfSingle: '单次多关键帧',
+            wfSegments: '分段拼接',
+            uploadImages: '上传图片',
+            uploadMulti1: '点击或拖入多张图片',
+            uploadMulti2: '支持一次选多张，可多次添加',
+            batchStripTitle: '已选图片 · 顺序 = 播放先后',
+            batchStripHint: '在缩略图上按住拖动排序；松手落入虚线框位置',
+            batchFfmpegHint:
+                '💡 <strong>分段模式</strong>：2 张 = 1 段；3 张 = 2 段再拼接。<strong>单次模式</strong>：几张图就几个 latent 锚点，一条视频出片。<br>多段需 <code style="font-size:9px;">ffmpeg</code>：装好后加 PATH，或设环境变量 <code style="font-size:9px;">LTX_FFMPEG_PATH</code>，或在 <code style="font-size:9px;">%LOCALAPPDATA%\\LTXDesktop\\ffmpeg_path.txt</code> 第一行写 ffmpeg.exe 完整路径。',
+            globalPromptLabel: '本页全局补充词（可选）',
+            globalPromptPh: '与顶部主 Prompt 叠加；单次模式与分段模式均可用',
+            bgmLabel: '成片配乐（可选，统一音轨）',
+            bgmUploadHint: '上传一条完整 BGM（生成完成后会替换整段成片的音轨）',
+            mainRender: '开始渲染',
+            waitingTask: '等待分配渲染任务...',
+            libHistory: '历史资产 / ASSETS',
+            libLog: '系统日志 / LOGS',
+            refresh: '刷新',
+            logReady: '> LTX-2 Studio Ready. Expecting commands...',
+            resizeHandleTitle: '拖动调整面板高度',
+            batchNeedTwo: '💡 请上传至少2张图片',
+            batchSegTitle: '视频片段设置（分段拼接）',
+            batchSegClip: '片段',
+            batchSegDuration: '时长',
+            batchSegSec: '秒',
+            batchSegPrompt: '片段提示词',
+            batchSegPromptPh: '此片段的提示词，如：跳舞、吃饭...',
+            batchKfPanelTitle: '单次多关键帧 · 时间轴',
+            batchTotalDur: '总时长',
+            batchTotalSec: '秒',
+            batchPanelHint:
+                '用「间隔」连接相邻关键帧：第 1 张固定在 0 s，最后一张在<strong>各间隔之和</strong>的终点。顶部总时长与每张的锚点时刻会随间隔即时刷新。因后端按<strong>整数秒</strong>建序列，实际请求里的整段时长为合计秒数<strong>向上取整</strong>（至少 2），略长于小数合计时属正常。镜头与 FPS 仍用左侧「视频生成」。',
+            batchKfTitle: '关键帧',
+            batchStrength: '引导强度',
+            batchGapTitle: '间隔',
+            batchSec: '秒',
+            batchAnchorStart: '片头',
+            batchAnchorEnd: '片尾',
+            batchThumbDrag: '按住拖动排序',
+            batchThumbRemove: '删除',
+            batchAddMore: '＋ 继续添加',
+            batchGapInputTitle: '上一关键帧到下一关键帧的时长（秒）；总时长 = 各间隔之和',
+            batchStrengthTitle: '与 Comfy guide strength 类似，中间帧可调低（如 0.2）减轻闪烁',
+            batchTotalPillTitle: '等于下方各「间隔」之和，无需单独填写',
+            defaultPath: '默认路径',
+            phase_loading_model: '加载权重',
+            phase_encoding_text: 'T5 编码',
+            phase_validating_request: '校验请求',
+            phase_uploading_audio: '上传音频',
+            phase_uploading_image: '上传图像',
+            phase_inference: 'AI 推理',
+            phase_downloading_output: '下载结果',
+            phase_complete: '完成',
+            gpuBusyPrefix: 'GPU 运算中',
+            progressStepUnit: '步',
+            loaderGpuAlloc: 'GPU 正在分配资源...',
+            warnGenerating: '⚠️ 当前正在生成中，请等待完成',
+            warnBatchPrompt: '⚠️ 智能多帧请至少填写：顶部主提示词、本页全局补充词或某一「片段提示词」',
+            warnNeedPrompt: '⚠️ 请输入提示词后再开始渲染',
+            warnVideoLong: '⚠️ 时长设定为 {n}s 极长，可能导致显存溢出或耗时较久。',
+            errUpscaleNoVideo: '请先上传待超分的视频',
+            errBatchMinImages: '请上传至少2张图片',
+            errSingleKfPrompt: '单次多关键帧请至少填写顶部主提示词或本页全局补充词',
+            loraNoneLabel: '无',
+            modelDefaultLabel: '默认',
+        },
+        en: {
+            tabVideo: 'Video',
+            tabBatch: 'Multi-frame',
+            tabUpscale: 'Upscale',
+            tabImage: 'Image',
+            promptLabel: 'Prompt',
+            promptPlaceholder: 'Describe the scene...',
+            promptPlaceholderUpscale: 'Optional guidance for enhancement...',
+            clearVram: 'Clear VRAM',
+            clearingVram: 'Clearing...',
+            settingsTitle: 'Advanced settings',
+            langToggleAriaZh: 'Switch to English',
+            langToggleAriaEn: 'Switch to Chinese',
+            sysScanning: 'Scanning GPU...',
+            sysBusy: 'Busy...',
+            sysOnline: 'Online / Ready',
+            sysStarting: 'Starting...',
+            sysOffline: 'Backend offline (port 3000)',
+            advancedSettings: 'Advanced',
+            deviceSelect: 'GPU device',
+            gpuDetecting: 'Detecting GPU...',
+            outputPath: 'Output & upload folder',
+            outputPathPh: 'e.g. D:\\LTX_outputs',
+            savePath: 'Save path',
+            outputPathHint:
+                'Outputs default to C: drive. Enter a folder and click Save.',
+            lowVram: 'Low-VRAM mode',
+            lowVramDesc:
+                'Tries to reduce VRAM (engine-dependent). Shorter duration / lower resolution helps more.',
+            vramLimitLabel: 'Max VRAM Limit (GB, 0 for unlimited)',
+            vramLimitPh: 'e.g. 12 (0 for unlimited)',
+            saveLabel: 'Save',
+            modelLoraSettings: 'Model & LoRA folders',
+            modelFolder: 'Models folder',
+            modelFolderPh: 'e.g. F:\\LTX2.3\\models',
+            loraFolder: 'LoRAs folder',
+            loraFolderPh: 'e.g. F:\\LTX2.3\\loras',
+            loraFolderPath: 'LoRA folder path',
+            loraFolderPathPlaceholder: 'Leave empty for default path',
+            saveScan: 'Save & scan',
+            loraHint: 'Put .safetensors / .ckpt LoRAs here, then refresh lists.',
+            basicEngine: 'Basic / Engine',
+            qualityLevel: 'Quality',
+            aspectRatio: 'Aspect ratio',
+            ratio169: '16:9 widescreen',
+            ratio916: '9:16 portrait',
+            resPreviewPrefix: 'Output',
+            fpsLabel: 'FPS',
+            durationLabel: 'Duration (s)',
+            cameraMotion: 'Camera motion',
+            motionStatic: 'Static',
+            motionDollyIn: 'Dolly in',
+            motionDollyOut: 'Dolly out',
+            motionDollyLeft: 'Dolly left',
+            motionDollyRight: 'Dolly right',
+            motionJibUp: 'Jib up',
+            motionJibDown: 'Jib down',
+            motionFocus: 'Focus shift',
+            audioGen: 'AI ambient audio',
+            selectModel: 'Model',
+            selectLora: 'LoRA',
+            defaultModel: 'Default model',
+            noLora: 'No LoRA',
+            loraStrength: 'LoRA strength',
+            genSource: 'Source media',
+            startFrame: 'Start frame',
+            endFrame: 'End frame (optional)',
+            uploadStart: 'Upload start',
+            uploadEnd: 'Upload end (opt.)',
+            refAudio: 'Reference audio (A2V)',
+            uploadAudio: 'Upload audio',
+            sourceHint:
+                '💡 Start only = I2V / A2V; start + end = interpolation.',
+            imgPreset: 'Resolution presets',
+            imgOptSquare: '1:1 (1024×1024)',
+            imgOptLand: '16:9 (1280×720)',
+            imgOptPort: '9:16 (720×1280)',
+            imgOptCustom: 'Custom...',
+            width: 'Width',
+            height: 'Height',
+            samplingSteps: 'Steps',
+            upscaleSource: 'Source video',
+            upscaleUpload: 'Drop low-res video',
+            targetRes: 'Target resolution',
+            upscale1080: '1080p Full HD (2×)',
+            upscale720: '720p HD',
+            smartMultiFrameGroup: 'Smart multi-frame',
+            workflowModeLabel: 'Workflow',
+            wfSingle: 'Single pass',
+            wfSegments: 'Segments',
+            uploadImages: 'Upload images',
+            uploadMulti1: 'Click or drop multiple images',
+            uploadMulti2: 'Multi-select OK; add more anytime.',
+            batchStripTitle: 'Order = playback',
+            batchStripHint: 'Drag thumbnails to reorder.',
+            batchFfmpegHint:
+                '💡 <strong>Segments</strong>: 2 images → 1 clip; 3 → 2 clips stitched. <strong>Single</strong>: N images → N latent anchors, one video.<br>Stitching needs <code style="font-size:9px;">ffmpeg</code> on PATH, or <code style="font-size:9px;">LTX_FFMPEG_PATH</code>, or <code style="font-size:9px;">%LOCALAPPDATA%\\LTXDesktop\\ffmpeg_path.txt</code> with full path to ffmpeg.exe.',
+            globalPromptLabel: 'Extra prompt (optional)',
+            globalPromptPh: 'Appended to main prompt for both modes.',
+            bgmLabel: 'Full-length BGM (optional)',
+            bgmUploadHint: 'Replaces final mix audio after generation.',
+            mainRender: 'Render',
+            waitingTask: 'Waiting for task...',
+            libHistory: 'Assets',
+            libLog: 'Logs',
+            refresh: 'Refresh',
+            logReady: '> LTX-2 Studio ready.',
+            resizeHandleTitle: 'Drag to resize panel',
+            batchNeedTwo: '💡 Upload at least 2 images',
+            batchSegTitle: 'Segment settings',
+            batchSegClip: 'Clip',
+            batchSegDuration: 'Duration',
+            batchSegSec: 's',
+            batchSegPrompt: 'Prompt',
+            batchSegPromptPh: 'e.g. dancing, walking...',
+            batchKfPanelTitle: 'Single pass · timeline',
+            batchTotalDur: 'Total',
+            batchTotalSec: 's',
+            batchPanelHint:
+                'Use gaps between keyframes: first at 0s, last at the sum of gaps. Totals update live. Backend uses whole seconds (ceil, min 2). Motion & FPS use the Video panel.',
+            batchKfTitle: 'Keyframe',
+            batchStrength: 'Strength',
+            batchGapTitle: 'Gap',
+            batchSec: 's',
+            batchAnchorStart: 'start',
+            batchAnchorEnd: 'end',
+            batchThumbDrag: 'Drag to reorder',
+            batchThumbRemove: 'Remove',
+            batchAddMore: '+ Add more',
+            batchGapInputTitle: 'Seconds between keyframes; total = sum of gaps',
+            batchStrengthTitle: 'Guide strength (lower on middle keys may reduce flicker)',
+            batchTotalPillTitle: 'Equals the sum of gaps below',
+            defaultPath: 'default',
+            phase_loading_model: 'Loading weights',
+            phase_encoding_text: 'T5 encode',
+            phase_validating_request: 'Validating',
+            phase_uploading_audio: 'Uploading audio',
+            phase_uploading_image: 'Uploading image',
+            phase_inference: 'Inference',
+            phase_downloading_output: 'Downloading',
+            phase_complete: 'Done',
+            gpuBusyPrefix: 'GPU',
+            progressStepUnit: 'steps',
+            loaderGpuAlloc: 'Allocating GPU...',
+            warnGenerating: '⚠️ Already generating, please wait.',
+            warnBatchPrompt: '⚠️ Enter main prompt, page extra prompt, or a segment prompt.',
+            warnNeedPrompt: '⚠️ Enter a prompt first.',
+            warnVideoLong: '⚠️ Duration {n}s is very long; may OOM or take a long time.',
+            errUpscaleNoVideo: 'Upload a video to upscale first.',
+            errBatchMinImages: 'Upload at least 2 images.',
+            errSingleKfNeedPrompt: 'Enter main or page extra prompt for single-pass keyframes.',
+            loraNoneLabel: 'none',
+            modelDefaultLabel: 'default',
+            loraPlacementHintWithDir:
+                'Place LoRAs into the default models directory: <code>{dir}</code>\\loras',
+        },
+    };
+
+    function getLang() {
+        return localStorage.getItem(STORAGE_KEY) === 'en' ? 'en' : 'zh';
+    }
+
+    function setLang(lang) {
+        const L = lang === 'en' ? 'en' : 'zh';
+        localStorage.setItem(STORAGE_KEY, L);
+        document.documentElement.lang = L === 'en' ? 'en' : 'zh-CN';
+        try {
+            applyI18n();
+        } catch (err) {
+            console.error('[i18n] applyI18n failed:', err);
+        }
+        updateLangButton();
+        if (typeof global.onUiLanguageChanged === 'function') {
+            try {
+                global.onUiLanguageChanged();
+            } catch (e) {
+                console.warn('onUiLanguageChanged', e);
+            }
+        }
+    }
+
+    function t(key) {
+        const L = getLang();
+        const table = STR[L] || STR.zh;
+        if (Object.prototype.hasOwnProperty.call(table, key)) return table[key];
+        if (Object.prototype.hasOwnProperty.call(STR.zh, key)) return STR.zh[key];
+        return key;
+    }
+
+    function applyI18n(root) {
+        root = root || document;
+        root.querySelectorAll('[data-i18n]').forEach(function (el) {
+            var key = el.getAttribute('data-i18n');
+            if (!key) return;
+            if (el.tagName === 'OPTION') {
+                el.textContent = t(key);
+            } else {
+                el.textContent = t(key);
+            }
+        });
+        root.querySelectorAll('[data-i18n-placeholder]').forEach(function (el) {
+            var key = el.getAttribute('data-i18n-placeholder');
+            if (key) el.placeholder = t(key);
+        });
+        root.querySelectorAll('[data-i18n-title]').forEach(function (el) {
+            var key = el.getAttribute('data-i18n-title');
+            if (key) el.title = t(key);
+        });
+        root.querySelectorAll('[data-i18n-html]').forEach(function (el) {
+            var key = el.getAttribute('data-i18n-html');
+            if (key) el.innerHTML = t(key);
+        });
+        root.querySelectorAll('[data-i18n-value]').forEach(function (el) {
+            var key = el.getAttribute('data-i18n-value');
+            if (key && (el.tagName === 'INPUT' || el.tagName === 'BUTTON')) {
+                el.value = t(key);
+            }
+        });
+    }
+
+    function updateLangButton() {
+        var btn = document.getElementById('lang-toggle-btn');
+        if (!btn) return;
+        btn.textContent = getLang() === 'zh' ? 'EN' : '中';
+        btn.setAttribute(
+            'aria-label',
+            getLang() === 'zh' ? t('langToggleAriaZh') : t('langToggleAriaEn')
+        );
+        btn.classList.toggle('active', getLang() === 'en');
+    }
+
+    function toggleUiLanguage() {
+        try {
+            setLang(getLang() === 'zh' ? 'en' : 'zh');
+        } catch (err) {
+            console.error('[i18n] toggleUiLanguage failed:', err);
+        }
+    }
+
+    /** 避免 CSP 拦截内联 onclick；确保按钮一定能触发 */
+    function bindLangToggleButton() {
+        var btn = document.getElementById('lang-toggle-btn');
+        if (!btn || btn.dataset.i18nBound === '1') return;
+        btn.dataset.i18nBound = '1';
+        btn.removeAttribute('onclick');
+        btn.addEventListener('click', function (ev) {
+            ev.preventDefault();
+            toggleUiLanguage();
+        });
+    }
+
+    function boot() {
+        document.documentElement.lang = getLang() === 'en' ? 'en' : 'zh-CN';
+        try {
+            applyI18n();
+        } catch (err) {
+            console.error('[i18n] applyI18n failed:', err);
+        }
+        updateLangButton();
+        bindLangToggleButton();
+    }
+
+    global.getUiLang = getLang;
+    global.setUiLang = setLang;
+    global.t = t;
+    global.applyI18n = applyI18n;
+    global.toggleUiLanguage = toggleUiLanguage;
+    global.updateLangToggleButton = updateLangButton;
+
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', boot);
+    } else {
+        boot();
+    }
+})(typeof window !== 'undefined' ? window : global);

LTX2.3-1.0.4/UI/index.css

@@ -0,0 +1,775 @@
+:root {
+            --accent:      #2563EB;     /* Refined blue – not too bright, not purple */
+            --accent-hover:#3B82F6;
+            --accent-dim:  rgba(37,99,235,0.14);
+            --accent-ring: rgba(37,99,235,0.35);
+            --bg:          #111113;
+            --panel:       #18181B;
+            --panel-2:     #1F1F23;
+            --item:        rgba(255,255,255,0.035);
+            --border:      rgba(255,255,255,0.08);
+            --border-2:    rgba(255,255,255,0.05);
+            --text-dim:    #71717A;
+            --text-sub:    #A1A1AA;
+            --text:        #FAFAFA;
+        }
+
+        * { box-sizing: border-box; -webkit-font-smoothing: antialiased; min-width: 0; }
+        body {
+            background: var(--bg); margin: 0; color: var(--text);
+            font-family: -apple-system, "SF Pro Display", "Segoe UI", sans-serif;
+            display: flex; height: 100vh; overflow: hidden;
+            font-size: 13px; line-height: 1.5;
+        }
+
+        .sidebar {
+            width: 460px; min-width: 460px;
+            background: var(--panel);
+            border-right: 1px solid var(--border);
+            display: flex; flex-direction: column; z-index: 20;
+            overflow-y: auto; overflow-x: hidden;
+        }
+
+        /* Scrollbar */
+        ::-webkit-scrollbar { width: 5px; height: 5px; }
+        ::-webkit-scrollbar-track { background: transparent; }
+        ::-webkit-scrollbar-thumb { background: rgba(255,255,255,0.08); border-radius: 10px; }
+        ::-webkit-scrollbar-thumb:hover { background: rgba(255,255,255,0.18); }
+
+        .sidebar-header { padding: 24px 24px 4px; }
+
+        .lang-toggle {
+            background: #333;
+            border: 1px solid #555;
+            color: var(--text-dim);
+            padding: 4px 10px;
+            border-radius: 6px;
+            font-size: 11px;
+            cursor: pointer;
+            transition: background 0.15s, color 0.15s, border-color 0.15s;
+            font-weight: 700;
+            min-width: 44px;
+            flex-shrink: 0;
+        }
+        .lang-toggle:hover {
+            background: var(--item);
+            color: var(--text);
+            border-color: var(--accent);
+        }
+        .lang-toggle.active {
+            background: #333;
+            color: var(--text);
+            border-color: #555;
+        }
+        .sidebar-section { padding: 8px 24px 18px; border-bottom: 1px solid var(--border); }
+
+        .setting-group {
+            background: rgba(255,255,255,0.025);
+            border: 1px solid var(--border-2);
+            border-radius: 10px;
+            padding: 14px;
+            margin-bottom: 12px;
+        }
+        .group-title {
+            font-size: 10px; color: var(--text-dim); font-weight: 700;
+            text-transform: uppercase; letter-spacing: 0.7px;
+            margin-bottom: 12px; padding-bottom: 5px;
+            border-bottom: 1px solid var(--border-2);
+        }
+
+        /* Mode Tabs */
+        .tabs {
+            display: flex; gap: 4px; margin-bottom: 14px;
+            background: rgba(255,255,255,0.04);
+            padding: 4px; border-radius: 10px;
+            border: 1px solid var(--border-2);
+        }
+        .tab {
+            flex: 1; padding: 9px 0; text-align: center; border-radius: 7px;
+            cursor: pointer; font-size: 12px; color: var(--text-dim);
+            transition: all 0.2s; font-weight: 600;
+            display: flex; align-items: center; justify-content: center;
+        }
+        .tab.active { background: var(--accent); color: #fff; box-shadow: 0 1px 6px rgba(10,132,255,0.45); }
+        .tab:hover:not(.active) { background: rgba(255,255,255,0.06); color: var(--text); }
+
+        .label-group { display: flex; justify-content: space-between; align-items: center; margin-bottom: 6px; }
+        label { display: block; font-size: 11px; color: var(--text-dim); font-weight: 600; text-transform: uppercase; letter-spacing: 0.5px; margin-bottom: 6px; }
+        .val-badge { font-size: 11px; color: var(--accent); font-family: "SF Mono", ui-monospace, monospace; font-weight: 600; }
+
+        input[type="text"], input[type="number"], select, textarea {
+            width: 100%; background: var(--panel-2);
+            border: 1px solid var(--border);
+            border-radius: 7px; color: var(--text);
+            padding: 8px 11px; font-size: 12.5px; outline: none; margin-bottom: 9px;
+            /* Only transition border/shadow – NOT background-image to prevent arrow flicker */
+            transition: border-color 0.15s, box-shadow 0.15s;
+        }
+        input:focus, select:focus, textarea:focus {
+            border-color: var(--accent);
+            box-shadow: 0 0 0 2px var(--accent-ring);
+        }
+        select {
+            -webkit-appearance: none; -moz-appearance: none; appearance: none;
+            /* Stable grey arrow – no background shorthand so it won't animate */
+            background-color: var(--panel-2);
+            background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 24 24' fill='none' stroke='%2371717A' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='6 9 12 15 18 9'/%3E%3C/svg%3E");
+            background-repeat: no-repeat;
+            background-position: right 10px center;
+            background-size: 12px;
+            padding-right: 28px;
+            cursor: pointer;
+            /* Explicitly do NOT transition background properties */
+            transition: border-color 0.15s, box-shadow 0.15s;
+        }
+        select:focus { background-color: var(--panel-2); }
+        select option { background: #27272A; color: var(--text); }
+        textarea { resize: vertical; min-height: 78px; font-family: inherit; }
+
+        .slider-container { display: flex; align-items: center; gap: 12px; margin-bottom: 14px; }
+        input[type="range"] { flex: 1; accent-color: var(--accent); height: 4px; cursor: pointer; border-radius: 2px; }
+
+        .upload-zone {
+            border: 1px dashed var(--border); border-radius: 10px;
+            padding: 18px 10px; text-align: center; cursor: pointer;
+            background: rgba(255,255,255,0.03); margin-bottom: 10px; position: relative;
+            transition: all 0.2s;
+        }
+        .upload-zone:hover, .upload-zone.dragover { background: var(--accent-dim); border-color: var(--accent); }
+        .upload-zone.has-images {
+            padding: 12px; background: rgba(255,255,255,0.025);
+        }
+        .upload-zone.has-images .upload-placeholder-mini {
+            display: flex; align-items: center; gap: 8px; justify-content: center;
+            color: var(--text-dim); font-size: 11px;
+        }
+        .upload-zone.has-images .upload-placeholder-mini span {
+            background: var(--item); padding: 6px 12px; border-radius: 6px;
+        }
+        #batch-images-placeholder { display: block; }
+        .upload-zone.has-images #batch-images-placeholder { display: none; }
+
+        /* 批量模式：上传区下方的横向缩略图条 */
+        .batch-thumb-strip-wrap {
+            margin-top: 10px;
+            margin-bottom: 4px;
+        }
+        .batch-thumb-strip-head {
+            display: flex;
+            flex-direction: column;
+            gap: 2px;
+            margin-bottom: 8px;
+        }
+        .batch-thumb-strip-title {
+            font-size: 11px;
+            font-weight: 700;
+            color: var(--text-sub);
+        }
+        .batch-thumb-strip-hint {
+            font-size: 10px;
+            color: var(--text-dim);
+        }
+        .batch-images-container {
+            display: flex;
+            flex-direction: row;
+            flex-wrap: nowrap;
+            gap: 10px;
+            overflow-x: auto;
+            overflow-y: visible;
+            padding: 6px 4px 14px;
+            margin: 0 -4px;
+            scrollbar-width: thin;
+            scrollbar-color: var(--border) transparent;
+            align-items: center;
+        }
+        .batch-images-container::-webkit-scrollbar { height: 6px; }
+        .batch-images-container::-webkit-scrollbar-thumb {
+            background: var(--border);
+            border-radius: 3px;
+        }
+        .batch-image-wrapper {
+            flex: 0 0 72px;
+            width: 72px;
+            height: 72px;
+            position: relative;
+            border-radius: 10px;
+            overflow: hidden;
+            background: var(--item);
+            border: 1px solid var(--border);
+            cursor: grab;
+            touch-action: none;
+            user-select: none;
+            -webkit-user-select: none;
+            transition:
+                flex-basis 0.38s cubic-bezier(0.22, 1, 0.36, 1),
+                width 0.38s cubic-bezier(0.22, 1, 0.36, 1),
+                min-width 0.38s cubic-bezier(0.22, 1, 0.36, 1),
+                margin 0.38s cubic-bezier(0.22, 1, 0.36, 1),
+                opacity 0.25s ease,
+                border-color 0.2s ease,
+                box-shadow 0.2s ease,
+                transform 0.28s cubic-bezier(0.22, 1, 0.36, 1);
+        }
+        .batch-image-wrapper:active { cursor: grabbing; }
+        .batch-image-wrapper.batch-thumb--source {
+            flex: 0 0 0;
+            width: 0;
+            min-width: 0;
+            height: 72px;
+            margin: 0;
+            padding: 0;
+            border: none;
+            overflow: hidden;
+            opacity: 0;
+            background: transparent;
+            box-shadow: none;
+            pointer-events: none;
+            /* 收起必须瞬时：若与占位框同时用 0.38s 过渡，右侧缩略图会与「突然出现」的槽位不同步而闪一下 */
+            transition: none !important;
+        }
+        /* 按下瞬间：冻结其它卡片与槽位动画，避免「槽位插入 + 邻居过渡」两帧打架 */
+        .batch-images-container.is-batch-settling .batch-image-wrapper:not(.batch-thumb--source) {
+            transition: none !important;
+        }
+        .batch-images-container.is-batch-settling .batch-thumb-drop-slot {
+            animation: none;
+            opacity: 1;
+        }
+        /* 拖动时跟手的浮动缩略图（避免原槽位透明后光标下像「黑块」） */
+        .batch-thumb-floating-ghost {
+            position: fixed;
+            left: 0;
+            top: 0;
+            z-index: 99999;
+            width: 76px;
+            height: 76px;
+            border-radius: 12px;
+            overflow: hidden;
+            pointer-events: none;
+            will-change: transform;
+            box-shadow:
+                0 20px 50px rgba(0, 0, 0, 0.45),
+                0 10px 28px rgba(0, 0, 0, 0.28),
+                0 0 0 1px rgba(255, 255, 255, 0.18);
+            transform: translate3d(0, 0, 0) scale(1.06) rotate(-1deg);
+        }
+        .batch-thumb-floating-ghost img {
+            width: 100%;
+            height: 100%;
+            object-fit: cover;
+            display: block;
+            pointer-events: none;
+        }
+        .batch-thumb-drop-slot {
+            flex: 0 0 72px;
+            width: 72px;
+            height: 72px;
+            box-sizing: border-box;
+            border-radius: 12px;
+            border: 2px dashed rgba(255, 255, 255, 0.22);
+            background: linear-gradient(145deg, rgba(255, 255, 255, 0.09), rgba(255, 255, 255, 0.03));
+            pointer-events: none;
+            transition: border-color 0.35s ease, box-shadow 0.35s ease, opacity 0.35s ease;
+            animation: batch-slot-breathe 2.4s ease-in-out infinite;
+            box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.06);
+        }
+        @keyframes batch-slot-breathe {
+            0%, 100% { opacity: 0.88; }
+            50% { opacity: 1; }
+        }
+        .batch-image-wrapper .batch-thumb-img-wrap {
+            width: 100%;
+            height: 100%;
+            border-radius: 9px;
+            overflow: hidden;
+            /* 必须让事件落到外层 .batch-image-wrapper，否则 HTML5 drag 无法从 draggable 父级启动 */
+            pointer-events: none;
+        }
+        .batch-image-wrapper .batch-thumb-img {
+            width: 100%;
+            height: 100%;
+            object-fit: cover;
+            display: block;
+            pointer-events: none;
+            user-select: none;
+            -webkit-user-drag: none;
+        }
+        .batch-thumb-remove {
+            position: absolute;
+            top: 3px;
+            right: 3px;
+            z-index: 5;
+            box-sizing: border-box;
+            min-width: 22px;
+            height: 22px;
+            padding: 0 5px;
+            margin: 0;
+            border: 1px solid rgba(255, 255, 255, 0.12);
+            border-radius: 6px;
+            background: rgba(0, 0, 0, 0.5);
+            font-family: inherit;
+            font-size: 14px;
+            font-weight: 400;
+            line-height: 1;
+            color: rgba(255, 255, 255, 0.9);
+            opacity: 0.72;
+            cursor: pointer;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            transition: background 0.12s, opacity 0.12s, border-color 0.12s;
+            pointer-events: auto;
+        }
+        .batch-image-wrapper:hover .batch-thumb-remove {
+            opacity: 1;
+            background: rgba(0, 0, 0, 0.68);
+            border-color: rgba(255, 255, 255, 0.2);
+        }
+        .batch-thumb-remove:hover {
+            background: rgba(80, 20, 20, 0.75) !important;
+            border-color: rgba(255, 180, 180, 0.35);
+            color: #fff;
+        }
+        .batch-thumb-remove:focus-visible {
+            opacity: 1;
+            outline: 2px solid var(--accent-dim, rgba(120, 160, 255, 0.6));
+            outline-offset: 1px;
+        }
+        .upload-icon { font-size: 18px; margin-bottom: 6px; opacity: 0.45; }
+        .upload-text { font-size: 11px; color: var(--text); }
+        .upload-hint { font-size: 10px; color: var(--text-dim); margin-top: 3px; }
+        .preview-thumb { width: 100%; height: auto; max-height: 100px; object-fit: contain; border-radius: 8px; display: none; margin-top: 10px; }
+        .clear-img-overlay {
+            position: absolute; top: 8px; right: 8px; background: rgba(255,59,48,0.85); color: white;
+            width: 20px; height: 20px; border-radius: 10px; display: none; align-items: center; justify-content: center;
+            font-size: 11px; cursor: pointer; z-index: 5;
+        }
+
+        .btn-outline {
+            background: var(--panel-2);
+            border: 1px solid var(--border);
+            color: var(--text-sub); padding: 5px 12px; border-radius: 7px;
+            font-size: 11.5px; font-weight: 600; cursor: pointer;
+            transition: background 0.15s, border-color 0.15s, color 0.15s;
+            display: inline-flex; align-items: center; justify-content: center; gap: 5px;
+            white-space: nowrap;
+        }
+        .btn-outline:hover:not(:disabled) { background: rgba(255,255,255,0.08); color: var(--text); border-color: rgba(255,255,255,0.18); }
+        .btn-outline:active { opacity: 0.7; }
+        .btn-outline:disabled { opacity: 0.3; cursor: not-allowed; }
+
+        .btn-icon {
+            padding: 5px; background: transparent; border: none; color: var(--text-dim);
+            border-radius: 6px; cursor: pointer; display: flex; align-items: center; justify-content: center;
+            transition: color 0.15s, background 0.15s;
+        }
+        .btn-icon:hover { color: var(--text-sub); background: rgba(255,255,255,0.07); }
+
+        .btn-primary {
+            width: 100%; padding: 13px;
+            background: var(--accent); border: none;
+            border-radius: 9px; color: #fff; font-weight: 700; font-size: 13.5px;
+            letter-spacing: 0.2px; cursor: pointer; margin-top: 14px;
+            transition: background 0.15s;
+        }
+        .btn-primary:hover:not(:disabled) { background: var(--accent-hover); }
+        .btn-primary:active { opacity: 0.82; }
+        .btn-primary:disabled { background: rgba(255,255,255,0.08); color: var(--text-dim); cursor: not-allowed; }
+
+        .btn-danger {
+            width: 100%; padding: 12px; background: #DC2626; border: none;
+            border-radius: 9px; color: #fff; font-weight: 700; font-size: 13.5px;
+            cursor: pointer; margin-top: 8px; display: none; transition: background 0.15s;
+        }
+        .btn-danger:hover { background: #EF4444; }
+
+        /* Workspace */
+        .workspace { flex: 1; display: flex; flex-direction: column; background: #0A0A0A; position: relative; overflow: hidden; }
+        .viewer { flex: 2; display: flex; align-items: center; justify-content: center; padding: 16px; background: #0A0A0A; position: relative; min-height: 40vh; }
+        .monitor {
+            width: 100%; height: 100%; max-width: 1650px; border-radius: 10px; border: 1px solid var(--border);
+            overflow: hidden; position: relative; background: #070707;
+            display: flex; align-items: center; justify-content: center;
+            background-image: radial-gradient(rgba(255,255,255,0.02) 1px, transparent 1px);
+            background-size: 18px 18px;
+        }
+        .monitor img, .monitor video {
+            width: auto; height: auto; max-width: 100%; max-height: 100%;
+            object-fit: contain; display: none; z-index: 2; border-radius: 3px;
+        }
+
+        .progress-container { position: absolute; bottom: 0; left: 0; width: 100%; height: 2px; background: var(--border-2); z-index: 10; }
+        #progress-fill { width: 0%; height: 100%; background: var(--accent); transition: width 0.5s; }
+        #loading-txt { font-size: 12px; color: var(--text-sub); font-weight: 600; z-index: 5; position: absolute; display: none; }
+
+
+
+        .spinner {
+            width: 12px; height: 12px;
+            border: 2px solid rgba(255,255,255,0.2);
+            border-top-color: currentColor;
+            border-radius: 50%;
+            animation: spin 1s linear infinite;
+        }
+        @keyframes spin { to { transform: rotate(360deg); } }
+        
+        .loading-card {
+            display: flex; align-items: center; justify-content: center;
+            flex-direction: column; gap: 6px; color: var(--text-dim); font-size: 10px;
+            background: rgba(37,99,235,0.07) !important;
+            border-color: rgba(37,99,235,0.3) !important;
+        }
+        .loading-card .spinner { width: 28px; height: 28px; border-width: 3px; color: var(--accent); }
+        .loading-card:hover { background: rgba(37,99,235,0.14) !important; border-color: var(--accent) !important; }
+
+        .library { flex: 1.5; border-top: 1px solid var(--border); padding: 14px 20px; display: flex; flex-direction: column; background: #0F0F11; overflow-y: hidden; }
+        #log-container { flex: 1; overflow-y: auto; padding-right: 4px; }
+        #log { font-family: ui-monospace, "SF Mono", monospace; font-size: 10.5px; color: var(--text-dim); line-height: 1.7; }
+
+        /* History wrapper: scrollable area for thumbnails only */
+        #history-wrapper {
+            flex: 1;
+            overflow-y: auto;
+            min-height: 110px;   /* always show at least one row */
+            padding-right: 4px;
+        }
+        #history-container {
+            display: grid;
+            grid-template-columns: repeat(auto-fill, minmax(150px, 1fr));
+            justify-content: start;
+            gap: 10px; align-content: flex-start;
+            padding-bottom: 4px;
+        }
+        /* Pagination row: hidden, using infinite scroll instead */
+        #pagination-bar {
+            display: none;
+        }
+
+        .history-card {
+            width: 100%; max-width: 200px; aspect-ratio: 16 / 9;
+            background: #1A1A1E; border-radius: 7px;
+            overflow: hidden; border: 1px solid var(--border);
+            cursor: pointer; position: relative; transition: border-color 0.15s, transform 0.15s;
+        }
+        .history-card:hover { border-color: var(--accent); transform: translateY(-1px); }
+        .history-card img, .history-card video {
+            width: 100%; height: 100%; object-fit: cover;
+            background: #1A1A1E;
+        }
+        /* 解码/加载完成前避免视频黑块猛闪，与卡片底色一致；就绪后淡入 */
+        .history-card .history-thumb-media {
+            opacity: 0;
+            transition: opacity 0.28s ease;
+        }
+        .history-card .history-thumb-media.history-thumb-ready {
+            opacity: 1;
+        }
+        .history-type-badge {
+            position: absolute; top: 5px; left: 5px; font-size: 8px; padding: 1px 5px; border-radius: 3px;
+            background: rgba(0,0,0,0.8); color: var(--text-sub); border: 1px solid rgba(255,255,255,0.06);
+            z-index: 2; font-weight: 700; letter-spacing: 0.4px;
+        }
+        .history-delete-btn {
+            position: absolute; top: 5px; right: 5px; width: 20px; height: 20px;
+            border-radius: 50%; border: none; background: rgba(255,50,50,0.8); color: #fff;
+            font-size: 10px; cursor: pointer; z-index: 3; display: flex; align-items: center; justify-content: center;
+            opacity: 0; transition: opacity 0.2s;
+        }
+        .history-card:hover .history-delete-btn { opacity: 1; }
+        .history-delete-btn:hover { background: rgba(255,0,0,0.9); }
+
+        .vram-bar { width: 160px; height: 5px; background: rgba(255,255,255,0.08); border-radius: 999px; overflow: hidden; display: inline-block; vertical-align: middle; }
+        .vram-used { height: 100%; background: var(--accent); width: 0%; transition: width 0.5s; }
+
+        /* 智能多帧：工作流模式卡片式单选 */
+        .smart-param-mode-label {
+            font-size: 10px;
+            color: var(--text-dim);
+            font-weight: 700;
+            margin-bottom: 8px;
+            letter-spacing: 0.04em;
+            text-transform: uppercase;
+        }
+        .smart-param-modes {
+            display: flex;
+            flex-direction: row;
+            align-items: stretch;
+            gap: 0;
+            padding: 3px;
+            margin-bottom: 12px;
+            background: var(--panel-2);
+            border-radius: 8px;
+            border: 1px solid var(--border);
+        }
+        .smart-param-mode-opt {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            flex: 1;
+            min-width: 0;
+            gap: 0;
+            margin: 0;
+            padding: 6px 8px;
+            border-radius: 6px;
+            border: none;
+            background: transparent;
+            cursor: pointer;
+            transition: background 0.15s, color 0.15s;
+            position: relative;
+        }
+        .smart-param-mode-opt:hover:not(:has(input:checked)) {
+            background: rgba(255, 255, 255, 0.05);
+        }
+        .smart-param-mode-opt input[type="radio"] {
+            position: absolute;
+            opacity: 0;
+            width: 0;
+            height: 0;
+            margin: 0;
+        }
+        .smart-param-mode-opt:has(input:checked) {
+            background: var(--accent);
+            box-shadow: none;
+        }
+        .smart-param-mode-opt:has(input:checked) .smart-param-mode-title {
+            color: #fff;
+        }
+        .smart-param-mode-title {
+            font-size: 11px;
+            font-weight: 600;
+            color: var(--text-sub);
+            text-align: center;
+            line-height: 1.25;
+            flex: none;
+            min-width: 0;
+        }
+        /* 单次多关键帧：时间轴面板 */
+        .batch-kf-panel {
+            background: var(--item);
+            border-radius: 10px;
+            padding: 12px 14px;
+            margin-bottom: 10px;
+            border: 1px solid var(--border);
+        }
+        .batch-kf-panel-hd {
+            display: flex;
+            flex-wrap: wrap;
+            align-items: center;
+            justify-content: space-between;
+            gap: 10px;
+            margin-bottom: 8px;
+        }
+        .batch-kf-panel-title {
+            font-size: 12px;
+            font-weight: 700;
+            color: var(--text);
+        }
+        .batch-kf-total-pill {
+            font-size: 11px;
+            color: var(--text-sub);
+            background: var(--panel-2);
+            border: 1px solid var(--border);
+            border-radius: 999px;
+            padding: 6px 12px;
+            white-space: nowrap;
+        }
+        .batch-kf-total-pill strong {
+            color: var(--accent);
+            font-weight: 800;
+            font-variant-numeric: tabular-nums;
+            margin: 0 2px;
+        }
+        .batch-kf-total-unit {
+            font-size: 10px;
+            color: var(--text-dim);
+        }
+        .batch-kf-panel-hint {
+            font-size: 10px;
+            color: var(--text-dim);
+            line-height: 1.5;
+            margin: 0 0 12px;
+        }
+        .batch-kf-timeline-col {
+            display: flex;
+            flex-direction: column;
+            gap: 0;
+        }
+        .batch-kf-kcard {
+            border-radius: 10px;
+            border: 1px solid var(--border);
+            background: rgba(255, 255, 255, 0.03);
+            padding: 10px 12px;
+        }
+        .batch-kf-kcard-head {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            margin-bottom: 10px;
+        }
+        .batch-kf-kthumb {
+            width: 48px;
+            height: 48px;
+            border-radius: 8px;
+            object-fit: cover;
+            flex-shrink: 0;
+            border: 1px solid var(--border);
+        }
+        .batch-kf-kcard-titles {
+            display: flex;
+            flex-direction: column;
+            gap: 4px;
+            min-width: 0;
+        }
+        .batch-kf-ktitle {
+            font-size: 12px;
+            font-weight: 700;
+            color: var(--text);
+        }
+        .batch-kf-anchor {
+            font-size: 11px;
+            color: var(--accent);
+            font-variant-numeric: tabular-nums;
+            font-weight: 600;
+        }
+        .batch-kf-kcard-ctrl {
+            display: flex;
+            flex-wrap: wrap;
+            align-items: center;
+            gap: 12px;
+        }
+        .batch-kf-klabel {
+            font-size: 10px;
+            color: var(--text-dim);
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+        .batch-kf-klabel input[type="number"] {
+            width: 72px;
+            padding: 6px 8px;
+            font-size: 12px;
+            border-radius: 6px;
+            border: 1px solid var(--border);
+            background: var(--panel);
+            color: var(--text);
+        }
+        /* 关键帧之间：细时间轴 + 单行紧凑间隔输入 */
+        .batch-kf-gap {
+            display: flex;
+            align-items: stretch;
+            gap: 8px;
+            padding: 0 0 6px;
+            margin: 0 0 0 10px;
+        }
+        .batch-kf-gap-rail {
+            width: 2px;
+            flex-shrink: 0;
+            border-radius: 2px;
+            background: linear-gradient(
+                180deg,
+                rgba(255, 255, 255, 0.06),
+                var(--accent-dim),
+                rgba(255, 255, 255, 0.04)
+            );
+            min-height: 22px;
+            align-self: stretch;
+        }
+        .batch-kf-gap-inner {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+            flex: 1;
+            min-width: 0;
+            padding: 2px 0 4px;
+        }
+        .batch-kf-gap-ix {
+            font-size: 10px;
+            font-weight: 600;
+            color: var(--text-dim);
+            font-variant-numeric: tabular-nums;
+            letter-spacing: -0.02em;
+            flex-shrink: 0;
+        }
+        .batch-kf-seg-field {
+            display: inline-flex;
+            align-items: center;
+            gap: 3px;
+            margin: 0;
+            cursor: text;
+        }
+        .batch-kf-seg-input {
+            width: 46px;
+            min-width: 0;
+            padding: 2px 5px;
+            font-size: 11px;
+            font-weight: 600;
+            line-height: 1.3;
+            border-radius: 4px;
+            border: 1px solid var(--border);
+            background: rgba(0, 0, 0, 0.2);
+            color: var(--text);
+            font-variant-numeric: tabular-nums;
+        }
+        .batch-kf-seg-input:hover {
+            border-color: rgba(255, 255, 255, 0.12);
+        }
+        .batch-kf-seg-input:focus {
+            outline: none;
+            border-color: var(--accent);
+            box-shadow: 0 0 0 1px var(--accent-ring);
+        }
+        .batch-kf-gap-unit {
+            font-size: 10px;
+            color: var(--text-dim);
+            font-weight: 500;
+            flex-shrink: 0;
+        }
+
+        .sub-mode-toggle { display: flex; background: var(--panel-2); border-radius: 7px; padding: 3px; border: 1px solid var(--border); }
+        .sub-mode-btn { flex: 1; padding: 6px 0; border-radius: 5px; border: none; background: transparent; font-size: 11.5px; color: var(--text-dim); font-weight: 600; cursor: pointer; transition: background 0.15s, color 0.15s; }
+        .sub-mode-btn.active { background: var(--accent); color: #fff; }
+        .sub-mode-btn:hover:not(.active) { background: rgba(255,255,255,0.05); color: var(--text-sub); }
+
+        .vid-section { display: none; margin-top: 12px; }
+        .vid-section.active-section { display: block; animation: fadeIn 0.25s ease; }
+        @keyframes fadeIn { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: translateY(0); } }
+
+        /* Status indicator */
+        @keyframes breathe-orange {
+            0%,100% { box-shadow: 0 0 4px #FF9F0A; opacity: 0.7; }
+            50%      { box-shadow: 0 0 10px #FF9F0A; opacity: 1; }
+        }
+        .indicator-busy    { background: #FF9F0A !important; animation: breathe-orange 1.6s infinite ease-in-out !important; box-shadow: none !important; transition: all 0.3s; }
+        .indicator-ready   { background: #30D158 !important; box-shadow: 0 0 8px rgba(48,209,88,0.6) !important; animation: none !important; transition: all 0.3s; }
+        .indicator-offline { background: #636366 !important; box-shadow: none !important; animation: none !important; transition: all 0.3s; }
+
+        .res-preview-tag { font-size: 11px; color: var(--accent); margin-bottom: 10px; font-family: ui-monospace, monospace; }
+        .top-status { display: flex; justify-content: space-between; font-size: 12px; color: var(--text-dim); margin-bottom: 8px; align-items: center; }
+        .checkbox-container { display: flex; align-items: center; gap: 8px; cursor: pointer; background: rgba(255,255,255,0.02); padding: 10px; border-radius: 8px; border: 1px solid var(--border-2); }
+        .checkbox-container input { width: 15px; height: 15px; accent-color: var(--accent); cursor: pointer; margin: 0; }
+        .checkbox-container label { margin-bottom: 0; cursor: pointer; text-transform: none; color: var(--text); }
+        .flex-row { display: flex; gap: 10px; }
+        .flex-1 { flex: 1; min-width: 0; }
+
+        @media (max-width: 1024px) {
+            body { flex-direction: column; overflow-y: auto; }
+            .sidebar { width: 100%; min-width: 100%; border-right: none; border-bottom: 1px solid var(--border); height: auto; overflow: visible; }
+            .workspace { height: auto; min-height: 100vh; overflow: visible; }
+        }
+:root {
+    --plyr-color-main: #3F51B5;
+    --plyr-video-control-background-hover: rgba(255,255,255,0.1);
+    --plyr-control-radius: 6px;
+    --plyr-player-width: 100%;
+}
+.plyr {
+    border-radius: 8px;
+    overflow: hidden;
+    width: 100%;
+    height: 100%;
+}
+.plyr--video .plyr__controls {
+    background: linear-gradient(rgba(0,0,0,0), rgba(0,0,0,0.8));
+    padding: 20px 15px 15px 15px;
+}
+

LTX2.3-1.0.4/UI/index.html

@@ -0,0 +1,416 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>LTX-2 | Multi-GPU Cinematic Studio</title>
+        <link rel="stylesheet" href="index.css">
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/plyr/3.7.8/plyr.css" />
+</head>
+<body>
+
+<aside class="sidebar">
+    <div class="sidebar-header">
+        <div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 12px;">
+            <div style="display: flex; align-items: center; gap: 10px;">
+                <div id="sys-indicator" class="indicator-ready" style="width: 12px; height: 12px; border-radius: 50%;"></div>
+                <span style="font-weight: 800; font-size: 18px;">LTX-2 STUDIO</span>
+            </div>
+            <div style="display: flex; gap: 8px; align-items: center;">
+                <button id="clearGpuBtn" onclick="clearGpu()" class="btn-outline" data-i18n="clearVram">释放显存</button>
+                <button type="button" id="lang-toggle-btn" class="lang-toggle">EN</button>
+            </div>
+        </div>
+        
+        <div class="top-status" style="margin-bottom: 5px;">
+            <div style="display: flex; align-items: center; gap: 8px;">
+                <span id="sys-status" style="font-weight:bold; color: var(--text-dim); font-size: 12px;" data-i18n="sysScanning">正在扫描 GPU...</span>
+            </div>
+            
+            <button type="button" onclick="const el = document.getElementById('sys-settings'); el.style.display = el.style.display === 'none' ? 'block' : 'none';" class="btn-icon" data-i18n-title="settingsTitle" title="系统高级设置">
+                <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"></circle><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"></path></svg>
+            </button>
+
+        </div>
+        
+        <div style="font-size: 11px; color: var(--text-dim); margin-bottom: 20px; display: flex; align-items: center; width: 100%;">
+            <div class="vram-bar" style="width: 120px; min-width: 120px; margin-top: 0; margin-right: 12px;"><div class="vram-used" id="vram-fill"></div></div> 
+            <span id="vram-text" style="font-variant-numeric: tabular-nums; flex-shrink: 0; text-align: right;">0/32 GB</span>
+            <span id="gpu-name" style="display: none;"></span> <!-- Hidden globally to avoid duplicate -->
+        </div>
+        
+        <div id="sys-settings" style="display: none; padding: 14px; background: rgba(0,0,0,0.4) !important; border-radius: 12px; border: 1px solid rgba(255,255,255,0.1); margin-bottom: 15px; box-shadow: 0 4px 15px rgba(0,0,0,0.5); backdrop-filter: blur(10px);">
+            <div style="font-size: 13px; font-weight: bold; margin-bottom: 12px; color: #fff;" data-i18n="advancedSettings">高级设置</div>
+            
+            <label style="font-size: 11px; margin-bottom: 6px;" data-i18n="deviceSelect">工作设备选择</label>
+            <select id="gpu-selector" onchange="switchGpu(this.value)" style="margin-bottom: 12px; font-size: 11px; padding: 6px;">
+                <option value="" data-i18n="gpuDetecting">正在检测 GPU...</option>
+            </select>
+
+            <label style="font-size: 11px; margin-bottom: 6px; margin-top: 12px;" data-i18n="vramLimitLabel">可用最高显存上限 (GB, 0为全开优先显存)</label>
+            <div style="display: flex; gap: 6px; margin-bottom: 9px; align-items: stretch;">
+                <input type="number" id="vram-limit-input" data-i18n-placeholder="vramLimitPh" placeholder="例如: 12 (0表示无限制)" style="flex: 1; height: 28px; box-sizing: border-box; font-size: 12px; padding: 0 10px;">
+                <button onclick="saveVramLimit()" style="font-size: 12px; padding: 0 10px; height: 28px; box-sizing: border-box; white-space: nowrap; background: #333; border: 1px solid #555; color: #fff; border-radius: 7px; cursor: pointer;" data-i18n="saveLabel">保存</button>
+            </div>
+            <div id="vram-limit-status" style="font-size: 10px; color: var(--text-dim);"></div>
+            
+            
+            <label style="font-size: 11px; margin-bottom: 6px; margin-top: 12px;" data-i18n="loraFolderPath">LoRA 文件夹路径</label>
+            <div style="display: flex; gap: 6px; margin-bottom: 9px; align-items: stretch;">
+                <input type="text" id="lora-dir-input" placeholder="留空使用默认路径" data-i18n-placeholder="loraFolderPathPlaceholder" style="flex: 1; height: 28px; box-sizing: border-box; font-size: 12px; padding: 0 10px;">
+                <button onclick="saveLoraDir()" style="font-size: 12px; padding: 0 10px; height: 28px; box-sizing: border-box; white-space: nowrap; background: #333; border: 1px solid #555; color: #fff; border-radius: 7px; cursor: pointer;" data-i18n="saveLabel">保存</button>
+            </div>
+            <div id="lora-dir-status" style="font-size: 10px; color: var(--text-dim);"></div>
+        </div>
+    </div>
+
+    <div class="sidebar-section">
+        <div class="tabs">
+            <div id="tab-video" class="tab" onclick="switchMode('video')">
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="margin-right: 6px;"><rect x="2" y="2" width="20" height="20" rx="2.18" ry="2.18"></rect><line x1="7" y1="2" x2="7" y2="22"></line><line x1="17" y1="2" x2="17" y2="22"></line><line x1="2" y1="12" x2="22" y2="12"></line><line x1="2" y1="7" x2="7" y2="7"></line><line x1="2" y1="17" x2="7" y2="17"></line><line x1="17" y1="17" x2="22" y2="17"></line><line x1="17" y1="7" x2="22" y2="7"></line></svg>
+                <span data-i18n="tabVideo">视频生成</span>
+            </div>
+            <div id="tab-batch" class="tab" onclick="switchMode('batch')">
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="margin-right: 6px;"><rect x="3" y="3" width="7" height="7"></rect><rect x="14" y="3" width="7" height="7"></rect><rect x="14" y="14" width="7" height="7"></rect><rect x="3" y="14" width="7" height="7"></rect></svg>
+                <span data-i18n="tabBatch">智能多帧</span>
+            </div>
+            <div id="tab-upscale" class="tab" onclick="switchMode('upscale')">
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="margin-right: 6px;"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon></svg>
+                <span data-i18n="tabUpscale">视频增强</span>
+            </div>
+            <div id="tab-image" class="tab" onclick="switchMode('image')">
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="margin-right: 6px;"><rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect><circle cx="8.5" cy="8.5" r="1.5"></circle><polyline points="21 15 16 10 5 21"></polyline></svg>
+                <span data-i18n="tabImage">图像生成</span>
+            </div>
+        </div>
+        
+        <label data-i18n="promptLabel">视觉描述词 (Prompt)</label>
+        <textarea id="prompt" data-i18n-placeholder="promptPlaceholder" placeholder="在此输入视觉描述词 (Prompt)..." style="height: 90px; margin-bottom: 0;"></textarea>
+    </div>
+
+    <!-- 视频模式选项 -->
+    <div class="sidebar-section" id="video-opts" style="display:none">
+        <div class="setting-group">
+            <div class="group-title" data-i18n="basicEngine">基础画面 / Basic EngineSpecs</div>
+            <div class="flex-row">
+                <div class="flex-1">
+                    <label data-i18n="qualityLevel">清晰度级别</label>
+                    <select id="vid-quality" onchange="updateResPreview()">
+                        <option value="1080">1080P Full HD</option>
+                        <option value="720" selected>720P Standard</option>
+                        <option value="540">540P Preview</option>
+                    </select>
+                </div>
+                <div class="flex-1">
+                    <label data-i18n="aspectRatio">画幅比例</label>
+                    <select id="vid-ratio" onchange="updateResPreview()">
+                        <option value="16:9" data-i18n="ratio169">16:9 电影宽幅</option>
+                        <option value="9:16" data-i18n="ratio916">9:16 移动竖屏</option>
+                    </select>
+                </div>
+            </div>
+            <div id="res-preview" class="res-preview-tag" style="margin-top: -5px; margin-bottom: 12px;">最终发送: 1280x704</div>
+
+            <div class="flex-row">
+                <div class="flex-1">
+                    <label data-i18n="fpsLabel">帧率 (FPS)</label>
+                    <select id="vid-fps">
+                        <option value="24" selected>24 FPS</option>
+                        <option value="25">25 FPS</option>
+                        <option value="30">30 FPS</option>
+                        <option value="48">48 FPS</option>
+                        <option value="60">60 FPS</option>
+                    </select>
+                </div>
+                <div class="flex-1">
+                    <label data-i18n="durationLabel">时长 (秒)</label>
+                    <input type="number" id="vid-duration" value="5" min="1" max="30" step="1">
+                </div>
+            </div>
+
+            <label style="margin-top: 12px;" data-i18n="cameraMotion">镜头运动方式</label>
+            <select id="vid-motion">
+                <option value="static" selected data-i18n="motionStatic">Static (静止机位)</option>
+                <option value="dolly_in" data-i18n="motionDollyIn">Dolly In (推近)</option>
+                <option value="dolly_out" data-i18n="motionDollyOut">Dolly Out (拉远)</option>
+                <option value="dolly_left" data-i18n="motionDollyLeft">Dolly Left (向左)</option>
+                <option value="dolly_right" data-i18n="motionDollyRight">Dolly Right (向右)</option>
+                <option value="jib_up" data-i18n="motionJibUp">Jib Up (升臂)</option>
+                <option value="jib_down" data-i18n="motionJibDown">Jib Down (降臂)</option>
+                <option value="focus_shift" data-i18n="motionFocus">Focus Shift (焦点)</option>
+            </select>
+            <div class="checkbox-container" style="margin-top: 8px;">
+                <input type="checkbox" id="vid-audio" checked>
+                <label for="vid-audio" data-i18n="audioGen">生成 AI 环境音 (Audio Gen)</label>
+            </div>
+
+            <label style="margin-top: 12px;" data-i18n="selectModel">选择模型</label>
+            <select id="vid-model" style="margin-bottom: 8px;">
+                <option value="" data-i18n="defaultModel">使用默认模型</option>
+            </select>
+            <label data-i18n="selectLora">选择 LoRA</label>
+            <select id="vid-lora" onchange="updateLoraStrength()" style="margin-bottom: 8px;">
+                <option value="" data-i18n="noLora">不使用 LoRA</option>
+            </select>
+            <div id="lora-strength-container" style="display: none; align-items: center; gap: 8px; margin-top: 8px;">
+                <label data-i18n="loraStrength" style="margin: 0; white-space: nowrap; min-width: 65px;">LoRA 强度</label>
+                <input type="range" id="lora-strength" min="0.1" max="2.0" step="0.1" value="1.0" style="flex: 1; margin: 0;" oninput="document.getElementById('lora-strength-val').textContent = this.value">
+                <span id="lora-strength-val" style="font-size: 12px; color: var(--accent); width: 22px; text-align: right; flex-shrink: 0;">1.0</span>
+            </div>
+        </div>
+
+        <!-- 生成媒介组 -->
+        <div class="setting-group" id="video-source-group">
+            <div class="group-title" data-i18n="genSource">生成媒介 / Generation Source</div>
+            
+            <div class="flex-row" style="margin-bottom: 10px;">
+                <div class="flex-1">
+                    <label data-i18n="startFrame">起始帧 (首帧)</label>
+                    <div class="upload-zone" id="start-frame-drop-zone" onclick="document.getElementById('start-frame-input').click()">
+                        <div class="clear-img-overlay" id="clear-start-frame-overlay" onclick="event.stopPropagation(); clearFrame('start')">×</div>
+                        <div id="start-frame-placeholder">
+                            <div class="upload-icon">🖼️</div>
+                            <div class="upload-text" data-i18n="uploadStart">上传首帧</div>
+                        </div>
+                        <img id="start-frame-preview" class="preview-thumb">
+                        <input type="file" id="start-frame-input" accept="image/*" style="display:none" onchange="handleFrameUpload(this.files[0], 'start')">
+                    </div>
+                    <input type="hidden" id="start-frame-path">
+                </div>
+                <div class="flex-1">
+                    <label data-i18n="endFrame">结束帧 (尾帧)</label>
+                    <div class="upload-zone" id="end-frame-drop-zone" onclick="document.getElementById('end-frame-input').click()">
+                        <div class="clear-img-overlay" id="clear-end-frame-overlay" onclick="event.stopPropagation(); clearFrame('end')">×</div>
+                        <div id="end-frame-placeholder">
+                            <div class="upload-icon">🏁</div>
+                            <div class="upload-text" data-i18n="uploadEnd">上传尾帧 (可选)</div>
+                        </div>
+                        <img id="end-frame-preview" class="preview-thumb">
+                        <input type="file" id="end-frame-input" accept="image/*" style="display:none" onchange="handleFrameUpload(this.files[0], 'end')">
+                    </div>
+                    <input type="hidden" id="end-frame-path">
+                </div>
+            </div>
+
+            <div class="flex-row">
+                <div class="flex-1">
+                    <label data-i18n="refAudio">参考音频 (A2V)</label>
+                    <div class="upload-zone" id="audio-drop-zone" onclick="document.getElementById('vid-audio-input').click()">
+                        <div class="clear-img-overlay" id="clear-audio-overlay" onclick="event.stopPropagation(); clearUploadedAudio()">×</div>
+                        <div id="audio-upload-placeholder">
+                            <div class="upload-icon">🎵</div>
+                            <div class="upload-text" data-i18n="uploadAudio">点击上传音频</div>
+                        </div>
+                        <div id="audio-upload-status" style="display:none;">
+                            <div class="upload-icon" style="color:var(--accent); opacity:1;">✔️</div>
+                            <div id="audio-filename-status" class="upload-text"></div>
+                        </div>
+                        <input type="file" id="vid-audio-input" accept="audio/*" style="display:none" onchange="handleAudioUpload(this.files[0])">
+                    </div>
+                    <input type="hidden" id="uploaded-audio-path">
+                </div>
+            </div>
+            <div style="font-size: 10px; color: var(--text-dim); text-align: center; margin-top: 5px;" data-i18n="sourceHint">
+                💡 若仅上传首帧 = 图生视频/音视频；若同时上传首尾帧 = 首尾插帧。
+            </div>
+        </div>
+    </div>
+
+    <!-- 图像模式选项 -->
+    <div id="image-opts" class="sidebar-section" style="display:none">
+        <label data-i18n="imgPreset">预设分辨率 (Presets)</label>
+        <select id="img-res-preset" onchange="applyImgPreset(this.value)">
+            <option value="1024x1024" data-i18n="imgOptSquare">1:1 Square (1024x1024)</option>
+            <option value="1280x720" data-i18n="imgOptLand">16:9 Landscape (1280x720)</option>
+            <option value="720x1280" data-i18n="imgOptPort">9:16 Portrait (720x1280)</option>
+            <option value="custom" data-i18n="imgOptCustom">Custom 自定义...</option>
+        </select>
+
+        <div id="img-custom-res" class="flex-row" style="margin-top: 10px;">
+            <div class="flex-1"><label data-i18n="width">宽度</label><input type="number" id="img-w" value="1024" onchange="updateImgResPreview()"></div>
+            <div class="flex-1"><label data-i18n="height">高度</label><input type="number" id="img-h" value="1024" onchange="updateImgResPreview()"></div>
+        </div>
+        <div id="img-res-preview" class="res-preview-tag">最终发送: 1024x1024</div>
+        
+        <div class="label-group" style="margin-top: 15px;">
+            <label data-i18n="samplingSteps">采样步数 (Steps)</label>
+            <span class="val-badge" id="stepsVal">28</span>
+        </div>
+        <div class="slider-container">
+            <input type="range" id="img-steps" min="1" max="50" value="28" oninput="document.getElementById('stepsVal').innerText=this.value">
+        </div>
+    </div>
+
+    <!-- 超分模式选项 -->
+    <div id="upscale-opts" class="sidebar-section" style="display:none">
+        <div class="setting-group">
+            <label data-i18n="upscaleSource">待超分视频 (Source)</label>
+            <div class="upload-zone" id="upscale-drop-zone" onclick="document.getElementById('upscale-video-input').click()" style="margin-bottom: 0;">
+                <div class="clear-img-overlay" id="clear-upscale-overlay" onclick="event.stopPropagation(); clearUpscaleVideo()">×</div>
+                <div id="upscale-placeholder">
+                    <div class="upload-icon">📹</div>
+                    <div class="upload-text" data-i18n="upscaleUpload">拖入低分辨率视频片段</div>
+                </div>
+                <div id="upscale-status" style="display:none;">
+                    <div class="upload-icon" style="color:var(--accent); opacity:1;">✔️</div>
+                    <div id="upscale-filename" class="upload-text"></div>
+                </div>
+                <input type="file" id="upscale-video-input" accept="video/*" style="display:none" onchange="handleUpscaleVideoUpload(this.files[0])">
+            </div>
+            <input type="hidden" id="upscale-video-path">
+        </div>
+
+        <div class="setting-group">
+            <label data-i18n="targetRes">目标分辨率</label>
+            <select id="upscale-res" style="margin-bottom: 0;">
+                <option value="1080p" data-i18n="upscale1080">1080P Full HD (2x)</option>
+                <option value="720p" data-i18n="upscale720">720P HD</option>
+            </select>
+        </div>
+        </div>
+
+    <!-- 智能多帧模式 -->
+    <div class="sidebar-section" id="batch-opts" style="display:none">
+        <div class="setting-group">
+            <div class="group-title" data-i18n="smartMultiFrameGroup">智能多帧</div>
+            <div class="smart-param-mode-label" data-i18n="workflowModeLabel">工作流模式（点击切换）</div>
+            <div class="smart-param-modes" role="radiogroup" aria-label="工作流模式">
+                <label class="smart-param-mode-opt">
+                    <input type="radio" name="batch-workflow" value="single" checked onchange="onBatchWorkflowChange()">
+                    <span class="smart-param-mode-title" data-i18n="wfSingle">单次多关键帧</span>
+                </label>
+                <label class="smart-param-mode-opt">
+                    <input type="radio" name="batch-workflow" value="segments" onchange="onBatchWorkflowChange()">
+                    <span class="smart-param-mode-title" data-i18n="wfSegments">分段拼接</span>
+                </label>
+            </div>
+            
+            <label data-i18n="uploadImages">上传图片</label>
+            <div class="upload-zone" id="batch-images-drop-zone" onclick="document.getElementById('batch-images-input').click()" style="min-height: 72px; margin-bottom: 0;">
+                <div id="batch-images-placeholder">
+                    <div class="upload-icon">📁</div>
+                    <div class="upload-text" data-i18n="uploadMulti1">点击或拖入多张图片</div>
+                    <div class="upload-hint" data-i18n="uploadMulti2">支持一次选多张，可多次添加</div>
+                </div>
+                <input type="file" id="batch-images-input" accept="image/*" multiple style="display:none" onchange="handleBatchImagesUpload(this.files, true)">
+            </div>
+            <input type="hidden" id="batch-images-path">
+
+            <div class="batch-thumb-strip-wrap" id="batch-thumb-strip-wrap" style="display: none;">
+                <div class="batch-thumb-strip-head">
+                    <span class="batch-thumb-strip-title" data-i18n="batchStripTitle">已选图片 · 顺序 = 播放先后</span>
+                    <span class="batch-thumb-strip-hint" data-i18n="batchStripHint">在缩略图上按住拖动排序；松手落入虚线框位置</span>
+                </div>
+                <div class="batch-images-container" id="batch-images-container"></div>
+            </div>
+
+            <div style="font-size: 10px; color: var(--text-dim); margin-bottom: 12px; margin-top: 10px; line-height: 1.45;" data-i18n-html="batchFfmpegHint">
+                💡 <strong>分段模式</strong>：2 张 = 1 段；3 张 = 2 段再拼接。<strong>单次模式</strong>：几张图就几个 latent 锚点，一条视频出片。<br>
+                多段需 <code style="font-size:9px;">ffmpeg</code>：装好后加 PATH，或设环境变量 <code style="font-size:9px;">LTX_FFMPEG_PATH</code>，或在 <code style="font-size:9px;">%LOCALAPPDATA%\LTXDesktop\ffmpeg_path.txt</code> 第一行写 ffmpeg.exe 完整路径。
+            </div>
+
+            <label style="margin-top: 4px;" data-i18n="globalPromptLabel">本页全局补充词（可选）</label>
+            <textarea id="batch-common-prompt" data-i18n-placeholder="globalPromptPh" placeholder="与顶部主 Prompt 叠加；单次模式与分段模式均可用" style="width: 100%; height: 56px; margin-bottom: 10px; padding: 8px; font-size: 11px; box-sizing: border-box; resize: vertical; border-radius: 8px; border: 1px solid var(--border); background: var(--item); color: var(--text);"></textarea>
+
+            <label style="margin-top: 8px;" data-i18n="bgmLabel">成片配乐（可选，统一音轨）</label>
+            <div class="upload-zone" id="batch-audio-drop-zone" onclick="document.getElementById('batch-audio-input').click()" style="min-height: 44px; margin-bottom: 8px; position: relative;">
+                <div class="clear-img-overlay" id="clear-batch-audio-overlay" onclick="event.stopPropagation(); clearBatchBackgroundAudio()" style="display: none;">×</div>
+                <div id="batch-audio-placeholder">
+                    <div class="upload-text" style="font-size: 11px;" data-i18n="bgmUploadHint">上传一条完整 BGM（生成完成后会替换整段成片的音轨）</div>
+                </div>
+                <div id="batch-audio-status" style="display: none; font-size: 11px; color: var(--accent);"></div>
+                <input type="file" id="batch-audio-input" accept="audio/*" style="display:none" onchange="handleBatchBackgroundAudioUpload(this.files[0])">
+            </div>
+            <input type="hidden" id="batch-background-audio-path">
+
+            <div id="batch-segments-container" style="margin-top: 15px;"></div>
+        </div>
+
+        <div class="setting-group">
+            <div class="group-title" data-i18n="basicEngine">基础画面 / Basic EngineSpecs</div>
+            <div class="flex-row">
+                <div class="flex-1">
+                    <label data-i18n="qualityLevel">清晰度级别</label>
+                    <select id="batch-quality" onchange="updateBatchResPreview()">
+                        <option value="1080">1080P Full HD</option>
+                        <option value="720" selected>720P Standard</option>
+                        <option value="540">540P Preview</option>
+                    </select>
+                </div>
+                <div class="flex-1">
+                    <label data-i18n="aspectRatio">画幅比例</label>
+                    <select id="batch-ratio" onchange="updateBatchResPreview()">
+                        <option value="16:9" data-i18n="ratio169">16:9 电影宽幅</option>
+                        <option value="9:16" data-i18n="ratio916">9:16 移动竖屏</option>
+                    </select>
+                </div>
+            </div>
+            <div id="batch-res-preview" class="res-preview-tag" style="margin-top: -5px; margin-bottom: 12px;">最终发送: 1280x704</div>
+
+            <label data-i18n="selectModel">选择模型</label>
+            <select id="batch-model" style="margin-bottom: 8px;">
+                <option value="" data-i18n="defaultModel">使用默认模型</option>
+            </select>
+            <label data-i18n="selectLora">选择 LoRA</label>
+            <select id="batch-lora" onchange="updateBatchLoraStrength()" style="margin-bottom: 8px;">
+                <option value="" data-i18n="noLora">不使用 LoRA</option>
+            </select>
+            <div id="batch-lora-strength-container" style="display: none;">
+                <label data-i18n="loraStrength">LoRA 强度</label>
+                <input type="range" id="batch-lora-strength" min="0.1" max="2.0" step="0.1" value="1.2" style="width: 100%;" oninput="document.getElementById('batch-lora-strength-val').textContent = this.value">
+                <span id="batch-lora-strength-val" style="font-size: 12px; color: var(--accent);">1.2</span>
+            </div>
+        </div>
+    </div>
+
+    <div style="padding: 0 30px 30px 30px;">
+        <button class="btn-primary" id="mainBtn" onclick="run()" data-i18n="mainRender">开始渲染</button>
+    </div>
+</aside>
+
+<main class="workspace">
+    <section class="viewer" id="viewer-section">
+        <div class="monitor" id="viewer">
+            <div id="loading-txt" data-i18n="waitingTask">等待分配渲染任务...</div>
+            <img id="res-img" src="">
+            <div id="video-wrapper" style="width:100%; height:100%; display:none; max-height:100%; align-items:center; justify-content:center;">
+                <video id="res-video" autoplay loop playsinline></video>
+            </div>
+            <div class="progress-container"><div id="progress-fill"></div></div>
+        </div>
+    </section>
+
+    <!-- Drag Handle -->
+    <div id="resize-handle" style="
+        height: 5px; background: transparent; cursor: row-resize;
+        flex-shrink: 0; position: relative; z-index: 50;
+        display: flex; align-items: center; justify-content: center;
+    " data-i18n-title="resizeHandleTitle" title="拖动调整面板高度">
+        <div style="width: 40px; height: 3px; background: var(--border); border-radius: 999px; pointer-events: none;"></div>
+    </div>
+
+    <section class="library" id="library-section">
+        <div style="display: flex; justify-content: space-between; margin-bottom: 15px; align-items: center; border-bottom: 1px solid var(--border); padding-bottom: 10px;">
+            <div style="display: flex; gap: 20px;">
+                <span id="tab-history" style="font-size: 11px; font-weight: 800; color: var(--accent); cursor: pointer; border-bottom: 2px solid var(--accent); padding-bottom: 11px; margin-bottom: -11px;" onclick="switchLibTab('history')" data-i18n="libHistory">历史资产 / ASSETS</span>
+                <span id="tab-log" style="font-size: 11px; font-weight: 800; color: var(--text-dim); cursor: pointer; border-bottom: 2px solid transparent; padding-bottom: 11px; margin-bottom: -11px;" onclick="switchLibTab('log')" data-i18n="libLog">系统日志 / LOGS</span>
+            </div>
+            <button type="button" onclick="fetchHistory(currentHistoryPage)" style="background: var(--item); border: 1px solid var(--border); border-radius: 6px; color: var(--text-dim); font-size: 11px; padding: 4px 10px; cursor: pointer;" data-i18n="refresh">刷新</button>
+        </div>
+        
+        <div id="log-container" style="display: none; flex: 1; flex-direction: column;">
+            <div id="log" data-i18n="logReady">> LTX-2 Studio Ready. Expecting commands...</div>
+        </div>
+        
+        <div id="history-wrapper">
+            <div id="history-container"></div>
+        </div>
+        <div id="pagination-bar" style="display:none;"></div>
+    </section>
+</main>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/plyr/3.7.8/plyr.min.js"></script>
+<script src="i18n.js"></script>
+<script src="index.js"></script>
+
+</body>
+</html>

LTX2.3-1.0.4/UI/index.js

@@ -0,0 +1,2114 @@
+// ─── Resizable panel drag logic ───────────────────────────────────────────────
+(function() {
+    const handle = document.getElementById('resize-handle');
+    const viewer = document.getElementById('viewer-section');
+    const library = document.getElementById('library-section');
+    const workspace = document.querySelector('.workspace');
+    let dragging = false, startY = 0, startVH = 0;
+
+    handle.addEventListener('mousedown', (e) => {
+        dragging = true;
+        startY = e.clientY;
+        startVH = viewer.getBoundingClientRect().height;
+        document.body.style.cursor = 'row-resize';
+        document.body.style.userSelect = 'none';
+        handle.querySelector('div').style.background = 'var(--accent)';
+        e.preventDefault();
+    });
+    document.addEventListener('mousemove', (e) => {
+        if (!dragging) return;
+        const wsH = workspace.getBoundingClientRect().height;
+        const delta = e.clientY - startY;
+        let newVH = startVH + delta;
+        // Clamp: viewer min 150px, library min 100px
+        newVH = Math.max(150, Math.min(wsH - 100 - 5, newVH));
+        viewer.style.flex = 'none';
+        viewer.style.height = newVH + 'px';
+        library.style.flex = '1';
+    });
+    document.addEventListener('mouseup', () => {
+        if (dragging) {
+            dragging = false;
+            document.body.style.cursor = '';
+            document.body.style.userSelect = '';
+            handle.querySelector('div').style.background = 'var(--border)';
+        }
+    });
+    // Hover highlight
+    handle.addEventListener('mouseenter', () => { handle.querySelector('div').style.background = 'var(--text-dim)'; });
+    handle.addEventListener('mouseleave', () => { if (!dragging) handle.querySelector('div').style.background = 'var(--border)'; });
+})();
+// ──────────────────────────────────────────────────────────────────────────────
+
+
+
+
+
+
+// 动态获取当前访问的域名或 IP，自动对齐 3000 端口
+    const BASE = `http://${window.location.hostname}:3000`;
+
+    function _t(k) {
+        return typeof window.t === 'function' ? window.t(k) : k;
+    }
+    
+    let currentMode = 'image';
+    let pollInterval = null;
+    let availableModels = [];
+    let availableLoras = [];
+
+    // 建议增加一个简单的调试日志，方便在控制台确认地址是否正确
+    console.log("Connecting to Backend API at:", BASE);
+
+    // 模型扫描功能
+    async function scanModels() {
+        try {
+            const url = `${BASE}/api/models`;
+            console.log("Scanning models from:", url);
+            const res = await fetch(url);
+            const data = await res.json().catch(() => ({}));
+            console.log("Models response:", res.status, data);
+            if (!res.ok) {
+                const msg = data.message || data.error || res.statusText;
+                addLog(`❌ 模型扫描失败 (${res.status}): ${msg}`);
+                availableModels = [];
+                updateModelDropdown();
+                updateBatchModelDropdown();
+                return;
+            }
+            availableModels = data.models || [];
+            updateModelDropdown();
+            updateBatchModelDropdown();
+            if (availableModels.length > 0) {
+                addLog(`📂 已扫描到 ${availableModels.length} 个模型: ${availableModels.map(m => m.name).join(', ')}`);
+            }
+        } catch (e) {
+            console.log("Model scan error:", e);
+            addLog(`❌ 模型扫描异常: ${e.message || e}`);
+        }
+    }
+
+    function updateModelDropdown() {
+        const select = document.getElementById('vid-model');
+        if (!select) return;
+        select.innerHTML = '<option value="">' + _t('defaultModel') + '</option>';
+        availableModels.forEach(model => {
+            const opt = document.createElement('option');
+            opt.value = model.path;
+            opt.textContent = model.name;
+            select.appendChild(opt);
+        });
+    }
+
+    // LoRA 扫描功能
+    async function scanLoras() {
+        try {
+            const url = `${BASE}/api/loras`;
+            console.log("Scanning LoRA from:", url);
+            const res = await fetch(url);
+            const data = await res.json().catch(() => ({}));
+            console.log("LoRA response:", res.status, data);
+            if (!res.ok) {
+                const msg = data.message || data.error || res.statusText;
+                addLog(`❌ LoRA 扫描失败 (${res.status}): ${msg}`);
+                availableLoras = [];
+                updateLoraDropdown();
+                updateBatchLoraDropdown();
+                return;
+            }
+            availableLoras = data.loras || [];
+            updateLoraDropdown();
+            updateBatchLoraDropdown();
+            if (data.loras_dir) {
+                const hintEl = document.getElementById('lora-placement-hint');
+                if (hintEl) {
+                    const tpl = _t('loraPlacementHintWithDir');
+                    hintEl.innerHTML = tpl.replace(
+                        '{dir}',
+                        escapeHtmlAttr(data.models_dir || data.loras_dir)
+                    );
+                }
+            }
+            if (availableLoras.length > 0) {
+                addLog(`📂 已扫描到 ${availableLoras.length} 个 LoRA: ${availableLoras.map(l => l.name).join(', ')}`);
+            }
+        } catch (e) {
+            console.log("LoRA scan error:", e);
+            addLog(`❌ LoRA 扫描异常: ${e.message || e}`);
+        }
+    }
+
+    function updateLoraDropdown() {
+        const select = document.getElementById('vid-lora');
+        if (!select) return;
+        select.innerHTML = '<option value="">' + _t('noLora') + '</option>';
+        availableLoras.forEach(lora => {
+            const opt = document.createElement('option');
+            opt.value = lora.path;
+            opt.textContent = lora.name;
+            select.appendChild(opt);
+        });
+    }
+
+    function updateLoraStrength() {
+        const select = document.getElementById('vid-lora');
+        const container = document.getElementById('lora-strength-container');
+        if (select && container) {
+            container.style.display = select.value ? 'flex' : 'none';
+        }
+    }
+
+    // 更新批量模式的模型和LoRA下拉框
+    function updateBatchModelDropdown() {
+        const select = document.getElementById('batch-model');
+        if (!select) return;
+        select.innerHTML = '<option value="">' + _t('defaultModel') + '</option>';
+        availableModels.forEach(model => {
+            const opt = document.createElement('option');
+            opt.value = model.path;
+            opt.textContent = model.name;
+            select.appendChild(opt);
+        });
+    }
+
+    function updateBatchLoraDropdown() {
+        const select = document.getElementById('batch-lora');
+        if (!select) return;
+        select.innerHTML = '<option value="">' + _t('noLora') + '</option>';
+        availableLoras.forEach(lora => {
+            const opt = document.createElement('option');
+            opt.value = lora.path;
+            opt.textContent = lora.name;
+            select.appendChild(opt);
+        });
+    }
+
+    // 页面加载时更新批量模式的下拉框
+    function initBatchDropdowns() {
+        updateBatchModelDropdown();
+        updateBatchLoraDropdown();
+    }
+
+    // 已移除：模型/LoRA 目录自定义与浏览（保持后端默认路径扫描）
+
+    // 页面加载时扫描模型和LoRA（使用后端默认目录规则）
+    (function() {
+        ['vid-quality', 'batch-quality'].forEach((id) => {
+            const sel = document.getElementById(id);
+            if (sel && sel.value === '544') sel.value = '540';
+        });
+        
+        setTimeout(() => {
+            scanModels();
+            scanLoras();
+            initBatchDropdowns();
+        }, 1500);
+    })();
+
+    // 分辨率自动计算逻辑
+    function updateResPreview() {
+        const q = document.getElementById('vid-quality').value; // "1080", "720", "540"
+        const r = document.getElementById('vid-ratio').value;
+        
+        // 核心修复：后端解析器期待 "1080p", "720p", "540p" 这种标签格式
+        let resLabel = q === "1080" ? "1080p" : q === "720" ? "720p" : "540p";
+        
+        /* 与后端一致：宽高均为 64 的倍数（LTX 内核要求） */
+        let resDisplay;
+        if (r === "16:9") {
+            resDisplay = q === "1080" ? "1920x1088" : q === "720" ? "1280x704" : "1024x576";
+        } else {
+            resDisplay = q === "1080" ? "1088x1920" : q === "720" ? "704x1280" : "576x1024";
+        }
+        
+        document.getElementById('res-preview').innerText = `${_t('resPreviewPrefix')}: ${resLabel} (${resDisplay})`;
+        return resLabel;
+    }
+
+    // 图片分辨率预览
+    function updateImgResPreview() {
+        const w = document.getElementById('img-w').value;
+        const h = document.getElementById('img-h').value;
+        document.getElementById('img-res-preview').innerText = `${_t('resPreviewPrefix')}: ${w}x${h}`;
+    }
+
+    // 批量模式分辨率预览
+    function updateBatchResPreview() {
+        const q = document.getElementById('batch-quality').value;
+        const r = document.getElementById('batch-ratio').value;
+        let resLabel = q === "1080" ? "1080p" : q === "720" ? "720p" : "540p";
+        let resDisplay;
+        if (r === "16:9") {
+            resDisplay = q === "1080" ? "1920x1088" : q === "720" ? "1280x704" : "1024x576";
+        } else {
+            resDisplay = q === "1080" ? "1088x1920" : q === "720" ? "704x1280" : "576x1024";
+        }
+        document.getElementById('batch-res-preview').innerText = `${_t('resPreviewPrefix')}: ${resLabel} (${resDisplay})`;
+        return resLabel;
+    }
+
+    // 批量模式 LoRA 强度切换
+    function updateBatchLoraStrength() {
+        const select = document.getElementById('batch-lora');
+        const container = document.getElementById('batch-lora-strength-container');
+        if (select && container) {
+            container.style.display = select.value ? 'flex' : 'none';
+        }
+    }
+
+    // 切换图片预设分辨率
+    function applyImgPreset(val) {
+        if (val === "custom") {
+            document.getElementById('img-custom-res').style.display = 'flex';
+        } else {
+            const [w, h] = val.split('x');
+            document.getElementById('img-w').value = w;
+            document.getElementById('img-h').value = h;
+            updateImgResPreview();
+            // 隐藏自定义区域或保持显示供微调
+            // document.getElementById('img-custom-res').style.display = 'none';
+        }
+    }
+
+
+
+    // 处理帧图片上传
+    async function handleFrameUpload(file, frameType) {
+        if (!file) return;
+
+        const preview = document.getElementById(`${frameType}-frame-preview`);
+        const placeholder = document.getElementById(`${frameType}-frame-placeholder`);
+        const clearOverlay = document.getElementById(`clear-${frameType}-frame-overlay`);
+
+        const previewReader = new FileReader();
+        previewReader.onload = (e) => {
+            preview.src = e.target.result;
+            preview.style.display = 'block';
+            placeholder.style.display = 'none';
+            clearOverlay.style.display = 'flex';
+        };
+        previewReader.readAsDataURL(file);
+
+        const reader = new FileReader();
+        reader.onload = async (e) => {
+            const b64Data = e.target.result;
+            addLog(`正在上传 ${frameType === 'start' ? '起始帧' : '结束帧'}: ${file.name}...`);
+            try {
+                const res = await fetch(`${BASE}/api/system/upload-image`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ image: b64Data, filename: file.name })
+                });
+                const data = await res.json();
+                if (res.ok && data.path) {
+                    document.getElementById(`${frameType}-frame-path`).value = data.path;
+                    addLog(`✅ ${frameType === 'start' ? '起始帧' : '结束帧'}上传成功`);
+                } else {
+                    throw new Error(data.error || data.detail || "上传失败");
+                }
+            } catch (e) {
+                addLog(`❌ 帧图片上传失败: ${e.message}`);
+            }
+        };
+        reader.readAsDataURL(file);
+    }
+
+    function clearFrame(frameType) {
+        document.getElementById(`${frameType}-frame-input`).value = "";
+        document.getElementById(`${frameType}-frame-path`).value = "";
+        document.getElementById(`${frameType}-frame-preview`).style.display = 'none';
+        document.getElementById(`${frameType}-frame-preview`).src = "";
+        document.getElementById(`${frameType}-frame-placeholder`).style.display = 'block';
+        document.getElementById(`clear-${frameType}-frame-overlay`).style.display = 'none';
+        addLog(`🧹 已清除${frameType === 'start' ? '起始帧' : '结束帧'}`);
+    }
+
+    // 处理图片上传
+    async function handleImageUpload(file) {
+        if (!file) return;
+        
+        // 预览图片
+        const preview = document.getElementById('upload-preview');
+        const placeholder = document.getElementById('upload-placeholder');
+        const clearOverlay = document.getElementById('clear-img-overlay');
+        
+        const previewReader = new FileReader();
+        preview.onload = () => {
+            preview.style.display = 'block';
+            placeholder.style.display = 'none';
+            clearOverlay.style.display = 'flex';
+        };
+        previewReader.onload = (e) => preview.src = e.target.result;
+        previewReader.readAsDataURL(file);
+
+        // 使用 FileReader 转换为 Base64，绕过后端缺失 python-multipart 的问题
+        const reader = new FileReader();
+        reader.onload = async (e) => {
+            const b64Data = e.target.result;
+            addLog(`正在上传参考图: ${file.name}...`);
+            try {
+                const res = await fetch(`${BASE}/api/system/upload-image`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        image: b64Data,
+                        filename: file.name
+                    })
+                });
+                const data = await res.json();
+                if (res.ok && data.path) {
+                    document.getElementById('uploaded-img-path').value = data.path;
+                    addLog(`✅ 参考图上传成功: ${file.name}`);
+                } else {
+                    const errMsg = data.error || data.detail || "上传失败";
+                    throw new Error(typeof errMsg === 'string' ? errMsg : JSON.stringify(errMsg));
+                }
+            } catch (e) {
+                addLog(`❌ 图片上传失败: ${e.message}`);
+            }
+        };
+        reader.onerror = () => addLog("❌ 读取本地文件失败");
+        reader.readAsDataURL(file);
+    }
+
+    function clearUploadedImage() {
+        document.getElementById('vid-image-input').value = "";
+        document.getElementById('uploaded-img-path').value = "";
+        document.getElementById('upload-preview').style.display = 'none';
+        document.getElementById('upload-preview').src = "";
+        document.getElementById('upload-placeholder').style.display = 'block';
+        document.getElementById('clear-img-overlay').style.display = 'none';
+        addLog("🧹 已清除参考图");
+    }
+
+    // 处理音频上传
+    async function handleAudioUpload(file) {
+        if (!file) return;
+
+        const placeholder = document.getElementById('audio-upload-placeholder');
+        const statusDiv = document.getElementById('audio-upload-status');
+        const filenameStatus = document.getElementById('audio-filename-status');
+        const clearOverlay = document.getElementById('clear-audio-overlay');
+
+        placeholder.style.display = 'none';
+        filenameStatus.innerText = file.name;
+        statusDiv.style.display = 'block';
+        clearOverlay.style.display = 'flex';
+
+        const reader = new FileReader();
+        reader.onload = async (e) => {
+            const b64Data = e.target.result;
+            addLog(`正在上传音频: ${file.name}...`);
+            try {
+                // 复用图片上传接口，后端已支持任意文件类型
+                const res = await fetch(`${BASE}/api/system/upload-image`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        image: b64Data,
+                        filename: file.name
+                    })
+                });
+                const data = await res.json();
+                if (res.ok && data.path) {
+                    document.getElementById('uploaded-audio-path').value = data.path;
+                    addLog(`✅ 音频上传成功: ${file.name}`);
+                } else {
+                    const errMsg = data.error || data.detail || "上传失败";
+                    throw new Error(typeof errMsg === 'string' ? errMsg : JSON.stringify(errMsg));
+                }
+            } catch (e) {
+                addLog(`❌ 音频上传失败: ${e.message}`);
+            }
+        };
+        reader.onerror = () => addLog("❌ 读取本地音频文件失败");
+        reader.readAsDataURL(file);
+    }
+
+    function clearUploadedAudio() {
+        document.getElementById('vid-audio-input').value = "";
+        document.getElementById('uploaded-audio-path').value = "";
+        document.getElementById('audio-upload-placeholder').style.display = 'block';
+        document.getElementById('audio-upload-status').style.display = 'none';
+        document.getElementById('clear-audio-overlay').style.display = 'none';
+        addLog("🧹 已清除音频文件");
+    }
+
+    // 处理超分视频上传
+    async function handleUpscaleVideoUpload(file) {
+        if (!file) return;
+        const placeholder = document.getElementById('upscale-placeholder');
+        const statusDiv = document.getElementById('upscale-status');
+        const filenameStatus = document.getElementById('upscale-filename');
+        const clearOverlay = document.getElementById('clear-upscale-overlay');
+
+        filenameStatus.innerText = file.name;
+        placeholder.style.display = 'none';
+        statusDiv.style.display = 'block';
+        clearOverlay.style.display = 'flex';
+
+        const reader = new FileReader();
+        reader.onload = async (e) => {
+            const b64Data = e.target.result;
+            addLog(`正在上传待超分视频: ${file.name}...`);
+            try {
+                const res = await fetch(`${BASE}/api/system/upload-image`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ image: b64Data, filename: file.name })
+                });
+                const data = await res.json();
+                if (res.ok && data.path) {
+                    document.getElementById('upscale-video-path').value = data.path;
+                    addLog(`✅ 视频上传成功`);
+                } else {
+                    throw new Error(data.error || "上传失败");
+                }
+            } catch (e) {
+                addLog(`❌ 视频上传失败: ${e.message}`);
+            }
+        };
+        reader.readAsDataURL(file);
+    }
+
+    function clearUpscaleVideo() {
+        document.getElementById('upscale-video-input').value = "";
+        document.getElementById('upscale-video-path').value = "";
+        document.getElementById('upscale-placeholder').style.display = 'block';
+        document.getElementById('upscale-status').style.display = 'none';
+        document.getElementById('clear-upscale-overlay').style.display = 'none';
+        addLog("🧹 已清除待超分视频");
+    }
+
+    // 初始化拖拽上传逻辑
+    function initDragAndDrop() {
+        const audioDropZone = document.getElementById('audio-drop-zone');
+        const startFrameDropZone = document.getElementById('start-frame-drop-zone');
+        const endFrameDropZone = document.getElementById('end-frame-drop-zone');
+        const upscaleDropZone = document.getElementById('upscale-drop-zone');
+        const batchImagesDropZone = document.getElementById('batch-images-drop-zone');
+        
+        const zones = [audioDropZone, startFrameDropZone, endFrameDropZone, upscaleDropZone, batchImagesDropZone];
+
+        ['dragenter', 'dragover', 'dragleave', 'drop'].forEach(eventName => {
+            zones.forEach(zone => {
+                if (!zone) return;
+                zone.addEventListener(eventName, (e) => {
+                    e.preventDefault();
+                    e.stopPropagation();
+                }, false);
+            });
+        });
+
+        ['dragenter', 'dragover'].forEach(eventName => {
+            zones.forEach(zone => {
+                if (!zone) return;
+                zone.addEventListener(eventName, () => zone.classList.add('dragover'), false);
+            });
+        });
+
+        ['dragleave', 'drop'].forEach(eventName => {
+            zones.forEach(zone => {
+                if (!zone) return;
+                zone.addEventListener(eventName, () => zone.classList.remove('dragover'), false);
+            });
+        });
+
+        audioDropZone.addEventListener('drop', (e) => {
+            const file = e.dataTransfer.files[0];
+            if (file && file.type.startsWith('audio/')) handleAudioUpload(file);
+        }, false);
+
+        startFrameDropZone.addEventListener('drop', (e) => {
+            const file = e.dataTransfer.files[0];
+            if (file && file.type.startsWith('image/')) handleFrameUpload(file, 'start');
+        }, false);
+
+        endFrameDropZone.addEventListener('drop', (e) => {
+            const file = e.dataTransfer.files[0];
+            if (file && file.type.startsWith('image/')) handleFrameUpload(file, 'end');
+        }, false);
+
+        upscaleDropZone.addEventListener('drop', (e) => {
+            const file = e.dataTransfer.files[0];
+            if (file && file.type.startsWith('video/')) handleUpscaleVideoUpload(file);
+        }, false);
+
+        // 批量图片拖拽上传
+        if (batchImagesDropZone) {
+            batchImagesDropZone.addEventListener('drop', (e) => {
+                e.preventDefault();
+                e.stopPropagation();
+                batchImagesDropZone.classList.remove('dragover');
+                const files = Array.from(e.dataTransfer.files).filter(f => f.type.startsWith('image/'));
+                if (files.length > 0) handleBatchImagesUpload(files);
+            }, false);
+        }
+    }
+
+    // 批量图片上传处理
+    let batchImages = [];
+    /** 单次多关键帧：按 path 记引导强度；按段索引 0..n-2 记「上一张→本张」间隔秒数 */
+    const batchKfStrengthByPath = {};
+    const batchKfSegDurByIndex = {};
+
+    function escapeHtmlAttr(s) {
+        return String(s)
+            .replace(/&/g, '&amp;')
+            .replace(/"/g, '&quot;')
+            .replace(/</g, '&lt;');
+    }
+
+    function defaultKeyframeStrengthForIndex(i, n) {
+        if (n <= 2) return '1';
+        if (i === 0) return '0.62';
+        if (i === n - 1) return '1';
+        return '0.42';
+    }
+
+    function captureBatchKfTimelineFromDom() {
+        batchImages.forEach((img, i) => {
+            if (!img.path) return;
+            const sEl = document.getElementById(`batch-kf-strength-${i}`);
+            if (sEl) batchKfStrengthByPath[img.path] = sEl.value.trim();
+        });
+        const n = batchImages.length;
+        for (let j = 0; j < n - 1; j++) {
+            const el = document.getElementById(`batch-kf-seg-dur-${j}`);
+            if (el) batchKfSegDurByIndex[j] = el.value.trim();
+        }
+    }
+
+    /** 读取间隔（秒），非法则回退为 minSeg */
+    function readBatchKfSegmentSeconds(n, minSeg) {
+        const seg = [];
+        for (let j = 0; j < n - 1; j++) {
+            let v = parseFloat(document.getElementById(`batch-kf-seg-dur-${j}`)?.value);
+            if (!Number.isFinite(v) || v < minSeg) v = minSeg;
+            seg.push(v);
+        }
+        return seg;
+    }
+
+    function updateBatchKfTimelineDerivedUI() {
+        if (!batchWorkflowIsSingle() || batchImages.length < 2) return;
+        const n = batchImages.length;
+        const minSeg = 0.1;
+        const seg = readBatchKfSegmentSeconds(n, minSeg);
+        let t = 0;
+        for (let i = 0; i < n; i++) {
+            const label = document.getElementById(`batch-kf-anchor-label-${i}`);
+            if (!label) continue;
+            if (i === 0) {
+                label.textContent = `0.0 s · ${_t('batchAnchorStart')}`;
+            } else {
+                t += seg[i - 1];
+                label.textContent =
+                    i === n - 1
+                        ? `${t.toFixed(1)} s · ${_t('batchAnchorEnd')}`
+                        : `${t.toFixed(1)} s`;
+            }
+        }
+        const totalEl = document.getElementById('batch-kf-total-seconds');
+        if (totalEl) {
+            const sum = seg.reduce((a, b) => a + b, 0);
+            totalEl.textContent = sum.toFixed(1);
+        }
+    }
+    async function handleBatchImagesUpload(files, append = true) {
+        if (!files || files.length === 0) return;
+        addLog(`正在上传 ${files.length} 张图片...`);
+
+        for (let i = 0; i < files.length; i++) {
+            const file = files[i];
+            const reader = new FileReader();
+
+            const imgData = await new Promise((resolve) => {
+                reader.onload = async (e) => {
+                    const b64Data = e.target.result;
+                    try {
+                        const res = await fetch(`${BASE}/api/system/upload-image`, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ image: b64Data, filename: file.name })
+                        });
+                        const data = await res.json();
+                        if (res.ok && data.path) {
+                            resolve({ name: file.name, path: data.path, preview: e.target.result });
+                        } else {
+                            resolve(null);
+                        }
+                    } catch (e) {
+                        resolve(null);
+                    }
+                };
+                reader.readAsDataURL(file);
+            });
+
+            if (imgData) {
+                batchImages.push(imgData);
+                addLog(`✅ 图片 ${i + 1}/${files.length} 上传成功: ${file.name}`);
+            }
+        }
+
+        renderBatchImages();
+        updateBatchSegments();
+    }
+
+    async function handleBatchBackgroundAudioUpload(file) {
+        if (!file) return;
+        const ph = document.getElementById('batch-audio-placeholder');
+        const st = document.getElementById('batch-audio-status');
+        const overlay = document.getElementById('clear-batch-audio-overlay');
+        const reader = new FileReader();
+        reader.onload = async (e) => {
+            const b64Data = e.target.result;
+            addLog(`正在上传成片配乐: ${file.name}...`);
+            try {
+                const res = await fetch(`${BASE}/api/system/upload-image`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ image: b64Data, filename: file.name })
+                });
+                const data = await res.json();
+                if (res.ok && data.path) {
+                    const hid = document.getElementById('batch-background-audio-path');
+                    if (hid) hid.value = data.path;
+                    if (ph) ph.style.display = 'none';
+                    if (st) {
+                        st.style.display = 'block';
+                        st.textContent = '✓ ' + file.name;
+                    }
+                    if (overlay) overlay.style.display = 'flex';
+                    addLog('✅ 成片配乐已上传（将覆盖各片段自带音轨）');
+                } else {
+                    addLog(`❌ 配乐上传失败: ${data.error || '未知错误'}`);
+                }
+            } catch (err) {
+                addLog(`❌ 配乐上传失败: ${err.message}`);
+            }
+        };
+        reader.onerror = () => addLog('❌ 读取音频文件失败');
+        reader.readAsDataURL(file);
+    }
+
+    function clearBatchBackgroundAudio() {
+        const hid = document.getElementById('batch-background-audio-path');
+        const inp = document.getElementById('batch-audio-input');
+        if (hid) hid.value = '';
+        if (inp) inp.value = '';
+        const ph = document.getElementById('batch-audio-placeholder');
+        const st = document.getElementById('batch-audio-status');
+        const overlay = document.getElementById('clear-batch-audio-overlay');
+        if (ph) ph.style.display = 'block';
+        if (st) {
+            st.style.display = 'none';
+            st.textContent = '';
+        }
+        if (overlay) overlay.style.display = 'none';
+        addLog('🧹 已清除成片配乐');
+    }
+
+    function syncBatchDropZoneChrome() {
+        const dropZone = document.getElementById('batch-images-drop-zone');
+        const placeholder = document.getElementById('batch-images-placeholder');
+        const stripWrap = document.getElementById('batch-thumb-strip-wrap');
+        if (batchImages.length === 0) {
+            if (dropZone) {
+                dropZone.classList.remove('has-images');
+                const mini = dropZone.querySelector('.upload-placeholder-mini');
+                if (mini) mini.remove();
+            }
+            if (placeholder) placeholder.style.display = 'block';
+            if (stripWrap) stripWrap.style.display = 'none';
+            return;
+        }
+        if (placeholder) placeholder.style.display = 'none';
+        if (dropZone) dropZone.classList.add('has-images');
+        if (stripWrap) stripWrap.style.display = 'block';
+        if (dropZone && !dropZone.querySelector('.upload-placeholder-mini')) {
+            const mini = document.createElement('div');
+            mini.className = 'upload-placeholder-mini';
+            mini.innerHTML = '<span>' + _t('batchAddMore') + '</span>';
+            dropZone.appendChild(mini);
+        }
+    }
+
+    let batchDragPlaceholderEl = null;
+    let batchPointerState = null;
+    let batchPendingPhX = null;
+    let batchPhMoveRaf = null;
+
+    function batchRemoveFloatingGhost() {
+        document.querySelectorAll('.batch-thumb-floating-ghost').forEach((n) => n.remove());
+    }
+
+    function batchCancelPhMoveRaf() {
+        if (batchPhMoveRaf != null) {
+            cancelAnimationFrame(batchPhMoveRaf);
+            batchPhMoveRaf = null;
+        }
+        batchPendingPhX = null;
+    }
+
+    function batchEnsurePlaceholder() {
+        if (batchDragPlaceholderEl && batchDragPlaceholderEl.isConnected) return batchDragPlaceholderEl;
+        const el = document.createElement('div');
+        el.className = 'batch-thumb-drop-slot';
+        el.setAttribute('aria-hidden', 'true');
+        batchDragPlaceholderEl = el;
+        return el;
+    }
+
+    function batchRemovePlaceholder() {
+        if (batchDragPlaceholderEl && batchDragPlaceholderEl.parentNode) {
+            batchDragPlaceholderEl.parentNode.removeChild(batchDragPlaceholderEl);
+        }
+    }
+
+    function batchComputeInsertIndex(container, placeholder) {
+        let t = 0;
+        for (const child of container.children) {
+            if (child === placeholder) return t;
+            if (child.classList && child.classList.contains('batch-image-wrapper')) {
+                if (!child.classList.contains('batch-thumb--source')) t++;
+            }
+        }
+        return t;
+    }
+
+    function batchMovePlaceholderFromPoint(container, clientX) {
+        const ph = batchEnsurePlaceholder();
+        const wrappers = [...container.querySelectorAll('.batch-image-wrapper')];
+        let insertBefore = null;
+        for (const w of wrappers) {
+            if (w.classList.contains('batch-thumb--source')) continue;
+            const r = w.getBoundingClientRect();
+            if (clientX < r.left + r.width / 2) {
+                insertBefore = w;
+                break;
+            }
+        }
+        if (insertBefore === null) {
+            const vis = wrappers.filter((w) => !w.classList.contains('batch-thumb--source'));
+            const last = vis[vis.length - 1];
+            if (last) {
+                if (last.nextSibling) {
+                    container.insertBefore(ph, last.nextSibling);
+                } else {
+                    container.appendChild(ph);
+                }
+            } else {
+                container.appendChild(ph);
+            }
+        } else {
+            container.insertBefore(ph, insertBefore);
+        }
+    }
+
+    function batchFlushPlaceholderMove() {
+        batchPhMoveRaf = null;
+        if (!batchPointerState || batchPendingPhX == null) return;
+        batchMovePlaceholderFromPoint(batchPointerState.container, batchPendingPhX);
+    }
+
+    function handleBatchPointerMove(e) {
+        if (!batchPointerState) return;
+        e.preventDefault();
+        const st = batchPointerState;
+        st.ghostTX = e.clientX - st.offsetX;
+        st.ghostTY = e.clientY - st.offsetY;
+        batchPendingPhX = e.clientX;
+        if (batchPhMoveRaf == null) {
+            batchPhMoveRaf = requestAnimationFrame(batchFlushPlaceholderMove);
+        }
+    }
+
+    function batchGhostFrame() {
+        const st = batchPointerState;
+        if (!st || !st.ghostEl || !st.ghostEl.isConnected) {
+            return;
+        }
+        const t = 0.42;
+        st.ghostCX += (st.ghostTX - st.ghostCX) * t;
+        st.ghostCY += (st.ghostTY - st.ghostCY) * t;
+        st.ghostEl.style.transform =
+            `translate3d(${st.ghostCX}px,${st.ghostCY}px,0) scale(1.06) rotate(-1deg)`;
+        st.ghostRaf = requestAnimationFrame(batchGhostFrame);
+    }
+
+    function batchStartGhostLoop() {
+        const st = batchPointerState;
+        if (!st || !st.ghostEl) return;
+        if (st.ghostRaf != null) cancelAnimationFrame(st.ghostRaf);
+        st.ghostRaf = requestAnimationFrame(batchGhostFrame);
+    }
+
+    function batchEndPointerDrag(e) {
+        if (!batchPointerState) return;
+        if (e.pointerId !== batchPointerState.pointerId) return;
+        const st = batchPointerState;
+
+        batchCancelPhMoveRaf();
+        if (st.ghostRaf != null) {
+            cancelAnimationFrame(st.ghostRaf);
+            st.ghostRaf = null;
+        }
+        if (st.ghostEl && st.ghostEl.parentNode) {
+            st.ghostEl.remove();
+        }
+        batchPointerState = null;
+
+        document.removeEventListener('pointermove', handleBatchPointerMove);
+        document.removeEventListener('pointerup', batchEndPointerDrag);
+        document.removeEventListener('pointercancel', batchEndPointerDrag);
+
+        try {
+            if (st.wrapperEl) st.wrapperEl.releasePointerCapture(st.pointerId);
+        } catch (_) {}
+
+        const { fromIndex, container, wrapperEl } = st;
+        container.classList.remove('is-batch-settling');
+        if (!batchDragPlaceholderEl || !batchDragPlaceholderEl.parentNode) {
+            if (wrapperEl) wrapperEl.classList.remove('batch-thumb--source');
+            renderBatchImages();
+            updateBatchSegments();
+            return;
+        }
+        const to = batchComputeInsertIndex(container, batchDragPlaceholderEl);
+        batchRemovePlaceholder();
+        if (wrapperEl) wrapperEl.classList.remove('batch-thumb--source');
+
+        if (fromIndex !== to && fromIndex >= 0 && to >= 0) {
+            const [item] = batchImages.splice(fromIndex, 1);
+            batchImages.splice(to, 0, item);
+            updateBatchSegments();
+        }
+        renderBatchImages();
+    }
+
+    function handleBatchPointerDown(e) {
+        if (batchPointerState) return;
+        if (e.button !== 0) return;
+        if (e.target.closest && e.target.closest('.batch-thumb-remove')) return;
+
+        const wrapper = e.currentTarget;
+        const container = document.getElementById('batch-images-container');
+        if (!container) return;
+
+        e.preventDefault();
+        e.stopPropagation();
+
+        const fromIndex = parseInt(wrapper.dataset.index, 10);
+        if (Number.isNaN(fromIndex)) return;
+
+        const rect = wrapper.getBoundingClientRect();
+        const offsetX = e.clientX - rect.left;
+        const offsetY = e.clientY - rect.top;
+        const startLeft = rect.left;
+        const startTop = rect.top;
+
+        const ghost = document.createElement('div');
+        ghost.className = 'batch-thumb-floating-ghost';
+        const gImg = document.createElement('img');
+        const srcImg = wrapper.querySelector('img');
+        gImg.src = srcImg ? srcImg.src : '';
+        gImg.alt = '';
+        ghost.appendChild(gImg);
+        document.body.appendChild(ghost);
+
+        batchPointerState = {
+            fromIndex,
+            pointerId: e.pointerId,
+            wrapperEl: wrapper,
+            container,
+            ghostEl: ghost,
+            offsetX,
+            offsetY,
+            ghostTX: e.clientX - offsetX,
+            ghostTY: e.clientY - offsetY,
+            ghostCX: startLeft,
+            ghostCY: startTop,
+            ghostRaf: null
+        };
+
+        ghost.style.transform =
+            `translate3d(${startLeft}px,${startTop}px,0) scale(1.06) rotate(-1deg)`;
+
+        container.classList.add('is-batch-settling');
+        wrapper.classList.add('batch-thumb--source');
+        const ph = batchEnsurePlaceholder();
+        container.insertBefore(ph, wrapper.nextSibling);
+        /* 不在 pointerdown 立刻重算槽位；双 rAF 后再恢复邻居 transition，保证先完成本帧布局再动画 */
+        requestAnimationFrame(() => {
+            requestAnimationFrame(() => {
+                container.classList.remove('is-batch-settling');
+            });
+        });
+
+        batchStartGhostLoop();
+
+        document.addEventListener('pointermove', handleBatchPointerMove, { passive: false });
+        document.addEventListener('pointerup', batchEndPointerDrag);
+        document.addEventListener('pointercancel', batchEndPointerDrag);
+
+        try {
+            wrapper.setPointerCapture(e.pointerId);
+        } catch (_) {}
+    }
+
+    function removeBatchImage(index) {
+        if (index < 0 || index >= batchImages.length) return;
+        batchImages.splice(index, 1);
+        renderBatchImages();
+        updateBatchSegments();
+    }
+
+    // 横向缩略图：Pointer 拖动排序（避免 HTML5 DnD 在 WebView/部分浏览器失效）
+    function renderBatchImages() {
+        const container = document.getElementById('batch-images-container');
+        if (!container) return;
+
+        syncBatchDropZoneChrome();
+        batchRemovePlaceholder();
+        batchCancelPhMoveRaf();
+        batchRemoveFloatingGhost();
+        batchPointerState = null;
+        container.classList.remove('is-batch-settling');
+        container.innerHTML = '';
+
+        batchImages.forEach((img, index) => {
+            const wrapper = document.createElement('div');
+            wrapper.className = 'batch-image-wrapper';
+            wrapper.dataset.index = String(index);
+            wrapper.title = _t('batchThumbDrag');
+
+            const imgWrap = document.createElement('div');
+            imgWrap.className = 'batch-thumb-img-wrap';
+            const im = document.createElement('img');
+            im.className = 'batch-thumb-img';
+            im.src = img.preview;
+            im.alt = img.name || '';
+            im.draggable = false;
+            imgWrap.appendChild(im);
+
+            const del = document.createElement('button');
+            del.type = 'button';
+            del.className = 'batch-thumb-remove';
+            del.title = _t('batchThumbRemove');
+            del.setAttribute('aria-label', _t('batchThumbRemove'));
+            del.textContent = '×';
+            del.addEventListener('pointerdown', (ev) => ev.stopPropagation());
+            del.addEventListener('click', (ev) => {
+                ev.stopPropagation();
+                removeBatchImage(index);
+            });
+
+            wrapper.appendChild(imgWrap);
+            wrapper.appendChild(del);
+
+            wrapper.addEventListener('pointerdown', handleBatchPointerDown);
+
+            container.appendChild(wrapper);
+        });
+    }
+
+    function batchWorkflowIsSingle() {
+        const r = document.querySelector('input[name="batch-workflow"]:checked');
+        return !!(r && r.value === 'single');
+    }
+
+    function onBatchWorkflowChange() {
+        updateBatchSegments();
+    }
+
+    // 更新片段设置 UI（分段模式）或单次多关键帧设置
+    function updateBatchSegments() {
+        const container = document.getElementById('batch-segments-container');
+        if (!container) return;
+        
+        if (batchImages.length < 2) {
+            container.innerHTML =
+                '<div style="color: var(--text-dim); font-size: 11px;">' +
+                escapeHtmlAttr(_t('batchNeedTwo')) +
+                '</div>';
+            return;
+        }
+
+        if (batchWorkflowIsSingle()) {
+            if (batchImages.length >= 2) captureBatchKfTimelineFromDom();
+            const n = batchImages.length;
+            const defaultTotal = 8;
+            const defaultSeg =
+                n > 1 ? (defaultTotal / (n - 1)).toFixed(1) : '4';
+            let blocks = '';
+            batchImages.forEach((img, i) => {
+                const path = img.path || '';
+                const stDef = defaultKeyframeStrengthForIndex(i, n);
+                const stStored = batchKfStrengthByPath[path];
+                const stVal = stStored !== undefined && stStored !== ''
+                    ? escapeHtmlAttr(stStored)
+                    : stDef;
+                const prev = escapeHtmlAttr(img.preview || '');
+                if (i > 0) {
+                    const j = i - 1;
+                    const sdStored = batchKfSegDurByIndex[j];
+                    const segVal =
+                        sdStored !== undefined && sdStored !== ''
+                            ? escapeHtmlAttr(sdStored)
+                            : defaultSeg;
+                    blocks += `
+                <div class="batch-kf-gap">
+                    <div class="batch-kf-gap-rail" aria-hidden="true"></div>
+                    <div class="batch-kf-gap-inner">
+                        <span class="batch-kf-gap-ix">${i}→${i + 1}</span>
+                        <label class="batch-kf-seg-field">
+                            <input type="number" class="batch-kf-seg-input" id="batch-kf-seg-dur-${j}"
+                                value="${segVal}" min="0.1" max="120" step="0.1"
+                                title="${escapeHtmlAttr(_t('batchGapInputTitle'))}"
+                                oninput="updateBatchKfTimelineDerivedUI()">
+                            <span class="batch-kf-gap-unit">${escapeHtmlAttr(_t('batchSec'))}</span>
+                        </label>
+                    </div>
+                </div>`;
+                }
+                blocks += `
+                <div class="batch-kf-kcard">
+                    <div class="batch-kf-kcard-head">
+                        <img class="batch-kf-kthumb" src="${prev}" alt="">
+                        <div class="batch-kf-kcard-titles">
+                            <span class="batch-kf-ktitle">${escapeHtmlAttr(_t('batchKfTitle'))} ${i + 1} / ${n}</span>
+                            <span class="batch-kf-anchor" id="batch-kf-anchor-label-${i}">—</span>
+                        </div>
+                    </div>
+                    <div class="batch-kf-kcard-ctrl">
+                        <label class="batch-kf-klabel">${escapeHtmlAttr(_t('batchStrength'))}
+                            <input type="number" id="batch-kf-strength-${i}" value="${stVal}" min="0.1" max="1" step="0.01"
+                                title="${escapeHtmlAttr(_t('batchStrengthTitle'))}">
+                        </label>
+                    </div>
+                </div>`;
+            });
+            container.innerHTML = `
+                <div class="batch-kf-panel" id="batch-kf-timeline-root">
+                    <div class="batch-kf-panel-hd">
+                        <div class="batch-kf-panel-title">${escapeHtmlAttr(_t('batchKfPanelTitle'))}</div>
+                        <div class="batch-kf-total-pill" title="${escapeHtmlAttr(_t('batchTotalPillTitle'))}">
+                            ${escapeHtmlAttr(_t('batchTotalDur'))} <strong id="batch-kf-total-seconds">—</strong> <span class="batch-kf-total-unit">${escapeHtmlAttr(_t('batchTotalSec'))}</span>
+                        </div>
+                    </div>
+                    <p class="batch-kf-panel-hint">${escapeHtmlAttr(_t('batchPanelHint'))}</p>
+                    <div class="batch-kf-timeline-col">
+                        ${blocks}
+                    </div>
+                </div>`;
+            updateBatchKfTimelineDerivedUI();
+            return;
+        }
+        
+        let html =
+            '<div style="font-size: 12px; font-weight: bold; margin-bottom: 10px;">' +
+            escapeHtmlAttr(_t('batchSegTitle')) +
+            '</div>';
+        
+        for (let i = 0; i < batchImages.length - 1; i++) {
+            const segPh = escapeHtmlAttr(_t('batchSegPromptPh'));
+            html += `
+                <div style="background: var(--item); border-radius: 8px; padding: 10px; margin-bottom: 10px; border: 1px solid var(--border);">
+                    <div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 8px;">
+                        <div style="display: flex; align-items: center; gap: 8px;">
+                            <img src="${batchImages[i].preview}" style="width: 40px; height: 40px; border-radius: 4px; object-fit: cover;">
+                            <span style="color: var(--accent);">→</span>
+                            <img src="${batchImages[i + 1].preview}" style="width: 40px; height: 40px; border-radius: 4px; object-fit: cover;">
+                            <span style="font-size: 11px; color: var(--text-dim);">${escapeHtmlAttr(_t('batchSegClip'))} ${i + 1}</span>
+                        </div>
+                        <div style="display: flex; align-items: center; gap: 6px;">
+                            <label style="font-size: 10px; color: var(--text-dim);">${escapeHtmlAttr(_t('batchSegDuration'))}</label>
+                            <input type="number" id="batch-segment-duration-${i}" value="5" min="1" max="30" step="1" style="width: 50px; padding: 4px; font-size: 11px;">
+                            <span style="font-size: 10px; color: var(--text-dim);">${escapeHtmlAttr(_t('batchSegSec'))}</span>
+                        </div>
+                    </div>
+                    <div>
+                        <label style="font-size: 10px;">${escapeHtmlAttr(_t('batchSegPrompt'))}</label>
+                        <textarea id="batch-segment-prompt-${i}" placeholder="${segPh}" style="width: 100%; height: 60px; padding: 6px; font-size: 11px; box-sizing: border-box; resize: vertical;"></textarea>
+                    </div>
+                </div>
+            `;
+        }
+        
+        container.innerHTML = html;
+    }
+
+    let _isGeneratingFlag = false;
+
+    // 系统状态轮询
+    async function checkStatus() {
+        try {
+            const h = await fetch(`${BASE}/health`).then(r => r.json()).catch(() => ({status: "error"}));
+            const g = await fetch(`${BASE}/api/gpu-info`).then(r => r.json()).catch(() => ({gpu_info: {}}));
+            const p = await fetch(`${BASE}/api/generation/progress`).then(r => r.json()).catch(() => ({progress: 0}));
+            const sysGpus = await fetch(`${BASE}/api/system/list-gpus`).then(r => r.json()).catch(() => ({gpus: []}));
+            
+            const activeGpu = (sysGpus.gpus || []).find(x => x.active) || (sysGpus.gpus || [])[0] || {};
+            const gpuName = activeGpu.name || g.gpu_info?.name || "GPU";
+            
+            const s = document.getElementById('sys-status');
+            const indicator = document.getElementById('sys-indicator');
+            
+            const isReady = h.status === "ok" || h.status === "ready" || h.models_loaded;
+            const backendActive = (p && p.progress > 0);
+            
+            if (_isGeneratingFlag || backendActive) {
+                s.innerText = `${gpuName}: ${_t('sysBusy')}`;
+                if(indicator) indicator.className = 'indicator-busy';
+            } else {
+                s.innerText = isReady ? `${gpuName}: ${_t('sysOnline')}` : `${gpuName}: ${_t('sysStarting')}`;
+                if(indicator) indicator.className = isReady ? 'indicator-ready' : 'indicator-offline';
+            }
+            s.style.color = "var(--text-dim)";
+
+            const vUsedMB = g.gpu_info?.vramUsed || 0;
+            const vTotalMB = activeGpu.vram_mb || g.gpu_info?.vram || 32768; 
+            const vUsedGB = vUsedMB / 1024;
+            const vTotalGB = vTotalMB / 1024;
+            
+            document.getElementById('vram-fill').style.width = (vUsedMB / vTotalMB * 100) + "%";
+            document.getElementById('vram-text').innerText = `${vUsedGB.toFixed(1)} / ${vTotalGB.toFixed(0)} GB`;
+        } catch(e) { document.getElementById('sys-status').innerText = _t('sysOffline'); }
+    }
+    setInterval(checkStatus, 1000); // 提升到 1 秒一次实时监控
+    checkStatus();
+    initDragAndDrop();
+    listGpus(); // 初始化 GPU 列表
+    // 已移除：输出目录自定义（保持后端默认路径）
+
+    updateResPreview();
+    updateBatchResPreview();
+    updateImgResPreview();
+    refreshPromptPlaceholder();
+
+    window.onUiLanguageChanged = function () {
+        updateResPreview();
+        updateBatchResPreview();
+        updateImgResPreview();
+        refreshPromptPlaceholder();
+        if (typeof currentMode !== 'undefined' && currentMode === 'batch') {
+            updateBatchSegments();
+        }
+        updateModelDropdown();
+        updateLoraDropdown();
+        updateBatchModelDropdown();
+        updateBatchLoraDropdown();
+    };
+
+    async function setOutputDir() {
+        const dir = document.getElementById('global-out-dir').value.trim();
+        localStorage.setItem('output_dir', dir);
+        try {
+            const res = await fetch(`${BASE}/api/system/set-dir`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ directory: dir })
+            });
+            if (res.ok) {
+                addLog(`✅ 存储路径更新成功! 当前路径: ${dir || _t('defaultPath')}`);
+                if (typeof fetchHistory === 'function') fetchHistory(currentHistoryPage);
+            }
+        } catch (e) {
+            addLog(`❌ 设置路径时连接异常: ${e.message}`);
+        }
+    }
+
+    async function browseOutputDir() {
+        try {
+            const res = await fetch(`${BASE}/api/system/browse-dir`);
+            const data = await res.json();
+            if (data.status === "success" && data.directory) {
+                document.getElementById('global-out-dir').value = data.directory;
+                // auto apply immediately
+                setOutputDir();
+                addLog(`📂 检测到新路径，已自动套用！`);
+            } else if (data.error) {
+                addLog(`❌ 内部系统权限拦截了弹窗: ${data.error}`);
+            }
+        } catch (e) {
+            addLog(`❌ 无法调出文件夹浏览弹窗, 请直接复制粘贴绝对路径。`);
+        }
+    }
+
+    async function getOutputDir() {
+        try {
+            const res = await fetch(`${BASE}/api/system/get-dir`);
+            const data = await res.json();
+            if (data.directory && data.directory.indexOf('LTXDesktop') === -1 && document.getElementById('global-out-dir')) {
+                document.getElementById('global-out-dir').value = data.directory;
+            }
+        } catch (e) {}
+    }
+
+    async function saveLoraDir() {
+        const input = document.getElementById('lora-dir-input');
+        const status = document.getElementById('lora-dir-status');
+        if (!input || !status) return;
+        
+        const loraDir = input.value.trim();
+        try {
+            const res = await fetch(`${BASE}/api/lora-dir`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ loraDir: loraDir })
+            });
+            const data = await res.json();
+            if (data && data.status === 'ok') {
+                status.textContent = '✓ 已保存';
+                status.style.color = '#4caf50';
+                setTimeout(() => { status.textContent = ''; }, 3000);
+            } else {
+                status.textContent = '✗ 保存失败: ' + (data.message || JSON.stringify(data));
+                status.style.color = '#f44336';
+            }
+        } catch (e) {
+            status.textContent = '✗ 保存失败: ' + e.message;
+            status.style.color = '#f44336';
+        }
+    }
+
+    async function loadLoraDir() {
+        try {
+            const res = await fetch(`${BASE}/api/lora-dir`);
+            const data = await res.json();
+            if (data && document.getElementById('lora-dir-input')) {
+                document.getElementById('lora-dir-input').value = data.loraDir || '';
+            }
+        } catch (e) {}
+    }
+
+    function switchMode(m) {
+        currentMode = m;
+        document.getElementById('tab-image').classList.toggle('active', m === 'image');
+        document.getElementById('tab-video').classList.toggle('active', m === 'video');
+        document.getElementById('tab-batch').classList.toggle('active', m === 'batch');
+        document.getElementById('tab-upscale').classList.toggle('active', m === 'upscale');
+        
+        document.getElementById('image-opts').style.display = m === 'image' ? 'block' : 'none';
+        document.getElementById('video-opts').style.display = m === 'video' ? 'block' : 'none';
+        document.getElementById('batch-opts').style.display = m === 'batch' ? 'block' : 'none';
+        document.getElementById('upscale-opts').style.display = m === 'upscale' ? 'block' : 'none';
+        if (m === 'batch') updateBatchSegments();
+
+        // 如果切到图像模式，隐藏���示词框外的其他东西
+        refreshPromptPlaceholder();
+    }
+
+    function refreshPromptPlaceholder() {
+        const pe = document.getElementById('prompt');
+        if (!pe) return;
+        pe.placeholder =
+            currentMode === 'upscale' ? _t('promptPlaceholderUpscale') : _t('promptPlaceholder');
+    }
+
+    function showGeneratingView() {
+        if (!_isGeneratingFlag) return;
+        const resImg = document.getElementById('res-img');
+        const videoWrapper = document.getElementById('video-wrapper');
+        if (resImg) resImg.style.display = "none";
+        if (videoWrapper) videoWrapper.style.display = "none";
+        if (player) {
+            try { player.stop(); } catch(_) {}
+        } else {
+            const vid = document.getElementById('res-video');
+            if (vid) { vid.pause(); vid.removeAttribute('src'); vid.load(); }
+        }
+        const loadingTxt = document.getElementById('loading-txt');
+        if (loadingTxt) loadingTxt.style.display = "flex";
+    }
+
+    async function run() {
+        // 防止重复点击（_isGeneratingFlag 比 btn.disabled 更可靠）
+        if (_isGeneratingFlag) {
+            addLog(_t('warnGenerating'));
+            return;
+        }
+
+        const btn = document.getElementById('mainBtn');
+        const promptEl = document.getElementById('prompt');
+        const prompt = promptEl ? promptEl.value.trim() : '';
+
+        function batchHasUsablePrompt() {
+            if (prompt) return true;
+            const c = document.getElementById('batch-common-prompt')?.value?.trim();
+            if (c) return true;
+            if (typeof batchWorkflowIsSingle === 'function' && batchWorkflowIsSingle()) {
+                return false;
+            }
+            if (batchImages.length < 2) return false;
+            for (let i = 0; i < batchImages.length - 1; i++) {
+                if (document.getElementById(`batch-segment-prompt-${i}`)?.value?.trim()) return true;
+            }
+            return false;
+        }
+
+        if (currentMode !== 'upscale') {
+            if (currentMode === 'batch') {
+                if (!batchHasUsablePrompt()) {
+                    addLog(_t('warnBatchPrompt'));
+                    return;
+                }
+            } else if (!prompt) {
+                addLog(_t('warnNeedPrompt'));
+                return;
+            }
+        }
+
+        if (!btn) {
+            console.error('mainBtn not found');
+            return;
+        }
+
+        // 先设置标志 + 禁用按钮，然后用顶层 try/finally 保证一定能解锁
+        _isGeneratingFlag = true;
+        btn.disabled = true;
+
+        try {
+            // 安全地操作 UI 元素（改用 if 判空，防止 Plyr 接管后 getElementById 返回 null）
+            const loader = document.getElementById('loading-txt');
+            const resImg = document.getElementById('res-img');
+            const resVideo = document.getElementById('res-video');
+
+            if (loader) {
+                loader.style.display = "flex";
+                loader.style.flexDirection = "column";
+                loader.style.alignItems = "center";
+                loader.style.gap = "12px";
+                loader.innerHTML = `
+                    <div class="spinner" style="width:48px;height:48px;border-width:4px;color:var(--accent);"></div>
+                    <div id="loader-step-text" style="font-size:13px;font-weight:700;color:var(--text-sub);">${escapeHtmlAttr(_t('loaderGpuAlloc'))}</div>
+                `;
+            }
+            if (resImg) resImg.style.display = "none";
+            // 必须隐藏整个 video-wrapper（Plyr 外层容器），否则第二次生成时视频会与 spinner 叠加
+            const videoWrapper = document.getElementById('video-wrapper');
+            if (videoWrapper) videoWrapper.style.display = "none";
+            if (player) { try { player.stop(); } catch(_) {} }
+            else if (resVideo) { resVideo.pause?.(); resVideo.removeAttribute?.('src'); }
+
+        checkStatus();
+
+            // 重置后端状态锁（非关键，失败不影响主流程）
+            try { await fetch(`${BASE}/api/system/reset-state`, { method: 'POST' }); } catch(_) {}
+
+            startProgressPolling();
+
+            // ---- 新增：在历史记录区插入「正在渲染」缩略图卡片 ----
+            const historyContainer = document.getElementById('history-container');
+            if (historyContainer) {
+                const old = document.getElementById('current-loading-card');
+                if (old) old.remove();
+                const loadingCard = document.createElement('div');
+                loadingCard.className = 'history-card loading-card';
+                loadingCard.id = 'current-loading-card';
+                loadingCard.onclick = showGeneratingView;
+                loadingCard.innerHTML = `
+                    <div class="spinner"></div>
+                    <div id="loading-card-step" style="font-size:10px;color:var(--text-dim);margin-top:4px;">等待中...</div>
+                `;
+                historyContainer.prepend(loadingCard);
+            }
+
+            // ---- 构建请求 ----
+            let endpoint, payload;
+            if (currentMode === 'image') {
+                const w = parseInt(document.getElementById('img-w').value);
+                const h = parseInt(document.getElementById('img-h').value);
+                endpoint = '/api/generate-image';
+                payload = {
+                    prompt, width: w, height: h,
+                    numSteps: parseInt(document.getElementById('img-steps').value),
+                    numImages: 1
+                };
+                addLog(`正在发起图像渲染: ${w}x${h}, Steps: ${payload.numSteps}`);
+
+            } else if (currentMode === 'video') {
+                const res = updateResPreview();
+                const dur = parseFloat(document.getElementById('vid-duration').value);
+                const fps = document.getElementById('vid-fps').value;
+                if (dur > 20) addLog(_t('warnVideoLong').replace('{n}', String(dur)));
+
+                const audio = document.getElementById('vid-audio').checked ? "true" : "false";
+                const audioPath = document.getElementById('uploaded-audio-path').value;
+                const startFramePathValue = document.getElementById('start-frame-path').value;
+                const endFramePathValue = document.getElementById('end-frame-path').value;
+
+                let finalImagePath = null, finalStartFramePath = null, finalEndFramePath = null;
+                if (startFramePathValue && endFramePathValue) {
+                    finalStartFramePath = startFramePathValue;
+                    finalEndFramePath = endFramePathValue;
+                } else if (startFramePathValue) {
+                    finalImagePath = startFramePathValue;
+                }
+
+                endpoint = '/api/generate';
+                const modelSelect = document.getElementById('vid-model');
+                const loraSelect = document.getElementById('vid-lora');
+                const loraStrengthInput = document.getElementById('lora-strength');
+                const modelPath = modelSelect ? modelSelect.value : '';
+                const loraPath = loraSelect ? loraSelect.value : '';
+                const loraStrength = loraStrengthInput ? (parseFloat(loraStrengthInput.value) || 1.0) : 1.0;
+                console.log("modelPath:", modelPath);
+                console.log("loraPath:", loraPath);
+                console.log("loraStrength:", loraStrength);
+                payload = {
+                    prompt, resolution: res, model: "ltx-2",
+                    cameraMotion: document.getElementById('vid-motion').value,
+                    negativePrompt: "low quality, blurry, noisy, static noise, distorted",
+                    duration: String(dur), fps, audio,
+                    imagePath: finalImagePath,
+                    audioPath: audioPath || null,
+                    startFramePath: finalStartFramePath,
+                    endFramePath: finalEndFramePath,
+                    aspectRatio: document.getElementById('vid-ratio').value,
+                    modelPath: modelPath || null,
+                    loraPath: loraPath || null,
+                    loraStrength: loraStrength,
+                };
+                addLog(`正在发起视频渲染: ${res}, 时长: ${dur}s, FPS: ${fps}, 模型: ${modelPath ? modelPath.split(/[/\\]/).pop() : _t('modelDefaultLabel')}, LoRA: ${loraPath ? loraPath.split(/[/\\]/).pop() : _t('loraNoneLabel')}`);
+
+            } else if (currentMode === 'upscale') {
+                const videoPath = document.getElementById('upscale-video-path').value;
+                const targetRes = document.getElementById('upscale-res').value;
+                if (!videoPath) throw new Error(_t('errUpscaleNoVideo'));
+                endpoint = '/api/system/upscale-video';
+                payload = { video_path: videoPath, resolution: targetRes, prompt: "high quality, detailed, 4k", strength: 0.7 };
+                addLog(`正在发起视频超分: 目标 ${targetRes}`);
+            } else if (currentMode === 'batch') {
+                const res = updateBatchResPreview();
+                const commonPromptEl = document.getElementById('batch-common-prompt');
+                const commonPrompt = commonPromptEl ? commonPromptEl.value : '';
+                const modelSelect = document.getElementById('batch-model');
+                const loraSelect = document.getElementById('batch-lora');
+                const loraStrengthInput = document.getElementById('batch-lora-strength');
+                const modelPath = modelSelect ? modelSelect.value : '';
+                const loraPath = loraSelect ? loraSelect.value : '';
+                const loraStrength = loraStrengthInput ? (parseFloat(loraStrengthInput.value) || 1.2) : 1.2;
+                
+                if (batchImages.length < 2) {
+                    throw new Error(_t('errBatchMinImages'));
+                }
+
+                if (batchWorkflowIsSingle()) {
+                    captureBatchKfTimelineFromDom();
+                    const fps = document.getElementById('vid-fps').value;
+                    const parts = [prompt.trim(), commonPrompt.trim()].filter(Boolean);
+                    const combinedPrompt = parts.join(', ');
+                    if (!combinedPrompt) {
+                        throw new Error(_t('errSingleKfPrompt'));
+                    }
+                    const nKf = batchImages.length;
+                    const minSeg = 0.1;
+                    const segDurs = [];
+                    for (let j = 0; j < nKf - 1; j++) {
+                        let v = parseFloat(document.getElementById(`batch-kf-seg-dur-${j}`)?.value);
+                        if (!Number.isFinite(v) || v < minSeg) v = minSeg;
+                        segDurs.push(v);
+                    }
+                    const sumSec = segDurs.reduce((a, b) => a + b, 0);
+                    const dur = Math.max(2, Math.ceil(sumSec - 1e-9));
+                    const times = [0];
+                    let acc = 0;
+                    for (let j = 0; j < nKf - 1; j++) {
+                        acc += segDurs[j];
+                        times.push(acc);
+                    }
+                    const strengths = [];
+                    for (let i = 0; i < nKf; i++) {
+                        const sEl = document.getElementById(`batch-kf-strength-${i}`);
+                        let sv = parseFloat(sEl?.value);
+                        if (!Number.isFinite(sv)) {
+                            sv = parseFloat(defaultKeyframeStrengthForIndex(i, nKf));
+                        }
+                        if (!Number.isFinite(sv)) sv = 1;
+                        sv = Math.max(0.1, Math.min(1.0, sv));
+                        strengths.push(sv);
+                    }
+                    endpoint = '/api/generate';
+                    payload = {
+                        prompt: combinedPrompt,
+                        resolution: res,
+                        model: "ltx-2",
+                        cameraMotion: document.getElementById('vid-motion').value,
+                        negativePrompt: "low quality, blurry, noisy, static noise, distorted",
+                        duration: String(dur),
+                        fps,
+                        audio: "false",
+                        imagePath: null,
+                        audioPath: null,
+                        startFramePath: null,
+                        endFramePath: null,
+                        keyframePaths: batchImages.map((b) => b.path),
+                        keyframeStrengths: strengths,
+                        keyframeTimes: times,
+                        aspectRatio: document.getElementById('batch-ratio').value,
+                        modelPath: modelPath || null,
+                        loraPath: loraPath || null,
+                        loraStrength: loraStrength,
+                    };
+                    addLog(
+                        `单次多关键帧: ${nKf} 锚点, 轴长合计 ${sumSec.toFixed(1)}s → 请求时长 ${dur}s, ${res}, FPS ${fps}`
+                    );
+                } else {
+                    const segments = [];
+                    for (let i = 0; i < batchImages.length - 1; i++) {
+                        const duration = parseFloat(document.getElementById(`batch-segment-duration-${i}`)?.value || 5);
+                        const segmentPrompt = document.getElementById(`batch-segment-prompt-${i}`)?.value || '';
+                        const segParts = [prompt.trim(), commonPrompt.trim(), segmentPrompt.trim()].filter(Boolean);
+                        const combinedSegPrompt = segParts.join(', ');
+                        segments.push({
+                            startImage: batchImages[i].path,
+                            endImage: batchImages[i + 1].path,
+                            duration: duration,
+                            prompt: combinedSegPrompt
+                        });
+                    }
+
+                    endpoint = '/api/generate-batch';
+                    const bgAudioEl = document.getElementById('batch-background-audio-path');
+                    const backgroundAudioPath = (bgAudioEl && bgAudioEl.value) ? bgAudioEl.value.trim() : null;
+                    payload = {
+                        segments: segments,
+                        resolution: res,
+                        model: "ltx-2",
+                        aspectRatio: document.getElementById('batch-ratio').value,
+                        modelPath: modelPath || null,
+                        loraPath: loraPath || null,
+                        loraStrength: loraStrength,
+                        negativePrompt: "low quality, blurry, noisy, static noise, distorted",
+                        backgroundAudioPath: backgroundAudioPath || null
+                    };
+                    addLog(`分段拼接: ${segments.length} 段, ${res}${backgroundAudioPath ? '，含统一配乐' : ''}`);
+                }
+            }
+
+            // ---- 发��请求 ----
+            const res = await fetch(BASE + endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload)
+            });
+            const data = await res.json();
+            if (!res.ok) {
+                const errMsg = data.error || data.detail || "API 拒绝了请求";
+                throw new Error(typeof errMsg === 'string' ? errMsg : JSON.stringify(errMsg));
+            }
+
+            // ---- 显示结果 ----
+            const rawPath = data.image_paths ? data.image_paths[0] : data.video_path;
+            if (rawPath) {
+                try { displayOutput(rawPath); } catch (dispErr) { addLog(`⚠️ 播放器显示异常: ${dispErr.message}`); }
+            }
+
+            // 强制刷新历史记录（不依赖 isLoadingHistory 标志，确保新生成的视频立即显示）
+            setTimeout(() => {
+                isLoadingHistory = false; // 强制重置状态
+                if (typeof fetchHistory === 'function') fetchHistory(1);
+            }, 500);
+
+        } catch (e) {
+            const errText = e && e.message ? e.message : String(e);
+            addLog(`❌ 渲染中断: ${errText}`);
+            const loader = document.getElementById('loading-txt');
+            if (loader) {
+                loader.style.display = 'flex';
+                loader.textContent = '';
+                const span = document.createElement('span');
+                span.style.cssText = 'color:var(--text-sub);font-size:13px;padding:12px;text-align:center;';
+                span.textContent = `渲染失败：${errText}`;
+                loader.appendChild(span);
+            }
+
+        } finally {
+            // ✅ 无论发生什么，这里一定执行，确保按钮永远可以再次点击
+            _isGeneratingFlag = false;
+            btn.disabled = false;
+            stopProgressPolling();
+            checkStatus();
+            // 生成完毕后自动释放显存（不 await 避免阻塞 UI 解锁）
+            setTimeout(() => { clearGpu(); }, 500);
+        }
+    }
+
+    async function clearGpu() {
+        const btn = document.getElementById('clearGpuBtn');
+        btn.disabled = true;
+        btn.innerText = _t('clearingVram');
+        try {
+            const res = await fetch(`${BASE}/api/system/clear-gpu`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' }
+            });
+            const data = await res.json();
+            if (res.ok) {
+                addLog(`🧹 显存清理成功: ${data.message}`);
+                // 立即触发状态刷新
+                checkStatus();
+                setTimeout(checkStatus, 1000); 
+            } else {
+                const errMsg = data.error || data.detail || "后端未实现此接口 (404)";
+                throw new Error(errMsg);
+            }
+        } catch(e) {
+            addLog(`❌ 清理显存失败: ${e.message}`);
+        } finally {
+            btn.disabled = false;
+            btn.innerText = _t('clearVram');
+        }
+    }
+
+    async function listGpus() {
+        try {
+            const res = await fetch(`${BASE}/api/system/list-gpus`);
+            const data = await res.json();
+            if (res.ok && data.gpus) {
+                const selector = document.getElementById('gpu-selector');
+                selector.innerHTML = data.gpus.map(g => 
+                    `<option value="${g.id}" ${g.active ? 'selected' : ''}>GPU ${g.id}: ${g.name} (${g.vram})</option>`
+                ).join('');
+                
+                // 更新当前显示的 GPU 名称
+                const activeGpu = data.gpus.find(g => g.active);
+                if (activeGpu) document.getElementById('gpu-name').innerText = activeGpu.name;
+            }
+        } catch (e) {
+            console.error("Failed to list GPUs", e);
+        }
+    }
+
+    async function switchGpu(id) {
+        if (!id) return;
+        addLog(`🔄 正在切换到 GPU ${id}...`);
+        try {
+            const res = await fetch(`${BASE}/api/system/switch-gpu`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ gpu_id: parseInt(id) })
+            });
+            const data = await res.json();
+            if (res.ok) {
+                addLog(`✅ 已成功切换到 GPU ${id}，模型将重新加载。`);
+                listGpus(); // 重新获取列表以同步状态
+                setTimeout(checkStatus, 1000);
+            } else {
+                throw new Error(data.error || "切换失败");
+            }
+        } catch (e) {
+            addLog(`❌ GPU 切换失败: ${e.message}`);
+        }
+    }
+
+    function startProgressPolling() {
+        if (pollInterval) clearInterval(pollInterval);
+        pollInterval = setInterval(async () => {
+            try {
+                const res = await fetch(`${BASE}/api/generation/progress`);
+                const d = await res.json();
+                if (d.progress > 0) {
+                    const ph = String(d.phase || 'inference');
+                    const phaseKey = 'phase_' + ph;
+                    let phaseStr = _t(phaseKey);
+                    if (phaseStr === phaseKey) phaseStr = ph;
+
+                    let stepLabel;
+                    if (d.current_step !== undefined && d.current_step !== null && d.total_steps) {
+                        stepLabel = `${d.current_step}/${d.total_steps} ${_t('progressStepUnit')}`;
+                    } else {
+                        stepLabel = `${d.progress}%`;
+                    }
+
+                    document.getElementById('progress-fill').style.width = d.progress + "%";
+                    const loaderStep = document.getElementById('loader-step-text');
+                    const busyLine = `${_t('gpuBusyPrefix')}: ${stepLabel} [${phaseStr}]`;
+                    if (loaderStep) loaderStep.innerText = busyLine;
+                    else {
+                        const loadingTxt = document.getElementById('loading-txt');
+                        if (loadingTxt) loadingTxt.innerText = busyLine;
+                    }
+
+                    // 同步更新历史缩略图卡片上的进度文字
+                    const cardStep = document.getElementById('loading-card-step');
+                    if (cardStep) cardStep.innerText = stepLabel;
+                }
+            } catch(e) {}
+        }, 1000);
+    }
+
+    function stopProgressPolling() {
+        clearInterval(pollInterval);
+        pollInterval = null;
+        document.getElementById('progress-fill').style.width = "0%";
+        // 移除渲染中的卡片（生成已结束）
+        const lc = document.getElementById('current-loading-card');
+        if (lc) lc.remove();
+    }
+
+    function displayOutput(fileOrPath) {
+        const img = document.getElementById('res-img');
+        const vid = document.getElementById('res-video');
+        const loader = document.getElementById('loading-txt');
+        
+        // 关键BUG修复：切换前强制清除并停止现有视频和声音，避免后台继续播放
+        if(player) {
+            player.stop();
+        } else {
+            vid.pause();
+            vid.removeAttribute('src');
+            vid.load();
+        }
+        
+        let url = "";
+        let fileName = fileOrPath;
+        if (fileOrPath.indexOf('\\') !== -1 || fileOrPath.indexOf('/') !== -1) {
+            url = `${BASE}/api/system/file?path=${encodeURIComponent(fileOrPath)}&t=${Date.now()}`;
+            fileName = fileOrPath.split(/[\\/]/).pop();
+        } else {
+            const outInput = document.getElementById('global-out-dir');
+            const globalDir = outInput ? outInput.value.replace(/\\/g, '/').replace(/\/$/, '') : "";
+            if (globalDir && globalDir !== "") {
+                url = `${BASE}/api/system/file?path=${encodeURIComponent(globalDir + '/' + fileOrPath)}&t=${Date.now()}`;
+            } else {
+                url = `${BASE}/outputs/${fileOrPath}?t=${Date.now()}`;
+            }
+        }
+
+        loader.style.display = "none";
+        if (currentMode === 'image') {
+            img.src = url;
+            img.style.display = "block";
+            addLog(`✅ 图像渲染成功: ${fileName}`);
+        } else {
+            document.getElementById('video-wrapper').style.display = "flex";
+            
+            if(player) {
+                player.source = {
+                    type: 'video',
+                    sources: [{ src: url, type: 'video/mp4' }]
+                };
+                player.play();
+            } else {
+                vid.src = url;
+            }
+            addLog(`✅ 视频渲染成功: ${fileName}`);
+        }
+    }
+
+
+
+    function addLog(msg) {
+        const log = document.getElementById('log');
+        if (!log) {
+            console.log('[LTX]', msg);
+            return;
+        }
+        const time = new Date().toLocaleTimeString();
+        log.innerHTML += `<div style="margin-bottom:5px"> <span style="color:var(--text-dim)">[${time}]</span> ${msg}</div>`;
+        log.scrollTop = log.scrollHeight;
+    }
+
+
+// Force switch to video mode on load
+window.addEventListener('DOMContentLoaded', () => switchMode('video'));
+
+
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    let currentHistoryPage = 1;
+    let isLoadingHistory = false;
+    /** 与上次成功渲染一致时，silent 轮询跳过整表 innerHTML，避免缩略图周期性重新加载 */
+    let _historyListFingerprint = '';
+
+    function switchLibTab(tab) {
+        document.getElementById('log-container').style.display = tab === 'log' ? 'flex' : 'none';
+        const hw = document.getElementById('history-wrapper');
+        if (hw) hw.style.display = tab === 'history' ? 'block' : 'none';
+        
+        document.getElementById('tab-log').style.color = tab === 'log' ? 'var(--accent)' : 'var(--text-dim)';
+        document.getElementById('tab-log').style.borderColor = tab === 'log' ? 'var(--accent)' : 'transparent';
+        
+        document.getElementById('tab-history').style.color = tab === 'history' ? 'var(--accent)' : 'var(--text-dim)';
+        document.getElementById('tab-history').style.borderColor = tab === 'history' ? 'var(--accent)' : 'transparent';
+        
+        if (tab === 'history') {
+            fetchHistory();
+        }
+    }
+
+    async function fetchHistory(isFirstLoad = false, silent = false) {
+        if (isLoadingHistory) return;
+        isLoadingHistory = true;
+        
+        try {
+            // 加载所有历史，不分页
+            const res = await fetch(`${BASE}/api/system/history?page=1&limit=10000`);
+            if (!res.ok) {
+                isLoadingHistory = false;
+                return;
+            }
+            const data = await res.json();
+
+            const validHistory = (data.history || []).filter(item => item && item.filename);
+            const fingerprint = validHistory.length === 0
+                ? '__empty__'
+                : validHistory.map(h => `${h.type}|${h.filename}`).join('\0');
+
+            if (silent && fingerprint === _historyListFingerprint) {
+                return;
+            }
+
+            const container = document.getElementById('history-container');
+            if (!container) {
+                return;
+            }
+
+            let loadingCardHtml = "";
+            const lc = document.getElementById('current-loading-card');
+            if (lc && _isGeneratingFlag) {
+                loadingCardHtml = lc.outerHTML;
+            }
+
+            if (validHistory.length === 0) {
+                container.innerHTML = loadingCardHtml;
+                const newLcEmpty = document.getElementById('current-loading-card');
+                if (newLcEmpty) newLcEmpty.onclick = showGeneratingView;
+                _historyListFingerprint = fingerprint;
+                return;
+            }
+
+            container.innerHTML = loadingCardHtml;
+
+            const outInput = document.getElementById('global-out-dir');
+            const globalDir = outInput ? outInput.value.replace(/\\/g, '/').replace(/\/$/, '') : "";
+
+            const cardsHtml = validHistory.map((item, index) => {
+                    const url = (globalDir && globalDir !== "") 
+                        ? `${BASE}/api/system/file?path=${encodeURIComponent(globalDir + '/' + item.filename)}` 
+                        : `${BASE}/outputs/${item.filename}`;
+                        
+                    const safeFilename = item.filename.replace(/'/g, "\\'").replace(/"/g, '\\"');
+                    const media = item.type === 'video' 
+                        ? `<video data-src="${url}#t=0.001" class="lazy-load history-thumb-media" muted loop preload="none" playsinline onmouseover="if(this.readyState >= 2) this.play()" onmouseout="this.pause()" style="pointer-events: none; object-fit: cover; width: 100%; height: 100%;"></video>` 
+                        : `<img data-src="${url}" class="lazy-load history-thumb-media" alt="" style="object-fit: cover; width: 100%; height: 100%;">`;
+                    return `<div class="history-card" onclick="displayHistoryOutput('${safeFilename}', '${item.type}')">
+                                <div class="history-type-badge">${item.type === 'video' ? '🎬 VID' : '🎨 IMG'}</div>
+                                <button class="history-delete-btn" onclick="event.stopPropagation(); deleteHistoryItem('${safeFilename}', '${item.type}', this)">✕</button>
+                                ${media}
+                            </div>`;
+            }).join('');
+
+            container.insertAdjacentHTML('beforeend', cardsHtml);
+
+            // 重新绑定loading card点击事件
+            const newLc = document.getElementById('current-loading-card');
+            if (newLc) newLc.onclick = showGeneratingView;
+
+            // 加载可见的图片
+            loadVisibleImages();
+            _historyListFingerprint = fingerprint;
+        } catch(e) {
+            console.error("Failed to load history", e);
+        } finally {
+            isLoadingHistory = false;
+        }
+    }
+    
+    async function deleteHistoryItem(filename, type, btn) {
+        if (!confirm(`确定要删除 "${filename}" 吗？`)) return;
+        
+        try {
+            const res = await fetch(`${BASE}/api/system/delete-file`, {
+                method: 'POST',
+                headers: {'Content-Type': 'application/json'},
+                body: JSON.stringify({filename: filename, type: type})
+            });
+            
+            if (res.ok) {
+                // 删除成功后移除元素
+                const card = btn.closest('.history-card');
+                if (card) {
+                    card.remove();
+                }
+            } else {
+                alert('删除失败');
+            }
+        } catch(e) {
+            console.error('Delete failed', e);
+            alert('删除失败');
+        }
+    }
+
+    function loadVisibleImages() {
+        const hw = document.getElementById('history-wrapper');
+        if (!hw) return;
+        
+        const lazyMedias = document.querySelectorAll('#history-container .lazy-load');
+        
+        // 每次只加载3个媒体元素（图片或视频）
+        let loadedCount = 0;
+        lazyMedias.forEach(media => {
+            if (loadedCount >= 3) return;
+            
+            const src = media.dataset.src;
+            if (!src) return;
+            
+            // 检查是否在可见区域附近
+            const rect = media.getBoundingClientRect();
+            const containerRect = hw.getBoundingClientRect();
+            
+            if (rect.top < containerRect.bottom + 300 && rect.bottom > containerRect.top - 100) {
+                let revealed = false;
+                let thumbRevealTimer;
+                const revealThumb = () => {
+                    if (revealed) return;
+                    revealed = true;
+                    if (thumbRevealTimer) clearTimeout(thumbRevealTimer);
+                    media.classList.add('history-thumb-ready');
+                };
+                thumbRevealTimer = setTimeout(revealThumb, 4000);
+
+                if (media.tagName === 'VIDEO') {
+                    media.addEventListener('loadeddata', revealThumb, { once: true });
+                    media.addEventListener('error', revealThumb, { once: true });
+                } else {
+                    media.addEventListener('load', revealThumb, { once: true });
+                    media.addEventListener('error', revealThumb, { once: true });
+                }
+
+                media.src = src;
+                media.classList.remove('lazy-load');
+
+                if (media.tagName === 'VIDEO') {
+                    media.preload = 'metadata';
+                    if (media.readyState >= 2) revealThumb();
+                } else if (media.complete && media.naturalWidth > 0) {
+                    revealThumb();
+                }
+
+                loadedCount++;
+            }
+        });
+        
+        // 继续检查直到没有更多媒体需要加载
+        if (loadedCount > 0) {
+            setTimeout(loadVisibleImages, 100);
+        }
+    }
+
+    // 监听history-wrapper的滚动事件来懒加载
+    function initHistoryScrollListener() {
+        const hw = document.getElementById('history-wrapper');
+        if (!hw) return;
+        
+        let scrollTimeout;
+        hw.addEventListener('scroll', () => {
+            if (scrollTimeout) clearTimeout(scrollTimeout);
+            scrollTimeout = setTimeout(() => {
+                loadVisibleImages();
+            }, 100);
+        });
+    }
+
+    // 页面加载时初始化滚动监听
+    window.addEventListener('DOMContentLoaded', () => {
+        setTimeout(initHistoryScrollListener, 500);
+    });
+
+    function displayHistoryOutput(file, type) {
+        document.getElementById('res-img').style.display = 'none';
+        document.getElementById('video-wrapper').style.display = 'none';
+
+        const mode = type === 'video' ? 'video' : 'image';
+        switchMode(mode);
+        displayOutput(file);
+    }
+    
+    window.addEventListener('DOMContentLoaded', () => {
+        // Initialize Plyr Custom Video Component
+        if(window.Plyr) {
+            player = new Plyr('#res-video', {
+                controls: [
+                    'play-large', 'play', 'progress', 'current-time', 
+                    'mute', 'volume', 'fullscreen'
+                ],
+                settings: [],
+                loop: { active: true },
+                autoplay: true
+            });
+        }
+        
+        // Fetch current directory context to show in UI
+        fetch(`${BASE}/api/system/get-dir`)
+            .then((res) => res.json())
+            .then((data) => {
+                if (data && data.directory) {
+                    const outInput = document.getElementById('global-out-dir');
+                    if (outInput) outInput.value = data.directory;
+                }
+            })
+            .catch((e) => console.error(e))
+            .finally(() => {
+                /* 先同步输出目录再拉历史，避免短时间内两次 fetchHistory 整表重绘导致缩略图闪两下 */
+                switchLibTab('history');
+            });
+
+        // Load LoRA dir from settings
+        loadLoraDir();
+
+        let historyRefreshInterval = null;
+        function startHistoryAutoRefresh() {
+            if (historyRefreshInterval) return;
+            historyRefreshInterval = setInterval(() => {
+                const hc = document.getElementById('history-container');
+                if (hc && hc.offsetParent !== null && !_isGeneratingFlag) {
+                    fetchHistory(1, true);
+                }
+            }, 5000);
+        }
+        startHistoryAutoRefresh();
+    });
+
+
+async function saveVramLimit() {
+    const lim = document.getElementById("vram-limit-input").value;
+    const status = document.getElementById("vram-limit-status");
+    status.textContent = "保存中...";
+    try {
+        const res = await fetch(`${BASE}/api/vram-limit`, {
+            method: "POST", headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ vramLimit: lim })
+        });
+        const d = await res.json();
+        if (d.status === 'ok') {
+            status.textContent = "保存成功";
+            status.style.color = '#4caf50';
+        } else throw new Error(d.message || "Unknown error");
+    } catch (e) {
+        status.textContent = e.message;
+        status.style.color = '#f44336';
+    }
+}
+async function fetchVramLimit() {
+    try {
+        const res = await fetch(`${BASE}/api/vram-limit`);
+        const d = await res.json();
+        if (d.vramLimit !== undefined && d.vramLimit !== null) {
+            document.getElementById("vram-limit-input").value = d.vramLimit;
+        }
+    } catch (e) {}
+}
+try { fetchVramLimit(); } catch(e) {}
+

LTX2.3-1.0.4/main.py

@@ -0,0 +1,264 @@
+import os
+import sys
+import subprocess
+import threading
+import time
+import socket
+import logging
+from fastapi import FastAPI
+from fastapi.responses import FileResponse
+from fastapi.staticfiles import StaticFiles
+import uvicorn
+
+# ============================================================
+# 配置区 (动态路径适配与补丁挂载)
+# ============================================================
+def resolve_ltx_path():
+    import glob, tempfile, subprocess
+    sc_dir = os.path.join(os.getcwd(), "LTX_Shortcut")
+    os.makedirs(sc_dir, exist_ok=True)
+    lnk_files = glob.glob(os.path.join(sc_dir, "*.lnk"))
+    if not lnk_files:
+        print("\033[91m[ERROR] 未在 LTX_Shortcut 文件夹中找到快捷方式！\n请打开程序目录下的 LTX_Shortcut 文件夹，并将官方 LTX Desktop 的快捷方式复制进去后重试。\033[0m")
+        sys.exit(1)
+        
+    lnk_path = lnk_files[0]
+    # 使用 VBScript 解析快捷方式，兼容所有 Windows 系统
+    vbs_code = f'''Set sh = CreateObject("WScript.Shell")\nSet obj = sh.CreateShortcut("{os.path.abspath(lnk_path)}")\nWScript.Echo obj.TargetPath'''
+    fd, vbs_path = tempfile.mkstemp(suffix='.vbs')
+    with os.fdopen(fd, 'w') as f:
+        f.write(vbs_code)
+    try:
+        out = subprocess.check_output(['cscript', '//nologo', vbs_path], stderr=subprocess.STDOUT)
+        target_exe = out.decode('ansi').strip()
+    finally:
+        os.remove(vbs_path)
+        
+    if not target_exe or not os.path.exists(target_exe):
+        # 如果快捷方式解析失败，或者解析出来的是朋友电脑的路径（当前电脑不存在），自动全盘搜索默认路径
+        default_paths = [
+            os.path.join(os.environ.get("LOCALAPPDATA", ""), r"Programs\LTX Desktop\LTX Desktop.exe"),
+            r"C:\Program Files\LTX Desktop\LTX Desktop.exe",
+            r"D:\Program Files\LTX Desktop\LTX Desktop.exe",
+            r"E:\Program Files\LTX Desktop\LTX Desktop.exe"
+        ]
+        found = False
+        for p in default_paths:
+            if os.path.exists(p):
+                target_exe = p
+                print(f"\033[96m[INFO] 自动检测到 LTX 原版安装路径: {p}\033[0m")
+                found = True
+                break
+        
+        if not found:
+            print(f"\033[91m[ERROR] 未能找到原版 LTX Desktop 的安装路径！\033[0m")
+            print("请清理 LTX_Shortcut 文件夹，并将您当前电脑上真正的原版快捷方式重贴复制进去。")
+            sys.exit(1)
+        
+    return os.path.dirname(target_exe)
+
+USER_PROFILE = os.path.expanduser("~")
+PYTHON_EXE = os.path.join(USER_PROFILE, r"AppData\Local\LTXDesktop\python\python.exe")
+DATA_DIR = os.path.join(USER_PROFILE, r"AppData\Local\LTXDesktop")
+
+# 1. 动态获取主安装路径
+LTX_INSTALL_DIR = resolve_ltx_path()
+BACKEND_DIR = os.path.join(LTX_INSTALL_DIR, r"resources\backend")
+UI_FILE_NAME = "UI/index.html"
+
+# 环境致命检测：如果官方 Python 还没解压释放，立刻强制中断整个程序
+if not os.path.exists(PYTHON_EXE):
+    print(f"\n\033[1;41m [致命错误] 您的电脑上尚未配置好 LTX 的官方渲染核心框架！ \033[0m")
+    print(f"\033[93m此应用仅是 UI 图形控制台，必需依赖原版软件环境才能生成。在 ({PYTHON_EXE}) 未找到运行引擎。\n")
+    print(">> 解决方案：\n1. 请先在您的电脑上正常安装【LTX Desktop 官方原版软件】。")
+    print("2. 必需：双击打开运行一次原版软件！（运行后原版软件会在后台自动释放环境）")
+    print("3. 把原版软件的快捷方式复制到本文档的 LTX_Shortcut 文件夹里面。")
+    print("4. 全部完成后，再重新启动本 run.bat 脚本即可！\033[0m\n")
+    os._exit(1)
+
+# 2. 从目录读取改动过的 Python 文件 (热修复拦截器)
+PATCHES_DIR = os.path.join(os.getcwd(), "patches")
+os.makedirs(PATCHES_DIR, exist_ok=True)
+
+# 3. 默认输出定向至程序根目录
+LOCAL_OUTPUTS = os.path.join(os.getcwd(), "outputs")
+os.makedirs(LOCAL_OUTPUTS, exist_ok=True)
+
+# 强制注入自定义输出录至 LTX 缓存数据中
+os.makedirs(DATA_DIR, exist_ok=True)
+with open(os.path.join(DATA_DIR, "custom_dir.txt"), 'w', encoding='utf-8') as f:
+    f.write(LOCAL_OUTPUTS)
+
+os.environ["LTX_APP_DATA_DIR"] = DATA_DIR
+
+# 将 patches 目录优先级提升，做到 Python 无损替换
+os.environ["PYTHONPATH"] = f"{PATCHES_DIR};{BACKEND_DIR}"
+
+def get_lan_ip():
+    try:
+        host_name = socket.gethostname()
+        _, _, ip_list = socket.gethostbyname_ex(host_name)
+        
+        candidates = []
+        for ip in ip_list:
+            if ip.startswith("192.168."):
+                return ip
+            elif ip.startswith("10.") or (ip.startswith("172.") and 16 <= int(ip.split('.')[1]) <= 31):
+                candidates.append(ip)
+                
+        if candidates:
+            return candidates[0]
+            
+        # Fallback to the default socket routing approach if no obvious LAN IP found
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))
+        ip = s.getsockname()[0]
+        s.close()
+        return ip
+    except:
+        return "127.0.0.1"
+
+LAN_IP = get_lan_ip()
+
+# ============================================================
+# 服务启动逻辑
+# ============================================================
+def check_port_in_use(port):
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        return s.connect_ex(('127.0.0.1', port)) == 0
+
+def launch_backend():
+    """启动核心引擎 - 监听 0.0.0.0 确保局域网可调"""
+    if check_port_in_use(3000):
+        print(f"\n\033[1;41m [致命错误] 3000 端口已被占用，无法启动核心引擎！ \033[0m")
+        print("\033[93m>> 绝大多数情况下，这是因为【官方原版 LTX Desktop】正在您的电脑后台运行。\033[0m")
+        print(">> 冲突会导致显存爆炸。请检查右下角系统托盘图标，右键完全退出官方软件。")
+        print(">> 退出后重新双击 run.bat 启动本程序！\n")
+        os._exit(1)
+
+    print(f"\033[96m[CORE] 核心引擎正在启动...\033[0m")
+    # 只开启重要级别的 Python 应用层日志，去除无用的 HTTP 刷屏
+    import logging as _logging
+    _logging.basicConfig(
+        level=_logging.INFO,
+        format="[%(asctime)s] %(levelname)s %(name)s: %(message)s",
+        datefmt="%H:%M:%S",
+        force=True
+    )
+    
+    # 构建绝对无损的环境拦截器：防止其他电脑被 cwd 劫持加载原版文件
+    launcher_code = f"""
+import sys
+import os
+
+patch_dir = r"{PATCHES_DIR}"
+backend_dir = r"{BACKEND_DIR}"
+
+# 防御性清除：强行剥离所有的默认 backend_dir 引用
+sys.path = [p for p in sys.path if p and os.path.normpath(p) != os.path.normpath(backend_dir)]
+sys.path = [p for p in sys.path if p and p != "." and p != ""]
+
+# 绝对插队注入：优先搜索 PATCHES_DIR
+sys.path.insert(0, patch_dir)
+sys.path.insert(1, backend_dir)
+
+import uvicorn
+from ltx2_server import app
+
+if __name__ == '__main__':
+    uvicorn.run(app, host="0.0.0.0", port=3000, log_level="info", access_log=False)
+"""
+    launcher_path = os.path.join(PATCHES_DIR, "launcher.py")
+    with open(launcher_path, "w", encoding="utf-8") as f:
+        f.write(launcher_code)
+
+    cmd = [PYTHON_EXE, launcher_path]
+    env = os.environ.copy()
+    result = subprocess.run(cmd, cwd=BACKEND_DIR, env=env)
+    if result.returncode != 0:
+        print(f"\n\033[1;41m [致命错误] 核心引擎异常崩溃退出！ (Exit Code: {result.returncode})\033[0m")
+        print(">> 请检查上述终端报错信息。确认显卡驱动是否正常。")
+        os._exit(1)
+
+ui_app = FastAPI()
+# 已移除存在安全隐患的静态资源挂载目录
+
+@ui_app.get("/")
+async def serve_index():
+    return FileResponse(os.path.join(os.getcwd(), UI_FILE_NAME))
+
+@ui_app.get("/index.css")
+async def serve_css():
+    return FileResponse(os.path.join(os.getcwd(), "UI/index.css"))
+
+@ui_app.get("/index.js")
+async def serve_js():
+    return FileResponse(os.path.join(os.getcwd(), "UI/index.js"))
+
+
+@ui_app.get("/i18n.js")
+async def serve_i18n():
+    return FileResponse(os.path.join(os.getcwd(), "UI/i18n.js"))
+
+
+def launch_ui_server():
+    print(f"\033[92m[UI] 工作站已就绪！\033[0m")
+    print(f"\033[92m[LOCAL] 本机访问: http://127.0.0.1:4000\033[0m")
+    print(f"\033[93m[WIFI]  局域网访问: http://{LAN_IP}:4000\033[0m")
+    
+    # 彻底压制 WinError 10054 (客户端强制断开) 的底层警告报错
+    if sys.platform == 'win32':
+        # Uvicorn 内部会拉起循环，所以只能通过底层 Logging Filter 拦截控制台噪音
+        class UvicornAsyncioNoiseFilter(logging.Filter):
+            """压掉客户端断开、Win Proactor 管道收尾等无害 asyncio 控制台刷屏。"""
+
+            def filter(self, record):
+                if record.name != "asyncio":
+                    return True
+                msg = record.getMessage()
+                if "_call_connection_lost" in msg or "_ProactorBasePipeTransport" in msg:
+                    return False
+                if hasattr(record, "exc_info") and record.exc_info:
+                    exc_type, exc_value, _ = record.exc_info
+                    if isinstance(exc_value, ConnectionResetError) and getattr(
+                        exc_value, "winerror", None
+                    ) == 10054:
+                        return False
+                if "10054" in msg and "ConnectionResetError" in msg:
+                    return False
+                return True
+
+        logging.getLogger("asyncio").addFilter(UvicornAsyncioNoiseFilter())
+        
+    uvicorn.run(ui_app, host="0.0.0.0", port=4000, log_level="warning", access_log=False)
+
+if __name__ == "__main__":
+    os.system('cls' if os.name == 'nt' else 'clear')
+    print("\033[1;97;44m LTX-2 CINEMATIC WORKSTATION | NETWORK ENABLED \033[0m\n")
+    
+    threading.Thread(target=launch_backend, daemon=True).start()
+    
+    # 强制校验 3000 端口是否存活
+    print("\033[93m[SYS] 正在等待内部核心 3000 端口启动...\033[0m")
+    backend_ready = False
+    for _ in range(30):
+        try:
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                if s.connect_ex(('127.0.0.1', 3000)) == 0:
+                    backend_ready = True
+                    break
+        except Exception:
+            pass
+        time.sleep(1)
+        
+    if backend_ready:
+        print("\033[92m[SYS] 3000 端口已通过连通性握手验证！后端装载成功。\033[0m")
+    else:
+        print("\033[1;41m [崩坏警告] 等待 30 秒后，3000 端口依然无法连通！ \033[0m")
+        print(">> Uvicorn 可能在后台陷入了死锁，或者被防火墙拦截，前端大概率将无法连接到后端！")
+        print(">> 请检查上方是否有 Python 报错。\n")
+        
+    try:
+        launch_ui_server()
+    except KeyboardInterrupt:
+        sys.exit(0)

LTX2.3-1.0.4/patches/API模式问题修复说明.md

@@ -0,0 +1,41 @@
+# LTX 本地显卡模式修复
+
+## 问题描述
+系统强制使用 FAL API 生成图片，即使本地有 GPU 可用。
+
+## 原因
+LTX 强制要求 GPU 有 31GB VRAM 才会使用本地显卡，低于此值会强制走 API 模式。
+
+## 修复方法
+
+### 方法一：自动替换（推荐）
+运行程序后，patches 目录中的文件会自动替换原版文件。
+
+### 方法二：手动替换
+
+#### 1. 修改 VRAM 阈值
+- **原文件**: `C:\Program Files\LTX Desktop\resources\backend\runtime_config\runtime_policy.py`
+- **找到** (第16行):
+  ```python
+  return vram_gb < 31
+  ```
+- **改为**:
+  ```python
+  return vram_gb < 6
+  ```
+
+#### 2. 清空无效 API Key
+- **原文件**: `C:\Users\Administrator\AppData\Local\LTXDesktop\settings.json`
+- **找到**:
+  ```json
+  "fal_api_key": "12123",
+  ```
+- **改为**:
+  ```json
+  "fal_api_key": "",
+  ```
+
+## 说明
+- VRAM 阈值改为 6GB，意味着 6GB 及以上显存都会使用本地显卡
+- 清空 fal_api_key 避免系统误判为已配置 API
+- 修改后重启程序即可生效

LTX2.3-1.0.4/patches/api_types.py

@@ -0,0 +1,395 @@
+"""Pydantic request/response models and TypedDicts for ltx2_server."""
+
+from __future__ import annotations
+
+from typing import Literal, NamedTuple, TypeAlias, TypedDict
+from typing import Annotated
+
+from pydantic import BaseModel, Field, StringConstraints
+
+NonEmptyPrompt = Annotated[str, StringConstraints(strip_whitespace=True, min_length=1)]
+ModelFileType = Literal[
+    "checkpoint",
+    "upsampler",
+    "distilled_lora",
+    "ic_lora",
+    "depth_processor",
+    "person_detector",
+    "pose_processor",
+    "text_encoder",
+    "zit",
+]
+
+
+class ImageConditioningInput(NamedTuple):
+    """Image conditioning triplet used by all video pipelines."""
+
+    path: str
+    frame_idx: int
+    strength: float
+
+
+# ============================================================
+# TypedDicts for module-level state globals
+# ============================================================
+
+
+class GenerationState(TypedDict):
+    id: str | None
+    cancelled: bool
+    result: str | list[str] | None
+    error: str | None
+    status: str  # "idle" | "running" | "complete" | "cancelled" | "error"
+    phase: str
+    progress: int
+    current_step: int
+    total_steps: int
+
+
+JsonObject: TypeAlias = dict[str, object]
+VideoCameraMotion = Literal[
+    "none",
+    "dolly_in",
+    "dolly_out",
+    "dolly_left",
+    "dolly_right",
+    "jib_up",
+    "jib_down",
+    "static",
+    "focus_shift",
+]
+
+RetakeMode: TypeAlias = Literal[
+    "replace_audio_and_video", "replace_video", "replace_audio"
+]
+
+
+# ============================================================
+# Response Models
+# ============================================================
+
+
+class ModelStatusItem(BaseModel):
+    id: str
+    name: str
+    loaded: bool
+    downloaded: bool
+
+
+class GpuTelemetry(BaseModel):
+    name: str
+    vram: int
+    vramUsed: int
+
+
+class HealthResponse(BaseModel):
+    status: str
+    models_loaded: bool
+    active_model: str | None
+    gpu_info: GpuTelemetry
+    sage_attention: bool
+    models_status: list[ModelStatusItem]
+
+
+class GpuInfoResponse(BaseModel):
+    cuda_available: bool
+    mps_available: bool = False
+    gpu_available: bool = False
+    gpu_name: str | None
+    vram_gb: int | None
+    gpu_info: GpuTelemetry
+
+
+class RuntimePolicyResponse(BaseModel):
+    force_api_generations: bool
+
+
+class GenerationProgressResponse(BaseModel):
+    status: str
+    phase: str
+    progress: int
+    currentStep: int | None
+    totalSteps: int | None
+
+
+class ModelInfo(BaseModel):
+    id: str
+    name: str
+    description: str
+
+
+class ModelFileStatus(BaseModel):
+    id: ModelFileType
+    name: str
+    description: str
+    downloaded: bool
+    size: int
+    expected_size: int
+    required: bool = True
+    is_folder: bool = False
+    optional_reason: str | None = None
+
+
+class TextEncoderStatus(BaseModel):
+    downloaded: bool
+    size_bytes: int
+    size_gb: float
+    expected_size_gb: float
+
+
+class ModelsStatusResponse(BaseModel):
+    models: list[ModelFileStatus]
+    all_downloaded: bool
+    total_size: int
+    downloaded_size: int
+    total_size_gb: float
+    downloaded_size_gb: float
+    models_path: str
+    has_api_key: bool
+    text_encoder_status: TextEncoderStatus
+    use_local_text_encoder: bool
+
+
+class DownloadProgressRunningResponse(BaseModel):
+    status: Literal["downloading"]
+    current_downloading_file: ModelFileType | None
+    current_file_progress: float
+    total_progress: float
+    total_downloaded_bytes: int
+    expected_total_bytes: int
+    completed_files: set[ModelFileType]
+    all_files: set[ModelFileType]
+    error: None = None
+    speed_bytes_per_sec: float
+
+
+class DownloadProgressCompleteResponse(BaseModel):
+    status: Literal["complete"]
+
+
+class DownloadProgressErrorResponse(BaseModel):
+    status: Literal["error"]
+    error: str
+
+
+DownloadProgressResponse: TypeAlias = (
+    DownloadProgressRunningResponse
+    | DownloadProgressCompleteResponse
+    | DownloadProgressErrorResponse
+)
+
+
+class SuggestGapPromptResponse(BaseModel):
+    status: str = "success"
+    suggested_prompt: str
+
+
+class GenerateVideoCompleteResponse(BaseModel):
+    status: Literal["complete"]
+    video_path: str
+
+
+class GenerateVideoCancelledResponse(BaseModel):
+    status: Literal["cancelled"]
+
+
+GenerateVideoResponse: TypeAlias = (
+    GenerateVideoCompleteResponse | GenerateVideoCancelledResponse
+)
+
+
+class GenerateImageCompleteResponse(BaseModel):
+    status: Literal["complete"]
+    image_paths: list[str]
+
+
+class GenerateImageCancelledResponse(BaseModel):
+    status: Literal["cancelled"]
+
+
+GenerateImageResponse: TypeAlias = (
+    GenerateImageCompleteResponse | GenerateImageCancelledResponse
+)
+
+
+class CancelCancellingResponse(BaseModel):
+    status: Literal["cancelling"]
+    id: str
+
+
+class CancelNoActiveGenerationResponse(BaseModel):
+    status: Literal["no_active_generation"]
+
+
+CancelResponse: TypeAlias = CancelCancellingResponse | CancelNoActiveGenerationResponse
+
+
+class RetakeVideoResponse(BaseModel):
+    status: Literal["complete"]
+    video_path: str
+
+
+class RetakePayloadResponse(BaseModel):
+    status: Literal["complete"]
+    result: JsonObject
+
+
+class RetakeCancelledResponse(BaseModel):
+    status: Literal["cancelled"]
+
+
+RetakeResponse: TypeAlias = (
+    RetakeVideoResponse | RetakePayloadResponse | RetakeCancelledResponse
+)
+
+
+class IcLoraExtractResponse(BaseModel):
+    conditioning: str
+    original: str
+    conditioning_type: Literal["canny", "depth"]
+    frame_time: float
+
+
+class IcLoraGenerateCompleteResponse(BaseModel):
+    status: Literal["complete"]
+    video_path: str
+
+
+class IcLoraGenerateCancelledResponse(BaseModel):
+    status: Literal["cancelled"]
+
+
+IcLoraGenerateResponse: TypeAlias = (
+    IcLoraGenerateCompleteResponse | IcLoraGenerateCancelledResponse
+)
+
+
+class ModelDownloadStartResponse(BaseModel):
+    status: Literal["started"]
+    message: str
+    sessionId: str
+
+
+class TextEncoderDownloadStartedResponse(BaseModel):
+    status: Literal["started"]
+    message: str
+    sessionId: str
+
+
+class TextEncoderAlreadyDownloadedResponse(BaseModel):
+    status: Literal["already_downloaded"]
+    message: str
+
+
+TextEncoderDownloadResponse: TypeAlias = (
+    TextEncoderDownloadStartedResponse | TextEncoderAlreadyDownloadedResponse
+)
+
+
+class StatusResponse(BaseModel):
+    status: str
+
+
+class ErrorResponse(BaseModel):
+    error: str
+    message: str | None = None
+
+
+# ============================================================
+# Request Models
+# ============================================================
+
+
+class GenerateVideoRequest(BaseModel):
+    prompt: NonEmptyPrompt
+    resolution: str = "512p"
+    model: str = "fast"
+    cameraMotion: VideoCameraMotion = "none"
+    negativePrompt: str = ""
+    duration: str = "2"
+    fps: str = "24"
+    audio: str = "false"
+    imagePath: str | None = None
+    audioPath: str | None = None
+    startFramePath: str | None = None
+    endFramePath: str | None = None
+    # 多张图单次推理：latent 时间轴多锚点（Comfy LTXVAddGuideMulti 思路）；≥2 路径时优先于首尾帧
+    keyframePaths: list[str] | None = None
+    # 与 keyframePaths 等长、0.1–1.0；不传则按 Comfy 类工作流自动降低中间帧强度，减轻闪烁
+    keyframeStrengths: list[float] | None = None
+    # 与 keyframePaths 等长，单位秒，落在 [0, 整段时长]；全提供时按时间映射 latent，否则仍自动均分
+    keyframeTimes: list[float] | None = None
+    aspectRatio: Literal["16:9", "9:16"] = "16:9"
+    modelPath: str | None = None
+    loraPath: str | None = None
+    loraStrength: float = 1.0
+
+
+class GenerateImageRequest(BaseModel):
+    prompt: NonEmptyPrompt
+    width: int = 1024
+    height: int = 1024
+    numSteps: int = 4
+    numImages: int = 1
+
+
+def _default_model_types() -> set[ModelFileType]:
+    return set()
+
+
+class ModelDownloadRequest(BaseModel):
+    modelTypes: set[ModelFileType] = Field(default_factory=_default_model_types)
+
+
+class RequiredModelsResponse(BaseModel):
+    modelTypes: list[ModelFileType]
+
+
+class SuggestGapPromptRequest(BaseModel):
+    beforePrompt: str = ""
+    afterPrompt: str = ""
+    beforeFrame: str | None = None
+    afterFrame: str | None = None
+    gapDuration: float = 5
+    mode: str = "t2v"
+    inputImage: str | None = None
+
+
+class RetakeRequest(BaseModel):
+    video_path: str
+    start_time: float = 0
+    duration: float = 0
+    prompt: str = ""
+    mode: str = "replace_video_only"
+    width: int | None = None
+    height: int | None = None
+
+
+class IcLoraExtractRequest(BaseModel):
+    video_path: str
+    conditioning_type: Literal["canny", "depth"] = "canny"
+    frame_time: float = 0
+
+
+class IcLoraImageInput(BaseModel):
+    path: str
+    frame: int = 0
+    strength: float = 1.0
+
+
+def _default_ic_lora_images() -> list[IcLoraImageInput]:
+    return []
+
+
+class IcLoraGenerateRequest(BaseModel):
+    video_path: str
+    conditioning_type: Literal["canny", "depth"]
+    prompt: NonEmptyPrompt
+    conditioning_strength: float = 1.0
+    num_inference_steps: int = 30
+    cfg_guidance_scale: float = 1.0
+    negative_prompt: str = ""
+    images: list[IcLoraImageInput] = Field(default_factory=_default_ic_lora_images)
+
+
+ConditioningType: TypeAlias = Literal["canny", "depth"]

LTX2.3-1.0.4/patches/app_settings_patch.py

@@ -0,0 +1,22 @@
+"""运行时补丁：给 AppSettings 添加 lora_dir 字段（如果不存在）。"""
+
+import sys
+import os
+
+
+def patch_app_settings():
+    try:
+        from state.app_settings import AppSettings
+        from pydantic import Field
+
+        if "lora_dir" not in AppSettings.model_fields:
+            AppSettings.model_fields["lora_dir"] = Field(
+                default="", validation_alias="loraDir", serialization_alias="loraDir"
+            )
+            AppSettings.model_rebuild(_force=True)
+            print("[PATCH] AppSettings patched: added lora_dir field")
+    except Exception as e:
+        print(f"[PATCH] AppSettings patch failed: {e}")
+
+
+patch_app_settings()

LTX2.3-1.0.4/patches/handlers/video_generation_handler.py

@@ -0,0 +1,868 @@
+"""Video generation orchestration handler."""
+
+from __future__ import annotations
+
+import logging
+import os
+import tempfile
+import time
+import uuid
+from datetime import datetime
+from pathlib import Path
+from threading import RLock
+from typing import TYPE_CHECKING
+
+from PIL import Image
+
+from api_types import (
+    GenerateVideoRequest,
+    GenerateVideoResponse,
+    ImageConditioningInput,
+    VideoCameraMotion,
+)
+from _routes._errors import HTTPError
+from handlers.base import StateHandlerBase
+from handlers.generation_handler import GenerationHandler
+from handlers.pipelines_handler import PipelinesHandler
+from handlers.text_handler import TextHandler
+from runtime_config.model_download_specs import resolve_model_path
+from server_utils.media_validation import (
+    normalize_optional_path,
+    validate_audio_file,
+    validate_image_file,
+)
+from services.interfaces import LTXAPIClient
+from state.app_state_types import AppState
+from state.app_settings import should_video_generate_with_ltx_api
+
+if TYPE_CHECKING:
+    from runtime_config.runtime_config import RuntimeConfig
+
+logger = logging.getLogger(__name__)
+
+FORCED_API_MODEL_MAP: dict[str, str] = {
+    "fast": "ltx-2-3-fast",
+    "pro": "ltx-2-3-pro",
+}
+FORCED_API_RESOLUTION_MAP: dict[str, dict[str, str]] = {
+    "1080p": {"16:9": "1920x1080", "9:16": "1080x1920"},
+    "1440p": {"16:9": "2560x1440", "9:16": "1440x2560"},
+    "2160p": {"16:9": "3840x2160", "9:16": "2160x3840"},
+}
+A2V_FORCED_API_RESOLUTION = "1920x1080"
+FORCED_API_ALLOWED_ASPECT_RATIOS = {"16:9", "9:16"}
+FORCED_API_ALLOWED_FPS = {24, 25, 48, 50}
+
+
+def _get_allowed_durations(model_id: str, resolution_label: str, fps: int) -> set[int]:
+    if model_id == "ltx-2-3-fast" and resolution_label == "1080p" and fps in {24, 25}:
+        return {6, 8, 10, 12, 14, 16, 18, 20}
+    return {6, 8, 10}
+
+
+class VideoGenerationHandler(StateHandlerBase):
+    def __init__(
+        self,
+        state: AppState,
+        lock: RLock,
+        generation_handler: GenerationHandler,
+        pipelines_handler: PipelinesHandler,
+        text_handler: TextHandler,
+        ltx_api_client: LTXAPIClient,
+        config: RuntimeConfig,
+    ) -> None:
+        super().__init__(state, lock, config)
+        self._generation = generation_handler
+        self._pipelines = pipelines_handler
+        self._text = text_handler
+        self._ltx_api_client = ltx_api_client
+
+    def generate(self, req: GenerateVideoRequest) -> GenerateVideoResponse:
+        if should_video_generate_with_ltx_api(
+            force_api_generations=self.config.force_api_generations,
+            settings=self.state.app_settings,
+        ):
+            return self._generate_forced_api(req)
+
+        if self._generation.is_generation_running():
+            raise HTTPError(409, "Generation already in progress")
+
+        resolution = req.resolution
+
+        duration = int(float(req.duration))
+        fps = int(float(req.fps))
+
+        audio_path = normalize_optional_path(req.audioPath)
+        if audio_path:
+            return self._generate_a2v(req, duration, fps, audio_path=audio_path)
+
+        logger.info("Resolution %s - using fast pipeline", resolution)
+
+        RESOLUTION_MAP_16_9: dict[str, tuple[int, int]] = {
+            "540p": (1024, 576),
+            "720p": (1280, 704),
+            "1080p": (1920, 1088),
+        }
+
+        def get_16_9_size(res: str) -> tuple[int, int]:
+            return RESOLUTION_MAP_16_9.get(res, (1280, 704))
+
+        def get_9_16_size(res: str) -> tuple[int, int]:
+            w, h = get_16_9_size(res)
+            return h, w
+
+        match req.aspectRatio:
+            case "9:16":
+                width, height = get_9_16_size(resolution)
+            case "16:9":
+                width, height = get_16_9_size(resolution)
+
+        num_frames = self._compute_num_frames(duration, fps)
+
+        image = None
+        image_path = normalize_optional_path(req.imagePath)
+        if image_path:
+            image = self._prepare_image(image_path, width, height)
+            logger.info("Image: %s -> %sx%s", image_path, width, height)
+
+        generation_id = self._make_generation_id()
+        seed = self._resolve_seed()
+
+        logger.info(
+            f"Request loraPath: '{req.loraPath}', loraStrength: {req.loraStrength}, inferenceSteps: {req.inferenceSteps}"
+        )
+
+        # 尝试支持自定义步数（实验性）
+        inference_steps = req.inferenceSteps
+        logger.info(f"Using inference steps: {inference_steps}")
+
+        loras = None
+        if req.loraPath and req.loraPath.strip():
+            try:
+                import os
+                from pathlib import Path
+                from ltx_core.loader import LoraPathStrengthAndSDOps
+                from ltx_core.loader.sd_ops import LTXV_LORA_COMFY_RENAMING_MAP
+
+                lora_path = req.loraPath.strip()
+                logger.info(
+                    f"LoRA path: {lora_path}, exists: {os.path.exists(lora_path)}"
+                )
+
+                if os.path.exists(lora_path):
+                    loras = [
+                        LoraPathStrengthAndSDOps(
+                            path=lora_path,
+                            strength=req.loraStrength,
+                            sd_ops=LTXV_LORA_COMFY_RENAMING_MAP,
+                        )
+                    ]
+                    logger.info(
+                        f"LoRA prepared: {lora_path} with strength {req.loraStrength}"
+                    )
+                else:
+                    logger.warning(f"LoRA file not found: {lora_path}")
+            except Exception as e:
+                logger.warning(f"Failed to load LoRA: {e}")
+                import traceback
+
+                logger.warning(f"LoRA traceback: {traceback.format_exc()}")
+                loras = None
+
+        lora_path_req = (req.loraPath or "").strip()
+        desired_sig = (
+            "fast",
+            lora_path_req if loras is not None else "",
+            round(float(req.loraStrength), 4) if loras is not None else 0.0,
+        )
+        try:
+            if loras is not None:
+                # 强制卸载并重新加载带LoRA的pipeline
+                logger.info("Unloading pipeline for LoRA...")
+                from keep_models_runtime import force_unload_gpu_pipeline
+
+                force_unload_gpu_pipeline(self._pipelines)
+
+                # 强制垃圾回收
+                import gc
+
+                gc.collect()
+                # 释放 CUDA 缓存，降低 LoRA 首次构建的显存峰值/碎片风险
+                try:
+                    import torch
+                    if torch.cuda.is_available():
+                        torch.cuda.empty_cache()
+                        torch.cuda.ipc_collect()
+                except Exception:
+                    pass
+
+                gemma_root = self._pipelines._text_handler.resolve_gemma_root()
+                from runtime_config.model_download_specs import resolve_model_path
+                from services.fast_video_pipeline.ltx_fast_video_pipeline import (
+                    LTXFastVideoPipeline,
+                )
+
+                checkpoint_path = str(
+                    resolve_model_path(
+                        self._pipelines.models_dir,
+                        self._pipelines.config.model_download_specs,
+                        "checkpoint",
+                    )
+                )
+                upsampler_path = str(
+                    resolve_model_path(
+                        self._pipelines.models_dir,
+                        self._pipelines.config.model_download_specs,
+                        "upsampler",
+                    )
+                )
+
+                logger.info(
+                    f"Creating pipeline with LoRA: {loras}, steps: {inference_steps}"
+                )
+                from lora_injection import (
+                    _lora_init_kwargs,
+                    inject_loras_into_fast_pipeline,
+                )
+
+                lora_kw = _lora_init_kwargs(LTXFastVideoPipeline, loras)
+                pipeline = LTXFastVideoPipeline(
+                    checkpoint_path,
+                    gemma_root,
+                    upsampler_path,
+                    self._pipelines.config.device,
+                    **lora_kw,
+                )
+                n_inj = inject_loras_into_fast_pipeline(pipeline, loras)
+                if hasattr(pipeline, "pipeline") and hasattr(
+                    pipeline.pipeline, "model_ledger"
+                ):
+                    try:
+                        pipeline.pipeline.model_ledger.loras = tuple(loras)
+                    except Exception:
+                        pass
+                logger.info(
+                    "LoRA 注入: init_kw=%s, 注入点=%s, model_ledger.loras=%s",
+                    list(lora_kw.keys()),
+                    n_inj,
+                    getattr(
+                        getattr(pipeline.pipeline, "model_ledger", None),
+                        "loras",
+                        None,
+                    ),
+                )
+
+                from state.app_state_types import (
+                    VideoPipelineState,
+                    VideoPipelineWarmth,
+                    GpuSlot,
+                )
+
+                state = VideoPipelineState(
+                    pipeline=pipeline,
+                    warmth=VideoPipelineWarmth.COLD,
+                    is_compiled=False,
+                )
+
+                self._pipelines.state.gpu_slot = GpuSlot(
+                    active_pipeline=state, generation=None
+                )
+                logger.info("Pipeline with LoRA loaded successfully")
+            else:
+                # 无论有没有LoRA，都尝试使用自定义步数重新加载pipeline
+                logger.info(f"Loading pipeline with {inference_steps} steps")
+                from keep_models_runtime import force_unload_gpu_pipeline
+
+                force_unload_gpu_pipeline(self._pipelines)
+
+                import gc
+
+                gc.collect()
+
+                gemma_root = self._pipelines._text_handler.resolve_gemma_root()
+                from runtime_config.model_download_specs import resolve_model_path
+                from services.fast_video_pipeline.ltx_fast_video_pipeline import (
+                    LTXFastVideoPipeline,
+                )
+
+                checkpoint_path = str(
+                    resolve_model_path(
+                        self._pipelines.models_dir,
+                        self._pipelines.config.model_download_specs,
+                        "checkpoint",
+                    )
+                )
+                upsampler_path = str(
+                    resolve_model_path(
+                        self._pipelines.models_dir,
+                        self._pipelines.config.model_download_specs,
+                        "upsampler",
+                    )
+                )
+
+                pipeline = LTXFastVideoPipeline(
+                    checkpoint_path,
+                    gemma_root,
+                    upsampler_path,
+                    self._pipelines.config.device,
+                )
+
+                from state.app_state_types import (
+                    VideoPipelineState,
+                    VideoPipelineWarmth,
+                    GpuSlot,
+                )
+
+                state = VideoPipelineState(
+                    pipeline=pipeline,
+                    warmth=VideoPipelineWarmth.COLD,
+                    is_compiled=False,
+                )
+
+                self._pipelines.state.gpu_slot = GpuSlot(
+                    active_pipeline=state, generation=None
+                )
+
+            self._pipelines._pipeline_signature = desired_sig
+
+            self._generation.start_generation(generation_id)
+
+            output_path = self.generate_video(
+                prompt=req.prompt,
+                image=image,
+                height=height,
+                width=width,
+                num_frames=num_frames,
+                fps=fps,
+                seed=seed,
+                camera_motion=req.cameraMotion,
+                negative_prompt=req.negativePrompt,
+            )
+
+            self._generation.complete_generation(output_path)
+            return GenerateVideoResponse(status="complete", video_path=output_path)
+
+        except Exception as e:
+            self._generation.fail_generation(str(e))
+            if "cancelled" in str(e).lower():
+                logger.info("Generation cancelled by user")
+                return GenerateVideoResponse(status="cancelled")
+
+            raise HTTPError(500, str(e)) from e
+
+    def generate_video(
+        self,
+        prompt: str,
+        image: Image.Image | None,
+        height: int,
+        width: int,
+        num_frames: int,
+        fps: float,
+        seed: int,
+        camera_motion: VideoCameraMotion,
+        negative_prompt: str,
+    ) -> str:
+        t_total_start = time.perf_counter()
+        gen_mode = "i2v" if image is not None else "t2v"
+        logger.info(
+            "[%s] Generation started (model=fast, %dx%d, %d frames, %d fps)",
+            gen_mode,
+            width,
+            height,
+            num_frames,
+            int(fps),
+        )
+
+        if self._generation.is_generation_cancelled():
+            raise RuntimeError("Generation was cancelled")
+
+        if not resolve_model_path(
+            self.models_dir, self.config.model_download_specs, "checkpoint"
+        ).exists():
+            raise RuntimeError(
+                "Models not downloaded. Please download the AI models first using the Model Status menu."
+            )
+
+        total_steps = 8
+
+        self._generation.update_progress("loading_model", 5, 0, total_steps)
+        t_load_start = time.perf_counter()
+        pipeline_state = self._pipelines.load_gpu_pipeline("fast", should_warm=False)
+        t_load_end = time.perf_counter()
+        logger.info("[%s] Pipeline load: %.2fs", gen_mode, t_load_end - t_load_start)
+
+        self._generation.update_progress("encoding_text", 10, 0, total_steps)
+
+        enhanced_prompt = prompt + self.config.camera_motion_prompts.get(
+            camera_motion, ""
+        )
+
+        images: list[ImageConditioningInput] = []
+        temp_image_path: str | None = None
+        if image is not None:
+            temp_image_path = tempfile.NamedTemporaryFile(
+                suffix=".png", delete=False
+            ).name
+            image.save(temp_image_path)
+            images = [
+                ImageConditioningInput(path=temp_image_path, frame_idx=0, strength=1.0)
+            ]
+
+        output_path = self._make_output_path()
+
+        try:
+            settings = self.state.app_settings
+            use_api_encoding = not self._text.should_use_local_encoding()
+            if image is not None:
+                enhance = use_api_encoding and settings.prompt_enhancer_enabled_i2v
+            else:
+                enhance = use_api_encoding and settings.prompt_enhancer_enabled_t2v
+
+            encoding_method = "api" if use_api_encoding else "local"
+            t_text_start = time.perf_counter()
+            self._text.prepare_text_encoding(enhanced_prompt, enhance_prompt=enhance)
+            t_text_end = time.perf_counter()
+            logger.info(
+                "[%s] Text encoding (%s): %.2fs",
+                gen_mode,
+                encoding_method,
+                t_text_end - t_text_start,
+            )
+
+            self._generation.update_progress("inference", 15, 0, total_steps)
+
+            height = round(height / 64) * 64
+            width = round(width / 64) * 64
+
+            t_inference_start = time.perf_counter()
+            pipeline_state.pipeline.generate(
+                prompt=enhanced_prompt,
+                seed=seed,
+                height=height,
+                width=width,
+                num_frames=num_frames,
+                frame_rate=fps,
+                images=images,
+                output_path=str(output_path),
+            )
+            t_inference_end = time.perf_counter()
+            logger.info(
+                "[%s] Inference: %.2fs", gen_mode, t_inference_end - t_inference_start
+            )
+
+            if self._generation.is_generation_cancelled():
+                if output_path.exists():
+                    output_path.unlink()
+                raise RuntimeError("Generation was cancelled")
+
+            t_total_end = time.perf_counter()
+            logger.info(
+                "[%s] Total generation: %.2fs (load=%.2fs, text=%.2fs, inference=%.2fs)",
+                gen_mode,
+                t_total_end - t_total_start,
+                t_load_end - t_load_start,
+                t_text_end - t_text_start,
+                t_inference_end - t_inference_start,
+            )
+
+            self._generation.update_progress("complete", 100, total_steps, total_steps)
+            return str(output_path)
+        finally:
+            self._text.clear_api_embeddings()
+            if temp_image_path and os.path.exists(temp_image_path):
+                os.unlink(temp_image_path)
+
+    def _generate_a2v(
+        self, req: GenerateVideoRequest, duration: int, fps: int, *, audio_path: str
+    ) -> GenerateVideoResponse:
+        if req.model != "pro":
+            logger.warning(
+                "A2V local requested with model=%s; A2V always uses pro pipeline",
+                req.model,
+            )
+        validated_audio_path = validate_audio_file(audio_path)
+        audio_path_str = str(validated_audio_path)
+
+        # 支持竖屏和横屏
+        RESOLUTION_MAP: dict[str, tuple[int, int]] = {
+            "540p": (1024, 576),
+            "720p": (1280, 704),
+            "1080p": (1920, 1088),
+        }
+
+        base_w, base_h = RESOLUTION_MAP.get(req.resolution, (1280, 704))
+
+        # 根据 aspectRatio 调整分辨率
+        if req.aspectRatio == "9:16":
+            width, height = base_h, base_w  # 竖屏
+        else:
+            width, height = base_w, base_h  # 横屏
+
+        num_frames = self._compute_num_frames(duration, fps)
+
+        image = None
+        temp_image_path: str | None = None
+        image_path = normalize_optional_path(req.imagePath)
+        if image_path:
+            image = self._prepare_image(image_path, width, height)
+
+        # 获取首尾帧
+        start_frame_path = normalize_optional_path(getattr(req, "startFramePath", None))
+        end_frame_path = normalize_optional_path(getattr(req, "endFramePath", None))
+
+        seed = self._resolve_seed()
+
+        generation_id = self._make_generation_id()
+
+        temp_image_paths: list[str] = []
+        try:
+            a2v_state = self._pipelines.load_a2v_pipeline()
+            self._generation.start_generation(generation_id)
+
+            enhanced_prompt = req.prompt + self.config.camera_motion_prompts.get(
+                req.cameraMotion, ""
+            )
+            neg = (
+                req.negativePrompt
+                if req.negativePrompt
+                else self.config.default_negative_prompt
+            )
+
+            images: list[ImageConditioningInput] = []
+            temp_image_paths: list[str] = []
+
+            # 首帧
+            if start_frame_path:
+                start_img = self._prepare_image(start_frame_path, width, height)
+                temp_start_path = tempfile.NamedTemporaryFile(
+                    suffix=".png", delete=False
+                ).name
+                start_img.save(temp_start_path)
+                temp_image_paths.append(temp_start_path)
+                images.append(
+                    ImageConditioningInput(
+                        path=temp_start_path, frame_idx=0, strength=1.0
+                    )
+                )
+
+            # 中间图片（如果有）
+            if image is not None and not start_frame_path:
+                temp_image_path = tempfile.NamedTemporaryFile(
+                    suffix=".png", delete=False
+                ).name
+                image.save(temp_image_path)
+                temp_image_paths.append(temp_image_path)
+                images.append(
+                    ImageConditioningInput(
+                        path=temp_image_path, frame_idx=0, strength=1.0
+                    )
+                )
+
+            # 尾帧
+            if end_frame_path:
+                last_latent_idx = (num_frames - 1) // 8 + 1 - 1
+                end_img = self._prepare_image(end_frame_path, width, height)
+                temp_end_path = tempfile.NamedTemporaryFile(
+                    suffix=".png", delete=False
+                ).name
+                end_img.save(temp_end_path)
+                temp_image_paths.append(temp_end_path)
+                images.append(
+                    ImageConditioningInput(
+                        path=temp_end_path, frame_idx=last_latent_idx, strength=1.0
+                    )
+                )
+
+            output_path = self._make_output_path()
+
+            total_steps = 11  # distilled: 8 steps (stage 1) + 3 steps (stage 2)
+
+            a2v_settings = self.state.app_settings
+            a2v_use_api = not self._text.should_use_local_encoding()
+            if image is not None:
+                a2v_enhance = a2v_use_api and a2v_settings.prompt_enhancer_enabled_i2v
+            else:
+                a2v_enhance = a2v_use_api and a2v_settings.prompt_enhancer_enabled_t2v
+
+            self._generation.update_progress("loading_model", 5, 0, total_steps)
+            self._generation.update_progress("encoding_text", 10, 0, total_steps)
+            self._text.prepare_text_encoding(
+                enhanced_prompt, enhance_prompt=a2v_enhance
+            )
+            self._generation.update_progress("inference", 15, 0, total_steps)
+
+            a2v_state.pipeline.generate(
+                prompt=enhanced_prompt,
+                negative_prompt=neg,
+                seed=seed,
+                height=height,
+                width=width,
+                num_frames=num_frames,
+                frame_rate=fps,
+                num_inference_steps=total_steps,
+                images=images,
+                audio_path=audio_path_str,
+                audio_start_time=0.0,
+                audio_max_duration=None,
+                output_path=str(output_path),
+            )
+
+            if self._generation.is_generation_cancelled():
+                if output_path.exists():
+                    output_path.unlink()
+                raise RuntimeError("Generation was cancelled")
+
+            self._generation.update_progress("complete", 100, total_steps, total_steps)
+            self._generation.complete_generation(str(output_path))
+            return GenerateVideoResponse(status="complete", video_path=str(output_path))
+
+        except Exception as e:
+            self._generation.fail_generation(str(e))
+            if "cancelled" in str(e).lower():
+                logger.info("Generation cancelled by user")
+                return GenerateVideoResponse(status="cancelled")
+            raise HTTPError(500, str(e)) from e
+        finally:
+            self._text.clear_api_embeddings()
+            # 清理所有临时图片
+            for tmp_path in temp_image_paths:
+                if tmp_path and os.path.exists(tmp_path):
+                    try:
+                        os.unlink(tmp_path)
+                    except Exception:
+                        pass
+            if temp_image_path and os.path.exists(temp_image_path):
+                try:
+                    os.unlink(temp_image_path)
+                except Exception:
+                    pass
+
+    def _prepare_image(self, image_path: str, width: int, height: int) -> Image.Image:
+        validated_path = validate_image_file(image_path)
+        try:
+            img = Image.open(validated_path).convert("RGB")
+        except Exception:
+            raise HTTPError(400, f"Invalid image file: {image_path}") from None
+        img_w, img_h = img.size
+        target_ratio = width / height
+        img_ratio = img_w / img_h
+        if img_ratio > target_ratio:
+            new_h = height
+            new_w = int(img_w * (height / img_h))
+        else:
+            new_w = width
+            new_h = int(img_h * (width / img_w))
+        resized = img.resize((new_w, new_h), Image.Resampling.LANCZOS)
+        left = (new_w - width) // 2
+        top = (new_h - height) // 2
+        return resized.crop((left, top, left + width, top + height))
+
+    @staticmethod
+    def _make_generation_id() -> str:
+        return uuid.uuid4().hex[:8]
+
+    @staticmethod
+    def _compute_num_frames(duration: int, fps: int) -> int:
+        n = ((duration * fps) // 8) * 8 + 1
+        return max(n, 9)
+
+    def _resolve_seed(self) -> int:
+        settings = self.state.app_settings
+        if settings.seed_locked:
+            logger.info("Using locked seed: %s", settings.locked_seed)
+            return settings.locked_seed
+        return int(time.time()) % 2147483647
+
+    def _make_output_path(self) -> Path:
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        return (
+            self.config.outputs_dir
+            / f"ltx2_video_{timestamp}_{self._make_generation_id()}.mp4"
+        )
+
+    def _generate_forced_api(self, req: GenerateVideoRequest) -> GenerateVideoResponse:
+        if self._generation.is_generation_running():
+            raise HTTPError(409, "Generation already in progress")
+
+        generation_id = self._make_generation_id()
+        self._generation.start_api_generation(generation_id)
+
+        audio_path = normalize_optional_path(req.audioPath)
+        image_path = normalize_optional_path(req.imagePath)
+        has_input_audio = bool(audio_path)
+        has_input_image = bool(image_path)
+
+        try:
+            self._generation.update_progress("validating_request", 5, None, None)
+
+            api_key = self.state.app_settings.ltx_api_key.strip()
+            logger.info(
+                "Forced API generation route selected (key_present=%s)", bool(api_key)
+            )
+            if not api_key:
+                raise HTTPError(400, "PRO_API_KEY_REQUIRED")
+
+            requested_model = req.model.strip().lower()
+            api_model_id = FORCED_API_MODEL_MAP.get(requested_model)
+            if api_model_id is None:
+                raise HTTPError(400, "INVALID_FORCED_API_MODEL")
+
+            resolution_label = req.resolution
+            resolution_by_aspect = FORCED_API_RESOLUTION_MAP.get(resolution_label)
+            if resolution_by_aspect is None:
+                raise HTTPError(400, "INVALID_FORCED_API_RESOLUTION")
+
+            aspect_ratio = req.aspectRatio.strip()
+            if aspect_ratio not in FORCED_API_ALLOWED_ASPECT_RATIOS:
+                raise HTTPError(400, "INVALID_FORCED_API_ASPECT_RATIO")
+
+            api_resolution = resolution_by_aspect[aspect_ratio]
+
+            prompt = req.prompt
+
+            if self._generation.is_generation_cancelled():
+                raise RuntimeError("Generation was cancelled")
+
+            if has_input_audio:
+                if requested_model != "pro":
+                    logger.warning(
+                        "A2V requested with model=%s; overriding to 'pro'",
+                        requested_model,
+                    )
+                api_model_id = FORCED_API_MODEL_MAP["pro"]
+                if api_resolution != A2V_FORCED_API_RESOLUTION:
+                    logger.warning(
+                        "A2V requested with resolution=%s; overriding to '%s'",
+                        api_resolution,
+                        A2V_FORCED_API_RESOLUTION,
+                    )
+                api_resolution = A2V_FORCED_API_RESOLUTION
+                validated_audio_path = validate_audio_file(audio_path)
+                validated_image_path: Path | None = None
+                if image_path is not None:
+                    validated_image_path = validate_image_file(image_path)
+
+                self._generation.update_progress("uploading_audio", 20, None, None)
+                audio_uri = self._ltx_api_client.upload_file(
+                    api_key=api_key,
+                    file_path=str(validated_audio_path),
+                )
+                image_uri: str | None = None
+                if validated_image_path is not None:
+                    self._generation.update_progress("uploading_image", 35, None, None)
+                    image_uri = self._ltx_api_client.upload_file(
+                        api_key=api_key,
+                        file_path=str(validated_image_path),
+                    )
+                self._generation.update_progress("inference", 55, None, None)
+                video_bytes = self._ltx_api_client.generate_audio_to_video(
+                    api_key=api_key,
+                    prompt=prompt,
+                    audio_uri=audio_uri,
+                    image_uri=image_uri,
+                    model=api_model_id,
+                    resolution=api_resolution,
+                )
+                self._generation.update_progress("downloading_output", 85, None, None)
+            elif has_input_image:
+                validated_image_path = validate_image_file(image_path)
+
+                duration = self._parse_forced_numeric_field(
+                    req.duration, "INVALID_FORCED_API_DURATION"
+                )
+                fps = self._parse_forced_numeric_field(
+                    req.fps, "INVALID_FORCED_API_FPS"
+                )
+                if fps not in FORCED_API_ALLOWED_FPS:
+                    raise HTTPError(400, "INVALID_FORCED_API_FPS")
+                if duration not in _get_allowed_durations(
+                    api_model_id, resolution_label, fps
+                ):
+                    raise HTTPError(400, "INVALID_FORCED_API_DURATION")
+
+                generate_audio = self._parse_audio_flag(req.audio)
+                self._generation.update_progress("uploading_image", 20, None, None)
+                image_uri = self._ltx_api_client.upload_file(
+                    api_key=api_key,
+                    file_path=str(validated_image_path),
+                )
+                self._generation.update_progress("inference", 55, None, None)
+                video_bytes = self._ltx_api_client.generate_image_to_video(
+                    api_key=api_key,
+                    prompt=prompt,
+                    image_uri=image_uri,
+                    model=api_model_id,
+                    resolution=api_resolution,
+                    duration=float(duration),
+                    fps=float(fps),
+                    generate_audio=generate_audio,
+                    camera_motion=req.cameraMotion,
+                )
+                self._generation.update_progress("downloading_output", 85, None, None)
+            else:
+                duration = self._parse_forced_numeric_field(
+                    req.duration, "INVALID_FORCED_API_DURATION"
+                )
+                fps = self._parse_forced_numeric_field(
+                    req.fps, "INVALID_FORCED_API_FPS"
+                )
+                if fps not in FORCED_API_ALLOWED_FPS:
+                    raise HTTPError(400, "INVALID_FORCED_API_FPS")
+                if duration not in _get_allowed_durations(
+                    api_model_id, resolution_label, fps
+                ):
+                    raise HTTPError(400, "INVALID_FORCED_API_DURATION")
+
+                generate_audio = self._parse_audio_flag(req.audio)
+                self._generation.update_progress("inference", 55, None, None)
+                video_bytes = self._ltx_api_client.generate_text_to_video(
+                    api_key=api_key,
+                    prompt=prompt,
+                    model=api_model_id,
+                    resolution=api_resolution,
+                    duration=float(duration),
+                    fps=float(fps),
+                    generate_audio=generate_audio,
+                    camera_motion=req.cameraMotion,
+                )
+                self._generation.update_progress("downloading_output", 85, None, None)
+
+            if self._generation.is_generation_cancelled():
+                raise RuntimeError("Generation was cancelled")
+
+            output_path = self._write_forced_api_video(video_bytes)
+            if self._generation.is_generation_cancelled():
+                output_path.unlink(missing_ok=True)
+                raise RuntimeError("Generation was cancelled")
+
+            self._generation.update_progress("complete", 100, None, None)
+            self._generation.complete_generation(str(output_path))
+            return GenerateVideoResponse(status="complete", video_path=str(output_path))
+        except HTTPError as e:
+            self._generation.fail_generation(e.detail)
+            raise
+        except Exception as e:
+            self._generation.fail_generation(str(e))
+            if "cancelled" in str(e).lower():
+                logger.info("Generation cancelled by user")
+                return GenerateVideoResponse(status="cancelled")
+            raise HTTPError(500, str(e)) from e
+
+    def _write_forced_api_video(self, video_bytes: bytes) -> Path:
+        output_path = self._make_output_path()
+        output_path.write_bytes(video_bytes)
+        return output_path
+
+    @staticmethod
+    def _parse_forced_numeric_field(raw_value: str, error_detail: str) -> int:
+        try:
+            return int(float(raw_value))
+        except (TypeError, ValueError):
+            raise HTTPError(400, error_detail) from None
+
+    @staticmethod
+    def _parse_audio_flag(audio_value: str | bool) -> bool:
+        if isinstance(audio_value, bool):
+            return audio_value
+        normalized = audio_value.strip().lower()
+        return normalized in {"1", "true", "yes", "on"}

LTX2.3-1.0.4/patches/keep_models_runtime.py

@@ -0,0 +1,16 @@
+"""仅提供强制卸载 GPU 管线。「保持模型加载」功能已移除。"""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+def force_unload_gpu_pipeline(pipelines: Any) -> None:
+    """释放推理管线占用的显存（切换 GPU、清理、LoRA 重建等场景）。"""
+    try:
+        pipelines.unload_gpu_pipeline()
+    except Exception:
+        try:
+            type(pipelines).unload_gpu_pipeline(pipelines)
+        except Exception:
+            pass

LTX2.3-1.0.4/patches/launcher.py

@@ -0,0 +1,20 @@
+
+import sys
+import os
+
+patch_dir = os.path.dirname(os.path.abspath(__file__))
+backend_dir = r"C:\Program Files\LTX Desktop\resources\backend"
+
+# 防御性清除：强行剥离所有的默认 backend_dir 引用
+sys.path = [p for p in sys.path if p and os.path.normpath(p) != os.path.normpath(backend_dir)]
+sys.path = [p for p in sys.path if p and p != "." and p != ""]
+
+# 绝对插队注入：优先搜索 PATCHES_DIR
+sys.path.insert(0, patch_dir)
+sys.path.insert(1, backend_dir)
+
+import uvicorn
+from ltx2_server import app
+
+if __name__ == '__main__':
+    uvicorn.run(app, host="0.0.0.0", port=3000, log_level="info", access_log=False)

LTX2.3-1.0.4/patches/lora_build_hook.py

@@ -0,0 +1,104 @@
+"""
+在 SingleGPUModelBuilder.build() 时合并「当前请求」的用户 LoRA。
+
+桌面版 Fast 管线往往只在 model_ledger 上挂 loras，真正 load 权重时仍用
+初始化时的空 loras Builder；此处对 DiT/Transformer 的 Builder 在 build 前注入。
+"""
+
+from __future__ import annotations
+
+import contextvars
+import logging
+from dataclasses import replace
+from typing import Any
+
+logger = logging.getLogger(__name__)
+
+# 当前 HTTP 请求/生成任务中要额外融合的 LoRA（LoraPathStrengthAndSDOps 元组）
+_pending_user_loras: contextvars.ContextVar[tuple[Any, ...] | None] = contextvars.ContextVar(
+    "ltx_pending_user_loras", default=None
+)
+
+_HOOK_INSTALLED = False
+
+
+def pending_loras_token(loras: tuple[Any, ...] | None):
+    """返回 contextvar Token，供 finally reset；loras 为 None 表示本任务不用额外 LoRA。"""
+    return _pending_user_loras.set(loras)
+
+
+def reset_pending_loras(token: contextvars.Token | None) -> None:
+    if token is not None:
+        _pending_user_loras.reset(token)
+
+
+def _get_pending() -> tuple[Any, ...] | None:
+    return _pending_user_loras.get()
+
+
+def _is_ltx_diffusion_transformer_builder(builder: Any) -> bool:
+    """避免给 Gemma / VAE / Upsampler 的 Builder 误加视频 LoRA。"""
+    cfg = getattr(builder, "model_class_configurator", None)
+    if cfg is None:
+        return False
+    name = getattr(cfg, "__name__", "") or ""
+    # 排除明显非 DiT 的
+    for bad in (
+        "Gemma",
+        "VideoEncoder",
+        "VideoDecoder",
+        "AudioEncoder",
+        "AudioDecoder",
+        "Vocoder",
+        "EmbeddingsProcessor",
+        "LatentUpsampler",
+    ):
+        if bad in name:
+            return False
+    try:
+        from ltx_core.model.transformer import LTXModelConfigurator
+
+        if isinstance(cfg, type):
+            try:
+                if issubclass(cfg, LTXModelConfigurator):
+                    return True
+            except TypeError:
+                pass
+        if cfg is LTXModelConfigurator:
+            return True
+    except ImportError:
+        pass
+    # 兜底：LTX 主 transformer 配置器命名习惯（排除已列出的 VAE/Gemma）
+    return "LTX" in name and "ModelConfigurator" in name
+
+
+def install_lora_build_hook() -> None:
+    global _HOOK_INSTALLED
+    if _HOOK_INSTALLED:
+        return
+    try:
+        from ltx_core.loader.single_gpu_model_builder import SingleGPUModelBuilder
+    except ImportError:
+        logger.warning("lora_build_hook: 无法导入 SingleGPUModelBuilder，跳过")
+        return
+
+    _orig_build = SingleGPUModelBuilder.build
+
+    def build(self: Any, *args: Any, **kwargs: Any) -> Any:
+        extra = _get_pending()
+        if extra and _is_ltx_diffusion_transformer_builder(self):
+            have = {getattr(x, "path", None) for x in self.loras}
+            add = tuple(x for x in extra if getattr(x, "path", None) not in have)
+            if add:
+                merged = (*tuple(self.loras), *add)
+                self = replace(self, loras=merged)
+                logger.info(
+                    "lora_build_hook: 已向 DiT Builder 合并 %d 个用户 LoRA: %s",
+                    len(add),
+                    [getattr(x, "path", x) for x in add],
+                )
+        return _orig_build(self, *args, **kwargs)
+
+    SingleGPUModelBuilder.build = build  # type: ignore[method-assign]
+    _HOOK_INSTALLED = True
+    logger.info("lora_build_hook: 已挂载 SingleGPUModelBuilder.build")

LTX2.3-1.0.4/patches/lora_injection.py

@@ -0,0 +1,139 @@
+"""将用户 LoRA 注入 Fast 视频管线：兼容 ModelLedger 与 LTX-2 DiffusionStage/Builder。"""
+
+from __future__ import annotations
+
+import inspect
+import logging
+from typing import Any
+
+logger = logging.getLogger(__name__)
+
+
+def _lora_init_kwargs(
+    pipeline_cls: type, loras: list[Any] | tuple[Any, ...]
+) -> dict[str, Any]:
+    if not loras:
+        return {}
+    try:
+        sig = inspect.signature(pipeline_cls.__init__)
+        names = sig.parameters.keys()
+    except (TypeError, ValueError):
+        return {}
+    tup = tuple(loras)
+    for key in ("loras", "lora", "extra_loras", "user_loras"):
+        if key in names:
+            return {key: tup}
+    return {}
+
+
+def inject_loras_into_fast_pipeline(ltx_pipe: Any, loras: list[Any] | tuple[Any, ...]) -> int:
+    """在已构造的管线上尽量把 LoRA 写进会参与 build 的 Builder / ledger。返回成功写入的处数。"""
+    if not loras:
+        return 0
+    tup = tuple(loras)
+    patched = 0
+    visited: set[int] = set()
+
+    def visit(obj: Any, depth: int) -> None:
+        nonlocal patched
+        if obj is None or depth > 10:
+            return
+        oid = id(obj)
+        if oid in visited:
+            return
+        visited.add(oid)
+
+        # ModelLedger.loras（旧桌面）
+        ml = getattr(obj, "model_ledger", None)
+        if ml is not None:
+            try:
+                ml.loras = tup
+                patched += 1
+                logger.info("LoRA: 已设置 model_ledger.loras")
+            except Exception as e:
+                logger.debug("model_ledger.loras: %s", e)
+
+        # SingleGPUModelBuilder.with_loras（常见与变体属性名）
+        for holder in (obj, ml):
+            if holder is None:
+                continue
+            candidates: list[Any] = []
+            for attr in (
+                "_transformer_builder",
+                "transformer_builder",
+                "_model_builder",
+                "model_builder",
+            ):
+                tb = getattr(holder, attr, None)
+                if tb is not None:
+                    candidates.append((attr, tb))
+            try:
+                for attr in dir(holder):
+                    al = attr.lower()
+                    if "transformer" in al and "builder" in al and attr not in (
+                        "_transformer_builder",
+                        "transformer_builder",
+                    ):
+                        tb = getattr(holder, attr, None)
+                        if tb is not None:
+                            candidates.append((attr, tb))
+            except Exception:
+                pass
+            for attr, tb in candidates:
+                if hasattr(tb, "with_loras"):
+                    try:
+                        new_tb = tb.with_loras(tup)
+                        setattr(holder, attr, new_tb)
+                        patched += 1
+                        logger.info("LoRA: 已更新 %s.with_loras", attr)
+                    except Exception as e:
+                        logger.debug("with_loras %s: %s", attr, e)
+
+        # DiffusionStage（类名或 isinstance）
+        is_diffusion = type(obj).__name__ == "DiffusionStage"
+        if not is_diffusion:
+            try:
+                from ltx_pipelines.utils.blocks import DiffusionStage as _DS
+
+                is_diffusion = isinstance(obj, _DS)
+            except ImportError:
+                pass
+        if is_diffusion:
+            tb = getattr(obj, "_transformer_builder", None)
+            if tb is not None and hasattr(tb, "with_loras"):
+                try:
+                    obj._transformer_builder = tb.with_loras(tup)
+                    patched += 1
+                    logger.info("LoRA: 已写入 DiffusionStage._transformer_builder")
+                except Exception as e:
+                    logger.debug("DiffusionStage: %s", e)
+
+        # 常见嵌套属性
+        for name in (
+            "pipeline",
+            "inner",
+            "_inner",
+            "fast_pipeline",
+            "_pipeline",
+            "stage_1",
+            "stage_2",
+            "stage",
+            "_stage",
+            "stages",
+            "diffusion",
+            "_diffusion",
+        ):
+            try:
+                ch = getattr(obj, name, None)
+            except Exception:
+                continue
+            if ch is not None and ch is not obj:
+                visit(ch, depth + 1)
+
+        if isinstance(obj, (list, tuple)):
+            for item in obj[:8]:
+                visit(item, depth + 1)
+
+    root = getattr(ltx_pipe, "pipeline", ltx_pipe)
+    visit(root, 0)
+    return patched

LTX2.3-1.0.4/patches/low_vram_runtime.py

@@ -0,0 +1,227 @@
+"""低显存模式：尽量降峰值显存（以速度换显存）；效果取决于官方管线是否支持 offload。"""
+
+from __future__ import annotations
+
+import gc
+import logging
+import os
+import types
+from pathlib import Path
+from typing import Any
+
+logger = logging.getLogger("ltx_low_vram")
+
+
+def _ltx_desktop_config_dir() -> Path:
+    p = (
+        Path(os.environ.get("LOCALAPPDATA", os.path.expanduser("~/AppData/Local")))
+        / "LTXDesktop"
+    )
+    p.mkdir(parents=True, exist_ok=True)
+    return p.resolve()
+
+
+def low_vram_pref_path() -> Path:
+    return _ltx_desktop_config_dir() / "low_vram_mode.pref"
+
+
+def read_low_vram_pref() -> bool:
+    f = low_vram_pref_path()
+    if not f.is_file():
+        return False
+    return f.read_text(encoding="utf-8").strip().lower() in ("1", "true", "yes", "on")
+
+
+def write_low_vram_pref(enabled: bool) -> None:
+    low_vram_pref_path().write_text(
+        "true\n" if enabled else "false\n", encoding="utf-8"
+    )
+
+
+def apply_low_vram_config_tweaks(handler: Any) -> None:
+    """在官方 RuntimeConfig 上尽量关闭 fast 超分等（若字段存在）。"""
+    cfg = getattr(handler, "config", None)
+    if cfg is None:
+        return
+    fm = getattr(cfg, "fast_model", None)
+    if fm is None:
+        return
+    try:
+        if hasattr(fm, "model_copy"):
+            updated = fm.model_copy(update={"use_upscaler": False})
+            setattr(cfg, "fast_model", updated)
+        elif hasattr(fm, "use_upscaler"):
+            setattr(fm, "use_upscaler", False)
+    except Exception as e:
+        logger.debug("low_vram: 无法关闭 fast_model.use_upscaler: %s", e)
+
+
+def install_low_vram_on_pipelines(handler: Any) -> None:
+    """启动时读取偏好，挂到 pipelines 上供各补丁读取。"""
+    pl = handler.pipelines
+    low = read_low_vram_pref()
+    setattr(pl, "low_vram_mode", bool(low))
+    if low:
+        apply_low_vram_config_tweaks(handler)
+        logger.info(
+            "low_vram_mode: 已开启（尝试关闭 fast 超分；若显存仍高，多为权重常驻 GPU，需降分辨率/时长或 FP8 权重）"
+        )
+
+
+def install_low_vram_pipeline_hooks(pl: Any) -> None:
+    """在 load_gpu_pipeline / load_a2v 返回后尝试 Diffusers 式 CPU offload（无则静默）。"""
+    if getattr(pl, "_ltx_low_vram_hooks_installed", False):
+        return
+    pl._ltx_low_vram_hooks_installed = True
+
+    if hasattr(pl, "load_gpu_pipeline"):
+        _orig_gpu = pl.load_gpu_pipeline
+        pl._ltx_orig_load_gpu_for_low_vram = _orig_gpu
+
+        def _load_gpu_wrapped(self: Any, *a: Any, **kw: Any) -> Any:
+            r = _orig_gpu(*a, **kw)
+            if getattr(self, "low_vram_mode", False):
+                try_sequential_offload_on_pipeline_state(r)
+            return r
+
+        pl.load_gpu_pipeline = types.MethodType(_load_gpu_wrapped, pl)
+
+    if hasattr(pl, "load_a2v_pipeline"):
+        _orig_a2v = pl.load_a2v_pipeline
+        pl._ltx_orig_load_a2v_for_low_vram = _orig_a2v
+
+        def _load_a2v_wrapped(self: Any, *a: Any, **kw: Any) -> Any:
+            r = _orig_a2v(*a, **kw)
+            if getattr(self, "low_vram_mode", False):
+                try_sequential_offload_on_pipeline_state(r)
+            return r
+
+        pl.load_a2v_pipeline = types.MethodType(_load_a2v_wrapped, pl)
+
+    # Monkey patch: 接管 1.0.3 新增的底层 layer streaming 来实现完美的线性显存控制
+    if not getattr(pl, "_ltx_layer_streaming_patched", False):
+        pl._ltx_layer_streaming_patched = True
+        try:
+            def _patch_pipeline_class(cls_name, mod_name):
+                import importlib
+                try:
+                    mod = importlib.import_module(mod_name)
+                    pipeline_cls = getattr(mod, cls_name)
+                    _orig_call = pipeline_cls.__call__
+                    
+                    def _patched_call(self, *args, **kwargs):
+                        lim = get_vram_limit()
+                        if lim is not None:
+                            if lim == 0:
+                                # 0表示无限，完全关闭流传输，峰值会在26GB左右，速度最快
+                                kwargs["streaming_prefetch_count"] = None
+                                logger.info(f"low_vram_mode: VRAM limit is unlimited (0). Disabled layer streaming.")
+                            else:
+                                # 实测反馈：streaming_prefetch_count 的显存成本模型。
+                                # 数据表现：count=1 -> 峰值10G；count=8 -> 峰值14.7G；count=14 -> 峰值19G。
+                                # 精确建模：每提高 1 count，全局真实峰值严格提升 ≈ 0.67 GB。
+                                if lim <= 10.0:
+                                    count = 1
+                                elif lim >= 25.0:
+                                    count = None  # 接近极致直接放开
+                                else:
+                                    # 基于 10.0GB 进行精确的四舍五入映射，让它绝对贴紧用户输入的数值
+                                    extra_gb = float(lim) - 10.0
+                                    count = max(1, min(32, 1 + round(extra_gb / 0.67)))
+                                
+                                kwargs["streaming_prefetch_count"] = count
+                                logger.info(f"low_vram_mode: Dynamically tuned layer streaming prefetch count to {count} for {lim}GB limit.")
+                                
+                        return _orig_call(self, *args, **kwargs)
+                        
+                    pipeline_cls.__call__ = _patched_call
+                    logger.info(f"low_vram_mode: Successfully patched {cls_name} to override streaming_prefetch_count")
+                except Exception as e:
+                    pass
+
+            _patch_pipeline_class("DistilledPipeline", "ltx_pipelines.distilled")
+            _patch_pipeline_class("LTXRetakePipeline", "services.retake_pipeline.ltx_retake_pipeline")
+            _patch_pipeline_class("ICLoRAPipeline", "services.ic_lora_pipeline.ltx_ic_lora_pipeline")
+            _patch_pipeline_class("A2VPipeline", "services.a2v_pipeline.distilled_a2v_pipeline")
+        except Exception:
+            pass
+
+
+def get_vram_limit() -> float | None:
+    try:
+        import json
+        from pathlib import Path
+        settings_file = _ltx_desktop_config_dir() / "settings.json"
+        if settings_file.exists():
+            with open(settings_file, "r", encoding="utf-8") as f:
+                data = json.load(f)
+            if "vram_limit" in data:
+                lim = data["vram_limit"]
+                if lim != "":
+                    return float(lim)
+    except Exception:
+        pass
+    return None
+
+def try_sequential_offload_on_pipeline_state(state: Any) -> None:
+    """按设定最高显存分配，爆显存后写入系统内存"""
+    if state is None:
+        return
+    root = getattr(state, "pipeline", state)
+    candidates: list[Any] = [root]
+    inner = getattr(root, "pipeline", None)
+    if inner is not None and inner is not root:
+        candidates.append(inner)
+        
+    vram_limit = get_vram_limit()
+    
+    # We always apply the macro-level offload (enable_model_cpu_offload)
+    # to guarantee that T5 and VAE are evicted when DiT is generating, and vice versa.
+    # The micro-level (DiT intra-layer streaming) is already controlled by our __call__ hook.
+    
+    # Fallback to defaults (which applies the pipeline-level macro offload)
+    for obj in candidates:
+        for method_name in (
+            "enable_model_cpu_offload",
+            "enable_sequential_cpu_offload",
+        ):
+            fn = getattr(obj, method_name, None)
+            if callable(fn):
+                try:
+                    fn()
+                    logger.info(
+                        "low_vram_mode: 已对管线调用 %s()",
+                        method_name,
+                    )
+                    return
+                except Exception as e:
+                    logger.debug(
+                        "low_vram_mode: %s() 失败（可忽略）: %s",
+                        method_name,
+                        e,
+                    )
+
+
+def maybe_release_pipeline_after_task(handler: Any) -> None:
+    """单次生成结束后：低显存模式下强制卸载管线并回收缓存。"""
+    pl = getattr(handler, "pipelines", None) or getattr(handler, "_pipelines", None)
+    if pl is None or not getattr(pl, "low_vram_mode", False):
+        return
+    try:
+        from keep_models_runtime import force_unload_gpu_pipeline
+
+        force_unload_gpu_pipeline(pl)
+    except Exception as e:
+        logger.debug("low_vram_mode: 任务后卸载失败: %s", e)
+    try:
+        pl._pipeline_signature = None
+    except Exception:
+        pass
+    gc.collect()
+    try:
+        import torch
+
+        if torch.cuda.is_available():
+            torch.cuda.empty_cache()
+    except Exception:
+        pass

LTX2.3-1.0.4/patches/runtime_policy.py

@@ -0,0 +1,21 @@
+"""Runtime policy decisions for forced API mode."""
+
+from __future__ import annotations
+
+
+def decide_force_api_generations(
+    system: str, cuda_available: bool, vram_gb: int | None
+) -> bool:
+    """Return whether API-only generation must be forced for this runtime."""
+    if system == "Darwin":
+        return True
+
+    if system in ("Windows", "Linux"):
+        if not cuda_available:
+            return True
+        if vram_gb is None:
+            return True
+        return vram_gb < 6
+
+    # Fail closed for non-target platforms unless explicitly relaxed.
+    return True

LTX2.3-1.0.4/patches/settings.json

@@ -0,0 +1,23 @@
+{
+  "use_torch_compile": false,
+  "load_on_startup": false,
+  "ltx_api_key": "1231",
+  "user_prefers_ltx_api_video_generations": false,
+  "fal_api_key": "",
+  "use_local_text_encoder": true,
+  "fast_model": {
+    "use_upscaler": true
+  },
+  "pro_model": {
+    "steps": 20,
+    "use_upscaler": true
+  },
+  "prompt_cache_size": 100,
+  "prompt_enhancer_enabled_t2v": true,
+  "prompt_enhancer_enabled_i2v": false,
+  "gemini_api_key": "",
+  "seed_locked": false,
+  "locked_seed": 42,
+  "models_dir": "",
+  "lora_dir": ""
+}

LTX2.3-1.0.4/run.bat

@@ -0,0 +1,38 @@
+@echo off
+title LTX-2 Cinematic Workstation
+
+echo =========================================================
+echo    LTX-2 Cinematic UI Booting...
+echo =========================================================
+echo.
+
+set "LTX_PY=%USERPROFILE%\AppData\Local\LTXDesktop\python\python.exe"
+set "LTX_UI_URL=http://127.0.0.1:4000/"
+
+if exist "%LTX_PY%" (
+    echo [SUCCESS] LTX Bundled Python environment detected!
+    echo [INFO] Browser will open automatically when UI is ready...
+    start "" powershell -NoProfile -WindowStyle Hidden -Command "$ProgressPreference='SilentlyContinue'; $deadline=(Get-Date).AddSeconds(60); while((Get-Date) -lt $deadline){ try { Invoke-WebRequest -UseBasicParsing '%LTX_UI_URL%' -TimeoutSec 2 | Out-Null; Start-Process '%LTX_UI_URL%'; exit 0 } catch { Start-Sleep -Seconds 1 } }"
+    echo [INFO] Starting workspace natively...
+    echo ---------------------------------------------------------
+    "%LTX_PY%" main.py
+    pause
+    exit /b
+)
+
+python --version >nul 2>&1
+if %errorlevel% equ 0 (
+    echo [WARNING] LTX Bundled Python not found.
+    echo [INFO] Browser will open automatically when UI is ready...
+    start "" powershell -NoProfile -WindowStyle Hidden -Command "$ProgressPreference='SilentlyContinue'; $deadline=(Get-Date).AddSeconds(60); while((Get-Date) -lt $deadline){ try { Invoke-WebRequest -UseBasicParsing '%LTX_UI_URL%' -TimeoutSec 2 | Out-Null; Start-Process '%LTX_UI_URL%'; exit 0 } catch { Start-Sleep -Seconds 1 } }"
+    echo [INFO] Falling back to global Python environment...
+    echo ---------------------------------------------------------
+    python main.py
+    pause
+    exit /b
+)
+
+echo [ERROR] FATAL: No Python interpreter found on this system.
+echo [INFO] Please run install.bat to download and set up Python!
+echo.
+pause