LanMountainDesktop/.trae/documents/launcher_comprehensive_improvement_plan.md

LanMountainDesktop Launcher 全面改进计划

概述

本计划旨在将 LanMountainDesktop 的 Launcher 改进为符合原子化架构的独立启动器，参考 ClassIsland 的极简设计，同时保留阑山桌面的特色功能。

目标

1. P0 (必须完成): 重写 Launcher 为极简模式，移除与主程序的耦合
2. P1 (应该完成): 将 OOBE、Splash、更新、插件管理迁移到主程序
3. P2 (推荐完成): 实现 Launcher 自更新机制
4. P3 (可选优化): 性能优化和代码清理
5. P4 (长期规划): 增强功能和可扩展性

当前问题

1. Launcher 是 Avalonia 应用，启动慢、内存占用高
2. Launcher 引用了 PluginSdk，与主程序有耦合
3. 主程序引用了 Launcher，构建关系复杂
4. Launcher 职责过多（OOBE + Splash + 更新 + 插件 + 启动）
5. 缺少 Launcher 自更新机制
6. GitHub Actions 工作流需要适配新的目录结构

改进后架构

安装根目录/
├── LanMountainDesktop.exe              ← 启动器（唯一入口，极简，~100行代码）
├── app-1.0.0/                          ← 版本目录
│   ├── .current                        ← 当前版本标记
│   ├── LanMountainDesktop.exe          ← 主程序
│   └── ... (所有依赖)
└── .launcher/                          ← 启动器数据（可选）
    └── snapshots/                      ← 版本快照

详细实施步骤

P0: 基础架构重构

1. 重写 Launcher 为极简模式

文件: LanMountainDesktop.Launcher/Program.cs

目标:

• 代码量控制在 100 行以内
• 零外部依赖（不使用 Avalonia）
• 只负责：版本选择、启动主程序、清理旧版本

完整实现代码:

// LanMountainDesktop.Launcher/Program.cs
using System.Diagnostics;
using System.Runtime.InteropServices;

namespace LanMountainDesktop.Launcher;

internal static class Program
{
    private const string HostExecutableName = "LanMountainDesktop.exe";
    private const string HostExecutableNameLinux = "LanMountainDesktop";
    
    [STAThread]
    private static int Main(string[] args)
    {
        var rootDir = GetRootDirectory();
        
        // 1. 查找最佳版本
        var installation = FindBestVersion(rootDir);
        if (installation == null)
        {
            ShowError("找不到有效的 LanMountainDesktop 版本，请重新安装。");
            return 1;
        }
        
        // 2. 清理旧版本（异步，不阻塞）
        _ = Task.Run(() => CleanupOldVersions(rootDir));
        
        // 3. 启动主程序
        return LaunchHost(installation, args);
    }
    
    private static string GetRootDirectory()
    {
        return Path.GetFullPath(
            Path.GetDirectoryName(Environment.ProcessPath) ?? "");
    }
    
    private static string? FindBestVersion(string rootDir)
    {
        var exeName = OperatingSystem.IsWindows() 
            ? HostExecutableName 
            : HostExecutableNameLinux;
            
        return Directory.GetDirectories(rootDir)
            .Where(x => IsValidVersionDirectory(x, exeName))
            .OrderBy(x => File.Exists(Path.Combine(x, ".current")) ? 0 : 1)
            .ThenByDescending(x => ParseVersion(Path.GetFileName(x)))
            .FirstOrDefault();
    }
    
    private static bool IsValidVersionDirectory(string path, string exeName)
    {
        var dirName = Path.GetFileName(path);
        return dirName.StartsWith("app-") &&
               !File.Exists(Path.Combine(path, ".destroy")) &&
               !File.Exists(Path.Combine(path, ".partial")) &&
               File.Exists(Path.Combine(path, exeName));
    }
    
    private static Version ParseVersion(string dirName)
    {
        // app-1.0.0 or app-1.0.0-123
        var parts = dirName.Split('-');
        if (parts.Length >= 2 && Version.TryParse(parts[1], out var v))
            return v;
        return new Version(0, 0);
    }
    
    private static void CleanupOldVersions(string rootDir)
    {
        try
        {
            var oldVersions = Directory.GetDirectories(rootDir)
                .Where(x => File.Exists(Path.Combine(x, ".destroy")));
            
            foreach (var dir in oldVersions)
            {
                try { Directory.Delete(dir, recursive: true); } catch { }
            }
        }
        catch { /* 忽略清理失败 */ }
    }
    
    private static int LaunchHost(string installation, string[] args)
    {
        var exeName = OperatingSystem.IsWindows() 
            ? HostExecutableName 
            : HostExecutableNameLinux;
        var exePath = Path.Combine(installation, exeName);
        
        // Linux/macOS: 确保可执行权限
        if (!OperatingSystem.IsWindows())
        {
            EnsureExecutable(exePath);
        }
        
        var startInfo = new ProcessStartInfo
        {
            FileName = exePath,
            WorkingDirectory = Path.GetDirectoryName(installation),
            UseShellExecute = true
        };
        
        foreach (var arg in args)
            startInfo.ArgumentList.Add(arg);
        
        // 传递环境变量
        startInfo.EnvironmentVariables["LMD_PACKAGE_ROOT"] = 
            Path.GetDirectoryName(installation);
        startInfo.EnvironmentVariables["LMD_VERSION"] = 
            Path.GetFileName(installation).Replace("app-", "");
        
        try
        {
            Process.Start(startInfo);
            return 0;
        }
        catch (Exception ex)
        {
            ShowError($"启动失败: {ex.Message}");
            return 1;
        }
    }
    
    private static void EnsureExecutable(string path)
    {
        try
        {
            Process.Start(new ProcessStartInfo
            {
                FileName = "chmod",
                Arguments = $"+x \"{path}\"",
                CreateNoWindow = true
            })?.WaitForExit();
        }
        catch { }
    }
    
    private static void ShowError(string message)
    {
        if (OperatingSystem.IsWindows())
        {
            // Win32 MessageBox
            try
            {
                MessageBox(IntPtr.Zero, message, "LanMountainDesktop", 0x10);
            }
            catch 
            { 
                Console.Error.WriteLine(message);
            }
        }
        else
        {
            Console.Error.WriteLine(message);
        }
    }
    
    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    private static extern int MessageBox(IntPtr hWnd, string text, string caption, uint type);
}

2. 修改 Launcher 项目文件

文件: LanMountainDesktop.Launcher/LanMountainDesktop.Launcher.csproj

完整内容:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <Version>1.0.0</Version>
    <ApplicationIcon>Assets\logo_nightly.ico</ApplicationIcon>
  </PropertyGroup>
  
  <!-- 图标资源 -->
  <ItemGroup>
    <Content Include="..\LanMountainDesktop\Assets\logo_nightly.ico" Link="Assets\logo_nightly.ico">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </Content>
  </ItemGroup>
</Project>

3. 移除主程序对 Launcher 的引用

文件: LanMountainDesktop/LanMountainDesktop.csproj

修改: 删除以下行

<!-- 删除这一行 -->
<ProjectReference Include="..\LanMountainDesktop.Launcher\LanMountainDesktop.Launcher.csproj" ReferenceOutputAssembly="false" />

4. 修改主程序支持新架构

文件: LanMountainDesktop/Program.cs

修改: 添加环境变量读取

// 在 Program.cs 中添加
internal static class LaunchContext
{
    public static string? PackageRoot => 
        Environment.GetEnvironmentVariable("LMD_PACKAGE_ROOT");
    public static string? Version => 
        Environment.GetEnvironmentVariable("LMD_VERSION");
    public static bool IsLaunchedByLauncher => 
        !string.IsNullOrEmpty(PackageRoot);
}

---

P1: 功能迁移

5. 将 OOBE 迁移到主程序

新建文件: LanMountainDesktop/Services/Oobe/OobeService.cs

using LanMountainDesktop.Models;
using LanMountainDesktop.Services.Settings;

namespace LanMountainDesktop.Services.Oobe;

public class OobeService
{
    private readonly string _oobeStatePath;
    
    public OobeService()
    {
        var appData = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
        _oobeStatePath = Path.Combine(appData, "LanMountainDesktop", ".oobe_completed");
    }
    
    public bool IsFirstRun()
    {
        return !File.Exists(_oobeStatePath);
    }
    
    public void MarkCompleted()
    {
        var dir = Path.GetDirectoryName(_oobeStatePath);
        if (!Directory.Exists(dir))
            Directory.CreateDirectory(dir);
        File.WriteAllText(_oobeStatePath, DateTime.UtcNow.ToString("O"));
    }
}

新建文件: LanMountainDesktop/Views/Oobe/OobeWindow.axaml

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        x:Class="LanMountainDesktop.Views.Oobe.OobeWindow"
        Title="欢迎使用阑山桌面"
        Width="800"
        Height="600"
        WindowStartupLocation="CenterScreen">
  <Grid>
    <!-- OOBE 界面内容 -->
    <TextBlock Text="欢迎使用阑山桌面" FontSize="24" HorizontalAlignment="Center" Margin="0,50,0,0"/>
    <Button Content="开始使用" HorizontalAlignment="Center" VerticalAlignment="Bottom" Margin="0,0,0,50" Click="OnStartClick"/>
  </Grid>
</Window>

修改文件: LanMountainDesktop/App.axaml.cs

// 在 OnFrameworkInitializationCompleted 中添加
private async Task InitializeOobeAsync()
{
    var oobeService = new OobeService();
    if (oobeService.IsFirstRun())
    {
        var oobeWindow = new Views.Oobe.OobeWindow();
        await oobeWindow.ShowDialog();
        oobeService.MarkCompleted();
    }
}

6. 将 Splash 迁移到主程序

新建文件: LanMountainDesktop/Views/Splash/SplashWindow.axaml

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        x:Class="LanMountainDesktop.Views.Splash.SplashWindow"
        Title="阑山桌面"
        Width="400"
        Height="300"
        WindowStartupLocation="CenterScreen"
        ShowInTaskbar="False"
        SystemDecorations="None">
  <Grid Background="{DynamicResource SystemAccentColor}">
    <StackPanel VerticalAlignment="Center" HorizontalAlignment="Center">
      <Image Source="/Assets/logo_nightly.png" Width="100" Height="100"/>
      <TextBlock Text="阑山桌面" FontSize="20" Margin="0,20,0,0" HorizontalAlignment="Center"/>
      <TextBlock x:Name="StatusText" Text="正在启动..." Margin="0,10,0,0" HorizontalAlignment="Center"/>
    </StackPanel>
  </Grid>
</Window>

修改文件: LanMountainDesktop/App.axaml.cs

// 在初始化时显示 Splash
private SplashWindow? _splashWindow;

private void ShowSplash()
{
    _splashWindow = new SplashWindow();
    _splashWindow.Show();
}

private void CloseSplash()
{
    _splashWindow?.Close();
    _splashWindow = null;
}

7. 将更新逻辑迁移到主程序

新建目录: LanMountainDesktop/Services/Update/

新建文件: LanMountainDesktop/Services/Update/UpdateService.cs

using System.Net.Http.Json;
using LanMountainDesktop.Models;

namespace LanMountainDesktop.Services.Update;

public class UpdateService
{
    private readonly HttpClient _httpClient;
    private readonly string _currentVersion;
    
    public UpdateService()
    {
        _httpClient = new HttpClient();
        _httpClient.DefaultRequestHeaders.Add("User-Agent", "LanMountainDesktop");
        _currentVersion = GetType().Assembly.GetName().Version?.ToString() ?? "1.0.0";
    }
    
    public async Task<UpdateCheckResult> CheckForUpdateAsync(UpdateChannel channel)
    {
        // 调用 GitHub Release API
        var releases = await _httpClient.GetFromJsonAsync<List<GitHubRelease>>(
            "https://api.github.com/repos/ClassIsland/LanMountainDesktop/releases");
        
        var latest = channel == UpdateChannel.Stable
            ? releases?.FirstOrDefault(r => !r.Prerelease)
            : releases?.FirstOrDefault();
            
        if (latest == null)
            return new UpdateCheckResult { HasUpdate = false };
            
        var latestVersion = latest.TagName.TrimStart('v');
        var hasUpdate = new Version(latestVersion) > new Version(_currentVersion);
        
        return new UpdateCheckResult
        {
            HasUpdate = hasUpdate,
            Version = latestVersion,
            DownloadUrl = latest.Assets.FirstOrDefault()?.BrowserDownloadUrl
        };
    }
}

public class UpdateCheckResult
{
    public bool HasUpdate { get; set; }
    public string? Version { get; set; }
    public string? DownloadUrl { get; set; }
}

public enum UpdateChannel { Stable, Preview }

public class GitHubRelease
{
    public string TagName { get; set; } = "";
    public bool Prerelease { get; set; }
    public List<GitHubAsset> Assets { get; set; } = new();
}

public class GitHubAsset
{
    public string BrowserDownloadUrl { get; set; } = "";
}

8. 将插件管理迁移到主程序

新建目录: LanMountainDesktop/Services/Plugins/

新建文件: LanMountainDesktop/Services/Plugins/PluginUpdateService.cs

namespace LanMountainDesktop.Services.Plugins;

public class PluginUpdateService
{
    private readonly string _pluginsDirectory;
    
    public PluginUpdateService()
    {
        var appData = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
        _pluginsDirectory = Path.Combine(appData, "LanMountainDesktop", "plugins");
    }
    
    public async Task CheckAndUpdatePluginsAsync()
    {
        // 检查插件更新
        // 下载并安装更新
    }
}

---

P2: 自更新机制

9. 实现 Launcher 自更新

修改文件: LanMountainDesktop.Launcher/Program.cs

// 在 Main 方法开头添加自更新检查
private static void CheckForLauncherUpdate()
{
    var rootDir = GetRootDirectory();
    var updatePath = Path.Combine(rootDir, "LanMountainDesktop.Launcher.Update.exe");
    
    if (File.Exists(updatePath))
    {
        // 有新版本 Launcher，替换自身
        try
        {
            var currentPath = Environment.ProcessPath;
            var backupPath = currentPath + ".old";
            
            // 重命名当前版本
            if (File.Exists(backupPath))
                File.Delete(backupPath);
            File.Move(currentPath!, backupPath);
            
            // 移动新版本
            File.Move(updatePath, currentPath!);
            
            // 删除备份
            File.Delete(backupPath);
            
            // 重启自己
            Process.Start(new ProcessStartInfo
            {
                FileName = currentPath,
                UseShellExecute = true
            });
            Environment.Exit(0);
        }
        catch (Exception ex)
        {
            // 回滚
            Console.Error.WriteLine($"Launcher 更新失败: {ex.Message}");
        }
    }
}

10. 主程序支持更新 Launcher

新建文件: LanMountainDesktop/Services/Update/LauncherUpdateService.cs

namespace LanMountainDesktop.Services.Update;

public class LauncherUpdateService
{
    private readonly HttpClient _httpClient;
    
    public LauncherUpdateService()
    {
        _httpClient = new HttpClient();
    }
    
    public async Task<bool> UpdateLauncherAsync(string downloadUrl)
    {
        var rootDir = LaunchContext.PackageRoot 
            ?? Path.GetDirectoryName(Environment.ProcessPath)!;
        var updatePath = Path.Combine(rootDir, "LanMountainDesktop.Launcher.Update.exe");
        
        // 下载新版本
        var response = await _httpClient.GetAsync(downloadUrl);
        await using var fs = File.Create(updatePath);
        await response.Content.CopyToAsync(fs);
        
        return true;
    }
    
    public void RestartWithNewLauncher()
    {
        var launcherPath = Path.Combine(
            LaunchContext.PackageRoot ?? "",
            "LanMountainDesktop.exe");
            
        Process.Start(new ProcessStartInfo
        {
            FileName = launcherPath,
            UseShellExecute = true
        });
        
        // 退出主程序，让 Launcher 接管
        Environment.Exit(0);
    }
}

---

P3: 清理旧代码

11. 删除文件清单

删除以下文件/目录:

LanMountainDesktop.Launcher/
├── App.axaml                          ← 删除
├── App.axaml.cs                       ← 删除
├── Views/                             ← 删除整个目录
│   ├── OobeWindow.axaml
│   ├── OobeWindow.axaml.cs
│   ├── SplashWindow.axaml
│   └── SplashWindow.axaml.cs
├── Services/                          ← 删除大部分
│   ├── LauncherFlowCoordinator.cs     ← 删除
│   ├── OobeStateService.cs            ← 删除
│   ├── UpdateCheckService.cs          ← 删除
│   ├── UpdateEngineService.cs         ← 删除
│   ├── PluginInstallerService.cs      ← 删除
│   └── PluginUpgradeQueueService.cs   ← 删除
└── Models/                            ← 删除（如不再需要）

---

P4: GitHub Actions 工作流修改

12. 修改 release.yml

关键修改点:

1. Launcher 单独编译:

- name: Publish Launcher
  run: |
    dotnet publish LanMountainDesktop.Launcher/LanMountainDesktop.Launcher.csproj `
      -c Release `
      -o ./publish/launcher-win-x64 `
      --self-contained `
      -r win-x64 `
      -p:PublishSingleFile=false `
      -p:PublishTrimmed=false `
      -p:DebugType=none

2. 目录结构调整:

- name: Restructure for Launcher
  run: |
    $version = "${{ needs.prepare.outputs.version }}"
    $publishDir = "publish/windows-x64"
    $launcherDir = "publish/launcher-win-x64"
    $appDir = "app-$version"
    
    # 创建新结构
    $newStructure = "publish-launcher/windows-x64"
    New-Item -ItemType Directory -Path $newStructure -Force
    
    # 移动主程序到 app-{version}/
    $appPath = Join-Path $newStructure $appDir
    Move-Item -Path $publishDir -Destination $appPath -Force
    
    # 复制 Launcher 到根目录
    Copy-Item -Path "$launcherDir\*" -Destination $newStructure -Recurse -Force
    
    # 创建 .current 标记
    New-Item -ItemType File -Path (Join-Path $appPath ".current") -Force

3. Linux/macOS 同样调整:

• Linux: 修改 DEB 打包流程
• macOS: 修改 DMG 打包流程

13. 修改 build.yml

修改: 移除 Launcher 相关构建步骤，因为 Launcher 现在完全独立

---

P5: 图标资源处理

14. Launcher 图标配置

方案: 使用链接方式引用主程序图标

文件: LanMountainDesktop.Launcher/LanMountainDesktop.Launcher.csproj

<ItemGroup>
  <!-- 链接主程序的图标 -->
  <Content Include="..\LanMountainDesktop\Assets\logo_nightly.ico" Link="Assets\logo_nightly.ico">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

15. 安装程序配置

文件: LanMountainDesktop/installer/LanMountainDesktop.iss (Inno Setup)

关键配置:

[Setup]
AppName=阑山桌面
AppVersion={#MyAppVersion}
DefaultDirName={autopf}\LanMountainDesktop
OutputBaseFilename=LanMountainDesktop-Setup-{#MyAppVersion}-x64
SetupIconFile=..\Assets\logo_nightly.ico
UninstallDisplayIcon={app}\LanMountainDesktop.exe

[Files]
; Launcher
Source: "..\..\publish\windows-x64\LanMountainDesktop.exe"; DestDir: "{app}"; Flags: ignoreversion
; 主程序版本目录
Source: "..\..\publish\windows-x64\app-{#MyAppVersion}\*"; DestDir: "{app}\app-{#MyAppVersion}"; Flags: ignoreversion recursesubdirs

[Icons]
; 桌面快捷方式
Name: "{autodesktop}\阑山桌面"; Filename: "{app}\LanMountainDesktop.exe"; IconFilename: "{app}\LanMountainDesktop.exe"
; 开始菜单
Name: "{group}\阑山桌面"; Filename: "{app}\LanMountainDesktop.exe"; IconFilename: "{app}\LanMountainDesktop.exe"

---

文件变更清单

修改文件

1. LanMountainDesktop.Launcher/Program.cs - 完全重写
2. LanMountainDesktop.Launcher/LanMountainDesktop.Launcher.csproj - 简化依赖
3. LanMountainDesktop/LanMountainDesktop.csproj - 移除 Launcher 引用
4. LanMountainDesktop/Program.cs - 添加 LaunchContext
5. LanMountainDesktop/App.axaml.cs - 添加 OOBE/Splash/更新入口
6. .github/workflows/release.yml - 调整打包流程
7. .github/workflows/build.yml - 适配新构建流程

新增文件

1. LanMountainDesktop/Services/Oobe/OobeService.cs
2. LanMountainDesktop/Views/Oobe/OobeWindow.axaml
3. LanMountainDesktop/Views/Oobe/OobeWindow.axaml.cs
4. LanMountainDesktop/Views/Splash/SplashWindow.axaml
5. LanMountainDesktop/Views/Splash/SplashWindow.axaml.cs
6. LanMountainDesktop/Services/Update/UpdateService.cs
7. LanMountainDesktop/Services/Update/LauncherUpdateService.cs
8. LanMountainDesktop/Services/Plugins/PluginUpdateService.cs

删除文件

1. LanMountainDesktop.Launcher/App.axaml
2. LanMountainDesktop.Launcher/App.axaml.cs
3. LanMountainDesktop.Launcher/Views/ 目录
4. LanMountainDesktop.Launcher/Services/LauncherFlowCoordinator.cs
5. LanMountainDesktop.Launcher/Services/OobeStateService.cs
6. LanMountainDesktop.Launcher/Services/UpdateCheckService.cs
7. LanMountainDesktop.Launcher/Services/UpdateEngineService.cs
8. LanMountainDesktop.Launcher/Services/PluginInstallerService.cs
9. LanMountainDesktop.Launcher/Services/PluginUpgradeQueueService.cs

---

风险与回滚方案

风险

1. 启动失败: 新 Launcher 可能有 bug 导致无法启动
2. 更新中断: 更新逻辑迁移可能导致更新失败
3. 图标丢失: 图标配置错误导致快捷方式无图标

回滚方案

1. 保留原 Launcher 代码分支
2. 准备紧急修复版本
3. 用户可手动下载完整安装包恢复

---

验证清单

• Launcher 能正常启动主程序
• 版本选择逻辑正确
• 旧版本清理正常
• OOBE 流程正常
• Splash 显示正常
• 更新检查正常
• 插件安装正常
• GitHub Actions 打包成功
• 安装程序图标正常
• 快捷方式图标正常

---

实施顺序建议

第一阶段（立即实施）

1. 重写 Launcher Program.cs
2. 修改 Launcher.csproj
3. 移除主程序对 Launcher 的引用
4. 测试基本启动功能

第二阶段（功能迁移）

1. 迁移 OOBE 到主程序
2. 迁移 Splash 到主程序
3. 迁移更新逻辑到主程序
4. 迁移插件管理到主程序

第三阶段（CI/CD）

1. 修改 release.yml
2. 修改 build.yml
3. 测试打包流程
4. 验证安装程序

第四阶段（优化）

1. 实现 Launcher 自更新
2. 性能优化
3. 清理旧代码