From 55ed3bae237022c033ac62d753b3029614937f5e Mon Sep 17 00:00:00 2001
From: huimanQAQ <huimanQAQ@gmail.com>
Date: Wed, 28 Oct 2026 23:57:57 +0800
Subject: [PATCH 1/6] =?UTF-8?q?feat(tools):=20=E6=96=B0=E5=A2=9E=E5=BC=80?=
 =?UTF-8?q?=E5=9C=BA=E8=A7=86=E9=A2=91=E4=B8=8E=E6=9B=B2=E7=9B=AE=E4=BC=AA?=
 =?UTF-8?q?=E8=A3=85=E7=9A=84=E7=BC=96=E8=BE=91=E5=B7=A5=E5=85=B7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 后端新增 FancyToolController，配合 AquaMai 的 Fancy.CustomIntroCinematic / Fancy.TrackCamouflage：
  - 开场视频：GetIntroMovie / GetIntroMovieFile（支持 Range）/ GetIntroMovieList / SetIntroMovie / DeleteIntroMovie
  - 上传视频统一转 H.264 MP4，并按当前编码器给画质参数（h264_mf 默认画质极低，实测同源 2.86 Mbps → 13 Mbps）
  - 支持左右屏同一视频（L=R）与左右分开；替换单侧时自动补齐另一侧
  - 音轨自动抽取成 Enter_<id>.acb / .awb（游戏里由 acb/awb 发声）；另提供 SetIntroAudio / DeleteIntroAudio 单独替换音频
  - 曲目伪装：GetCamouflage / GetCamouflageJacket / GetCamouflageList / SetCamouflage（Toml）/ SetCamouflageJacket / DeleteCamouflage
  - 删除与覆盖统一走占用重试（DeleteFilesWithRetry / MoveFileWithRetry），文件被占用时不会卡死或误报成功
- VideoConvert 新增 KeepAudio / ExtraArgs 选项与 H264QualityArgs，其他调用方行为不变
- 前端：工具页新增入口 + IntroCamouflageModal
  - 使用 MuNET-UI 的 Tabs / Select / TextInput / CheckBox，曲目选择带搜索框过滤
  - 左右分屏 1:2 预览，播放/暂停/拖动进度双向同步，显示实际分辨率与文件路径
  - 未选择乐曲时所有输入与按钮禁用
  - 已有列表显示真实曲名，载入时清空搜索并定位到该曲目
---
 .../Controllers/Tools/FancyToolController.cs  | 605 +++++++++++++++
 MaiChartManager/Front/src/client/apiGen.ts    | 333 ++++++++-
 MaiChartManager/Front/src/locales/en.yaml     |  64 ++
 MaiChartManager/Front/src/locales/zh-TW.yaml  |  64 ++
 MaiChartManager/Front/src/locales/zh.yaml     |  64 ++
 .../src/views/Tools/IntroCamouflageModal.tsx  | 698 ++++++++++++++++++
 .../Front/src/views/Tools/index.tsx           |   9 +
 MaiChartManager/Utils/VideoConvert.cs         |  43 +-
 8 files changed, 1878 insertions(+), 2 deletions(-)
 create mode 100644 MaiChartManager/Controllers/Tools/FancyToolController.cs
 create mode 100644 MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx

diff --git a/MaiChartManager/Controllers/Tools/FancyToolController.cs b/MaiChartManager/Controllers/Tools/FancyToolController.cs
new file mode 100644
index 00000000..bf3d4cc3
--- /dev/null
+++ b/MaiChartManager/Controllers/Tools/FancyToolController.cs
@@ -0,0 +1,605 @@
+using MaiChartManager.Platform;
+using MaiChartManager.Utils;
+using Microsoft.AspNetCore.Mvc;
+using Tomlyn;
+using Tomlyn.Model;
+
+namespace MaiChartManager.Controllers.Tools;
+
+/// <summary>
+/// 配合 AquaMai 的两个花活功能的编辑工具：
+/// <list type="bullet">
+/// <item>开场视频 CustomIntroCinematic：LocalAssets/IntroMovies/Enter_&lt;id&gt;.mp4（或 Enter_&lt;id&gt;_L/_R.mp4 左右分开）</item>
+/// <item>曲目伪装 TrackCamouflage：LocalAssets/Camouflages/&lt;id&gt;.toml + &lt;id&gt;_jacket.jpg/png</item>
+/// </list>
+/// </summary>
+[ApiController]
+[Route("MaiChartManagerServlet/[action]Api")]
+public class FancyToolController(ILogger<FancyToolController> logger) : ControllerBase
+{
+    private static readonly TomlModelOptions TomlOptions = new() { ConvertPropertyName = name => name };
+
+    private static string IntroMovieDir => Path.Combine(StaticSettings.GamePath, "LocalAssets", "IntroMovies");
+    private static string CamouflageDir => Path.Combine(StaticSettings.GamePath, "LocalAssets", "Camouflages");
+
+    public record FancyToolResult(bool Success, string? Error);
+
+    public record IntroMovieInfo(bool HasSingle, bool HasLeft, bool HasRight, bool HasAudio,
+        string? SinglePath, string? LeftPath, string? RightPath);
+
+    public record CamouflageInfoDto(string? Name, string? Artist, string? NoteDesigner, bool HideNoteDesigner,
+        double UnlockScore, bool HasJacket, string? JacketPath);
+
+    public class CamouflageModel
+    {
+        public string Name { get; set; } = "";
+        public string Artist { get; set; } = "";
+        public string? NoteDesigner { get; set; }
+        public bool HideNoteDesigner { get; set; }
+        public double UnlockScore { get; set; }
+    }
+
+    #region 开场视频
+
+    [HttpGet]
+    public IntroMovieInfo GetIntroMovie(int id)
+    {
+        var singlePath = ExistingPath(VideoFileName(id, null));
+        var leftPath = ExistingPath(VideoFileName(id, "L"));
+        var rightPath = ExistingPath(VideoFileName(id, "R"));
+        return new IntroMovieInfo(singlePath is not null, leftPath is not null, rightPath is not null,
+            System.IO.File.Exists(Path.Combine(IntroMovieDir, $"Enter_{id}.acb"))
+            && System.IO.File.Exists(Path.Combine(IntroMovieDir, $"Enter_{id}.awb")),
+            singlePath, leftPath, rightPath);
+    }
+
+    /// <summary>
+    /// 取开场视频文件供前端预览。未指定 side 时依次取单文件 / 左 / 右。
+    /// </summary>
+    [HttpGet]
+    public ActionResult GetIntroMovieFile(int id, string? side)
+    {
+        var path = side?.ToUpperInvariant() switch
+        {
+            "L" => ExistingPath(VideoFileName(id, "L")),
+            "R" => ExistingPath(VideoFileName(id, "R")),
+            _ => ExistingPath(VideoFileName(id, null))
+                 ?? ExistingPath(VideoFileName(id, "L"))
+                 ?? ExistingPath(VideoFileName(id, "R")),
+        };
+
+        if (path is null) return NotFound();
+        // enableRangeProcessing：<video> 拖动进度条需要 Range 请求
+        // 注意必须用 PhysicalFile：ControllerBase.File(string) 会把参数当成 wwwroot 下的虚拟路径，绝对路径会直接 500
+        return PhysicalFile(path, "video/mp4", enableRangeProcessing: true);
+    }
+
+    /// <summary>
+    /// 上传并转换开场视频。side 为空表示左右屏播放同一个视频，L / R 表示只替换其中一侧。
+    /// </summary>
+    [HttpPost]
+    [DisableRequestSizeLimit]
+    public async Task<FancyToolResult> SetIntroMovie([FromForm] int id, [FromForm] string? side, IFormFile file)
+    {
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+        var gamePathError = EnsureGamePath();
+        if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
+#if WINDOWS
+        if (IapManager.License != IapManager.LicenseStatus.Active)
+            return new FancyToolResult(false, "license-required");
+#endif
+
+        var normalizedSide = string.IsNullOrWhiteSpace(side) ? null : side.ToUpperInvariant();
+        if (normalizedSide is not (null or "L" or "R")) return new FancyToolResult(false, "invalid-side");
+
+        var tmpDir = Directory.CreateTempSubdirectory();
+        try
+        {
+            var inputPath = Path.Combine(tmpDir.FullName, "input" + Path.GetExtension(file.FileName));
+            await using (var stream = System.IO.File.Create(inputPath))
+            {
+                await file.CopyToAsync(stream);
+            }
+
+            Directory.CreateDirectory(IntroMovieDir);
+            var targetPath = Path.Combine(IntroMovieDir, VideoFileName(id, normalizedSide));
+            var tmpVideoPath = Path.Combine(tmpDir.FullName, "output.mp4");
+
+            // 统一转成 H.264 MP4：游戏里的 VideoPlayer 只保证能播这种编码
+            await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
+            {
+                InputPath = inputPath,
+                OutputPath = tmpVideoPath,
+                UseH264 = true,
+                NoScale = true, // 保持原分辨率，游戏里按比例缩放
+                Padding = 0,
+                ContentType = file.ContentType,
+                TaskbarProgress = false,
+                // 保留一份音轨，前端预览才听得到声音；游戏里 AquaMai 会把视频音轨静音，声音走 acb/awb
+                KeepAudio = true,
+                // 硬件编码器默认画质差别很大（h264_mf 默认很糊），这里按选中的编码器给画质参数
+                ExtraArgs = VideoConvert.H264QualityArgs(VideoConvert.H264Encoder),
+            });
+
+            if (!System.IO.File.Exists(tmpVideoPath)) return new FancyToolResult(false, "convert-failed");
+
+            // mp4 只保留画面（VideoConvert 用 -map 0:0 丢掉了音轨）；音轨另外提取成 Enter_<id>.acb/.awb，
+            // 游戏里由 AquaMai 单独播放，这样视频静音、声音走 acb/awb。
+            await CreateIntroAudio(inputPath, id, tmpDir.FullName);
+
+            MoveFileWithRetry(tmpVideoPath, targetPath);
+
+            if (normalizedSide is null)
+            {
+                // 单文件与左右分开的写法不能共存
+                DeleteFilesWithRetry(
+                    Path.Combine(IntroMovieDir, VideoFileName(id, "L")),
+                    Path.Combine(IntroMovieDir, VideoFileName(id, "R")));
+            }
+            else
+            {
+                DeleteFilesWithRetry(Path.Combine(IntroMovieDir, VideoFileName(id, null)));
+                // 只替换一侧时，另一侧还没有的话先复制一份，保证左右都在
+                var otherSide = normalizedSide == "L" ? "R" : "L";
+                var otherPath = Path.Combine(IntroMovieDir, VideoFileName(id, otherSide));
+                if (!System.IO.File.Exists(otherPath)) PlatformFile.CopyFile(targetPath, otherPath);
+            }
+
+            return new FancyToolResult(true, null);
+        }
+        catch (Exception e)
+        {
+            logger.LogError(e, "转换开场视频失败: {id}", id);
+            return new FancyToolResult(false, "convert-failed");
+        }
+        finally
+        {
+            try
+            {
+                tmpDir.Delete(true);
+            }
+            catch
+            {
+                // 忽略清理失败
+            }
+        }
+    }
+
+    /// <summary>
+    /// 从上传的文件里提取音轨，生成 Enter_&lt;id&gt;.acb / .awb。
+    /// 开场 mp4 本身是静音的，游戏里由 acb/awb 出声（AquaMai 的 CustomIntroCinematic 会调 SoundManager 播放）。
+    /// 没有音轨或转换失败时清掉旧的 acb/awb，避免出现「新视频配旧音频」。
+    /// </summary>
+    /// <summary>
+    /// 替换 / 新增开场音频。左右屏共用一套音频（Enter_&lt;id&gt;.acb / .awb），
+    /// 任意 ffmpeg 能解码的音频都会先解成 wav，再封装成 acb/awb。
+    /// </summary>
+    [HttpPost]
+    [DisableRequestSizeLimit]
+    public async Task<FancyToolResult> SetIntroAudio([FromForm] int id, IFormFile file)
+    {
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+        var gamePathError = EnsureGamePath();
+        if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
+#if WINDOWS
+        if (IapManager.License != IapManager.LicenseStatus.Active)
+            return new FancyToolResult(false, "license-required");
+#endif
+        if (file is null || file.Length <= 0) return new FancyToolResult(false, "invalid-audio");
+
+        var tmpDir = Directory.CreateTempSubdirectory();
+        try
+        {
+            Directory.CreateDirectory(IntroMovieDir);
+            var inputPath = Path.Combine(tmpDir.FullName, "input" + Path.GetExtension(file.FileName));
+            await using (var stream = System.IO.File.Create(inputPath))
+            {
+                await file.CopyToAsync(stream);
+            }
+
+            // CreateIntroAudio 内部已做「先转临时文件再搬过去」，失败时返回 false
+            if (!await CreateIntroAudio(inputPath, id, tmpDir.FullName, deleteOnFailure: false))
+                return new FancyToolResult(false, "invalid-audio");
+
+            return new FancyToolResult(true, null);
+        }
+        catch (Exception e)
+        {
+            logger.LogError(e, "写入开场音频失败: {id}", id);
+            return new FancyToolResult(false, "write-failed");
+        }
+        finally
+        {
+            try
+            {
+                tmpDir.Delete(true);
+            }
+            catch
+            {
+                // 忽略清理失败
+            }
+        }
+    }
+
+    /// <summary>
+    /// 只删掉开场音频，保留视频（左右屏共用的那一套 acb/awb）。
+    /// </summary>
+    [HttpPost]
+    public FancyToolResult DeleteIntroAudio(int id)
+    {
+        var ok = DeleteFilesWithRetry(
+            Path.Combine(IntroMovieDir, $"Enter_{id}.acb"),
+            Path.Combine(IntroMovieDir, $"Enter_{id}.awb"));
+        return new FancyToolResult(ok, ok ? null : "delete-failed");
+    }
+
+    private async Task<bool> CreateIntroAudio(string inputPath, int id, string tmpDir, bool deleteOnFailure = true)
+    {
+        var acbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.acb");
+        var awbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.awb");
+        var wavPath = Path.Combine(tmpDir, "audio.wav");
+        // 先在临时目录里生成，两个文件都成功后再搬过去
+        var tmpAcbPath = Path.Combine(tmpDir, $"Enter_{id}.acb");
+        var tmpAwbPath = Path.Combine(tmpDir, $"Enter_{id}.awb");
+
+        try
+        {
+            Audio.ExtractAudioFromMp4(inputPath, wavPath);
+            if (!System.IO.File.Exists(wavPath) || new FileInfo(wavPath).Length <= 44)
+                throw new InvalidOperationException("no audio track in source file");
+
+            // HCA 编码比较慢，别占着请求线程
+            await Task.Run(() => Audio.ConvertToMai(wavPath, tmpAcbPath));
+
+            if (!System.IO.File.Exists(tmpAcbPath) || !System.IO.File.Exists(tmpAwbPath))
+                throw new InvalidOperationException("acb/awb not generated");
+
+            MoveFileWithRetry(tmpAcbPath, acbPath);
+            MoveFileWithRetry(tmpAwbPath, awbPath);
+            return true;
+        }
+        catch (Exception e)
+        {
+            logger.LogWarning(e, "开场视频音频生成失败，按静音处理: {id}", id);
+            // 换视频时音画必须配套，所以没音轨就清掉旧的；用户单独传音频失败则保留原来的
+            if (deleteOnFailure)
+            {
+                DeleteFilesWithRetry(acbPath, awbPath);
+            }
+            return false;
+        }
+    }
+
+    [HttpPost]
+    public FancyToolResult DeleteIntroMovie(int id)
+    {
+        var ok = DeleteFilesWithRetry(
+            Path.Combine(IntroMovieDir, VideoFileName(id, null)),
+            Path.Combine(IntroMovieDir, VideoFileName(id, "L")),
+            Path.Combine(IntroMovieDir, VideoFileName(id, "R")),
+            Path.Combine(IntroMovieDir, $"Enter_{id}.acb"),
+            Path.Combine(IntroMovieDir, $"Enter_{id}.awb"));
+        return new FancyToolResult(ok, ok ? null : "delete-failed");
+    }
+
+    /// <summary>
+    /// 删除文件（Windows 走回收站）。被占用时（例如前端还在预览这个视频、句柄没释放）重试几次，
+    /// 全部失败才返回 false，让前端提示「文件被占用」而不是静默失败。
+    /// </summary>
+    /// <summary>
+    /// 覆盖式移动文件：目标被占用（例如前端还在预览旧文件）时重试几次。
+    /// </summary>
+    private static void MoveFileWithRetry(string source, string dest)
+    {
+        for (var attempt = 0; ; attempt++)
+        {
+            try
+            {
+                PlatformFile.MoveFile(source, dest);
+                return;
+            }
+            catch (Exception) when (attempt < 10)
+            {
+                Thread.Sleep(150);
+            }
+        }
+    }
+
+    private static bool DeleteFilesWithRetry(params string[] paths)
+    {
+        // 先等占用消失：这一步很便宜（只是尝试以独占方式打开文件），避免回收站删除在被占用时卡很久
+        var deadline = DateTime.UtcNow.AddSeconds(3);
+        var pending = paths.Where(System.IO.File.Exists).ToList();
+        while (pending.Count > 0 && DateTime.UtcNow < deadline && pending.Any(IsFileLocked))
+        {
+            Thread.Sleep(100);
+        }
+
+        var ok = true;
+        foreach (var path in pending)
+        {
+            if (!System.IO.File.Exists(path)) continue;
+            if (!TryDeleteFile(path)) ok = false;
+        }
+
+        return ok;
+    }
+
+    /// <summary>
+    /// 文件是否还被别人占着（能独占打开就说明没被占用）。
+    /// </summary>
+    private static bool IsFileLocked(string path)
+    {
+        try
+        {
+            using var stream = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.None);
+            return false;
+        }
+        catch (IOException)
+        {
+            return true;
+        }
+        catch (UnauthorizedAccessException)
+        {
+            return true;
+        }
+    }
+
+    private static bool TryDeleteFile(string path)
+    {
+        for (var attempt = 0; attempt < 2; attempt++)
+        {
+            if (!System.IO.File.Exists(path)) return true;
+            if (IsFileLocked(path))
+            {
+                Thread.Sleep(100);
+                continue;
+            }
+
+            try
+            {
+                PlatformFile.DeleteFile(path);
+                if (!System.IO.File.Exists(path)) return true;
+            }
+            catch (Exception)
+            {
+                // 交给下面的兜底
+            }
+
+            Thread.Sleep(100);
+        }
+
+        // 兜底：回收站删除失败时直接删，至少别让用户卡在「删不掉」
+        try
+        {
+            if (System.IO.File.Exists(path)) System.IO.File.Delete(path);
+            return !System.IO.File.Exists(path);
+        }
+        catch (Exception)
+        {
+            return false;
+        }
+    }
+
+    private static string VideoFileName(int id, string? side) => side is null ? $"Enter_{id}.mp4" : $"Enter_{id}_{side}.mp4";
+
+    private static string? ExistingPath(string fileName)
+    {
+        var path = Path.Combine(IntroMovieDir, fileName);
+        return System.IO.File.Exists(path) ? path : null;
+    }
+
+    public record IntroMovieEntry(int Id, bool HasSingle, bool HasLeft, bool HasRight, bool HasAudio);
+
+    /// <summary>
+    /// 列出 IntroMovies 目录里已有的开场视频。
+    /// </summary>
+    [HttpGet]
+    public IEnumerable<IntroMovieEntry> GetIntroMovieList()
+    {
+        if (!Directory.Exists(IntroMovieDir)) return [];
+
+        var ids = new HashSet<int>();
+        foreach (var file in Directory.EnumerateFiles(IntroMovieDir, "*.mp4"))
+        {
+            var name = Path.GetFileNameWithoutExtension(file);
+            if (!name.StartsWith("Enter_", StringComparison.OrdinalIgnoreCase)) continue;
+
+            var parts = name[6..].Split('_');
+            if (parts.Length is < 1 or > 2) continue;
+            if (int.TryParse(parts[0], out var id) && id > 0) ids.Add(id);
+        }
+
+        return ids.OrderBy(id => id).Select(id => new IntroMovieEntry(
+            id,
+            System.IO.File.Exists(Path.Combine(IntroMovieDir, VideoFileName(id, null))),
+            System.IO.File.Exists(Path.Combine(IntroMovieDir, VideoFileName(id, "L"))),
+            System.IO.File.Exists(Path.Combine(IntroMovieDir, VideoFileName(id, "R"))),
+            System.IO.File.Exists(Path.Combine(IntroMovieDir, $"Enter_{id}.acb"))
+            && System.IO.File.Exists(Path.Combine(IntroMovieDir, $"Enter_{id}.awb")))).ToList();
+    }
+
+    #endregion
+
+    #region 曲目伪装
+
+    [HttpGet]
+    public CamouflageInfoDto GetCamouflage(int id)
+    {
+        var path = Path.Combine(CamouflageDir, $"{id}.toml");
+        var model = new CamouflageModel();
+        if (System.IO.File.Exists(path))
+        {
+            try
+            {
+                model = Toml.ToModel<CamouflageModel>(System.IO.File.ReadAllText(path), options: TomlOptions)
+                        ?? new CamouflageModel();
+            }
+            catch (Exception e)
+            {
+                logger.LogWarning(e, "解析曲目伪装配置失败: {path}", path);
+            }
+        }
+
+        var jacketPath = FindJacket(id);
+        return new CamouflageInfoDto(model.Name, model.Artist, model.NoteDesigner, model.HideNoteDesigner,
+            model.UnlockScore, jacketPath is not null, jacketPath);
+    }
+
+    /// <summary>
+    /// 取伪装封面供前端预览。
+    /// </summary>
+    [HttpGet]
+    public ActionResult GetCamouflageJacket(int id)
+    {
+        var path = FindJacket(id);
+        if (path is null) return NotFound();
+
+        var contentType = Path.GetExtension(path).ToLowerInvariant() == ".png" ? "image/png" : "image/jpeg";
+        return PhysicalFile(path, contentType, enableRangeProcessing: true);
+    }
+
+    [HttpPost]
+    public FancyToolResult SetCamouflage([FromForm] int id, [FromForm] string? name, [FromForm] string? artist,
+        [FromForm] string? noteDesigner, [FromForm] bool hideNoteDesigner, [FromForm] double unlockScore)
+    {
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+        if (string.IsNullOrWhiteSpace(name) || string.IsNullOrWhiteSpace(artist))
+            return new FancyToolResult(false, "invalid-text");
+
+        var gamePathError = EnsureGamePath();
+        if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
+
+        var model = new CamouflageModel
+        {
+            Name = name.Trim(),
+            Artist = artist.Trim(),
+            NoteDesigner = noteDesigner?.Trim() ?? "",
+            HideNoteDesigner = hideNoteDesigner,
+            UnlockScore = unlockScore,
+        };
+
+        try
+        {
+            Directory.CreateDirectory(CamouflageDir);
+            WriteAllTextAtomic(Path.Combine(CamouflageDir, $"{id}.toml"),
+                Toml.FromModel(model, TomlOptions));
+            return new FancyToolResult(true, null);
+        }
+        catch (Exception e)
+        {
+            logger.LogError(e, "写入曲目伪装配置失败: {id}", id);
+            return new FancyToolResult(false, "write-failed");
+        }
+    }
+
+    [HttpPost]
+    [DisableRequestSizeLimit]
+    public async Task<FancyToolResult> SetCamouflageJacket([FromForm] int id, IFormFile file)
+    {
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+
+        var ext = Path.GetExtension(file.FileName).ToLowerInvariant();
+        if (ext is not (".jpg" or ".jpeg" or ".png")) return new FancyToolResult(false, "invalid-image");
+
+        var gamePathError = EnsureGamePath();
+        if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
+
+        try
+        {
+            Directory.CreateDirectory(CamouflageDir);
+            var targetPath = Path.Combine(CamouflageDir, $"{id}_jacket{ext}");
+            // 同一首曲子只保留一张封面
+            foreach (var otherExt in new[] { ".jpg", ".jpeg", ".png" })
+            {
+                var otherPath = Path.Combine(CamouflageDir, $"{id}_jacket{otherExt}");
+                if (!string.Equals(otherPath, targetPath, StringComparison.OrdinalIgnoreCase))
+                    DeleteFilesWithRetry(otherPath);
+            }
+
+            await using var stream = System.IO.File.Create(targetPath);
+            await file.CopyToAsync(stream);
+            return new FancyToolResult(true, null);
+        }
+        catch (Exception e)
+        {
+            logger.LogError(e, "写入曲目伪装封面失败: {id}", id);
+            return new FancyToolResult(false, "write-failed");
+        }
+    }
+
+    [HttpPost]
+    public FancyToolResult DeleteCamouflage(int id)
+    {
+        var ok = DeleteFilesWithRetry(
+            [
+                Path.Combine(CamouflageDir, $"{id}.toml"),
+                .. new[] { ".jpg", ".jpeg", ".png" }.Select(ext => Path.Combine(CamouflageDir, $"{id}_jacket{ext}")),
+            ]);
+        return new FancyToolResult(ok, ok ? null : "delete-failed");
+    }
+
+    private static string? FindJacket(int id)
+    {
+        foreach (var ext in new[] { ".jpg", ".jpeg", ".png" })
+        {
+            var path = Path.Combine(CamouflageDir, $"{id}_jacket{ext}");
+            if (System.IO.File.Exists(path)) return path;
+        }
+
+        return null;
+    }
+
+    public record CamouflageEntry(int Id, string? Name, string? Artist, bool HasJacket);
+
+    /// <summary>
+    /// 列出 Camouflages 目录里已有的曲目伪装。
+    /// </summary>
+    [HttpGet]
+    public IEnumerable<CamouflageEntry> GetCamouflageList()
+    {
+        if (!Directory.Exists(CamouflageDir)) return [];
+
+        var result = new List<CamouflageEntry>();
+        foreach (var file in Directory.EnumerateFiles(CamouflageDir, "*.toml"))
+        {
+            if (!int.TryParse(Path.GetFileNameWithoutExtension(file), out var id) || id <= 0) continue;
+
+            var model = new CamouflageModel();
+            try
+            {
+                model = Toml.ToModel<CamouflageModel>(System.IO.File.ReadAllText(file), options: TomlOptions)
+                        ?? new CamouflageModel();
+            }
+            catch (Exception e)
+            {
+                logger.LogWarning(e, "解析曲目伪装配置失败: {path}", file);
+            }
+
+            result.Add(new CamouflageEntry(id, model.Name, model.Artist, FindJacket(id) is not null));
+        }
+
+        return result.OrderBy(entry => entry.Id).ToList();
+    }
+
+    private static void WriteAllTextAtomic(string path, string content)
+    {
+        var tempPath = $"{path}.{Guid.NewGuid():N}.tmp";
+        try
+        {
+            System.IO.File.WriteAllText(tempPath, content);
+            System.IO.File.Move(tempPath, path, true);
+        }
+        finally
+        {
+            if (System.IO.File.Exists(tempPath)) System.IO.File.Delete(tempPath);
+        }
+    }
+
+    #endregion
+
+    private static string? EnsureGamePath()
+        => string.IsNullOrWhiteSpace(StaticSettings.GamePath) || !Directory.Exists(StaticSettings.GamePath)
+            ? "game-path-missing"
+            : null;
+}
diff --git a/MaiChartManager/Front/src/client/apiGen.ts b/MaiChartManager/Front/src/client/apiGen.ts
index c280581e..650846e8 100644
--- a/MaiChartManager/Front/src/client/apiGen.ts
+++ b/MaiChartManager/Front/src/client/apiGen.ts
@@ -125,6 +125,25 @@ export interface BatchSetPropsRequest {
   version?: number;
 }
 
+export interface CamouflageEntry {
+  /** @format int32 */
+  id?: number;
+  name?: string | null;
+  artist?: string | null;
+  hasJacket?: boolean;
+}
+
+export interface CamouflageInfoDto {
+  name?: string | null;
+  artist?: string | null;
+  noteDesigner?: string | null;
+  hideNoteDesigner?: boolean;
+  /** @format double */
+  unlockScore?: number;
+  hasJacket?: boolean;
+  jacketPath?: string | null;
+}
+
 export interface Chart {
   path?: string | null;
   /** @format int32 */
@@ -219,6 +238,11 @@ export interface EntryState {
   value?: any;
 }
 
+export interface FancyToolResult {
+  success?: boolean;
+  error?: string | null;
+}
+
 export interface GameModInfo {
   melonLoaderInstalled?: boolean;
   aquaMaiInstalled?: boolean;
@@ -324,6 +348,25 @@ export interface InstallMmlLibsDto {
   useLegacy?: boolean;
 }
 
+export interface IntroMovieEntry {
+  /** @format int32 */
+  id?: number;
+  hasSingle?: boolean;
+  hasLeft?: boolean;
+  hasRight?: boolean;
+  hasAudio?: boolean;
+}
+
+export interface IntroMovieInfo {
+  hasSingle?: boolean;
+  hasLeft?: boolean;
+  hasRight?: boolean;
+  hasAudio?: boolean;
+  singlePath?: string | null;
+  leftPath?: string | null;
+  rightPath?: string | null;
+}
+
 export interface MuModConfigDto {
   channel?: string | null;
   cachePath?: string | null;
@@ -769,7 +812,7 @@ export class HttpClient<SecurityDataType = unknown> {
 }
 
 /**
- * @title MaiChartManager.GenClient
+ * @title MaiChartManager
  * @version 1.0
  */
 export class Api<
@@ -1419,6 +1462,294 @@ export class Api<
         ...params,
       }),
 
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name GetIntroMovie
+     * @request GET:/MaiChartManagerServlet/GetIntroMovieApi
+     */
+    GetIntroMovie: (
+      query?: {
+        /** @format int32 */
+        id?: number;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<IntroMovieInfo, any>({
+        path: `/MaiChartManagerServlet/GetIntroMovieApi`,
+        method: "GET",
+        query: query,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name GetIntroMovieFile
+     * @request GET:/MaiChartManagerServlet/GetIntroMovieFileApi
+     */
+    GetIntroMovieFile: (
+      query?: {
+        /** @format int32 */
+        id?: number;
+        side?: string;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<void, any>({
+        path: `/MaiChartManagerServlet/GetIntroMovieFileApi`,
+        method: "GET",
+        query: query,
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name SetIntroMovie
+     * @request POST:/MaiChartManagerServlet/SetIntroMovieApi
+     */
+    SetIntroMovie: (
+      data: {
+        /** @format int32 */
+        id?: number;
+        side?: string;
+        /** @format binary */
+        file?: File;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<FancyToolResult, any>({
+        path: `/MaiChartManagerServlet/SetIntroMovieApi`,
+        method: "POST",
+        body: data,
+        type: ContentType.FormData,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name SetIntroAudio
+     * @request POST:/MaiChartManagerServlet/SetIntroAudioApi
+     */
+    SetIntroAudio: (
+      data: {
+        /** @format int32 */
+        id?: number;
+        /** @format binary */
+        file?: File;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<FancyToolResult, any>({
+        path: `/MaiChartManagerServlet/SetIntroAudioApi`,
+        method: "POST",
+        body: data,
+        type: ContentType.FormData,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name DeleteIntroAudio
+     * @request POST:/MaiChartManagerServlet/DeleteIntroAudioApi
+     */
+    DeleteIntroAudio: (
+      query?: {
+        /** @format int32 */
+        id?: number;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<FancyToolResult, any>({
+        path: `/MaiChartManagerServlet/DeleteIntroAudioApi`,
+        method: "POST",
+        query: query,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name DeleteIntroMovie
+     * @request POST:/MaiChartManagerServlet/DeleteIntroMovieApi
+     */
+    DeleteIntroMovie: (
+      query?: {
+        /** @format int32 */
+        id?: number;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<FancyToolResult, any>({
+        path: `/MaiChartManagerServlet/DeleteIntroMovieApi`,
+        method: "POST",
+        query: query,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name GetIntroMovieList
+     * @request GET:/MaiChartManagerServlet/GetIntroMovieListApi
+     */
+    GetIntroMovieList: (params: RequestParams = {}) =>
+      this.request<IntroMovieEntry[], any>({
+        path: `/MaiChartManagerServlet/GetIntroMovieListApi`,
+        method: "GET",
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name GetCamouflage
+     * @request GET:/MaiChartManagerServlet/GetCamouflageApi
+     */
+    GetCamouflage: (
+      query?: {
+        /** @format int32 */
+        id?: number;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<CamouflageInfoDto, any>({
+        path: `/MaiChartManagerServlet/GetCamouflageApi`,
+        method: "GET",
+        query: query,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name GetCamouflageJacket
+     * @request GET:/MaiChartManagerServlet/GetCamouflageJacketApi
+     */
+    GetCamouflageJacket: (
+      query?: {
+        /** @format int32 */
+        id?: number;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<void, any>({
+        path: `/MaiChartManagerServlet/GetCamouflageJacketApi`,
+        method: "GET",
+        query: query,
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name SetCamouflage
+     * @request POST:/MaiChartManagerServlet/SetCamouflageApi
+     */
+    SetCamouflage: (
+      data: {
+        /** @format int32 */
+        id?: number;
+        name?: string;
+        artist?: string;
+        noteDesigner?: string;
+        hideNoteDesigner?: boolean;
+        /** @format double */
+        unlockScore?: number;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<FancyToolResult, any>({
+        path: `/MaiChartManagerServlet/SetCamouflageApi`,
+        method: "POST",
+        body: data,
+        type: ContentType.FormData,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name SetCamouflageJacket
+     * @request POST:/MaiChartManagerServlet/SetCamouflageJacketApi
+     */
+    SetCamouflageJacket: (
+      data: {
+        /** @format int32 */
+        id?: number;
+        /** @format binary */
+        file?: File;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<FancyToolResult, any>({
+        path: `/MaiChartManagerServlet/SetCamouflageJacketApi`,
+        method: "POST",
+        body: data,
+        type: ContentType.FormData,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name DeleteCamouflage
+     * @request POST:/MaiChartManagerServlet/DeleteCamouflageApi
+     */
+    DeleteCamouflage: (
+      query?: {
+        /** @format int32 */
+        id?: number;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<FancyToolResult, any>({
+        path: `/MaiChartManagerServlet/DeleteCamouflageApi`,
+        method: "POST",
+        query: query,
+        format: "json",
+        ...params,
+      }),
+
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name GetCamouflageList
+     * @request GET:/MaiChartManagerServlet/GetCamouflageListApi
+     */
+    GetCamouflageList: (params: RequestParams = {}) =>
+      this.request<CamouflageEntry[], any>({
+        path: `/MaiChartManagerServlet/GetCamouflageListApi`,
+        method: "GET",
+        format: "json",
+        ...params,
+      }),
+
     /**
      * No description
      *
diff --git a/MaiChartManager/Front/src/locales/en.yaml b/MaiChartManager/Front/src/locales/en.yaml
index 76bf0f81..1c33313f 100644
--- a/MaiChartManager/Front/src/locales/en.yaml
+++ b/MaiChartManager/Front/src/locales/en.yaml
@@ -430,6 +430,70 @@ mod:
       USB serial number or port path, e.g. 2.2. Use the identifier shown in the configuration tool.
       Leave empty to use the first detected device as 1P
 tools:
+  fancy:
+    preview: Preview
+    path: File path
+    noPreview: No file yet
+    existing: Existing
+    none: None
+    load: Load
+    delete: Delete
+    introReplace: Replace video
+    camoJacketShort: with jacket
+    label: Intro movie & camo
+    title: Intro movie & track camouflage
+    music: Music
+    musicPlaceholder: Search by ID or name
+    musicPick: Choose a song
+    pickMusicFirst: Select a music first
+    introTab: Intro movie
+    camouflageTab: Camouflage
+    introHint: "Play a custom video before a track starts (AquaMai's CustomIntroCinematic). Both screens can share one video or use separate ones. Uploads are converted to a silent mp4; the audio track is extracted into Enter_<id>.acb / .awb and played separately by the game."
+    introSingle: Single file
+    introAudio: Audio
+    introSide: Apply to
+    introSame: Same video for both screens
+    introSameHint: "When off, each screen has its own video and the preview plays both side by side at 1:2. Toggling the switch does not touch the files; they are only written when you replace a video."
+    introLeft: Replace left video (L)
+    introRight: Replace right video (R)
+    introAudioGenerated: "Saved: audio track extracted to acb/awb"
+    introAudioSilent: "Saved: no audio track, the intro will be silent"
+    introAudioReplace: Replace audio
+    introAudioAdd: Add audio
+    introAudioRemove: Remove audio
+    introAudioRemoveConfirm: "Remove the intro audio for song {id}? (both screens share one acb/awb)"
+    introAudioShared: shared by both screens
+    sideBoth: Same video on both screens
+    sideLeft: Left screen only (L)
+    sideRight: Right screen only (R)
+    introUpload: Choose video
+    introRemove: Delete intro movie
+    introRemoveConfirm: Delete the intro movie of music {id}?
+    camouflageHint: Show another name, artist and jacket for this track in the music select and track start screens (AquaMai TrackCamouflage). Works well together with the intro movie.
+    camoName: Disguised name
+    camoArtist: Disguised artist
+    camoNoteDesigner: Disguised note designer
+    camoHideNoteDesigner: Hide note designer (shows -)
+    camoUnlockScore: Achievement required to remove camouflage
+    camoUnlockScoreHint: 0 means the camouflage disappears once the player has any score; use 102 to keep it forever
+    camoJacketUpload: Choose jacket (jpg / png)
+    camoJacketReplace: Replace jacket
+    camoRemove: Clear camouflage
+    camoRemoveConfirm: Clear the camouflage info and jacket of music {id}?
+    save: Save
+    saved: Saved
+    errorLoad: Failed to read settings
+    errorUnknown: Operation failed
+    errorInvalidId: Invalid music ID
+    errorInvalidSide: Invalid video side
+    errorInvalidText: Name and artist are required
+    errorInvalidImage: Only jpg / png images are supported
+    errorLicense: A valid license is required to convert video
+    errorGamePath: Game directory is not configured
+    errorConvert: Video conversion failed
+    errorWrite: Failed to write file
+    errorDeleteLocked: "Delete failed: the file is still in use. Close the preview and try again."
+    errorInvalidAudio: "Unsupported or invalid audio file"
   title: Tools
   audioConvert: Audio Convert (ACB + AWB)
   videoConvert: Video Convert (DAT)
diff --git a/MaiChartManager/Front/src/locales/zh-TW.yaml b/MaiChartManager/Front/src/locales/zh-TW.yaml
index bec90c6a..06cc34fb 100644
--- a/MaiChartManager/Front/src/locales/zh-TW.yaml
+++ b/MaiChartManager/Front/src/locales/zh-TW.yaml
@@ -393,6 +393,70 @@ mod:
     path2P: 2P 設備識別
     pathDesc: USB 序號或連接埠路徑，例如 2.2。請使用設定工具中顯示的識別。留空則使用第一個偵測到的設備作為 1P
 tools:
+  fancy:
+    preview: 預覽
+    path: 檔案路徑
+    noPreview: 尚無檔案
+    existing: 已有
+    none: 暫無
+    load: 載入
+    delete: 刪除
+    introReplace: 更換影片
+    camoJacketShort: 含封面
+    label: 開場影片與曲目偽裝
+    title: 開場影片與曲目偽裝
+    music: 樂曲
+    musicPlaceholder: 輸入 ID 或名稱搜尋
+    musicPick: 選擇樂曲
+    pickMusicFirst: 請先選擇一首樂曲
+    introTab: 開場影片
+    camouflageTab: 曲目偽裝
+    introHint: 在遊戲內開始樂曲前播放自訂影片（AquaMai 的 CustomIntroCinematic）。左右螢幕可以共用一個影片，也可以分開兩個。上傳後影片會轉成靜音 mp4，音軌自動擷取成 Enter_<id>.acb / .awb，由遊戲單獨播放。
+    introSingle: 單一檔案
+    introAudio: 音訊
+    introSide: 套用到
+    introSame: 左右螢幕使用同一影片
+    introSameHint: 關閉後左右螢幕各用一個影片，預覽以 1:2 並排播放，可分別替換某一側；切換開關本身不會改動檔案，替換影片時才會寫入
+    introLeft: 更換左側影片（L）
+    introRight: 更換右側影片（R）
+    introAudioGenerated: 已儲存：音軌已產生 acb/awb，遊戲中由它發聲
+    introAudioSilent: 已儲存：影片沒有音軌，將靜音播放
+    introAudioReplace: 更換音訊
+    introAudioAdd: 新增音訊
+    introAudioRemove: 刪除音訊
+    introAudioRemoveConfirm: 確定要刪除樂曲 {id} 的開場音訊嗎？（左右螢幕共用一組 acb/awb）
+    introAudioShared: 左右螢幕共用
+    sideBoth: 左右螢幕同一影片
+    sideLeft: 僅左螢幕（L）
+    sideRight: 僅右螢幕（R）
+    introUpload: 選擇影片
+    introRemove: 刪除開場影片
+    introRemoveConfirm: 確定要刪除樂曲 {id} 的開場影片嗎？
+    camouflageHint: 在選曲與開始畫面把樂曲顯示成別的曲名、曲師與封面（AquaMai 的 TrackCamouflage），適合搭配開場影片使用。
+    camoName: 偽裝後的曲名
+    camoArtist: 偽裝後的曲師
+    camoNoteDesigner: 偽裝後的譜師
+    camoHideNoteDesigner: 隱藏譜師（顯示為 -）
+    camoUnlockScore: 解除偽裝所需的達成率
+    camoUnlockScoreHint: 0 表示有成績後就不再偽裝；填 102 可以永久偽裝
+    camoJacketUpload: 選擇封面（jpg / png）
+    camoJacketReplace: 更換封面
+    camoRemove: 清除偽裝
+    camoRemoveConfirm: 確定要清除樂曲 {id} 的偽裝資訊與封面嗎？
+    save: 儲存
+    saved: 已儲存
+    errorLoad: 讀取設定失敗
+    errorUnknown: 操作失敗
+    errorInvalidId: 樂曲 ID 無效
+    errorInvalidSide: 影片位置無效
+    errorInvalidText: 曲名與曲師不能為空
+    errorInvalidImage: 只支援 jpg / png 圖片
+    errorLicense: 需要有效的授權才能轉換影片
+    errorGamePath: 未設定遊戲目錄
+    errorConvert: 影片轉換失敗
+    errorWrite: 寫入檔案失敗
+    errorDeleteLocked: 刪除失敗：檔案仍被占用，請關閉預覽後重試
+    errorInvalidAudio: 音訊檔案無法辨識或轉換失敗
   title: 工具
   audioConvert: 音訊轉換（ACB + AWB）
   videoConvert: 影片轉換（DAT）
diff --git a/MaiChartManager/Front/src/locales/zh.yaml b/MaiChartManager/Front/src/locales/zh.yaml
index ee8230a5..938bbb9f 100644
--- a/MaiChartManager/Front/src/locales/zh.yaml
+++ b/MaiChartManager/Front/src/locales/zh.yaml
@@ -387,6 +387,70 @@ mod:
     path2P: 2P 设备标识
     pathDesc: USB 序列号或端口路径，例如 2.2。请使用配置工具中显示的标识。留空则使用第一个检测到的设备作为 1P
 tools:
+  fancy:
+    preview: 预览
+    path: 文件路径
+    noPreview: 还没有文件
+    existing: 已有
+    none: 暂无
+    load: 载入
+    delete: 删除
+    introReplace: 更换视频
+    camoJacketShort: 含封面
+    label: 开场视频与曲目伪装
+    title: 开场视频与曲目伪装
+    music: 乐曲
+    musicPlaceholder: 输入 ID 或名称搜索
+    musicPick: 选择乐曲
+    pickMusicFirst: 请先选择一首乐曲
+    introTab: 开场视频
+    camouflageTab: 曲目伪装
+    introHint: 在游戏内开始乐曲前播放自定义视频（AquaMai 的 CustomIntroCinematic）。左右屏可以共用一个视频，也可以分开两个。上传后视频会转成静音 mp4，音轨自动提取成 Enter_<id>.acb / .awb，由游戏单独播放。
+    introSingle: 单文件
+    introAudio: 音频
+    introSide: 应用到
+    introSame: 左右屏使用同一视频
+    introSameHint: 关闭后左右屏各用一个视频，预览按 1:2 并排播放，可分别替换某一侧；切换开关本身不改动文件，替换视频时才会写入
+    introLeft: 替换左侧视频（L）
+    introRight: 替换右侧视频（R）
+    introAudioGenerated: 已保存：音轨已生成 acb/awb，游戏里由它发声
+    introAudioSilent: 已保存：视频没有音轨，将静音播放
+    introAudioReplace: 替换音频
+    introAudioAdd: 添加音频
+    introAudioRemove: 删除音频
+    introAudioRemoveConfirm: 确定要删除乐曲 {id} 的开场音频吗？（左右屏共用一组 acb/awb）
+    introAudioShared: 左右屏共用
+    sideBoth: 左右屏同一视频
+    sideLeft: 仅左屏（L）
+    sideRight: 仅右屏（R）
+    introUpload: 选择视频
+    introRemove: 删除开场视频
+    introRemoveConfirm: 确定要删除乐曲 {id} 的开场视频吗？
+    camouflageHint: 在选曲和开始界面把乐曲显示成别的曲名、曲师和封面（AquaMai 的 TrackCamouflage），适合配合开场视频做伪装演出。
+    camoName: 伪装后的曲名
+    camoArtist: 伪装后的曲师
+    camoNoteDesigner: 伪装后的谱师
+    camoHideNoteDesigner: 隐藏谱师（显示为 -）
+    camoUnlockScore: 解除伪装所需的达成率
+    camoUnlockScoreHint: 0 表示打过一个成绩就不再伪装；填 102 可以永久伪装
+    camoJacketUpload: 选择封面（jpg / png）
+    camoJacketReplace: 更换封面
+    camoRemove: 清除伪装
+    camoRemoveConfirm: 确定要清除乐曲 {id} 的伪装信息和封面吗？
+    save: 保存
+    saved: 已保存
+    errorLoad: 读取配置失败
+    errorUnknown: 操作失败
+    errorInvalidId: 乐曲 ID 无效
+    errorInvalidSide: 视频位置无效
+    errorInvalidText: 曲名和曲师不能为空
+    errorInvalidImage: 只支持 jpg / png 图片
+    errorLicense: 需要有效的授权才能转换视频
+    errorGamePath: 未配置游戏目录
+    errorConvert: 视频转换失败
+    errorWrite: 写入文件失败
+    errorDeleteLocked: 删除失败：文件仍被占用，请关闭预览后重试
+    errorInvalidAudio: 音频文件无法识别或转换失败
   title: 工具
   audioConvert: 音频转换（ACB + AWB）
   videoConvert: 视频转换（DAT）
diff --git a/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx b/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx
new file mode 100644
index 00000000..dbc1d890
--- /dev/null
+++ b/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx
@@ -0,0 +1,698 @@
+import { computed, defineComponent, ref, watch } from 'vue';
+import { Button, CheckBox, Modal, NumberInput, Select, TabPane, Tabs, TextInput, addToast, showTransactionalDialog } from '@munet/ui';
+import api, { getUrl } from '@/client/api';
+import type {
+  CamouflageEntry,
+  CamouflageInfoDto,
+  IntroMovieEntry,
+  IntroMovieInfo,
+} from '@/client/apiGen';
+import { globalCapture, musicListAll } from '@/store/refs';
+import { useI18n } from 'vue-i18n';
+import { pickFile } from '@/utils/pickFile';
+
+// 后端返回的错误码 → 文案
+const errorKeys: Record<string, string> = {
+  'invalid-id': 'tools.fancy.errorInvalidId',
+  'invalid-side': 'tools.fancy.errorInvalidSide',
+  'invalid-text': 'tools.fancy.errorInvalidText',
+  'invalid-image': 'tools.fancy.errorInvalidImage',
+  'license-required': 'tools.fancy.errorLicense',
+  'game-path-missing': 'tools.fancy.errorGamePath',
+  'convert-failed': 'tools.fancy.errorConvert',
+  'write-failed': 'tools.fancy.errorWrite',
+  'delete-failed': 'tools.fancy.errorDeleteLocked',
+  'invalid-audio': 'tools.fancy.errorInvalidAudio',
+};
+
+const emptyCamouflage = () => ({
+  name: '',
+  artist: '',
+  noteDesigner: '',
+  hideNoteDesigner: false,
+  unlockScore: 0,
+  hasJacket: false,
+  jacketPath: '',
+});
+
+export default defineComponent({
+  setup(props, { expose }) {
+    const { t } = useI18n();
+
+    const show = ref(false);
+    const tab = ref('intro');
+    const musicId = ref<number | null>(null);
+    const busy = ref(false);
+    // 用于给预览加时间戳，避免换文件后浏览器还用缓存
+    const previewToken = ref(Date.now());
+    // 正在上传/删除时先不渲染预览：播放器还读着文件的话，Windows 会因占用删不掉
+    const previewSuppressed = computed(() => busy.value);
+    // 视频实际分辨率：开场视频大多是 1:1，显示出来方便确认没有被压扁
+    const videoMeta = ref('');
+    const leftMeta = ref('');
+    const rightMeta = ref('');
+
+    const introSame = ref(true);
+    const introInfo = ref<IntroMovieInfo | null>(null);
+    const introEntries = ref<IntroMovieEntry[]>([]);
+
+    const camouflage = ref(emptyCamouflage());
+    const camouflageEntries = ref<CamouflageEntry[]>([]);
+
+    // MuNET 的 Select 不带搜索，这里用输入框过滤选项
+    const musicSearch = ref('');
+    const matchesSearch = (music: { id?: number; name?: string | null }) => {
+      const keyword = musicSearch.value.trim().toLowerCase();
+      if (!keyword) return true;
+      return `${music.id} ${music.name ?? ''}`.toLowerCase().includes(keyword);
+    };
+
+    // MuNET 的 Select 只收 string | number，用 undefined 表示「未选」
+    const selectedMusic = computed({
+      get: () => musicId.value ?? undefined,
+      set: (value) => { musicId.value = (value as number | undefined) ?? null; },
+    });
+
+    const musicOptions = computed(() => {
+      const seen = new Set<number>();
+      const options: { label: string; value: number }[] = [];
+      for (const music of musicListAll.value) {
+        if (music.id === undefined || seen.has(music.id)) continue;
+        if (!matchesSearch(music)) continue;
+        seen.add(music.id);
+        options.push({ label: `${music.id} · ${music.name ?? ''}`, value: music.id });
+      }
+      return options.sort((a, b) => a.value - b.value);
+    });
+
+    // 已有列表里按 id 回查真实曲名，查不到就只显示 id
+    const musicNameMap = computed(() => {
+      const map = new Map<number, string>();
+      for (const music of musicListAll.value) {
+        if (music.id === undefined || !music.name || map.has(music.id)) continue;
+        map.set(music.id, music.name);
+      }
+      return map;
+    });
+    const songName = (id: number) => musicNameMap.value.get(id) ?? '';
+    // 没选乐曲时不允许填写/操作（后端也是按乐曲 id 落盘的）
+    const hasMusic = computed(() => !!musicId.value);
+
+    const fail = (code?: string | null) => {
+      const key = code ? errorKeys[code] : undefined;
+      addToast({
+        message: key ? t(key) : `${t('tools.fancy.errorUnknown')}${code ? ` (${code})` : ''}`,
+        type: 'error',
+      });
+    };
+
+    const loadIntroMovie = async () => {
+      if (!musicId.value) {
+        introInfo.value = null;
+        return;
+      }
+      introInfo.value = (await api.GetIntroMovie({ id: musicId.value })).data;
+      const info = introInfo.value;
+      // 单文件优先；只有左右各一个文件时才进分屏模式
+      introSame.value = !info || info.hasSingle || !(info.hasLeft && info.hasRight);
+    };
+
+    const loadCamouflage = async () => {
+      if (!musicId.value) {
+        camouflage.value = emptyCamouflage();
+        return;
+      }
+      const data: CamouflageInfoDto = (await api.GetCamouflage({ id: musicId.value })).data;
+      camouflage.value = {
+        name: data.name ?? '',
+        artist: data.artist ?? '',
+        noteDesigner: data.noteDesigner ?? '',
+        hideNoteDesigner: !!data.hideNoteDesigner,
+        unlockScore: data.unlockScore ?? 0,
+        hasJacket: !!data.hasJacket,
+        jacketPath: data.jacketPath ?? '',
+      };
+    };
+
+    const loadLists = async () => {
+      introEntries.value = (await api.GetIntroMovieList()).data ?? [];
+      camouflageEntries.value = (await api.GetCamouflageList()).data ?? [];
+    };
+
+    // 只刷新封面状态，保留用户还在编辑、尚未保存的表单内容
+    const refreshCamouflageJacket = async () => {
+      if (!musicId.value) return;
+      const data: CamouflageInfoDto = (await api.GetCamouflage({ id: musicId.value })).data;
+      camouflage.value.hasJacket = !!data.hasJacket;
+      camouflage.value.jacketPath = data.jacketPath ?? '';
+    };
+
+    const reload = async () => {
+      previewToken.value = Date.now();
+      videoMeta.value = '';
+      leftMeta.value = '';
+      rightMeta.value = '';
+      try {
+        await Promise.all([loadIntroMovie(), loadCamouflage(), loadLists()]);
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorLoad'));
+      }
+    };
+
+    watch(show, (visible) => {
+      if (visible) reload();
+    });
+
+    watch(musicId, async (id) => {
+      if (!show.value) return;
+      previewToken.value = Date.now();
+      videoMeta.value = '';
+      leftMeta.value = '';
+      rightMeta.value = '';
+      try {
+        await Promise.all([loadIntroMovie(), loadCamouflage()]);
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorLoad'));
+      }
+    });
+
+    const selectMusic = (id: number) => {
+      // 载入已有条目时先清掉搜索词，否则下拉框可能因为过滤而显示不出这首歌
+      musicSearch.value = '';
+      musicId.value = id;
+    };
+
+    // ---------- 开场视频 ----------
+
+    const uploadIntroMovie = async (file: File, side: '' | 'L' | 'R' = '') => {
+      if (!musicId.value) return;
+      busy.value = true;
+      releaseMedia();
+      try {
+        const result = (await api.SetIntroMovie({
+          id: musicId.value,
+          // 注意：生成的 FormData 序列化会把 undefined 变成字符串 "undefined"，
+          // 所以这里必须传空字符串（后端会当成「单文件」）而不是 undefined。
+          side,
+          file,
+        })).data;
+        if (!result.success) {
+          fail(result.error);
+          return;
+        }
+        previewToken.value = Date.now();
+        await Promise.all([loadIntroMovie(), loadLists()]);
+        // mp4 是静音的，声音来自自动生成的 acb/awb
+        addToast({
+          message: introInfo.value?.hasAudio
+            ? t('tools.fancy.introAudioGenerated')
+            : t('tools.fancy.introAudioSilent'),
+          type: 'success',
+        });
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorConvert'));
+      } finally {
+        busy.value = false;
+      }
+    };
+
+    const chooseIntroMovie = async (side: '' | 'L' | 'R' = '') => {
+      const file = await pickFile('video/*');
+      if (file) await uploadIntroMovie(file, side);
+    };
+
+    // 左右屏共用同一套音频（Enter_<id>.acb / .awb），所以不区分 side
+    const uploadIntroAudio = async (file: File) => {
+      if (!musicId.value) return;
+      busy.value = true;
+      try {
+        const result = (await api.SetIntroAudio({ id: musicId.value, file })).data;
+        if (!result.success) {
+          fail(result.error);
+          return;
+        }
+        await Promise.all([loadIntroMovie(), loadLists()]);
+        addToast({ message: t('tools.fancy.introAudioGenerated'), type: 'success' });
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorConvert'));
+      } finally {
+        busy.value = false;
+      }
+    };
+
+    const chooseIntroAudio = async () => {
+      const file = await pickFile('audio/*,.wav,.mp3,.ogg,.aac,.m4a,.flac');
+      if (file) await uploadIntroAudio(file);
+    };
+
+    const removeIntroAudio = async (id: number) => {
+      const confirmed = await showTransactionalDialog(
+        t('tools.fancy.introTab'),
+        t('tools.fancy.introAudioRemoveConfirm', { id }),
+        [{ text: t('common.cancel'), action: false }, { text: t('common.confirm'), action: true }]
+      );
+      if (!confirmed) return;
+
+      busy.value = true;
+      try {
+        const result = (await api.DeleteIntroAudio({ id })).data;
+        if (!result.success) {
+          fail(result.error);
+          return;
+        }
+        await Promise.all([loadIntroMovie(), loadLists()]);
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorWrite'));
+      } finally {
+        busy.value = false;
+      }
+    };
+
+    const removeIntroMovie = async (id: number) => {
+      const confirmed = await showTransactionalDialog(
+        t('tools.fancy.introTab'),
+        t('tools.fancy.introRemoveConfirm', { id }),
+        [{ text: t('common.cancel'), action: false }, { text: t('common.confirm'), action: true }]
+      );
+      if (!confirmed) return;
+
+      busy.value = true;
+      releaseMedia();
+      try {
+        const result = (await api.DeleteIntroMovie({ id })).data;
+        if (!result.success) {
+          fail(result.error);
+          return;
+        }
+        if (id === musicId.value) previewToken.value = Date.now();
+        await Promise.all([loadIntroMovie(), loadLists()]);
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorWrite'));
+      } finally {
+        busy.value = false;
+      }
+    };
+
+    // ---------- 曲目伪装 ----------
+
+    const saveCamouflage = async () => {
+      if (!musicId.value) return;
+      busy.value = true;
+      try {
+        const result = (await api.SetCamouflage({
+          id: musicId.value,
+          name: camouflage.value.name,
+          artist: camouflage.value.artist,
+          noteDesigner: camouflage.value.noteDesigner,
+          hideNoteDesigner: camouflage.value.hideNoteDesigner,
+          unlockScore: camouflage.value.unlockScore,
+        })).data;
+        if (!result.success) {
+          fail(result.error);
+          return;
+        }
+        addToast({ message: t('tools.fancy.saved'), type: 'success' });
+        await Promise.all([loadCamouflage(), loadLists()]);
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorWrite'));
+      } finally {
+        busy.value = false;
+      }
+    };
+
+    const uploadCamouflageJacket = async (file: File) => {
+      if (!musicId.value) return;
+      busy.value = true;
+      try {
+        const result = (await api.SetCamouflageJacket({ id: musicId.value, file })).data;
+        if (!result.success) {
+          fail(result.error);
+          return;
+        }
+        addToast({ message: t('tools.fancy.saved'), type: 'success' });
+        previewToken.value = Date.now();
+        // 不要用 loadCamouflage：它会把服务端数据写回表单，冲掉还没保存的填写内容
+        await Promise.all([refreshCamouflageJacket(), loadLists()]);
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorWrite'));
+      } finally {
+        busy.value = false;
+      }
+    };
+
+    const chooseCamouflageJacket = async () => {
+      const file = await pickFile('image/png,image/jpeg');
+      if (file) await uploadCamouflageJacket(file);
+    };
+
+    const removeCamouflage = async (id: number) => {
+      const confirmed = await showTransactionalDialog(
+        t('tools.fancy.camouflageTab'),
+        t('tools.fancy.camoRemoveConfirm', { id }),
+        [{ text: t('common.cancel'), action: false }, { text: t('common.confirm'), action: true }]
+      );
+      if (!confirmed) return;
+
+      busy.value = true;
+      try {
+        const result = (await api.DeleteCamouflage({ id })).data;
+        if (!result.success) {
+          fail(result.error);
+          return;
+        }
+        if (id === musicId.value) previewToken.value = Date.now();
+        await Promise.all([loadCamouflage(), loadLists()]);
+      } catch (e) {
+        globalCapture(e, t('tools.fancy.errorWrite'));
+      } finally {
+        busy.value = false;
+      }
+    };
+
+    // ---------- 渲染 ----------
+
+    const hasIntroMovie = computed(() =>
+      !!(introInfo.value?.hasSingle || introInfo.value?.hasLeft || introInfo.value?.hasRight));
+
+    const introUrl = (side?: 'L' | 'R') => (previewSuppressed.value ? '' : getUrl(
+      `GetIntroMovieFileApi?id=${musicId.value}${side ? `&side=${side}` : ''}&t=${previewToken.value}`));
+
+    // 左右相同：优先单文件，退回任意一侧
+    const samePreviewSrc = computed(() => {
+      const info = introInfo.value;
+      if (!musicId.value || !info) return '';
+      if (info.hasSingle) return introUrl();
+      if (info.hasLeft) return introUrl('L');
+      if (info.hasRight) return introUrl('R');
+      return '';
+    });
+
+    const samePreviewPath = computed(() => {
+      const info = introInfo.value;
+      return info?.singlePath ?? info?.leftPath ?? info?.rightPath ?? '';
+    });
+
+    // 左右分开：某一侧还没有自己的文件时先用单文件顶替，方便对比
+    const leftPreviewSrc = computed(() => {
+      const info = introInfo.value;
+      if (!musicId.value || !info) return '';
+      if (info.hasLeft) return introUrl('L');
+      return info.hasSingle ? introUrl() : '';
+    });
+
+    const rightPreviewSrc = computed(() => {
+      const info = introInfo.value;
+      if (!musicId.value || !info) return '';
+      if (info.hasRight) return introUrl('R');
+      return info.hasSingle ? introUrl() : '';
+    });
+
+    const leftPreviewPath = computed(() => {
+      const info = introInfo.value;
+      if (!info) return '';
+      return info.leftPath ?? info.singlePath ?? '';
+    });
+
+    const rightPreviewPath = computed(() => {
+      const info = introInfo.value;
+      if (!info) return '';
+      return info.rightPath ?? info.singlePath ?? '';
+    });
+
+    const jacketPreviewUrl = computed(() => (musicId.value && camouflage.value.hasJacket && !previewSuppressed.value
+      ? getUrl(`GetCamouflageJacketApi?id=${musicId.value}&t=${previewToken.value}`)
+      : ''));
+
+    const entryRow = (id: number, title: string, desc: string, onDelete: (id: number) => void) => (
+      <div key={id} class="flex items-center gap-2 px-2 py-1 rounded hover:bg-[oklch(0.97_0.01_var(--hue))]">
+        <span class="text-sm font-500 tabular-nums w-16 shrink-0">#{id}</span>
+        <div class="w-0 grow flex flex-col">
+          {!!title && <span class="text-sm truncate">{title}</span>}
+          {!!desc && <span class="text-xs op-60 truncate">{desc}</span>}
+        </div>
+        <Button class="px-2! py-1! text-xs" onClick={() => selectMusic(id)}>{t('tools.fancy.load')}</Button>
+        <Button class="px-2! py-1! text-xs" disabled={busy.value} onClick={() => onDelete(id)}>
+          {t('tools.fancy.delete')}
+        </Button>
+      </div>
+    );
+
+    // 分屏预览时同步两侧的播放/暂停，方便看出游戏里两边一起播的效果
+    let sameVideoEl: HTMLVideoElement | null = null;
+    let leftVideoEl: HTMLVideoElement | null = null;
+    let rightVideoEl: HTMLVideoElement | null = null;
+
+    const readMeta = (e: Event) => {
+      const video = e.target as HTMLVideoElement;
+      return video.videoWidth && video.videoHeight ? `${video.videoWidth} × ${video.videoHeight}` : '';
+    };
+
+    const syncPlay = (from: HTMLVideoElement | null, to: HTMLVideoElement | null) => {
+      if (!from || !to) return;
+      if (from.paused) to.pause();
+      else to.play().catch(() => {});
+    };
+
+    // 手动拖动进度条时把另一侧也拖到同一时间点；差值小于阈值就不动，避免两侧互相触发死循环
+    const syncSeek = (from: HTMLVideoElement | null, to: HTMLVideoElement | null) => {
+      if (!from || !to) return;
+      if (!Number.isFinite(from.currentTime)) return;
+      if (Math.abs(to.currentTime - from.currentTime) <= 0.15) return;
+      const target = Number.isFinite(to.duration) ? Math.min(from.currentTime, to.duration) : from.currentTime;
+      to.currentTime = Math.max(0, target);
+    };
+
+    // 主动停掉并卸载预览，让文件句柄尽快释放（上传/删除前调用，避免 Windows 因占用删不掉）
+    const releaseMedia = () => {
+      for (const el of [sameVideoEl, leftVideoEl, rightVideoEl]) {
+        if (!el) continue;
+        try {
+          el.pause();
+          el.removeAttribute('src');
+          el.load();
+        } catch {
+          // 忽略
+        }
+      }
+    };
+
+    const renderIntroPreview = () => {
+      if (!hasIntroMovie.value) {
+        return <div class="text-sm op-50 px-2 py-4">{t('tools.fancy.noPreview')}</div>;
+      }
+
+      if (introSame.value) {
+        // 高度驱动尺寸：开场视频本身是 1:1，写死宽度会把画面压成中间一小块
+        return <div class="flex flex-col items-center gap-1">
+          <video key={samePreviewSrc.value} src={samePreviewSrc.value} controls
+                 ref={(el) => { sameVideoEl = el as HTMLVideoElement | null; }}
+                 class="max-h-72 max-w-full rounded bg-black object-contain"
+                 onLoadedmetadata={(e: Event) => { videoMeta.value = readMeta(e); }}/>
+          <div class="text-xs op-50 tabular-nums break-all">
+            {[videoMeta.value, samePreviewPath.value].filter(Boolean).join(' · ')}
+          </div>
+        </div>;
+      }
+
+      // 左右分开：1:2 的并排预览框，两个视频同时播放
+      return <div class="flex flex-col items-center gap-1">
+        <div class="flex gap-1 h-72 max-w-full" style={{ aspectRatio: '2 / 1' }}>
+          <video key={`L-${leftPreviewSrc.value}`} src={leftPreviewSrc.value} controls
+                 ref={(el) => { leftVideoEl = el as HTMLVideoElement | null; }}
+                 class="h-full w-1/2 rounded bg-black object-contain"
+                 onLoadedmetadata={(e: Event) => { leftMeta.value = readMeta(e); }}
+                 onPlay={() => syncPlay(leftVideoEl, rightVideoEl)}
+                 onPause={() => syncPlay(leftVideoEl, rightVideoEl)}
+                 onSeeked={() => syncSeek(leftVideoEl, rightVideoEl)}/>
+          <video key={`R-${rightPreviewSrc.value}`} src={rightPreviewSrc.value} controls
+                 ref={(el) => { rightVideoEl = el as HTMLVideoElement | null; }}
+                 class="h-full w-1/2 rounded bg-black object-contain"
+                 onLoadedmetadata={(e: Event) => { rightMeta.value = readMeta(e); }}
+                 onPlay={() => syncPlay(rightVideoEl, leftVideoEl)}
+                 onPause={() => syncPlay(rightVideoEl, leftVideoEl)}
+                 onSeeked={() => syncSeek(rightVideoEl, leftVideoEl)}/>
+        </div>
+        <div class="text-xs op-50 tabular-nums">{`L ${leftMeta.value || '-'}   R ${rightMeta.value || '-'}`}</div>
+        <div class="text-xs op-50 break-all text-center flex flex-col">
+          <span>L: {leftPreviewPath.value || t('tools.fancy.none')}</span>
+          <span>R: {rightPreviewPath.value || t('tools.fancy.none')}</span>
+        </div>
+      </div>;
+    };
+
+    const renderIntro = () => <div class="flex flex-col gap-3 pt-3">
+      <div class="text-sm op-70 ws-normal">{t('tools.fancy.introHint')}</div>
+      {!hasMusic.value &&
+        <div class="text-sm op-60 px-1">{t('tools.fancy.pickMusicFirst')}</div>}
+
+      <div>
+        <div class="ml-1 text-sm">{t('tools.fancy.preview')}</div>
+        {renderIntroPreview()}
+      </div>
+      {(hasIntroMovie.value || introInfo.value?.hasAudio) &&
+        <div class="text-xs op-50 px-1 text-center break-all">
+          {introInfo.value?.hasAudio
+            ? `${t('tools.fancy.introAudio')}${introSame.value ? '' : ` (${t('tools.fancy.introAudioShared')})`}: Enter_${musicId.value}.acb + .awb`
+            : `${t('tools.fancy.introAudio')}: ${t('tools.fancy.none')}`}
+        </div>}
+
+      <CheckBox v-model:value={introSame.value} class="px-1 text-sm" disabled={!hasMusic.value}>
+        {t('tools.fancy.introSame')}
+      </CheckBox>
+      {!introSame.value &&
+        <div class="text-xs op-60 px-1 ws-normal">{t('tools.fancy.introSameHint')}</div>}
+
+      <div class="flex gap-2">
+        {introSame.value
+          ? <Button class="w-0 grow" disabled={busy.value || !hasMusic.value} ing={busy.value}
+                    onClick={() => chooseIntroMovie()}>
+              {hasIntroMovie.value ? t('tools.fancy.introReplace') : t('tools.fancy.introUpload')}
+            </Button>
+          : <>
+              <Button class="w-0 grow" disabled={busy.value || !hasMusic.value} ing={busy.value}
+                      onClick={() => chooseIntroMovie('L')}>
+                {t('tools.fancy.introLeft')}
+              </Button>
+              <Button class="w-0 grow" disabled={busy.value || !hasMusic.value} ing={busy.value}
+                      onClick={() => chooseIntroMovie('R')}>
+                {t('tools.fancy.introRight')}
+              </Button>
+            </>}
+        <Button class="w-0 grow" disabled={busy.value || !hasMusic.value || !hasIntroMovie.value}
+                onClick={() => musicId.value && removeIntroMovie(musicId.value)}>
+          {t('tools.fancy.introRemove')}
+        </Button>
+      </div>
+
+      <div class="flex gap-2">
+        <Button class="w-0 grow" disabled={busy.value || !hasMusic.value} ing={busy.value}
+                onClick={chooseIntroAudio}>
+          {introInfo.value?.hasAudio ? t('tools.fancy.introAudioReplace') : t('tools.fancy.introAudioAdd')}
+        </Button>
+        <Button class="w-0 grow" disabled={busy.value || !hasMusic.value || !introInfo.value?.hasAudio}
+                onClick={() => musicId.value && removeIntroAudio(musicId.value)}>
+          {t('tools.fancy.introAudioRemove')}
+        </Button>
+      </div>
+
+      <div>
+        <div class="ml-1 text-sm mb-1">{t('tools.fancy.existing')} ({introEntries.value.length})</div>
+        <div class="max-h-40 overflow-auto border border-gray-200 rounded p-1">
+          {introEntries.value.length === 0
+            ? <div class="text-sm op-50 px-2 py-1">{t('tools.fancy.none')}</div>
+            : introEntries.value.map(entry => entryRow(entry.id!, songName(entry.id!), [
+              entry.hasSingle ? 'L=R' : '',
+              entry.hasLeft ? 'L' : '',
+              entry.hasRight ? 'R' : '',
+            ].filter(Boolean).join(' / '), removeIntroMovie))}
+        </div>
+      </div>
+    </div>;
+
+    const renderCamouflage = () => <div class="flex flex-col gap-3 pt-3">
+      <div class="text-sm op-70 ws-normal">{t('tools.fancy.camouflageHint')}</div>
+      {!hasMusic.value &&
+        <div class="text-sm op-60 px-1">{t('tools.fancy.pickMusicFirst')}</div>}
+
+      <div>
+        <div class="ml-1 text-sm">{t('tools.fancy.preview')}</div>
+        {camouflage.value.hasJacket
+          ? <div class="flex justify-center">
+              <img key={jacketPreviewUrl.value} src={jacketPreviewUrl.value} alt=""
+                   class="max-h-48 max-w-full rounded object-contain bg-black/5"/>
+            </div>
+          : <div class="text-sm op-50 px-2 py-4">{t('tools.fancy.noPreview')}</div>}
+        {!!camouflage.value.jacketPath &&
+          <div class="ml-1 text-xs op-50 select-text break-all">
+            {t('tools.fancy.path')}: {camouflage.value.jacketPath}
+          </div>}
+      </div>
+
+      <div>
+        <div class="ml-1 text-sm">{t('tools.fancy.camoName')}</div>
+        <TextInput v-model:value={camouflage.value.name} disabled={!hasMusic.value}/>
+      </div>
+      <div>
+        <div class="ml-1 text-sm">{t('tools.fancy.camoArtist')}</div>
+        <TextInput v-model:value={camouflage.value.artist} disabled={!hasMusic.value}/>
+      </div>
+      <div>
+        <div class="ml-1 text-sm">{t('tools.fancy.camoNoteDesigner')}</div>
+        <TextInput v-model:value={camouflage.value.noteDesigner} disabled={!hasMusic.value}/>
+      </div>
+      <CheckBox v-model:value={camouflage.value.hideNoteDesigner} class="m-1" disabled={!hasMusic.value}>
+        {t('tools.fancy.camoHideNoteDesigner')}
+      </CheckBox>
+      <div>
+        <div class="ml-1 text-sm">{t('tools.fancy.camoUnlockScore')}</div>
+        <NumberInput class="w-full" step={0.1} decimal={1} min={0} max={102}
+                     v-model:value={camouflage.value.unlockScore} disabled={!hasMusic.value}/>
+        <div class="ml-1 text-xs op-60 ws-normal">{t('tools.fancy.camoUnlockScoreHint')}</div>
+      </div>
+
+      <div class="flex gap-2">
+        <Button class="w-0 grow" disabled={busy.value || !hasMusic.value}
+                onClick={chooseCamouflageJacket}>
+          {camouflage.value.hasJacket ? t('tools.fancy.camoJacketReplace') : t('tools.fancy.camoJacketUpload')}
+        </Button>
+        <Button class="w-0 grow" disabled={busy.value || !hasMusic.value || !camouflage.value.name && !camouflage.value.hasJacket}
+                onClick={() => musicId.value && removeCamouflage(musicId.value)}>
+          {t('tools.fancy.camoRemove')}
+        </Button>
+      </div>
+      <Button disabled={busy.value || !hasMusic.value} ing={busy.value} onClick={saveCamouflage}>
+        {t('tools.fancy.save')}
+      </Button>
+
+      <div>
+        <div class="ml-1 text-sm mb-1">{t('tools.fancy.existing')} ({camouflageEntries.value.length})</div>
+        <div class="max-h-40 overflow-auto border border-gray-200 rounded p-1">
+          {camouflageEntries.value.length === 0
+            ? <div class="text-sm op-50 px-2 py-1">{t('tools.fancy.none')}</div>
+            : camouflageEntries.value.map(entry => {
+              const realName = songName(entry.id!);
+              const camoName = entry.name ?? '';
+              // 标题优先显示真实曲名；伪装名相同就不重复显示
+              const title = realName || camoName;
+              const desc = [
+                realName && camoName && camoName !== realName ? camoName : '',
+                entry.artist ?? '',
+              ].filter(Boolean).join(' / ');
+              return entryRow(entry.id!, title, desc, removeCamouflage);
+            })}
+        </div>
+      </div>
+    </div>;
+
+    const trigger = () => {
+      show.value = true;
+    };
+
+    expose({ trigger });
+
+    return () => (
+      <Modal width="min(56vw,48em)" title={t('tools.fancy.title')} v-model:show={show.value}>
+        {{
+          default: () => <div class="flex flex-col gap-3">
+            <div>
+              <div class="ml-1 text-sm">{t('tools.fancy.music')}</div>
+              <div class="flex flex-col gap-2">
+                <TextInput v-model:value={musicSearch.value} placeholder={t('tools.fancy.musicPlaceholder')}/>
+                <Select
+                  v-model:value={selectedMusic.value}
+                  options={musicOptions.value}
+                  placeholder={t('tools.fancy.musicPick')}
+                />
+              </div>
+            </div>
+            <Tabs v-model:value={tab.value}>
+              <TabPane name="intro" tab={t('tools.fancy.introTab')}>{renderIntro()}</TabPane>
+              <TabPane name="camouflage" tab={t('tools.fancy.camouflageTab')}>{renderCamouflage()}</TabPane>
+            </Tabs>
+          </div>,
+          actions: () => <Button class="w-0 grow" onClick={() => show.value = false}>{t('common.close')}</Button>,
+        }}
+      </Modal>
+    );
+  },
+});
diff --git a/MaiChartManager/Front/src/views/Tools/index.tsx b/MaiChartManager/Front/src/views/Tools/index.tsx
index f5c2fde5..a84470e3 100644
--- a/MaiChartManager/Front/src/views/Tools/index.tsx
+++ b/MaiChartManager/Front/src/views/Tools/index.tsx
@@ -4,6 +4,7 @@ import { defineComponent, ref } from 'vue';
 import ImageToAbModal from '@/views/Tools/ImageToAbModal';
 import PvConvertDropMenu from '@/views/Tools/PvConvertDropMenu';
 import ResourceJunctionModal from '@/views/Tools/ResourceJunctionModal';
+import IntroCamouflageModal from '@/views/Tools/IntroCamouflageModal';
 import { useI18n } from 'vue-i18n';
 
 interface ToolCard {
@@ -17,6 +18,7 @@ export default defineComponent({
   setup() {
     const imageToAbRef = ref<{ trigger: () => void }>();
     const resourceJunctionRef = ref<{ trigger: () => void }>();
+    const fancyRef = ref<{ trigger: () => void }>();
     const { t } = useI18n();
 
     const handleAudioConvert = async () => {
@@ -48,6 +50,11 @@ export default defineComponent({
         labelKey: 'tools.resourceJunction.label',
         action: () => resourceJunctionRef.value?.trigger(),
       },
+      {
+        icon: 'i-mdi-movie-open-star',
+        labelKey: 'tools.fancy.label',
+        action: () => fancyRef.value?.trigger(),
+      },
     ];
 
     const renderToolCard = (tool: ToolCard) => (
@@ -75,9 +82,11 @@ export default defineComponent({
           <PvConvertDropMenu />
           {renderToolCard(tools[1])}
           {renderToolCard(tools[2])}
+          {renderToolCard(tools[3])}
         </div>
         <ImageToAbModal ref={imageToAbRef as any} />
         <ResourceJunctionModal ref={resourceJunctionRef as any} />
+        <IntroCamouflageModal ref={fancyRef as any} />
       </div>
     );
   },
diff --git a/MaiChartManager/Utils/VideoConvert.cs b/MaiChartManager/Utils/VideoConvert.cs
index 26932232..de9f6e8e 100644
--- a/MaiChartManager/Utils/VideoConvert.cs
+++ b/MaiChartManager/Utils/VideoConvert.cs
@@ -41,7 +41,20 @@ private static string FormatFFmpegTime(TimeSpan time) =>
     /// </summary>
     private static List<string> BuildPostArgs(VideoEncoderProfile p, VideoConvertOptions options, bool isImage)
     {
-        var post = new List<string> { $"-c:v {p.Codec}", "-map 0:0" };
+        var post = new List<string> { $"-c:v {p.Codec}" };
+        if (options.KeepAudio)
+        {
+            // 只保留第一条视频轨和（如果有）第一条音频轨；
+            // 音频单独转 AAC，保证浏览器（预览）和游戏都能读
+            post.Add("-map 0:v:0");
+            post.Add("-map 0:a:0?");
+            post.Add("-c:a aac");
+            post.Add("-b:a 192k");
+        }
+        else
+        {
+            post.Add("-map 0:0");
+        }
         if (isImage) post.Add("-r 1 -t 2");
         post.Add(MultiThreadArg);
         if (p.Kind == VideoCodecKind.Vp9 && !p.IsHardware)
@@ -50,6 +63,8 @@ private static List<string> BuildPostArgs(VideoEncoderProfile p, VideoConvertOpt
             if (options.UseYuv420p) post.Add("-pix_fmt yuv420p");
         }
         post.AddRange(p.ExtraOutputArgs);
+        // 调用方指定的额外参数（画质等）放最后，可以覆盖前面的默认值
+        if (options.ExtraArgs is { Length: > 0 }) post.AddRange(options.ExtraArgs);
         return post;
     }
 
@@ -73,6 +88,22 @@ public static async Task CheckHardwareAcceleration()
             : HardwareAccelerationStatus.Disabled;
     }
 
+    /// <summary>
+    /// 按当前选中的 H264 编码器给出画质参数。
+    /// 不同硬件编码器的默认画质差很多——例如 h264_mf 不指定 quality 时会用很低的默认值，转出来非常糊。
+    /// </summary>
+    public static string[] H264QualityArgs(string codec) => codec switch
+    {
+        "libx264" => ["-crf", "18", "-preset", "medium"],
+        "h264_mf" => ["-rate_control", "quality", "-quality", "90"],
+        "h264_nvenc" => ["-rc", "vbr", "-cq", "19", "-b:v", "0"],
+        "h264_qsv" => ["-global_quality", "20"],
+        "h264_amf" => ["-rc", "cqp", "-qp_i", "20", "-qp_p", "20"],
+        "h264_vaapi" => ["-qp", "20"],
+        "h264_vulkan" => ["-qp", "20"],
+        _ => [],
+    };
+
     public class VideoConvertOptions
     {
         /// <summary>
@@ -90,6 +121,16 @@ public class VideoConvertOptions
         /// </summary>
         public bool UseYuv420p { get; set; }
 
+        /// <summary>
+        /// 是否保留音轨（默认丢弃，只留视频流）
+        /// </summary>
+        public bool KeepAudio { get; set; }
+
+        /// <summary>
+        /// 额外的 ffmpeg 输出参数（例如画质），追加在编码参数的最后
+        /// </summary>
+        public string[] ExtraArgs { get; set; } = [];
+
         /// <summary>
         /// 视频 padding（秒），正数为前置空白，负数为裁剪开头
         /// </summary>

From a5199d2739eeca3636935df7354c1e01d9d7a8d7 Mon Sep 17 00:00:00 2001
From: huimanQAQ <huimanQAQ@gmail.com>
Date: Thu, 29 Oct 2026 00:05:27 +0800
Subject: [PATCH 2/6] =?UTF-8?q?fix(tools):=20=E5=BC=80=E5=9C=BA=E8=A7=86?=
 =?UTF-8?q?=E9=A2=91=E9=9D=99=E9=9F=B3=E6=92=AD=E6=94=BE=EF=BC=8C=E5=A3=B0?=
 =?UTF-8?q?=E9=9F=B3=E7=BB=9F=E4=B8=80=E8=B5=B0=20acb/awb=20=E9=81=BF?=
 =?UTF-8?q?=E5=85=8D=E5=B7=A6=E5=8F=B3=E5=B1=8F=E9=87=8D=E5=A3=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 预览里左右两个 <video> 都带音轨时会同时出声（重声）。现在视频一律 muted，
  声音只播一路：新增 GetIntroAudioFileApi 把 Enter_<id>.acb/.awb 解成 wav
  （按 acb 修改时间缓存到临时目录，支持 Range），前端用隐藏的 <audio> 与视频
  同步播放/暂停/拖动进度
- SetIntroMovie 不再保留视频音轨（KeepAudio=false），mp4 回归纯画面，
  与游戏内一致（AquaMai 的 VideoPlayer 本来就不输出视频音轨）
- 重新生成 apiGen
---
 .../Controllers/Tools/FancyToolController.cs  | 55 ++++++++++++++++++-
 MaiChartManager/Front/src/client/apiGen.ts    | 21 +++++++
 .../src/views/Tools/IntroCamouflageModal.tsx  | 48 +++++++++++++---
 3 files changed, 115 insertions(+), 9 deletions(-)

diff --git a/MaiChartManager/Controllers/Tools/FancyToolController.cs b/MaiChartManager/Controllers/Tools/FancyToolController.cs
index bf3d4cc3..31c0fc92 100644
--- a/MaiChartManager/Controllers/Tools/FancyToolController.cs
+++ b/MaiChartManager/Controllers/Tools/FancyToolController.cs
@@ -74,6 +74,57 @@ public ActionResult GetIntroMovieFile(int id, string? side)
         return PhysicalFile(path, "video/mp4", enableRangeProcessing: true);
     }
 
+    /// <summary>
+    /// 开场音频预览：把 Enter_&lt;id&gt;.acb/.awb 解成 wav 给前端播放（浏览器放不了 acb）。
+    /// 解码结果按 acb 的修改时间缓存在临时目录，避免每次 Range 请求都重新解码。
+    /// </summary>
+    [HttpGet]
+    public ActionResult GetIntroAudioFile(int id)
+    {
+        var acbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.acb");
+        var awbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.awb");
+        if (!System.IO.File.Exists(acbPath) || !System.IO.File.Exists(awbPath)) return NotFound();
+
+        var wavPath = GetCachedIntroAudio(acbPath, id);
+        if (wavPath is null) return NotFound();
+
+        return PhysicalFile(wavPath, "audio/wav", enableRangeProcessing: true);
+    }
+
+    private string? GetCachedIntroAudio(string acbPath, int id)
+    {
+        try
+        {
+            var cacheDir = Path.Combine(StaticSettings.tempPath, "IntroAudioPreview");
+            Directory.CreateDirectory(cacheDir);
+            var stamp = System.IO.File.GetLastWriteTimeUtc(acbPath).Ticks;
+            var wavPath = Path.Combine(cacheDir, $"Enter_{id}_{stamp}.wav");
+            if (System.IO.File.Exists(wavPath)) return wavPath;
+
+            // acb 换了就清掉同一首曲子旧的缓存
+            foreach (var old in Directory.EnumerateFiles(cacheDir, $"Enter_{id}_*.wav").ToList())
+            {
+                try
+                {
+                    System.IO.File.Delete(old);
+                }
+                catch
+                {
+                    // 忽略清理失败
+                }
+            }
+
+            var wavBytes = Audio.AcbToWav(acbPath);
+            System.IO.File.WriteAllBytes(wavPath, wavBytes);
+            return wavPath;
+        }
+        catch (Exception e)
+        {
+            logger.LogWarning(e, "开场音频预览解码失败: {id}", id);
+            return null;
+        }
+    }
+
     /// <summary>
     /// 上传并转换开场视频。side 为空表示左右屏播放同一个视频，L / R 表示只替换其中一侧。
     /// </summary>
@@ -115,8 +166,8 @@ await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
                 Padding = 0,
                 ContentType = file.ContentType,
                 TaskbarProgress = false,
-                // 保留一份音轨，前端预览才听得到声音；游戏里 AquaMai 会把视频音轨静音，声音走 acb/awb
-                KeepAudio = true,
+                // 视频只留画面：游戏里由 acb/awb 出声，前端预览也是静音播放 + 单独播放音频
+                KeepAudio = false,
                 // 硬件编码器默认画质差别很大（h264_mf 默认很糊），这里按选中的编码器给画质参数
                 ExtraArgs = VideoConvert.H264QualityArgs(VideoConvert.H264Encoder),
             });
diff --git a/MaiChartManager/Front/src/client/apiGen.ts b/MaiChartManager/Front/src/client/apiGen.ts
index 650846e8..161f2402 100644
--- a/MaiChartManager/Front/src/client/apiGen.ts
+++ b/MaiChartManager/Front/src/client/apiGen.ts
@@ -1506,6 +1506,27 @@ export class Api<
         ...params,
       }),
 
+    /**
+     * No description
+     *
+     * @tags FancyTool
+     * @name GetIntroAudioFile
+     * @request GET:/MaiChartManagerServlet/GetIntroAudioFileApi
+     */
+    GetIntroAudioFile: (
+      query?: {
+        /** @format int32 */
+        id?: number;
+      },
+      params: RequestParams = {},
+    ) =>
+      this.request<void, any>({
+        path: `/MaiChartManagerServlet/GetIntroAudioFileApi`,
+        method: "GET",
+        query: query,
+        ...params,
+      }),
+
     /**
      * No description
      *
diff --git a/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx b/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx
index dbc1d890..968c3879 100644
--- a/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx
+++ b/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx
@@ -423,6 +423,11 @@ export default defineComponent({
       ? getUrl(`GetCamouflageJacketApi?id=${musicId.value}&t=${previewToken.value}`)
       : ''));
 
+    // 视频一律静音播放，声音单独播一份 acb 解码后的 wav（左右分屏也只有这一路声音，不会重声）
+    const introAudioSrc = computed(() => (musicId.value && introInfo.value?.hasAudio && !previewSuppressed.value
+      ? getUrl(`GetIntroAudioFileApi?id=${musicId.value}&t=${previewToken.value}`)
+      : ''));
+
     const entryRow = (id: number, title: string, desc: string, onDelete: (id: number) => void) => (
       <div key={id} class="flex items-center gap-2 px-2 py-1 rounded hover:bg-[oklch(0.97_0.01_var(--hue))]">
         <span class="text-sm font-500 tabular-nums w-16 shrink-0">#{id}</span>
@@ -441,20 +446,38 @@ export default defineComponent({
     let sameVideoEl: HTMLVideoElement | null = null;
     let leftVideoEl: HTMLVideoElement | null = null;
     let rightVideoEl: HTMLVideoElement | null = null;
+    let audioEl: HTMLAudioElement | null = null;
 
     const readMeta = (e: Event) => {
       const video = e.target as HTMLVideoElement;
       return video.videoWidth && video.videoHeight ? `${video.videoWidth} × ${video.videoHeight}` : '';
     };
 
+    // 播放/暂停跟着视频走，声音只有 audioEl 这一路
+    const playAudio = (playing: boolean) => {
+      if (!audioEl) return;
+      if (playing) audioEl.play().catch(() => {});
+      else audioEl.pause();
+    };
+
+    const syncAudioSeek = (from: HTMLVideoElement | null) => {
+      if (!audioEl || !from || !Number.isFinite(from.currentTime)) return;
+      if (Math.abs(audioEl.currentTime - from.currentTime) > 0.15) audioEl.currentTime = from.currentTime;
+    };
+
     const syncPlay = (from: HTMLVideoElement | null, to: HTMLVideoElement | null) => {
-      if (!from || !to) return;
-      if (from.paused) to.pause();
-      else to.play().catch(() => {});
+      if (!from) return;
+      const playing = !from.paused;
+      if (to) {
+        if (playing) to.play().catch(() => {});
+        else to.pause();
+      }
+      playAudio(playing);
     };
 
     // 手动拖动进度条时把另一侧也拖到同一时间点；差值小于阈值就不动，避免两侧互相触发死循环
     const syncSeek = (from: HTMLVideoElement | null, to: HTMLVideoElement | null) => {
+      syncAudioSeek(from);
       if (!from || !to) return;
       if (!Number.isFinite(from.currentTime)) return;
       if (Math.abs(to.currentTime - from.currentTime) <= 0.15) return;
@@ -474,6 +497,11 @@ export default defineComponent({
           // 忽略
         }
       }
+      try {
+        audioEl?.pause();
+      } catch {
+        // 忽略
+      }
     };
 
     const renderIntroPreview = () => {
@@ -484,10 +512,13 @@ export default defineComponent({
       if (introSame.value) {
         // 高度驱动尺寸：开场视频本身是 1:1，写死宽度会把画面压成中间一小块
         return <div class="flex flex-col items-center gap-1">
-          <video key={samePreviewSrc.value} src={samePreviewSrc.value} controls
+          <video key={samePreviewSrc.value} src={samePreviewSrc.value} controls muted
                  ref={(el) => { sameVideoEl = el as HTMLVideoElement | null; }}
                  class="max-h-72 max-w-full rounded bg-black object-contain"
-                 onLoadedmetadata={(e: Event) => { videoMeta.value = readMeta(e); }}/>
+                 onLoadedmetadata={(e: Event) => { videoMeta.value = readMeta(e); }}
+                 onPlay={() => syncPlay(sameVideoEl, null)}
+                 onPause={() => syncPlay(sameVideoEl, null)}
+                 onSeeked={() => syncSeek(sameVideoEl, null)}/>
           <div class="text-xs op-50 tabular-nums break-all">
             {[videoMeta.value, samePreviewPath.value].filter(Boolean).join(' · ')}
           </div>
@@ -497,14 +528,14 @@ export default defineComponent({
       // 左右分开：1:2 的并排预览框，两个视频同时播放
       return <div class="flex flex-col items-center gap-1">
         <div class="flex gap-1 h-72 max-w-full" style={{ aspectRatio: '2 / 1' }}>
-          <video key={`L-${leftPreviewSrc.value}`} src={leftPreviewSrc.value} controls
+          <video key={`L-${leftPreviewSrc.value}`} src={leftPreviewSrc.value} controls muted
                  ref={(el) => { leftVideoEl = el as HTMLVideoElement | null; }}
                  class="h-full w-1/2 rounded bg-black object-contain"
                  onLoadedmetadata={(e: Event) => { leftMeta.value = readMeta(e); }}
                  onPlay={() => syncPlay(leftVideoEl, rightVideoEl)}
                  onPause={() => syncPlay(leftVideoEl, rightVideoEl)}
                  onSeeked={() => syncSeek(leftVideoEl, rightVideoEl)}/>
-          <video key={`R-${rightPreviewSrc.value}`} src={rightPreviewSrc.value} controls
+          <video key={`R-${rightPreviewSrc.value}`} src={rightPreviewSrc.value} controls muted
                  ref={(el) => { rightVideoEl = el as HTMLVideoElement | null; }}
                  class="h-full w-1/2 rounded bg-black object-contain"
                  onLoadedmetadata={(e: Event) => { rightMeta.value = readMeta(e); }}
@@ -529,6 +560,9 @@ export default defineComponent({
         <div class="ml-1 text-sm">{t('tools.fancy.preview')}</div>
         {renderIntroPreview()}
       </div>
+      {!!introAudioSrc.value &&
+        <audio key={introAudioSrc.value} src={introAudioSrc.value} class="hidden"
+               ref={(el) => { audioEl = el as HTMLAudioElement | null; }}/>}
       {(hasIntroMovie.value || introInfo.value?.hasAudio) &&
         <div class="text-xs op-50 px-1 text-center break-all">
           {introInfo.value?.hasAudio

From bd43ecc0515e0ce3e96ca3d31c60f69ac514726c Mon Sep 17 00:00:00 2001
From: huimanQAQ <huimanQAQ@gmail.com>
Date: Thu, 29 Oct 2026 00:40:19 +0800
Subject: [PATCH 3/6] =?UTF-8?q?fix(tools):=20=E6=8C=89=20review=20?=
 =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E5=8E=9F=E5=AD=90=E6=80=A7=E3=80=81=E5=AE=88?=
 =?UTF-8?q?=E5=8D=AB=E4=B8=8E=E7=AB=9E=E6=80=81=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- VideoConvert：删除 KeepAudio 选项（IVF/USM 放不下音频，正数 Padding 路径也会忽略它），
  恢复统一的 -map 0:0；RunConcatenate 的输出参数也带上 ExtraArgs
- FancyToolController：
  - 开场音频 acb/awb 成对替换：先备份旧文件，任一移动失败就回滚
  - SetIntroMovie 先清理与新布局冲突的旧文件，清理失败直接返回 delete-failed，
    避免单文件与 L/R 同时存在
  - SetCamouflageJacket 先写临时文件再覆盖目标，写入失败不会破坏已有封面
  - Delete* 接口补 EnsureGamePath 守卫，避免 GamePath 为空时删到工作目录下的相对路径
- 前端 IntroCamouflageModal：
  - 替换音频后 bump previewToken，避免 <audio> 继续用旧 URL 播缓存
  - loadIntroMovie / loadCamouflage / refreshCamouflageJacket 加竞态保护，丢弃过期响应
- en.yaml：pickMusicFirst 改为 Select a song first，camoUnlockScore 明确为 Score
---
 .../Controllers/Tools/FancyToolController.cs  | 111 ++++++++++++++----
 MaiChartManager/Front/src/locales/en.yaml     |   4 +-
 .../src/views/Tools/IntroCamouflageModal.tsx  |  24 ++--
 MaiChartManager/Utils/VideoConvert.cs         |  24 +---
 4 files changed, 109 insertions(+), 54 deletions(-)

diff --git a/MaiChartManager/Controllers/Tools/FancyToolController.cs b/MaiChartManager/Controllers/Tools/FancyToolController.cs
index 31c0fc92..4bbfc075 100644
--- a/MaiChartManager/Controllers/Tools/FancyToolController.cs
+++ b/MaiChartManager/Controllers/Tools/FancyToolController.cs
@@ -166,8 +166,6 @@ await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
                 Padding = 0,
                 ContentType = file.ContentType,
                 TaskbarProgress = false,
-                // 视频只留画面：游戏里由 acb/awb 出声，前端预览也是静音播放 + 单独播放音频
-                KeepAudio = false,
                 // 硬件编码器默认画质差别很大（h264_mf 默认很糊），这里按选中的编码器给画质参数
                 ExtraArgs = VideoConvert.H264QualityArgs(VideoConvert.H264Encoder),
             });
@@ -178,18 +176,18 @@ await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
             // 游戏里由 AquaMai 单独播放，这样视频静音、声音走 acb/awb。
             await CreateIntroAudio(inputPath, id, tmpDir.FullName);
 
+            // 先把与新布局冲突的旧文件清掉：清理失败就直接返回，避免单文件和 L/R 同时存在
+            var oldLayoutCleaned = normalizedSide is null
+                ? DeleteFilesWithRetry(
+                    Path.Combine(IntroMovieDir, VideoFileName(id, "L")),
+                    Path.Combine(IntroMovieDir, VideoFileName(id, "R")))
+                : DeleteFilesWithRetry(Path.Combine(IntroMovieDir, VideoFileName(id, null)));
+            if (!oldLayoutCleaned) return new FancyToolResult(false, "delete-failed");
+
             MoveFileWithRetry(tmpVideoPath, targetPath);
 
-            if (normalizedSide is null)
-            {
-                // 单文件与左右分开的写法不能共存
-                DeleteFilesWithRetry(
-                    Path.Combine(IntroMovieDir, VideoFileName(id, "L")),
-                    Path.Combine(IntroMovieDir, VideoFileName(id, "R")));
-            }
-            else
+            if (normalizedSide is not null)
             {
-                DeleteFilesWithRetry(Path.Combine(IntroMovieDir, VideoFileName(id, null)));
                 // 只替换一侧时，另一侧还没有的话先复制一份，保证左右都在
                 var otherSide = normalizedSide == "L" ? "R" : "L";
                 var otherPath = Path.Combine(IntroMovieDir, VideoFileName(id, otherSide));
@@ -216,11 +214,6 @@ await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
         }
     }
 
-    /// <summary>
-    /// 从上传的文件里提取音轨，生成 Enter_&lt;id&gt;.acb / .awb。
-    /// 开场 mp4 本身是静音的，游戏里由 acb/awb 出声（AquaMai 的 CustomIntroCinematic 会调 SoundManager 播放）。
-    /// 没有音轨或转换失败时清掉旧的 acb/awb，避免出现「新视频配旧音频」。
-    /// </summary>
     /// <summary>
     /// 替换 / 新增开场音频。左右屏共用一套音频（Enter_&lt;id&gt;.acb / .awb），
     /// 任意 ffmpeg 能解码的音频都会先解成 wav，再封装成 acb/awb。
@@ -278,12 +271,20 @@ public async Task<FancyToolResult> SetIntroAudio([FromForm] int id, IFormFile fi
     [HttpPost]
     public FancyToolResult DeleteIntroAudio(int id)
     {
+        var gamePathError = EnsureGamePath();
+        if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
+
         var ok = DeleteFilesWithRetry(
             Path.Combine(IntroMovieDir, $"Enter_{id}.acb"),
             Path.Combine(IntroMovieDir, $"Enter_{id}.awb"));
         return new FancyToolResult(ok, ok ? null : "delete-failed");
     }
 
+    /// <summary>
+    /// 从上传的文件里提取音轨，生成 Enter_&lt;id&gt;.acb / .awb。
+    /// 开场 mp4 本身是静音的，游戏里由 acb/awb 出声（AquaMai 的 CustomIntroCinematic 会调 SoundManager 播放）。
+    /// acb/awb 成对替换：先备份旧文件，任一移动失败就回滚。
+    /// </summary>
     private async Task<bool> CreateIntroAudio(string inputPath, int id, string tmpDir, bool deleteOnFailure = true)
     {
         var acbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.acb");
@@ -292,6 +293,11 @@ private async Task<bool> CreateIntroAudio(string inputPath, int id, string tmpDi
         // 先在临时目录里生成，两个文件都成功后再搬过去
         var tmpAcbPath = Path.Combine(tmpDir, $"Enter_{id}.acb");
         var tmpAwbPath = Path.Combine(tmpDir, $"Enter_{id}.awb");
+        // 替换前先备份旧文件：任一移动失败就回滚，保证 acb/awb 始终配套
+        var bakAcbPath = Path.Combine(tmpDir, $"Enter_{id}.acb.bak");
+        var bakAwbPath = Path.Combine(tmpDir, $"Enter_{id}.awb.bak");
+        var hadAcb = System.IO.File.Exists(acbPath);
+        var hadAwb = System.IO.File.Exists(awbPath);
 
         try
         {
@@ -305,13 +311,27 @@ private async Task<bool> CreateIntroAudio(string inputPath, int id, string tmpDi
             if (!System.IO.File.Exists(tmpAcbPath) || !System.IO.File.Exists(tmpAwbPath))
                 throw new InvalidOperationException("acb/awb not generated");
 
+            if (hadAcb) System.IO.File.Copy(acbPath, bakAcbPath, true);
+            if (hadAwb) System.IO.File.Copy(awbPath, bakAwbPath, true);
+
             MoveFileWithRetry(tmpAcbPath, acbPath);
             MoveFileWithRetry(tmpAwbPath, awbPath);
             return true;
         }
         catch (Exception e)
         {
-            logger.LogWarning(e, "开场视频音频生成失败，按静音处理: {id}", id);
+            logger.LogWarning(e, "开场视频音频生成失败: {id}", id);
+            // 回滚成对音频：有备份就还原，本来没有的就删掉可能写进去的那一半
+            try
+            {
+                RestoreOrDelete(acbPath, bakAcbPath, hadAcb);
+                RestoreOrDelete(awbPath, bakAwbPath, hadAwb);
+            }
+            catch (Exception restoreError)
+            {
+                logger.LogWarning(restoreError, "开场音频回滚失败: {id}", id);
+            }
+
             // 换视频时音画必须配套，所以没音轨就清掉旧的；用户单独传音频失败则保留原来的
             if (deleteOnFailure)
             {
@@ -324,6 +344,9 @@ private async Task<bool> CreateIntroAudio(string inputPath, int id, string tmpDi
     [HttpPost]
     public FancyToolResult DeleteIntroMovie(int id)
     {
+        var gamePathError = EnsureGamePath();
+        if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
+
         var ok = DeleteFilesWithRetry(
             Path.Combine(IntroMovieDir, VideoFileName(id, null)),
             Path.Combine(IntroMovieDir, VideoFileName(id, "L")),
@@ -333,10 +356,6 @@ public FancyToolResult DeleteIntroMovie(int id)
         return new FancyToolResult(ok, ok ? null : "delete-failed");
     }
 
-    /// <summary>
-    /// 删除文件（Windows 走回收站）。被占用时（例如前端还在预览这个视频、句柄没释放）重试几次，
-    /// 全部失败才返回 false，让前端提示「文件被占用」而不是静默失败。
-    /// </summary>
     /// <summary>
     /// 覆盖式移动文件：目标被占用（例如前端还在预览旧文件）时重试几次。
     /// </summary>
@@ -356,6 +375,24 @@ private static void MoveFileWithRetry(string source, string dest)
         }
     }
 
+    /// <summary>
+    /// 回滚成对音频：原来有文件就从备份还原，原来没有就把可能写进去的那一半删掉。
+    /// </summary>
+    private static void RestoreOrDelete(string path, string backupPath, bool hadOriginal)
+    {
+        if (hadOriginal)
+        {
+            if (System.IO.File.Exists(backupPath)) System.IO.File.Copy(backupPath, path, true);
+            return;
+        }
+
+        if (System.IO.File.Exists(path)) System.IO.File.Delete(path);
+    }
+
+    /// <summary>
+    /// 删除文件（Windows 走回收站）。被占用时（例如前端还在预览这个视频、句柄没释放）重试几次，
+    /// 全部失败才返回 false，让前端提示「文件被占用」而不是静默失败。
+    /// </summary>
     private static bool DeleteFilesWithRetry(params string[] paths)
     {
         // 先等占用消失：这一步很便宜（只是尝试以独占方式打开文件），避免回收站删除在被占用时卡很久
@@ -556,20 +593,28 @@ public async Task<FancyToolResult> SetCamouflageJacket([FromForm] int id, IFormF
         var gamePathError = EnsureGamePath();
         if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
 
+        var tmpPath = Path.Combine(CamouflageDir, $"{id}_jacket{ext}.tmp");
         try
         {
             Directory.CreateDirectory(CamouflageDir);
             var targetPath = Path.Combine(CamouflageDir, $"{id}_jacket{ext}");
-            // 同一首曲子只保留一张封面
+
+            // 先写临时文件再覆盖目标，避免写到一半把已有封面弄坏
+            await using (var stream = System.IO.File.Create(tmpPath))
+            {
+                await file.CopyToAsync(stream);
+            }
+            MoveFileWithRetry(tmpPath, targetPath);
+
+            // 同一首曲子只保留一张封面；清理失败不影响新封面，只记日志
             foreach (var otherExt in new[] { ".jpg", ".jpeg", ".png" })
             {
                 var otherPath = Path.Combine(CamouflageDir, $"{id}_jacket{otherExt}");
-                if (!string.Equals(otherPath, targetPath, StringComparison.OrdinalIgnoreCase))
-                    DeleteFilesWithRetry(otherPath);
+                if (!string.Equals(otherPath, targetPath, StringComparison.OrdinalIgnoreCase) &&
+                    !DeleteFilesWithRetry(otherPath))
+                    logger.LogWarning("旧封面清理失败: {path}", otherPath);
             }
 
-            await using var stream = System.IO.File.Create(targetPath);
-            await file.CopyToAsync(stream);
             return new FancyToolResult(true, null);
         }
         catch (Exception e)
@@ -577,11 +622,25 @@ public async Task<FancyToolResult> SetCamouflageJacket([FromForm] int id, IFormF
             logger.LogError(e, "写入曲目伪装封面失败: {id}", id);
             return new FancyToolResult(false, "write-failed");
         }
+        finally
+        {
+            try
+            {
+                if (System.IO.File.Exists(tmpPath)) System.IO.File.Delete(tmpPath);
+            }
+            catch
+            {
+                // 忽略清理失败
+            }
+        }
     }
 
     [HttpPost]
     public FancyToolResult DeleteCamouflage(int id)
     {
+        var gamePathError = EnsureGamePath();
+        if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
+
         var ok = DeleteFilesWithRetry(
             [
                 Path.Combine(CamouflageDir, $"{id}.toml"),
diff --git a/MaiChartManager/Front/src/locales/en.yaml b/MaiChartManager/Front/src/locales/en.yaml
index 1c33313f..69bc979a 100644
--- a/MaiChartManager/Front/src/locales/en.yaml
+++ b/MaiChartManager/Front/src/locales/en.yaml
@@ -445,7 +445,7 @@ tools:
     music: Music
     musicPlaceholder: Search by ID or name
     musicPick: Choose a song
-    pickMusicFirst: Select a music first
+    pickMusicFirst: Select a song first
     introTab: Intro movie
     camouflageTab: Camouflage
     introHint: "Play a custom video before a track starts (AquaMai's CustomIntroCinematic). Both screens can share one video or use separate ones. Uploads are converted to a silent mp4; the audio track is extracted into Enter_<id>.acb / .awb and played separately by the game."
@@ -474,7 +474,7 @@ tools:
     camoArtist: Disguised artist
     camoNoteDesigner: Disguised note designer
     camoHideNoteDesigner: Hide note designer (shows -)
-    camoUnlockScore: Achievement required to remove camouflage
+    camoUnlockScore: Score required to remove camouflage
     camoUnlockScoreHint: 0 means the camouflage disappears once the player has any score; use 102 to keep it forever
     camoJacketUpload: Choose jacket (jpg / png)
     camoJacketReplace: Replace jacket
diff --git a/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx b/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx
index 968c3879..928a0810 100644
--- a/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx
+++ b/MaiChartManager/Front/src/views/Tools/IntroCamouflageModal.tsx
@@ -107,22 +107,28 @@ export default defineComponent({
     };
 
     const loadIntroMovie = async () => {
-      if (!musicId.value) {
+      const id = musicId.value;
+      if (!id) {
         introInfo.value = null;
         return;
       }
-      introInfo.value = (await api.GetIntroMovie({ id: musicId.value })).data;
-      const info = introInfo.value;
+      const data = (await api.GetIntroMovie({ id })).data;
+      // 切曲目后旧请求可能才回来，丢弃过期响应
+      if (id !== musicId.value) return;
+      introInfo.value = data;
+      const info = data;
       // 单文件优先；只有左右各一个文件时才进分屏模式
       introSame.value = !info || info.hasSingle || !(info.hasLeft && info.hasRight);
     };
 
     const loadCamouflage = async () => {
-      if (!musicId.value) {
+      const id = musicId.value;
+      if (!id) {
         camouflage.value = emptyCamouflage();
         return;
       }
-      const data: CamouflageInfoDto = (await api.GetCamouflage({ id: musicId.value })).data;
+      const data: CamouflageInfoDto = (await api.GetCamouflage({ id })).data;
+      if (id !== musicId.value) return;
       camouflage.value = {
         name: data.name ?? '',
         artist: data.artist ?? '',
@@ -141,8 +147,10 @@ export default defineComponent({
 
     // 只刷新封面状态，保留用户还在编辑、尚未保存的表单内容
     const refreshCamouflageJacket = async () => {
-      if (!musicId.value) return;
-      const data: CamouflageInfoDto = (await api.GetCamouflage({ id: musicId.value })).data;
+      const id = musicId.value;
+      if (!id) return;
+      const data: CamouflageInfoDto = (await api.GetCamouflage({ id })).data;
+      if (id !== musicId.value) return;
       camouflage.value.hasJacket = !!data.hasJacket;
       camouflage.value.jacketPath = data.jacketPath ?? '';
     };
@@ -231,6 +239,8 @@ export default defineComponent({
           fail(result.error);
           return;
         }
+        // 音频换了 URL 必须跟着变，否则 <audio> 可能还播浏览器缓存里的旧音频
+        previewToken.value = Date.now();
         await Promise.all([loadIntroMovie(), loadLists()]);
         addToast({ message: t('tools.fancy.introAudioGenerated'), type: 'success' });
       } catch (e) {
diff --git a/MaiChartManager/Utils/VideoConvert.cs b/MaiChartManager/Utils/VideoConvert.cs
index de9f6e8e..28acd29f 100644
--- a/MaiChartManager/Utils/VideoConvert.cs
+++ b/MaiChartManager/Utils/VideoConvert.cs
@@ -41,20 +41,9 @@ private static string FormatFFmpegTime(TimeSpan time) =>
     /// </summary>
     private static List<string> BuildPostArgs(VideoEncoderProfile p, VideoConvertOptions options, bool isImage)
     {
-        var post = new List<string> { $"-c:v {p.Codec}" };
-        if (options.KeepAudio)
-        {
-            // 只保留第一条视频轨和（如果有）第一条音频轨；
-            // 音频单独转 AAC，保证浏览器（预览）和游戏都能读
-            post.Add("-map 0:v:0");
-            post.Add("-map 0:a:0?");
-            post.Add("-c:a aac");
-            post.Add("-b:a 192k");
-        }
-        else
-        {
-            post.Add("-map 0:0");
-        }
+        // 只取第一条视频流：音频一律不写进输出（IVF/USM 也放不下音频），
+        // 需要声音的场景（例如开场视频）由调用方另外生成 acb/awb。
+        var post = new List<string> { $"-c:v {p.Codec}", "-map 0:0" };
         if (isImage) post.Add("-r 1 -t 2");
         post.Add(MultiThreadArg);
         if (p.Kind == VideoCodecKind.Vp9 && !p.IsHardware)
@@ -121,11 +110,6 @@ public class VideoConvertOptions
         /// </summary>
         public bool UseYuv420p { get; set; }
 
-        /// <summary>
-        /// 是否保留音轨（默认丢弃，只留视频流）
-        /// </summary>
-        public bool KeepAudio { get; set; }
-
         /// <summary>
         /// 额外的 ffmpeg 输出参数（例如画质），追加在编码参数的最后
         /// </summary>
@@ -414,6 +398,8 @@ private static async Task RunConcatenate(string vf, VideoEncoderProfile profile,
                 postArgs.Add("-pix_fmt yuv420p");
         }
         postArgs.AddRange(profile.ExtraOutputArgs);
+        // 调用方指定的额外参数（画质等）同样要带上，位置保持在默认参数之后
+        if (options.ExtraArgs is { Length: > 0 }) postArgs.AddRange(options.ExtraArgs);
 
 #if DEBUG
         Console.WriteLine($"[ffargs] concat profile={profile.Name} pre=[{string.Join(" ", profile.PreInputArgs)}] post=[{string.Join(" ", postArgs)}]");

From b73c56928b8cbfbce125e6e648ed5ce18009914d Mon Sep 17 00:00:00 2001
From: huimanQAQ <huimanQAQ@gmail.com>
Date: Thu, 29 Oct 2026 00:52:53 +0800
Subject: [PATCH 4/6] =?UTF-8?q?fix(tools):=20=E5=BC=80=E5=9C=BA=E8=A7=86?=
 =?UTF-8?q?=E9=A2=91=E6=94=B9=E6=88=90=E5=8F=AF=E5=9B=9E=E6=BB=9A=E4=BA=8B?=
 =?UTF-8?q?=E5=8A=A1=EF=BC=8C=E5=B9=B6=E4=BF=AE=E6=AD=A3=20-map=20?=
 =?UTF-8?q?=E9=80=89=E6=B5=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- SetIntroMovie 把「转码 → 清理旧布局 → 落地新视频 → 落地音频」做成一个事务：
  操作前备份 Enter_<id>.mp4 / _L / _R / .acb / .awb，任一步失败整体回滚，
  不会出现「新音频配旧画面」「旧布局已删但新视频没落地」这类半状态
- 抽出 BuildIntroAudio（只生成到临时目录）与 IntroFileTransaction，
  SetIntroAudio 复用同一套事务；删除不再需要的 CreateIntroAudio / RestoreOrDelete
- VideoConvert：-map 0:0 改为 -map 0:v:0，避免「第 0 个流其实是音频」的容器选错流导致转换失败
---
 .../Controllers/Tools/FancyToolController.cs  | 166 ++++++++++++------
 MaiChartManager/Utils/VideoConvert.cs         |   5 +-
 2 files changed, 111 insertions(+), 60 deletions(-)

diff --git a/MaiChartManager/Controllers/Tools/FancyToolController.cs b/MaiChartManager/Controllers/Tools/FancyToolController.cs
index 4bbfc075..d6cc83a9 100644
--- a/MaiChartManager/Controllers/Tools/FancyToolController.cs
+++ b/MaiChartManager/Controllers/Tools/FancyToolController.cs
@@ -127,6 +127,7 @@ public ActionResult GetIntroAudioFile(int id)
 
     /// <summary>
     /// 上传并转换开场视频。side 为空表示左右屏播放同一个视频，L / R 表示只替换其中一侧。
+    /// 视频、音频、旧布局清理作为整体提交：任一步失败都会回滚到操作前的状态。
     /// </summary>
     [HttpPost]
     [DisableRequestSizeLimit]
@@ -144,6 +145,7 @@ public async Task<FancyToolResult> SetIntroMovie([FromForm] int id, [FromForm] s
         if (normalizedSide is not (null or "L" or "R")) return new FancyToolResult(false, "invalid-side");
 
         var tmpDir = Directory.CreateTempSubdirectory();
+        var tx = new IntroFileTransaction(Path.Combine(tmpDir.FullName, "backup"));
         try
         {
             var inputPath = Path.Combine(tmpDir.FullName, "input" + Path.GetExtension(file.FileName));
@@ -172,17 +174,25 @@ await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
 
             if (!System.IO.File.Exists(tmpVideoPath)) return new FancyToolResult(false, "convert-failed");
 
-            // mp4 只保留画面（VideoConvert 用 -map 0:0 丢掉了音轨）；音轨另外提取成 Enter_<id>.acb/.awb，
-            // 游戏里由 AquaMai 单独播放，这样视频静音、声音走 acb/awb。
-            await CreateIntroAudio(inputPath, id, tmpDir.FullName);
+            // 音轨只生成到临时目录，等视频布局确定后和视频一起提交
+            var audio = await BuildIntroAudio(inputPath, id, tmpDir.FullName);
 
-            // 先把与新布局冲突的旧文件清掉：清理失败就直接返回，避免单文件和 L/R 同时存在
-            var oldLayoutCleaned = normalizedSide is null
-                ? DeleteFilesWithRetry(
+            // 这次会动到的文件先全部备份，失败时整体回滚
+            foreach (var path in IntroFilePaths(id)) tx.Track(path);
+
+            // 清理与新布局冲突的旧视频（单文件与 L/R 不能共存）
+            string[] conflictingFiles = normalizedSide is null
+                ?
+                [
                     Path.Combine(IntroMovieDir, VideoFileName(id, "L")),
-                    Path.Combine(IntroMovieDir, VideoFileName(id, "R")))
-                : DeleteFilesWithRetry(Path.Combine(IntroMovieDir, VideoFileName(id, null)));
-            if (!oldLayoutCleaned) return new FancyToolResult(false, "delete-failed");
+                    Path.Combine(IntroMovieDir, VideoFileName(id, "R")),
+                ]
+                : [Path.Combine(IntroMovieDir, VideoFileName(id, null))];
+            if (!DeleteFilesWithRetry(conflictingFiles))
+            {
+                tx.Rollback();
+                return new FancyToolResult(false, "delete-failed");
+            }
 
             MoveFileWithRetry(tmpVideoPath, targetPath);
 
@@ -194,11 +204,26 @@ await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
                 if (!System.IO.File.Exists(otherPath)) PlatformFile.CopyFile(targetPath, otherPath);
             }
 
+            // 音频必须和视频配套：这次没有音轨就把旧的 acb/awb 一起清掉
+            var acbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.acb");
+            var awbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.awb");
+            if (audio is not null)
+            {
+                MoveFileWithRetry(audio.AcbPath, acbPath);
+                MoveFileWithRetry(audio.AwbPath, awbPath);
+            }
+            else if (!DeleteFilesWithRetry(acbPath, awbPath))
+            {
+                tx.Rollback();
+                return new FancyToolResult(false, "delete-failed");
+            }
+
             return new FancyToolResult(true, null);
         }
         catch (Exception e)
         {
             logger.LogError(e, "转换开场视频失败: {id}", id);
+            tx.Rollback();
             return new FancyToolResult(false, "convert-failed");
         }
         finally
@@ -232,6 +257,7 @@ public async Task<FancyToolResult> SetIntroAudio([FromForm] int id, IFormFile fi
         if (file is null || file.Length <= 0) return new FancyToolResult(false, "invalid-audio");
 
         var tmpDir = Directory.CreateTempSubdirectory();
+        var tx = new IntroFileTransaction(Path.Combine(tmpDir.FullName, "backup"));
         try
         {
             Directory.CreateDirectory(IntroMovieDir);
@@ -241,15 +267,23 @@ public async Task<FancyToolResult> SetIntroAudio([FromForm] int id, IFormFile fi
                 await file.CopyToAsync(stream);
             }
 
-            // CreateIntroAudio 内部已做「先转临时文件再搬过去」，失败时返回 false
-            if (!await CreateIntroAudio(inputPath, id, tmpDir.FullName, deleteOnFailure: false))
-                return new FancyToolResult(false, "invalid-audio");
+            var audio = await BuildIntroAudio(inputPath, id, tmpDir.FullName);
+            if (audio is null) return new FancyToolResult(false, "invalid-audio");
+
+            var acbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.acb");
+            var awbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.awb");
+            tx.Track(acbPath);
+            tx.Track(awbPath);
+
+            MoveFileWithRetry(audio.AcbPath, acbPath);
+            MoveFileWithRetry(audio.AwbPath, awbPath);
 
             return new FancyToolResult(true, null);
         }
         catch (Exception e)
         {
             logger.LogError(e, "写入开场音频失败: {id}", id);
+            tx.Rollback();
             return new FancyToolResult(false, "write-failed");
         }
         finally
@@ -280,24 +314,17 @@ public FancyToolResult DeleteIntroAudio(int id)
         return new FancyToolResult(ok, ok ? null : "delete-failed");
     }
 
+    private sealed record IntroAudioFiles(string AcbPath, string AwbPath);
+
     /// <summary>
-    /// 从上传的文件里提取音轨，生成 Enter_&lt;id&gt;.acb / .awb。
-    /// 开场 mp4 本身是静音的，游戏里由 acb/awb 出声（AquaMai 的 CustomIntroCinematic 会调 SoundManager 播放）。
-    /// acb/awb 成对替换：先备份旧文件，任一移动失败就回滚。
+    /// 从上传的文件里提取音轨，生成到临时目录（acb/awb 成对）。
+    /// 没有音轨或转换失败返回 null，由调用方决定是否清掉旧的 acb/awb。
     /// </summary>
-    private async Task<bool> CreateIntroAudio(string inputPath, int id, string tmpDir, bool deleteOnFailure = true)
+    private async Task<IntroAudioFiles?> BuildIntroAudio(string inputPath, int id, string tmpDir)
     {
-        var acbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.acb");
-        var awbPath = Path.Combine(IntroMovieDir, $"Enter_{id}.awb");
         var wavPath = Path.Combine(tmpDir, "audio.wav");
-        // 先在临时目录里生成，两个文件都成功后再搬过去
         var tmpAcbPath = Path.Combine(tmpDir, $"Enter_{id}.acb");
         var tmpAwbPath = Path.Combine(tmpDir, $"Enter_{id}.awb");
-        // 替换前先备份旧文件：任一移动失败就回滚，保证 acb/awb 始终配套
-        var bakAcbPath = Path.Combine(tmpDir, $"Enter_{id}.acb.bak");
-        var bakAwbPath = Path.Combine(tmpDir, $"Enter_{id}.awb.bak");
-        var hadAcb = System.IO.File.Exists(acbPath);
-        var hadAwb = System.IO.File.Exists(awbPath);
 
         try
         {
@@ -311,36 +338,73 @@ private async Task<bool> CreateIntroAudio(string inputPath, int id, string tmpDi
             if (!System.IO.File.Exists(tmpAcbPath) || !System.IO.File.Exists(tmpAwbPath))
                 throw new InvalidOperationException("acb/awb not generated");
 
-            if (hadAcb) System.IO.File.Copy(acbPath, bakAcbPath, true);
-            if (hadAwb) System.IO.File.Copy(awbPath, bakAwbPath, true);
-
-            MoveFileWithRetry(tmpAcbPath, acbPath);
-            MoveFileWithRetry(tmpAwbPath, awbPath);
-            return true;
+            return new IntroAudioFiles(tmpAcbPath, tmpAwbPath);
         }
         catch (Exception e)
         {
-            logger.LogWarning(e, "开场视频音频生成失败: {id}", id);
-            // 回滚成对音频：有备份就还原，本来没有的就删掉可能写进去的那一半
-            try
-            {
-                RestoreOrDelete(acbPath, bakAcbPath, hadAcb);
-                RestoreOrDelete(awbPath, bakAwbPath, hadAwb);
-            }
-            catch (Exception restoreError)
+            logger.LogWarning(e, "开场音频生成失败，按静音处理: {id}", id);
+            return null;
+        }
+    }
+
+    private static string[] IntroFilePaths(int id) =>
+    [
+        Path.Combine(IntroMovieDir, VideoFileName(id, null)),
+        Path.Combine(IntroMovieDir, VideoFileName(id, "L")),
+        Path.Combine(IntroMovieDir, VideoFileName(id, "R")),
+        Path.Combine(IntroMovieDir, $"Enter_{id}.acb"),
+        Path.Combine(IntroMovieDir, $"Enter_{id}.awb"),
+    ];
+
+    /// <summary>
+    /// 开场文件事务：先把这次会改动/删除的文件备份到临时目录，
+    /// 失败时整体回滚（原本有的还原，原本没有的删掉），避免留下半套文件。
+    /// </summary>
+    private sealed class IntroFileTransaction(string backupDir)
+    {
+        private readonly List<(string Path, string BackupPath, bool Existed)> _entries = [];
+        private bool _rolledBack;
+
+        public void Track(string path)
+        {
+            if (_entries.Any(entry => string.Equals(entry.Path, path, StringComparison.OrdinalIgnoreCase))) return;
+
+            var existed = System.IO.File.Exists(path);
+            var backupPath = Path.Combine(backupDir, Guid.NewGuid().ToString("N"));
+            if (existed)
             {
-                logger.LogWarning(restoreError, "开场音频回滚失败: {id}", id);
+                Directory.CreateDirectory(backupDir);
+                System.IO.File.Copy(path, backupPath, true);
             }
 
-            // 换视频时音画必须配套，所以没音轨就清掉旧的；用户单独传音频失败则保留原来的
-            if (deleteOnFailure)
+            _entries.Add((path, backupPath, existed));
+        }
+
+        public void Rollback()
+        {
+            if (_rolledBack) return;
+            _rolledBack = true;
+
+            foreach (var (path, backupPath, existed) in _entries)
             {
-                DeleteFilesWithRetry(acbPath, awbPath);
+                try
+                {
+                    if (existed)
+                    {
+                        if (System.IO.File.Exists(backupPath)) System.IO.File.Copy(backupPath, path, true);
+                    }
+                    else if (System.IO.File.Exists(path))
+                    {
+                        System.IO.File.Delete(path);
+                    }
+                }
+                catch (Exception)
+                {
+                    // 尽力回滚，单个文件失败不影响其它文件
+                }
             }
-            return false;
         }
     }
-
     [HttpPost]
     public FancyToolResult DeleteIntroMovie(int id)
     {
@@ -375,20 +439,6 @@ private static void MoveFileWithRetry(string source, string dest)
         }
     }
 
-    /// <summary>
-    /// 回滚成对音频：原来有文件就从备份还原，原来没有就把可能写进去的那一半删掉。
-    /// </summary>
-    private static void RestoreOrDelete(string path, string backupPath, bool hadOriginal)
-    {
-        if (hadOriginal)
-        {
-            if (System.IO.File.Exists(backupPath)) System.IO.File.Copy(backupPath, path, true);
-            return;
-        }
-
-        if (System.IO.File.Exists(path)) System.IO.File.Delete(path);
-    }
-
     /// <summary>
     /// 删除文件（Windows 走回收站）。被占用时（例如前端还在预览这个视频、句柄没释放）重试几次，
     /// 全部失败才返回 false，让前端提示「文件被占用」而不是静默失败。
diff --git a/MaiChartManager/Utils/VideoConvert.cs b/MaiChartManager/Utils/VideoConvert.cs
index 28acd29f..a82d93de 100644
--- a/MaiChartManager/Utils/VideoConvert.cs
+++ b/MaiChartManager/Utils/VideoConvert.cs
@@ -41,9 +41,10 @@ private static string FormatFFmpegTime(TimeSpan time) =>
     /// </summary>
     private static List<string> BuildPostArgs(VideoEncoderProfile p, VideoConvertOptions options, bool isImage)
     {
-        // 只取第一条视频流：音频一律不写进输出（IVF/USM 也放不下音频），
+        // 只取输入的第一条视频流（-map 0:0 是「第 0 个流」，音频排在前面时会选错）：
+        // 音频一律不写进输出（IVF/USM 也放不下音频），
         // 需要声音的场景（例如开场视频）由调用方另外生成 acb/awb。
-        var post = new List<string> { $"-c:v {p.Codec}", "-map 0:0" };
+        var post = new List<string> { $"-c:v {p.Codec}", "-map 0:v:0" };
         if (isImage) post.Add("-r 1 -t 2");
         post.Add(MultiThreadArg);
         if (p.Kind == VideoCodecKind.Vp9 && !p.IsHardware)

From 62aeace463c958643dd60318bb2e1a42fc6c3f5e Mon Sep 17 00:00:00 2001
From: huimanQAQ <huimanQAQ@gmail.com>
Date: Thu, 29 Oct 2026 01:03:22 +0800
Subject: [PATCH 5/6] =?UTF-8?q?fix(tools):=20=E5=90=8C=E4=B8=80=E6=9B=B2?=
 =?UTF-8?q?=E7=9B=AE=E7=9A=84=E5=BC=80=E5=9C=BA=E6=96=87=E4=BB=B6=E6=93=8D?=
 =?UTF-8?q?=E4=BD=9C=E6=8C=89=20id=20=E4=B8=B2=E8=A1=8C=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增按 id 的 SemaphoreSlim（IntroFileGates）：SetIntroMovie / SetIntroAudio 与
  DeleteIntroMovie / DeleteIntroAudio / DeleteCamouflage 都先拿锁再执行，finally 释放，
  不同曲目互不阻塞
- 原因：上传视频时会顺带重写 acb/awb，两个并发请求交错提交可能出现
  「mp4 来自请求 A、acb/awb 来自请求 B」的音画不匹配；事务本身无法防止交错
---
 .../Controllers/Tools/FancyToolController.cs  | 78 +++++++++++++++++++
 1 file changed, 78 insertions(+)

diff --git a/MaiChartManager/Controllers/Tools/FancyToolController.cs b/MaiChartManager/Controllers/Tools/FancyToolController.cs
index d6cc83a9..3ca1ccf2 100644
--- a/MaiChartManager/Controllers/Tools/FancyToolController.cs
+++ b/MaiChartManager/Controllers/Tools/FancyToolController.cs
@@ -1,3 +1,4 @@
+using System.Collections.Concurrent;
 using MaiChartManager.Platform;
 using MaiChartManager.Utils;
 using Microsoft.AspNetCore.Mvc;
@@ -22,6 +23,13 @@ public class FancyToolController(ILogger<FancyToolController> logger) : Controll
     private static string IntroMovieDir => Path.Combine(StaticSettings.GamePath, "LocalAssets", "IntroMovies");
     private static string CamouflageDir => Path.Combine(StaticSettings.GamePath, "LocalAssets", "Camouflages");
 
+    /// <summary>
+    /// 同一个曲目的开场文件操作串行化：避免两个请求交错提交，留下音画不匹配的文件。
+    /// </summary>
+    private static readonly ConcurrentDictionary<int, SemaphoreSlim> IntroFileGates = new();
+
+    private static SemaphoreSlim GetIntroFileGate(int id) => IntroFileGates.GetOrAdd(id, _ => new SemaphoreSlim(1, 1));
+
     public record FancyToolResult(bool Success, string? Error);
 
     public record IntroMovieInfo(bool HasSingle, bool HasLeft, bool HasRight, bool HasAudio,
@@ -132,6 +140,20 @@ public ActionResult GetIntroAudioFile(int id)
     [HttpPost]
     [DisableRequestSizeLimit]
     public async Task<FancyToolResult> SetIntroMovie([FromForm] int id, [FromForm] string? side, IFormFile file)
+    {
+        var gate = GetIntroFileGate(id);
+        await gate.WaitAsync();
+        try
+        {
+            return await SetIntroMovieCore(id, side, file);
+        }
+        finally
+        {
+            gate.Release();
+        }
+    }
+
+    private async Task<FancyToolResult> SetIntroMovieCore(int id, string? side, IFormFile file)
     {
         if (id <= 0) return new FancyToolResult(false, "invalid-id");
         var gamePathError = EnsureGamePath();
@@ -246,6 +268,20 @@ await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
     [HttpPost]
     [DisableRequestSizeLimit]
     public async Task<FancyToolResult> SetIntroAudio([FromForm] int id, IFormFile file)
+    {
+        var gate = GetIntroFileGate(id);
+        await gate.WaitAsync();
+        try
+        {
+            return await SetIntroAudioCore(id, file);
+        }
+        finally
+        {
+            gate.Release();
+        }
+    }
+
+    private async Task<FancyToolResult> SetIntroAudioCore(int id, IFormFile file)
     {
         if (id <= 0) return new FancyToolResult(false, "invalid-id");
         var gamePathError = EnsureGamePath();
@@ -304,6 +340,20 @@ public async Task<FancyToolResult> SetIntroAudio([FromForm] int id, IFormFile fi
     /// </summary>
     [HttpPost]
     public FancyToolResult DeleteIntroAudio(int id)
+    {
+        var gate = GetIntroFileGate(id);
+        gate.Wait();
+        try
+        {
+            return DeleteIntroAudioCore(id);
+        }
+        finally
+        {
+            gate.Release();
+        }
+    }
+
+    private static FancyToolResult DeleteIntroAudioCore(int id)
     {
         var gamePathError = EnsureGamePath();
         if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
@@ -407,6 +457,20 @@ public void Rollback()
     }
     [HttpPost]
     public FancyToolResult DeleteIntroMovie(int id)
+    {
+        var gate = GetIntroFileGate(id);
+        gate.Wait();
+        try
+        {
+            return DeleteIntroMovieCore(id);
+        }
+        finally
+        {
+            gate.Release();
+        }
+    }
+
+    private static FancyToolResult DeleteIntroMovieCore(int id)
     {
         var gamePathError = EnsureGamePath();
         if (gamePathError is not null) return new FancyToolResult(false, gamePathError);
@@ -687,6 +751,20 @@ public async Task<FancyToolResult> SetCamouflageJacket([FromForm] int id, IFormF
 
     [HttpPost]
     public FancyToolResult DeleteCamouflage(int id)
+    {
+        var gate = GetIntroFileGate(id);
+        gate.Wait();
+        try
+        {
+            return DeleteCamouflageCore(id);
+        }
+        finally
+        {
+            gate.Release();
+        }
+    }
+
+    private static FancyToolResult DeleteCamouflageCore(int id)
     {
         var gamePathError = EnsureGamePath();
         if (gamePathError is not null) return new FancyToolResult(false, gamePathError);

From 40fcdc0f2826511488a3343b8e661660eb44f2e3 Mon Sep 17 00:00:00 2001
From: huimanQAQ <huimanQAQ@gmail.com>
Date: Thu, 29 Oct 2026 01:15:39 +0800
Subject: [PATCH 6/6] =?UTF-8?q?fix(tools):=20=E9=94=81=E6=94=B9=E6=88=90?=
 =?UTF-8?q?=E6=81=92=E5=AE=9A=E5=86=85=E5=AD=98=E7=9A=84=E5=88=86=E6=AE=B5?=
 =?UTF-8?q?=E9=94=81=EF=BC=8C=E5=B9=B6=E8=A6=86=E7=9B=96=E4=BC=AA=E8=A3=85?=
 =?UTF-8?q?=E5=86=99=E5=85=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 用固定 64 条 SemaphoreSlim 的分段锁替换按 id 建字典的 IntroFileGates：
  内存恒定、不需要回收，id 校验也提前到加锁之前
- DeleteIntroMovie / DeleteIntroAudio / DeleteCamouflage 改为 async action +
  await WaitAsync()，避免转码长时间持锁时阻塞线程池线程
- SetCamouflage / SetCamouflageJacket 也拿同一把锁（按 id），
  删除不会再与伪装配置 / 封面上传交错，留下不完整的伪装文件
---
 .../Controllers/Tools/FancyToolController.cs  | 76 +++++++++++++++----
 1 file changed, 60 insertions(+), 16 deletions(-)

diff --git a/MaiChartManager/Controllers/Tools/FancyToolController.cs b/MaiChartManager/Controllers/Tools/FancyToolController.cs
index 3ca1ccf2..9fce9b69 100644
--- a/MaiChartManager/Controllers/Tools/FancyToolController.cs
+++ b/MaiChartManager/Controllers/Tools/FancyToolController.cs
@@ -1,4 +1,3 @@
-using System.Collections.Concurrent;
 using MaiChartManager.Platform;
 using MaiChartManager.Utils;
 using Microsoft.AspNetCore.Mvc;
@@ -24,11 +23,13 @@ public class FancyToolController(ILogger<FancyToolController> logger) : Controll
     private static string CamouflageDir => Path.Combine(StaticSettings.GamePath, "LocalAssets", "Camouflages");
 
     /// <summary>
-    /// 同一个曲目的开场文件操作串行化：避免两个请求交错提交，留下音画不匹配的文件。
+    /// 同一个曲目的文件操作串行化：避免两个请求交错提交，留下音画 / 伪装不匹配的文件。
+    /// 用固定数量的「分段锁」而不是按 id 建字典，内存恒定（不同 id 偶尔落到同一段，可以接受）。
     /// </summary>
-    private static readonly ConcurrentDictionary<int, SemaphoreSlim> IntroFileGates = new();
+    private static readonly SemaphoreSlim[] FileGates =
+        Enumerable.Range(0, 64).Select(_ => new SemaphoreSlim(1, 1)).ToArray();
 
-    private static SemaphoreSlim GetIntroFileGate(int id) => IntroFileGates.GetOrAdd(id, _ => new SemaphoreSlim(1, 1));
+    private static SemaphoreSlim GetFileGate(int id) => FileGates[(uint)id % (uint)FileGates.Length];
 
     public record FancyToolResult(bool Success, string? Error);
 
@@ -141,7 +142,9 @@ public ActionResult GetIntroAudioFile(int id)
     [DisableRequestSizeLimit]
     public async Task<FancyToolResult> SetIntroMovie([FromForm] int id, [FromForm] string? side, IFormFile file)
     {
-        var gate = GetIntroFileGate(id);
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+
+        var gate = GetFileGate(id);
         await gate.WaitAsync();
         try
         {
@@ -269,7 +272,9 @@ await VideoConvert.ConvertVideo(new VideoConvert.VideoConvertOptions
     [DisableRequestSizeLimit]
     public async Task<FancyToolResult> SetIntroAudio([FromForm] int id, IFormFile file)
     {
-        var gate = GetIntroFileGate(id);
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+
+        var gate = GetFileGate(id);
         await gate.WaitAsync();
         try
         {
@@ -339,10 +344,12 @@ private async Task<FancyToolResult> SetIntroAudioCore(int id, IFormFile file)
     /// 只删掉开场音频，保留视频（左右屏共用的那一套 acb/awb）。
     /// </summary>
     [HttpPost]
-    public FancyToolResult DeleteIntroAudio(int id)
+    public async Task<FancyToolResult> DeleteIntroAudio(int id)
     {
-        var gate = GetIntroFileGate(id);
-        gate.Wait();
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+
+        var gate = GetFileGate(id);
+        await gate.WaitAsync();
         try
         {
             return DeleteIntroAudioCore(id);
@@ -456,10 +463,12 @@ public void Rollback()
         }
     }
     [HttpPost]
-    public FancyToolResult DeleteIntroMovie(int id)
+    public async Task<FancyToolResult> DeleteIntroMovie(int id)
     {
-        var gate = GetIntroFileGate(id);
-        gate.Wait();
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+
+        var gate = GetFileGate(id);
+        await gate.WaitAsync();
         try
         {
             return DeleteIntroMovieCore(id);
@@ -662,10 +671,27 @@ public ActionResult GetCamouflageJacket(int id)
     }
 
     [HttpPost]
-    public FancyToolResult SetCamouflage([FromForm] int id, [FromForm] string? name, [FromForm] string? artist,
+    public async Task<FancyToolResult> SetCamouflage([FromForm] int id, [FromForm] string? name, [FromForm] string? artist,
         [FromForm] string? noteDesigner, [FromForm] bool hideNoteDesigner, [FromForm] double unlockScore)
     {
         if (id <= 0) return new FancyToolResult(false, "invalid-id");
+
+        var gate = GetFileGate(id);
+        await gate.WaitAsync();
+        try
+        {
+            return SetCamouflageCore(id, name, artist, noteDesigner, hideNoteDesigner, unlockScore);
+        }
+        finally
+        {
+            gate.Release();
+        }
+    }
+
+    private FancyToolResult SetCamouflageCore(int id, string? name, string? artist,
+        string? noteDesigner, bool hideNoteDesigner, double unlockScore)
+    {
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
         if (string.IsNullOrWhiteSpace(name) || string.IsNullOrWhiteSpace(artist))
             return new FancyToolResult(false, "invalid-text");
 
@@ -701,6 +727,22 @@ public async Task<FancyToolResult> SetCamouflageJacket([FromForm] int id, IFormF
     {
         if (id <= 0) return new FancyToolResult(false, "invalid-id");
 
+        var gate = GetFileGate(id);
+        await gate.WaitAsync();
+        try
+        {
+            return await SetCamouflageJacketCore(id, file);
+        }
+        finally
+        {
+            gate.Release();
+        }
+    }
+
+    private async Task<FancyToolResult> SetCamouflageJacketCore(int id, IFormFile file)
+    {
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+
         var ext = Path.GetExtension(file.FileName).ToLowerInvariant();
         if (ext is not (".jpg" or ".jpeg" or ".png")) return new FancyToolResult(false, "invalid-image");
 
@@ -750,10 +792,12 @@ public async Task<FancyToolResult> SetCamouflageJacket([FromForm] int id, IFormF
     }
 
     [HttpPost]
-    public FancyToolResult DeleteCamouflage(int id)
+    public async Task<FancyToolResult> DeleteCamouflage(int id)
     {
-        var gate = GetIntroFileGate(id);
-        gate.Wait();
+        if (id <= 0) return new FancyToolResult(false, "invalid-id");
+
+        var gate = GetFileGate(id);
+        await gate.WaitAsync();
         try
         {
             return DeleteCamouflageCore(id);