Linux 原生支持（Photino + 跨平台音视频/CLI/打包）

.gitmodules

@@ -9,7 +9,7 @@
 	url = git@github.com:clansty/SonicAudioTools.git
 [submodule "XV2-Tools"]
 	path = XV2-Tools
-	url = git@github.com:clansty/XV2-Tools.git
+	url = git@github.com:MuNET-OSS/XV2-Tools.git
 [submodule "AquaMai"]
 	path = AquaMai
 	url = git@github.com:MewoLab/AquaMai.git

Directory.Build.props

@@ -1,9 +1,10 @@
 <Project>
-  <PropertyGroup Condition="'$(MSBuildProjectName)' == 'MuConvert'">
+  <!-- 仅在 Windows 上构建时，让随 MaiChartManager 一起发布的 MuConvert 为自包含 win-x64，
+       使打包进 Windows 版的 MuConvert.exe 可独立运行（不依赖单独的 dotnet 运行时）。
+       Linux 原生构建则不强制，MuConvert 随主项目按 linux-x64 框架依赖构建。
+       （原先无条件强制 win-x64 是为了在 Linux 上用 Wine 测 Windows 版，已不需要。） -->
+  <PropertyGroup Condition="'$(MSBuildProjectName)' == 'MuConvert' and $([MSBuild]::IsOSPlatform('Windows'))">
     <RuntimeIdentifier>win-x64</RuntimeIdentifier>
     <SelfContained>true</SelfContained>
   </PropertyGroup>
-  <PropertyGroup>
-    <EnableWindowsTargeting>true</EnableWindowsTargeting>
-  </PropertyGroup>
 </Project>

MaiChartManager.CLI/AssemblyInfo.cs

@@ -7,5 +7,7 @@
 [assembly: AssemblyProduct("MaiChartManager CLI")]
 [assembly: AssemblyTitle("MaiChartManager CLI")]
 [assembly: AssemblyVersion(AppMain.Version)]
+#if WINDOWS
 [assembly: System.Runtime.Versioning.TargetPlatformAttribute("Windows10.0.17763.0")]
-[assembly: System.Runtime.Versioning.SupportedOSPlatformAttribute("Windows10.0.17134.0")]
+[assembly: System.Runtime.Versioning.SupportedOSPlatformAttribute("Windows10.0.17134.0")]
+#endif

MaiChartManager.CLI/Commands/DebugCommand.cs

@@ -6,6 +6,7 @@ public class DebugCommand : Command
 {
     public override int Execute(CommandContext context, CancellationToken cancellationToken)
     {
+#if WINDOWS
         // WebView2 (COM) 要求 STA 线程；CLI 的 async 入口运行在 MTA 上下文中，
         // 而 Program.Main 上的 [STAThread] 作为普通方法调用时不生效，需手动建 STA 线程
         Exception? exception = null;
@@ -30,5 +31,10 @@ public override int Execute(CommandContext context, CancellationToken cancellati
             throw exception;
         }
         return 0;
+#else
+        // Linux：直接启动 Photino 主程序（无 COM/STA 限制），控制台可见日志
+        MaiChartManager.LinuxProgram.Main([]);
+        return 0;
+#endif
     }
 }

MaiChartManager.CLI/MaiChartManager.CLI.csproj

@@ -1,26 +1,38 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
+        <IsLinuxBuild Condition="$(Configuration.StartsWith('Linux'))">true</IsLinuxBuild>
         <OutputType>Exe</OutputType>
-        <TargetFramework>net10.0-windows10.0.17763.0</TargetFramework>
         <ImplicitUsings>enable</ImplicitUsings>
         <Nullable>enable</Nullable>
-        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
-        <SelfContained>true</SelfContained>
         <ValidateExecutableReferencesMatchSelfContained>False</ValidateExecutableReferencesMatchSelfContained>
         <EnableUnsafeBinaryFormatterSerialization>true</EnableUnsafeBinaryFormatterSerialization>
         <CETCompat>false</CETCompat>
         <PublishTrimmed>False</PublishTrimmed>
         <PublishAot>False</PublishAot>
         <PublishReadyToRun>true</PublishReadyToRun>
-        <PublishDir>..\Packaging\Pack</PublishDir>
-        <Configurations>Debug;Release;Crack</Configurations>
+        <Configurations>Debug;Release;Crack;LinuxDebug;LinuxRelease</Configurations>
         <Platforms>AnyCPU</Platforms>
-        <CETCompat>false</CETCompat>
-        <ApplicationIcon>icon.ico</ApplicationIcon>
         <GenerateAssemblyInfo>False</GenerateAssemblyInfo>
     </PropertyGroup>
 
+    <!-- Windows：net*-windows + 自包含 win-x64（与原行为一致） -->
+    <PropertyGroup Condition="'$(IsLinuxBuild)' != 'true'">
+        <TargetFramework>net10.0-windows10.0.17763.0</TargetFramework>
+        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
+        <SelfContained>true</SelfContained>
+        <PublishDir>..\Packaging\Pack</PublishDir>
+        <ApplicationIcon>icon.ico</ApplicationIcon>
+        <DefineConstants>$(DefineConstants);WINDOWS</DefineConstants>
+    </PropertyGroup>
+
+    <!-- Linux：net10.0 + 框架依赖 linux-x64（依赖系统 aspnet-runtime） -->
+    <PropertyGroup Condition="'$(IsLinuxBuild)' == 'true'">
+        <TargetFramework>net10.0</TargetFramework>
+        <RuntimeIdentifier>linux-x64</RuntimeIdentifier>
+        <SelfContained>false</SelfContained>
+    </PropertyGroup>
+
     <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Crack|x64' ">
         <DefineConstants>CRACK</DefineConstants>
         <Optimize>true</Optimize>

MaiChartManager.CLI/Program.cs

@@ -21,8 +21,15 @@
 #endif
     });
 
+#if WINDOWS
     AppMain.InitConfiguration(true);
     await IapManager.Init();
+#else
+    // Linux：复用 LinuxProgram 的无头初始化（加载配置 + 配置系统 ffmpeg），
+    // 不走 Windows-only 的 AppMain/IapManager。
+    LinuxProgram.InitConfiguration();
+    LinuxProgram.ConfigureFfmpeg();
+#endif
 
     var app = new CommandApp();
 

MaiChartManager/AppMain.cs

@@ -8,7 +8,7 @@
 using Microsoft.Web.WebView2.Core;
 using Microsoft.AspNetCore.Hosting.Server;
 using Microsoft.AspNetCore.Hosting.Server.Features;
-using Xabe.FFmpeg;
+using FFMpegCore;
 
 namespace MaiChartManager;
 
@@ -75,7 +75,13 @@ public void Run()
             ApplicationConfiguration.Initialize();
             SynchronizationContext.SetSynchronizationContext(new WindowsFormsSynchronizationContext());
             UiContext = SynchronizationContext.Current;
-            FFmpeg.SetExecutablesPath(StaticSettings.exeDir);
+            // FFMpegCore：Windows 内置 ffmpeg.exe/ffprobe.exe 在 exeDir，临时文件用 tempPath。
+            // FFMpegCore 会按 OS 自动给可执行名补 .exe 后缀。
+            GlobalFFOptions.Configure(o =>
+            {
+                o.BinaryFolder = StaticSettings.exeDir;
+                o.TemporaryFilesFolder = StaticSettings.tempPath;
+            });
             VideoConvert.CheckHardwareAcceleration();
 
             Directory.CreateDirectory(StaticSettings.appData);

MaiChartManager/AppMain.g.cs

@@ -3,5 +3,5 @@ namespace MaiChartManager;
 
     public partial class AppMain
     {
-        public const string Version = "26.2";
+        public const string Version = "26.3";
     }

MaiChartManager/Config.cs

@@ -24,12 +24,17 @@ public class Config
     public MovieCodec MovieCodec { get; set; } = MovieCodec.ForceVP9;
     public bool Yuv420p { get; set; } = true;
     public bool NoScale { get; set; } = false;
+    // 强制视频走软件编码：硬件 H264 产物若游戏不认，改 config.json 设为 true 即可一键退回软件。
+    public bool ForceSoftwareVideo { get; set; } = false;
     public bool IgnoreLevel { get; set; } = false;
     public bool DisableBga { get; set; } = false;
     public bool UseLegacyMaiLib { get; set; } = false;
     public bool ConvertJacketToAssetBundle { get; set; } = true;
     public int UiZoom { get; set; } = 0;
 
+    // 记住上次文件夹选择对话框选中的目录，下次打开时从这里开始（而不是每次都回到 Documents）。
+    public string? LastDialogFolder { get; set; } = null;
+
     public void Save()
     {
         var json = JsonSerializer.Serialize(this);

MaiChartManager/Controllers/App/AppLicenseController.cs

@@ -1,4 +1,6 @@
-using Windows.Services.Store;
+#if WINDOWS
+using Windows.Services.Store;
+#endif
 using Microsoft.AspNetCore.Mvc;
 
 namespace MaiChartManager.Controllers.App;
@@ -7,6 +9,7 @@ namespace MaiChartManager.Controllers.App;
 [Route("MaiChartManagerServlet/[action]Api")]
 public class AppLicenseController : Controller
 {
+#if WINDOWS
     public record RequestPurchaseResult(string? ErrorMessage, StorePurchaseStatus Status);
 
     [HttpPost]
@@ -32,4 +35,22 @@ public async Task<bool> VerifyOfflineKey([FromBody] string key)
         IapManager.SetOfflineLicenseActive();
         return true;
     }
-}
+#else
+    // Linux：始终已授权——不支持商店 / IAP
+    public record RequestPurchaseResult(string? ErrorMessage, int Status);
+
+    [HttpPost]
+    public Task<RequestPurchaseResult> RequestPurchase()
+    {
+        // StorePurchaseStatus.Succeeded = 0
+        return Task.FromResult(new RequestPurchaseResult(null, 0));
+    }
+
+    [HttpPost]
+    public Task<bool> VerifyOfflineKey([FromBody] string key)
+    {
+        // Linux 不做离线密钥验证；始终视为已授权
+        return Task.FromResult(true);
+    }
+#endif
+}

MaiChartManager/Controllers/App/AppVersionController.cs

@@ -1,4 +1,4 @@
-using MaiChartManager.Utils;
+using MaiChartManager.Utils;
 using Microsoft.AspNetCore.Mvc;
 
 namespace MaiChartManager.Controllers.App;
@@ -7,11 +7,29 @@ namespace MaiChartManager.Controllers.App;
 [Route("MaiChartManagerServlet/[action]Api")]
 public class AppVersionController(StaticSettings settings, ILogger<AppVersionController> logger) : ControllerBase
 {
+#if WINDOWS
     public record AppVersionResult(string Version, int GameVersion, IapManager.LicenseStatus License, VideoConvert.HardwareAccelerationStatus HardwareAcceleration, string H264Encoder, string Locale);
 
     [HttpGet]
     public AppVersionResult GetAppVersion()
     {
         return new AppVersionResult(Application.ProductVersion, settings.gameVersion, IapManager.License, VideoConvert.HardwareAcceleration, VideoConvert.H264Encoder, StaticSettings.CurrentLocale);
     }
-}
+#else
+    public enum LicenseStatus { Pending, Active, Inactive }
+    public record AppVersionResult(string Version, int GameVersion, LicenseStatus License, VideoConvert.HardwareAccelerationStatus HardwareAcceleration, string H264Encoder, string Locale);
+
+    [HttpGet]
+    public AppVersionResult GetAppVersion()
+    {
+        // 与 Windows 的 Application.ProductVersion 语义一致：取程序集 InformationalVersion
+        //（由 PKGBUILD 在 publish 时通过 -p:InformationalVersion 注入 git 派生的版本号），
+        // 去掉 SourceLink 可能附带的 "+<commit>" 后缀。
+        var asm = System.Reflection.Assembly.GetExecutingAssembly();
+        var info = (System.Reflection.AssemblyInformationalVersionAttribute?)System.Attribute
+            .GetCustomAttribute(asm, typeof(System.Reflection.AssemblyInformationalVersionAttribute));
+        var version = info?.InformationalVersion?.Split('+')[0] ?? "linux";
+        return new AppVersionResult(version, settings.gameVersion, LicenseStatus.Active, VideoConvert.HardwareAcceleration, VideoConvert.H264Encoder, StaticSettings.CurrentLocale);
+    }
+#endif
+}

MaiChartManager/Controllers/App/LocaleController.cs

@@ -6,7 +6,7 @@ namespace MaiChartManager.Controllers.App;
 
 [ApiController]
 [Route("MaiChartManagerServlet/[action]Api")]
-public class LocaleController(StaticSettings settings, ILogger<LocaleController> logger) : ControllerBase
+public class LocaleController(StaticSettings settings, ILogger<LocaleController> logger, MaiChartManager.Platform.IAppShell appShell) : ControllerBase
 {
     [HttpGet]
     public string GetCurrentLocale()
@@ -17,6 +17,31 @@ public string GetCurrentLocale()
     [HttpPost]
     public void SetLocale([FromBody] string locale)
     {
-        AppMain.SetLocale(locale);
+        if (locale != "zh" && locale != "zh-TW" && locale != "en")
+        {
+            throw new ArgumentException("Invalid locale. Must be 'zh', 'zh-TW', or 'en'");
+        }
+
+        StaticSettings.CurrentLocale = locale;
+        StaticSettings.Config.Locale = locale;
+
+        // 设置 Locale 资源管理器的 Culture（这会影响所有线程）
+        var culture = locale switch
+        {
+            "zh" => new CultureInfo("zh-CN"),
+            "zh-TW" => new CultureInfo("zh-TW"),
+            _ => new CultureInfo("en-US"),
+        };
+        Locale.Culture = culture;
+        CultureInfo.CurrentCulture = culture;
+        CultureInfo.CurrentUICulture = culture;
+
+        // 给外部依赖库设置Locale
+        MuConvert.utils.Utils.SetLocale(new CultureInfo(locale));
+
+        StaticSettings.Config.Save();
+
+        // 刷新原生 UI（Windows: 窗口/托盘；Linux: no-op）
+        appShell.ReloadLocale(locale);
     }
 }