using System; using System.Collections.Generic; using System.IO; using System.Linq; using System.Text.Json; using System.Threading; using System.Threading.Tasks; using GC.Download; using GC.Models; using GC.Services; using GC.UI.Server; using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; namespace GC.UI.Server; /// /// GC-UI 后端(本地 HTTP 服务:模型扫描 / 下载 / 更新 / 设置 / 模型窗口宿主)。 /// /// 两种跑法共用同一份代码: /// · 独立进程:GC.UI.Server 可执行文件(开发调试 / 旧包兼容); /// · 进程内:启动器直接调用 ,把后端跑在自己的进程里 —— /// 发布包因此只需要一个 exe,不必再复制一份完整的 .NET 运行时。 /// public static class BackendServer { /// 按命令行 / GC_UI_PORT 解析端口并构建(未启动)的后端。 public static WebApplication StartFromCommandLine(string[] args) => Start(args, ResolvePort(args)); /// /// 构建后端。返回的 尚未启动: /// 独立进程直接 Run(),启动器用 StartAsync() 之后继续拉起界面。 /// /// 界面是 Flutter,但**模型窗口仍由 Avalonia 承载**(模型契约返回的是 Avalonia Control)。 /// public static WebApplication Start(string[] args, int port) => Start(args, port, out _); /// /// 构建后端,并通过 交出模型窗口宿主。 /// /// 调用方(启动器)必须在**主线程**调用 : /// macOS 的 AppKit 要求 NSApplication 运行在主线程,否则打开模型窗口时整个进程会崩溃。 /// public static WebApplication Start(string[] args, int port, out AvaloniaHost uiHost) { // 下载模块(GC-DOWNLOAD)通过宿主钩子注入,和 GC-BOOT 的做法一致。 DownloadModuleHost.Factory = new DownloadModuleFactory(); var services = AppServices.Create(); var userService = new UserService(services.Paths.HomeRoot); var host = new AvaloniaHost(services); uiHost = host; var builder = WebApplication.CreateBuilder(new WebApplicationOptions { Args = args }); builder.Logging.ClearProviders(); builder.WebHost.UseUrls($"http://127.0.0.1:{port}"); // 本地伴随进程:限制请求体大小、关闭 Server 头、收紧超时,减少被本地恶意页面 // 或异常客户端拖垮的攻击面。 builder.WebHost.ConfigureKestrel(options => { options.AddServerHeader = false; options.Limits.MaxRequestBodySize = 2 * 1024 * 1024; options.Limits.RequestHeadersTimeout = TimeSpan.FromSeconds(15); options.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(2); options.Limits.MaxConcurrentConnections = 64; }); // 桌面端(Windows/macOS)走原生 HTTP,不需要 CORS; // 这里放开本机回环来源,方便用 `flutter run -d chrome` 调试界面。 builder.Services.AddCors(options => options.AddDefaultPolicy(policy => policy .SetIsOriginAllowed(origin => Uri.TryCreate(origin, UriKind.Absolute, out var uri) && (uri.Host == "127.0.0.1" || uri.Host == "localhost" || uri.Host == "::1")) .AllowAnyHeader() .AllowAnyMethod())); var app = builder.Build(); app.UseCors(); // 日志与启动器共用 .GC/logs,整条启动链路(启动器 → 后端 → 守护进程)都在同一组文件里。 var logPaths = AppPaths.Discover(); GcLog.Init(logPaths.LogsRoot); GcLog.Info($"GC-UI 后端启动,监听 127.0.0.1:{port}", $"GC-UI backend started on 127.0.0.1:{port}"); // 设置白名单 / 标识校验用到的规则(只在本进程内使用)。 var allowedLanguages = new HashSet(StringComparer.OrdinalIgnoreCase) { "auto", "zh-CN", "en" }; var allowedThemes = new HashSet(StringComparer.OrdinalIgnoreCase) { "light", "dark", "system" }; var accentHexRegex = new System.Text.RegularExpressions.Regex( "^#(?:[0-9A-Fa-f]{6})$", System.Text.RegularExpressions.RegexOptions.Compiled); var safeIdRegex = new System.Text.RegularExpressions.Regex( "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$", System.Text.RegularExpressions.RegexOptions.Compiled); // 安全响应头 + Host/Origin 校验(抵御 DNS rebinding 与跨站调用)。 app.Use(async (context, next) => { var headers = context.Response.Headers; headers["X-Content-Type-Options"] = "nosniff"; headers["X-Frame-Options"] = "DENY"; headers["Referrer-Policy"] = "no-referrer"; headers["Content-Security-Policy"] = "default-src 'none'; frame-ancestors 'none'"; headers["Cache-Control"] = "no-store"; var host = context.Request.Host.Host; if (!string.Equals(host, "127.0.0.1", StringComparison.OrdinalIgnoreCase) && !string.Equals(host, "localhost", StringComparison.OrdinalIgnoreCase) && !string.Equals(host, "::1", StringComparison.OrdinalIgnoreCase)) { context.Response.StatusCode = StatusCodes.Status403Forbidden; return; } var origin = context.Request.Headers.Origin.ToString(); if (!string.IsNullOrEmpty(origin) && !(Uri.TryCreate(origin, UriKind.Absolute, out var parsed) && (parsed.Host == "127.0.0.1" || parsed.Host == "localhost" || parsed.Host == "::1"))) { context.Response.StatusCode = StatusCodes.Status403Forbidden; return; } await next(); }); // 写入类接口做简单限流:单 IP 每秒最多 40 次,防止本地脚本刷爆下载/更新。 var writeBuckets = new System.Collections.Concurrent.ConcurrentDictionary(); app.Use(async (context, next) => { if (HttpMethods.IsPost(context.Request.Method) || HttpMethods.IsDelete(context.Request.Method)) { var key = context.Connection.RemoteIpAddress?.ToString() ?? "local"; var now = Environment.TickCount64; // 定期丢弃过期窗口:本机连接数不多,但长时间运行后桶只增不减会缓慢泄漏。 if (writeBuckets.Count > 256) { foreach (var entry in writeBuckets) { if (now - entry.Value.Window > 60_000) writeBuckets.TryRemove(entry.Key, out _); } } var bucket = writeBuckets.AddOrUpdate( key, _ => (now, 1), (_, old) => now - old.Window > 1000 ? (now, 1) : (old.Window, old.Count + 1)); if (bucket.Count > 40) { context.Response.StatusCode = StatusCodes.Status429TooManyRequests; await context.Response.WriteAsJsonAsync(ErrorDto.Of("请求过于频繁,请稍后再试")); return; } } await next(); }); // 会话令牌校验:启动器拉起时经 GC_UI_TOKEN 注入一次性令牌,前端每个 /api 请求 // 都必须带回。这样同机其他进程即使占了端口、伪造 /api/health 返回 200,也过不了 // 这一关——它拿不到令牌。独立进程 / 调试模式未设置令牌时放行,保持兼容。 var sessionToken = Environment.GetEnvironmentVariable(GcUiContract.TokenEnvVar); if (!string.IsNullOrEmpty(sessionToken)) { var expected = System.Text.Encoding.UTF8.GetBytes(sessionToken); app.Use(async (context, next) => { if (context.Request.Path.StartsWithSegments("/api")) { // 正常请求从请求头取;封面图由 Image.network 发起、无法加自定义头, // 用同名 query 参数携带(GET 只读资源,参数不会落到日志正文)。 var supplied = context.Request.Headers[GcUiContract.TokenHeader].ToString(); if (string.IsNullOrEmpty(supplied)) supplied = context.Request.Query[GcUiContract.TokenHeader].ToString(); var actual = System.Text.Encoding.UTF8.GetBytes(supplied); // 长度不等时 CryptographicOperations 仍安全比较,但先比对长度省一次分支泄漏。 if (actual.Length != expected.Length || !System.Security.Cryptography.CryptographicOperations.FixedTimeEquals(actual, expected)) { context.Response.StatusCode = StatusCodes.Status401Unauthorized; return; } } await next(); }); } // ---- 健康检查 ------------------------------------------------------------- // ---- 用户系统 ----------------------------------------------------------------- // 简单 session 存储:key = username(lower), value = session token var userSessions = new System.Collections.Concurrent.ConcurrentDictionary(); // 中间件:从 header 提取当前用户;没有 token 时回退到 user.yaml 记住的用户(自动登录) app.Use(async (context, next) => { context.Items["user"] = null as string; if (context.Request.Headers.TryGetValue("X-User-Token", out var tokens) && tokens.Count > 0) { var token = tokens[0]; foreach (var kv in userSessions) { if (kv.Value == token) { context.Items["user"] = kv.Key; break; } } } if (context.Items["user"] is not string u || string.IsNullOrEmpty(u)) context.Items["user"] = userService.RestoredUser; await next(); }); // 人品值评语(与前端 FortuneResult.commentFor 保持一致) static string FortuneComment(int value) { if (value >= 96) return "欧皇附体,今天买彩票吧"; if (value >= 90) return "运气爆棚,适合干大事"; if (value >= 80) return "手气不错,稳"; if (value >= 65) return "中上水平,稍微努一下"; if (value >= 50) return "普普通通,够用"; if (value >= 35) return "有点背,低调点"; if (value >= 20) return "今天别赌任何东西"; if (value >= 8) return "极差,建议躺平"; return "非酋之王,明天再来"; } // 统一的用户响应体:前端一次拿齐签到 / 主题色需要的所有字段 object UserPayload(UserRecord r) { // 与 UserService 保持一致:本地日历日,不能用 UTC var today = DateTime.Today; int nextConsecutive; if (!r.LastSignIn.HasValue) nextConsecutive = 1; else { var diff = (today - r.LastSignIn.Value.Date).Days; nextConsecutive = diff <= 1 ? r.ConsecutiveDays + 1 : 1; } var refund = UserService.RefundRemaining(r); return new { username = r.Username, points = r.Points, consecutive_days = r.ConsecutiveDays, cycle_day = UserService.CycleDay(r.ConsecutiveDays), cycle_days = UserService.SignInCycleDays, today_signed = r.LastSignIn.HasValue && r.LastSignIn.Value.Date == today, next_reward = UserService.GetSignInReward(UserService.CycleDay(nextConsecutive)), last_sign_in = r.LastSignIn?.ToString("yyyy-MM-dd") ?? "", theme_color = r.ThemeColor ?? UserService.DefaultThemeColor, theme_paid = r.ThemePaid, refund_seconds = refund.HasValue ? (int)refund.Value.TotalSeconds : 0 }; } // 人机验证:算术题,5 分钟有效、一次性 app.MapGet("/api/user/captcha", () => { var (id, question) = userService.IssueCaptcha(); return Results.Ok(new CaptchaDto(id, question)); }); app.MapPost("/api/user/register", (RegisterRequest? req) => { if (req == null) return Results.BadRequest(new { error = "请求体为空" }); if (string.IsNullOrWhiteSpace(req.Username)) return Results.BadRequest(new { error = "用户名不能为空" }); if (string.IsNullOrWhiteSpace(req.Password)) return Results.BadRequest(new { error = "密码不能为空" }); var ok = userService.Register(req.Username, req.Password, req.CaptchaId, req.Captcha, out var err); return ok ? Results.Ok(new { message = "注册成功" }) : Results.BadRequest(new { error = err }); }); app.MapPost("/api/user/login", (LoginRequest? req) => { if (req == null) return Results.BadRequest(new { error = "请求体为空" }); var ok = userService.Login(req.Username, req.Password, out var err, out var rec); if (!ok) return Results.BadRequest(new { error = err }); // 生成 session token var sessionToken = Convert.ToBase64String(System.Security.Cryptography.RandomNumberGenerator.GetBytes(32)).Replace("/", "_").Replace("+", "-").Substring(0, 32); userSessions[rec!.Username.ToLowerInvariant()] = sessionToken; // 记住登录:写 .GC/user/user.yaml,下次启动自动登录 userService.SaveSession(rec.Username, sessionToken); return Results.Ok(new { username = rec.Username, points = rec.Points, consecutive_days = rec.ConsecutiveDays, last_sign_in = rec.LastSignIn?.ToString("yyyy-MM-dd") ?? "", theme_color = rec.ThemeColor ?? "", session_token = sessionToken }); }); app.MapPost("/api/user/logout", (HttpContext ctx) => { var username = ctx.Items["user"] as string; if (!string.IsNullOrEmpty(username)) userSessions.TryRemove(username, out _); userService.ClearSession(); return Results.Ok(new { message = "已退出登录" }); }); app.MapGet("/api/user/me", (HttpContext ctx) => { var username = ctx.Items["user"] as string; if (string.IsNullOrEmpty(username) || !userService.TryGetUser(username, out var rec)) return Results.Json(new { error = "未登录" }, statusCode: 401); return Results.Ok(UserPayload(rec)); }); app.MapPost("/api/user/signin", (HttpContext ctx) => { var username = ctx.Items["user"] as string; if (string.IsNullOrEmpty(username) || !userService.TryGetUser(username, out var rec)) return Results.Json(new { error = "未登录" }, statusCode: 401); var ok = userService.UpdateSignIn(username, out var err, out var reward); if (!ok) { if (err == "今日已签到") return Results.Ok(new { message = err, user = UserPayload(rec) }); return Results.BadRequest(new { error = err }); } return Results.Ok(new { reward, user = UserPayload(rec) }); }); app.MapPost("/api/user/fortune", (HttpContext ctx) => { var username = ctx.Items["user"] as string; if (string.IsNullOrEmpty(username)) return Results.Json(new { error = "未登录" }, statusCode: 401); var ok = userService.RollFortune(username, out var err, out var value, out var cost, out var rec); if (!ok) return Results.BadRequest(new { error = err }); return Results.Ok(new { value, cost, comment = FortuneComment(value), user = UserPayload(rec!) }); }); app.MapPost("/api/user/pick", (HttpContext ctx, PickRequest? req) => { var username = ctx.Items["user"] as string; if (string.IsNullOrEmpty(username)) return Results.Json(new { error = "未登录" }, statusCode: 401); if (req == null) return Results.BadRequest(new { error = "请求体为空" }); var ok = userService.PickOne(username, req.OptionA, req.OptionB, out var err, out var choice, out var cost, out var rec); if (!ok) return Results.BadRequest(new { error = err }); return Results.Ok(new { choice, cost, user = UserPayload(rec!) }); }); app.MapPost("/api/user/theme", (HttpContext ctx, ThemeRequest? req) => { var username = ctx.Items["user"] as string; if (string.IsNullOrEmpty(username) || !userService.TryGetUser(username, out var rec)) return Results.Json(new { error = "未登录" }, statusCode: 401); if (req == null) return Results.BadRequest(new { error = "请求体为空" }); var ok = userService.ChangeThemeColor(username, req.Color, out var err, out var refunded); if (!ok) return Results.BadRequest(new { error = err }); return Results.Ok(new { message = "主题已更新", refunded, user = UserPayload(rec) }); }); app.MapGet("/api/health", () => Results.Ok(new HealthDto( true, LauncherRuntimeInfo.CurrentLauncherVersion, LauncherRuntimeInfo.CurrentRid, // 界面在客户端内渲染,后端不存在「窗口宿主不可用」的状态 true, (string?)null, GcUiContract.DeriveSessionProof(sessionToken)))); // ---- 已安装模型 ----------------------------------------------------------- app.MapGet("/api/models", () => Results.Ok(services.Models.Scan().Select(ToModelDto).ToList())); app.MapGet("/api/models/{id}/preview", (string id, HttpResponse response) => { if (!IsSafeId(id)) return Results.BadRequest(ErrorDto.Of("模型标识无效")); var package = services.Models.Find(id); if (package == null || !File.Exists(package.PreviewPath)) return Results.NotFound(); // 封面是静态图,允许前端缓存:默认全局中间件写的 no-store 会让每次滚动都重新请求。 // 按扩展名给准确的 MIME —— 统一写 image/png 时,WebP / JPEG 封面在部分平台显示不出来。 response.Headers.CacheControl = "private, max-age=300"; return Results.File(package.PreviewPath, GuessImageContentType(package.PreviewPath)); }); // 模型改为客户端内渲染(Flutter):这里只确认模型存在并把 id 交回去, // 不再拉起 Avalonia 窗口。保留接口是为了老客户端不至于 404。 app.MapPost("/api/models/{id}/launch", async (string id) => { if (!IsSafeId(id)) return Results.BadRequest(new LaunchResultDto(false, "模型标识无效")); var package = services.Models.Find(id); if (package == null) return Results.NotFound(new LaunchResultDto(false, $"没有找到模型 {id}")); try { services.Memory.Refresh(); var message = await host.LaunchAsync(package); return Results.Ok(new LaunchResultDto(true, message)); } catch (Exception ex) { Console.Error.WriteLine($"[launch] 启动模型 {id} 失败: {ex}"); return Results.Json(new LaunchResultDto(false, "模型启动失败,请查看后端日志"), statusCode: 503); } }); app.MapDelete("/api/models/{id}", (string id) => { if (!IsSafeId(id)) return Results.BadRequest(ErrorDto.Of("模型标识无效")); var ok = services.Models.Delete(id); if (ok) services.Models.NotifyChanged(); return ok ? Results.Ok(new LaunchResultDto(true, $"已删除模型 {id}")) : Results.NotFound(ErrorDto.Of($"没有找到模型 {id}")); }); // ---- 设置 ----------------------------------------------------------------- app.MapGet("/api/settings", () => Results.Ok(ToSettingsDto())); app.MapPost("/api/settings", (SettingsPatch? patch) => { if (patch == null) return Results.BadRequest(ErrorDto.Of("缺少设置内容")); // 白名单校验:设置项会写进磁盘并被前端直接使用,不接受任意字符串。 if (patch.Language != null && !allowedLanguages.Contains(patch.Language)) return Results.BadRequest(ErrorDto.Of("不支持的界面语言")); if (patch.Theme != null && !allowedThemes.Contains(patch.Theme)) return Results.BadRequest(ErrorDto.Of("不支持的主题")); if (patch.AccentColor != null && !accentHexRegex.IsMatch(patch.AccentColor)) return Results.BadRequest(ErrorDto.Of("主题色需为 #RRGGBB")); if (patch.UpdateRepository != null && !IsAllowedRepository(patch.UpdateRepository)) return Results.BadRequest(ErrorDto.Of("更新仓库地址不受信任")); services.Settings.Apply(s => { if (patch.Language != null) s.Language = patch.Language; if (patch.Theme != null) s.Theme = patch.Theme; if (patch.AccentColor != null) s.AccentColor = patch.AccentColor.ToUpperInvariant(); if (patch.RenderFps.HasValue) s.RenderFps = Math.Clamp(patch.RenderFps.Value, 12, 120); if (patch.MemoryMb.HasValue) s.MemoryMb = Math.Clamp(patch.MemoryMb.Value, 256, 16384); if (patch.MemoryAuto.HasValue) s.MemoryAuto = patch.MemoryAuto.Value; if (patch.AutoUpdateOnStartup.HasValue) s.AutoUpdateOnStartup = patch.AutoUpdateOnStartup.Value; if (patch.RequireSignedManifest.HasValue) s.RequireSignedManifest = patch.RequireSignedManifest.Value; if (patch.UpdateRepository != null) s.UpdateRepository = patch.UpdateRepository; if (patch.UpdateLocalRoot != null) s.UpdateLocalRoot = patch.UpdateLocalRoot; if (patch.ModelRootOverride != null) s.ModelRootOverride = patch.ModelRootOverride; }); if (patch.Language != null) L.I.SetLanguage(patch.Language); if (patch.MemoryMb.HasValue || patch.MemoryAuto.HasValue) services.Memory.ApplyAuto(services.Settings.Current.MemoryAuto, services.Settings.Current.MemoryMb); return Results.Ok(ToSettingsDto()); }); // ---- 模型源 --------------------------------------------------------------- app.MapGet("/api/sources", () => Results.Ok(services.Settings.Current.Sources.Select(ToSourceDto).ToList())); app.MapPost("/api/sources/select", async (ForceRequest? request) => { var force = request?.Force ?? false; try { var fastest = await services.Selector.PickFastestAsync(force, CancellationToken.None); services.Updates.UseRemote(services.DownloadModule.CreateRemote(fastest)); return Results.Ok(new LatencyDto( fastest.Id, fastest.Name, services.Selector.LastLatency.TryGetValue(fastest.Id, out var ms) ? ms : 0)); } catch (Exception ex) { Console.Error.WriteLine($"[sources] 切换模型源失败: {ex}"); return Results.Json(ErrorDto.Of("模型源切换失败"), statusCode: 503); } }); app.MapGet("/api/remote/models", async (string? sourceId, bool force) => { var source = ResolveSource(sourceId); if (source == null) return Results.NotFound(ErrorDto.Of("没有可用的模型源")); var index = await services.Sources.FetchAsync(source, force, null, CancellationToken.None); var installed = services.Models.Scan() .ToDictionary(p => p.Id, p => p.Manifest.Version, StringComparer.OrdinalIgnoreCase); return Results.Ok(new SourceIndexDto( index.SourceId, index.Root, index.FromCache, index.Error, index.ResolvedFrom, index.Models.Select(m => new RemoteModelDto( m.Id, m.LocalizedName, m.LocalizedDescription, m.Manifest.Version, m.SizeBytes, ModelScanner.HumanSize(m.SizeBytes), m.SourceId, installed.ContainsKey(m.Id), installed.TryGetValue(m.Id, out var v) ? v : null)).ToList())); }); // ---- 下载 ----------------------------------------------------------------- app.MapPost("/api/download", async (DownloadRequest? request) => { if (request == null || string.IsNullOrWhiteSpace(request.ModelId)) return Results.BadRequest(ErrorDto.Of("缺少 modelId")); var source = ResolveSource(request.SourceId); if (source == null) return Results.NotFound(ErrorDto.Of("没有可用的模型源")); var index = await services.Sources.FetchAsync(source, false, null, CancellationToken.None); var model = index.Models.FirstOrDefault(m => m.Id.Equals(request.ModelId, StringComparison.OrdinalIgnoreCase)); if (model == null) return Results.NotFound(ErrorDto.Of($"源里没有模型 {request.ModelId}")); var job = services.Downloads.Enqueue(model); return Results.Ok(ToJobDto(job)); }); app.MapGet("/api/download/jobs", () => Results.Ok(services.Downloads.Jobs.Select(ToJobDto).ToList())); app.MapPost("/api/download/{id}/cancel", (string id) => ActOnJob(id, job => services.Downloads.Cancel(job))); app.MapPost("/api/download/{id}/retry", (string id) => ActOnJob(id, job => services.Downloads.Retry(job))); app.MapPost("/api/download/{id}/remove", (string id) => ActOnJob(id, job => services.Downloads.Remove(job))); app.MapPost("/api/download/clear-finished", () => { services.Downloads.ClearFinished(); return Results.Ok(new LaunchResultDto(true, "已清除完成的任务")); }); // ---- 更新 ----------------------------------------------------------------- app.MapPost("/api/update/check", async (ForceRequest? request) => { var force = request?.Force ?? true; var messages = new List(); try { var fastest = await services.Selector.PickFastestAsync(force, CancellationToken.None); services.Updates.UseRemote(services.DownloadModule.CreateRemote(fastest)); } catch (Exception ex) { Console.Error.WriteLine($"[update] 测速失败,沿用当前源: {ex.Message}"); } string? launcherLatest = null; try { launcherLatest = await services.LauncherUpdates.CheckAsync( services.Updates.Remote, CancellationToken.None); } catch (Exception ex) { Console.Error.WriteLine($"[update] 启动器版本检查失败: {ex.Message}"); } var progress = new Progress(p => { if (!string.IsNullOrWhiteSpace(p.Message)) messages.Add(p.Message); }); var result = await services.Updates.RunAsync(force, progress, CancellationToken.None); return Results.Ok(new UpdateCheckDto( result.Outcome.ToString(), result.Message, result.UpdatedModels, result.ModelNames, result.LauncherMessage, result.Error, launcherLatest, services.Updates.Remote.DisplayName, services.Selector.LastLatency .Select(kv => new LatencyDto( kv.Key, SourcePreset.Find(kv.Key)?.Name ?? kv.Key, kv.Value)) .ToList())); }); // ---- 重新下载启动器 ------------------------------------------------------- // 「关于」页的按钮:本地程序文件被误删 / 损坏后,重新拉一份发布包。 // DownloadAsync 内部会按清单里的 sha256 逐块校验,清单缺 sha256 直接拒绝下载, // 所以「下载完确认完整性」是这条链路的固有动作,不是这里另加的一次比对。 app.MapPost("/api/launcher/redownload", async () => { try { var fastest = await services.Selector.PickFastestAsync(false, CancellationToken.None); services.Updates.UseRemote(services.DownloadModule.CreateRemote(fastest)); var steps = new List(); var progress = new Progress(p => { if (string.IsNullOrWhiteSpace(p.Stage)) return; lock (steps) steps.Add(p.Stage); }); var result = await services.LauncherUpdates.DownloadAsync( services.Paths, services.Updates.Remote, progress, CancellationToken.None); lock (steps) { return Results.Ok(new LauncherRedownloadDto( result.State.ToString(), result.Version, result.Message, steps.ToList())); } } catch (Exception ex) { Console.Error.WriteLine($"[launcher] 重新下载失败: {ex}"); return Results.Json( ErrorDto.Of($"重新下载启动器失败:{ex.Message}"), statusCode: 503); } }); // ---- 关于 ----------------------------------------------------------------- app.MapGet("/api/about", async () => { var repository = services.Settings.Current.UpdateRepository; var contributors = new List(); try { foreach (var c in await ContributorsService.FetchAsync(repository, CancellationToken.None)) contributors.Add(new ContributorDto(c.DisplayName, c.Contributions, c.AvatarUrl)); } catch (Exception ex) { Console.Error.WriteLine($"[about] 读取贡献者失败: {ex.Message}"); } return Results.Ok(new AboutDto( "Morris GC", LauncherRuntimeInfo.CurrentLauncherVersion, LauncherRuntimeInfo.CurrentRid, repository, contributors, // 「关于」页展示的技术栈信息:源码语言与前端框架。 SourceLanguage: "C#", Frontend: "Flutter")); }); // ---- 系统集成 ------------------------------------------------------------- app.MapPost("/api/shell/open-folder", (PathRequest? request) => { var path = request?.Path; if (string.IsNullOrWhiteSpace(path)) return Results.BadRequest(ErrorDto.Of("缺少 path")); // 只允许打开启动器自己的目录,避免前端被当成任意路径执行器 if (!IsInsideKnownRoot(path!)) return Results.BadRequest(ErrorDto.Of("只允许打开启动器自己的目录")); Shell.OpenFolder(path!); return Results.Ok(new LaunchResultDto(true, "已打开目录")); }); app.MapPost("/api/shell/open-url", (UrlRequest? request) => { var url = request?.Url; if (string.IsNullOrWhiteSpace(url) || url.Length > 2048 || !Uri.TryCreate(url, UriKind.Absolute, out var uri)) return Results.BadRequest(ErrorDto.Of("URL 无效")); if (uri.Scheme != Uri.UriSchemeHttp && uri.Scheme != Uri.UriSchemeHttps) return Results.BadRequest(ErrorDto.Of("只允许 http/https 链接")); if (!string.IsNullOrEmpty(uri.UserInfo)) return Results.BadRequest(ErrorDto.Of("URL 不允许携带账号密码")); Shell.OpenUrl(url!); return Results.Ok(new LaunchResultDto(true, "已打开链接")); }); // ---- 启动 ----------------------------------------------------------------- WriteEndpointFile(services, port, sessionToken); Console.WriteLine($"[GC-UI] 后端已启动: http://127.0.0.1:{port}"); Console.WriteLine($"[GC-UI] 模型库: {services.Paths.ModelRoot}"); return app; // --------------------------------------------------------------------------- // 局部辅助 // --------------------------------------------------------------------------- static void WriteEndpointFile(AppServices services, int port, string? token) { try { var file = Path.Combine(services.Paths.HomeRoot, "ui-backend.json"); var payload = JsonSerializer.Serialize(new { port, pid = Environment.ProcessId, url = $"http://127.0.0.1:{port}", version = LauncherRuntimeInfo.CurrentLauncherVersion, platform = LauncherRuntimeInfo.CurrentRid, startedAt = DateTimeOffset.UtcNow.ToString("o"), // 令牌也写进来:前端如果是被 Finder 直接打开(没有继承环境变量), // 只能从这里拿到会话令牌,否则每个 /api 都会 401 —— 表现为「无法连接后端」。 token }, new JsonSerializerOptions { WriteIndented = true }); File.WriteAllText(file, payload); if (!OperatingSystem.IsWindows()) { // 同机其他用户不该读到会话令牌 try { File.SetUnixFileMode(file, UnixFileMode.UserRead | UnixFileMode.UserWrite); } catch { /* 文件系统不支持时忽略 */ } } } catch (Exception ex) { Console.Error.WriteLine($"[GC-UI] 写入端点文件失败: {ex.Message}"); } } /// 按扩展名推断图片 MIME;模型封面允许 png / jpg / webp / gif。 static string GuessImageContentType(string path) => Path.GetExtension(path).ToLowerInvariant() switch { ".jpg" or ".jpeg" => "image/jpeg", ".webp" => "image/webp", ".gif" => "image/gif", ".bmp" => "image/bmp", ".svg" => "image/svg+xml", _ => "image/png" }; ModelDto ToModelDto(ModelPackage package) => new( package.Id, package.LocalizedName, package.LocalizedDescription, package.Manifest.Version, package.Manifest.Author, package.SizeBytes, ModelScanner.HumanSize(package.SizeBytes), package.Manifest.Tags ?? new List(), File.Exists(package.PreviewPath), $"/api/models/{package.Id}/preview", package.Directory, package.DataDirectory); SourceDto ToSourceDto(ModelSource source) => new( source.Id, string.IsNullOrWhiteSpace(source.Name) ? source.Id : source.Name, source.Url, source.Enabled, source.BuiltIn, source.DisplayHost); SettingsDto ToSettingsDto() => new( services.Settings.Current.Language, services.Settings.Current.Theme, services.Settings.Current.AccentColor, services.Settings.Current.RenderFps, services.Settings.Current.MemoryMb, services.Settings.Current.MemoryAuto, services.Settings.Current.AutoUpdateOnStartup, services.Settings.Current.RequireSignedManifest, services.Settings.Current.UpdateRepository, services.Settings.Current.UpdateLocalRoot, services.Settings.Current.ModelRootOverride, services.Memory.BudgetMb, services.Memory.UsageText, services.Paths.ModelRoot, services.Paths.DataRoot, services.Paths.SettingsFile, LauncherRuntimeInfo.CurrentLauncherVersion, LauncherRuntimeInfo.CurrentRid, services.Settings.Current.Sources.Select(ToSourceDto).ToList(), L.Supported.Select(s => new LanguageDto(s.Code, s.Label)).ToList()); JobDto ToJobDto(IDownloadJob job) => new( job.Id, job.Model.Id, job.Name, job.Version, job.State.ToString(), job.Progress, job.StatusText, job.DetailText, job.Error, job.IsActive, job.CanRetry, job.IsDone); ModelSource? ResolveSource(string? sourceId) { var sources = services.Settings.Current.Sources; if (!string.IsNullOrWhiteSpace(sourceId)) { var exact = sources.FirstOrDefault(s => s.Id.Equals(sourceId, StringComparison.OrdinalIgnoreCase)); if (exact != null) return exact; } return sources.FirstOrDefault(s => s.Enabled && !string.IsNullOrWhiteSpace(s.Url)) ?? sources.FirstOrDefault(); } IResult ActOnJob(string id, Action action) { if (!IsSafeId(id)) return Results.BadRequest(ErrorDto.Of("任务标识无效")); var job = services.Downloads.Jobs.FirstOrDefault(j => j.Id.Equals(id, StringComparison.OrdinalIgnoreCase)); if (job == null) return Results.NotFound(ErrorDto.Of($"没有找到任务 {id}")); action(job); return Results.Ok(ToJobDto(job)); } bool IsInsideKnownRoot(string path) { try { var full = Path.GetFullPath(path); var roots = new[] { services.Paths.ModelRoot, services.Paths.DataRoot, services.Paths.HomeRoot, services.Paths.AppRoot }; foreach (var root in roots) { if (string.IsNullOrWhiteSpace(root)) continue; var rootFull = Path.GetFullPath(root); if (full.Equals(rootFull, StringComparison.OrdinalIgnoreCase)) return true; if (full.StartsWith(rootFull + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase)) return true; } } catch { return false; } return false; } // 路由标识:只允许字母数字开头,后接字母数字/点/下划线/短横线,长度上限 64。 // 用于模型 id、任务 id,杜绝 `../` 之类的路径穿越尝试。 bool IsSafeId(string? id) => !string.IsNullOrEmpty(id) && safeIdRegex.IsMatch(id); // 更新仓库地址:必须是 https、不带账号密码、不是回环/内网 IP。 // 防止把本地后端当成 SSRF 跳板去访问内网服务。 bool IsAllowedRepository(string value) { if (string.IsNullOrWhiteSpace(value)) return false; if (!Uri.TryCreate(value, UriKind.Absolute, out var uri)) return false; if (uri.Scheme != Uri.UriSchemeHttps) return false; if (!string.IsNullOrEmpty(uri.UserInfo)) return false; if (string.Equals(uri.Host, "localhost", StringComparison.OrdinalIgnoreCase)) return false; if (System.Net.IPAddress.TryParse(uri.Host, out var ip) && (System.Net.IPAddress.IsLoopback(ip) || IsPrivateAddress(ip))) return false; return true; } static bool IsPrivateAddress(System.Net.IPAddress ip) { var bytes = ip.GetAddressBytes(); if (bytes.Length != 4) return false; return bytes[0] == 10 || (bytes[0] == 172 && bytes[1] >= 16 && bytes[1] <= 31) || (bytes[0] == 192 && bytes[1] == 168) || (bytes[0] == 169 && bytes[1] == 254); } } public static int ResolvePort(string[] args) { // 优先用启动器传来的端口(GC_UI_PORT),保证前端拼出来的 baseUrl 和这里一致。 var env = Environment.GetEnvironmentVariable(GcUiContract.PortEnvVar); if (int.TryParse(env, out var fromEnv) && fromEnv > 0 && fromEnv < 65536) return fromEnv; for (var i = 0; i < args.Length; i++) { if (args[i] == "--port" && i + 1 < args.Length && int.TryParse(args[i + 1], out var next) && next > 0 && next < 65536) return next; const string prefix = "--port="; if (args[i].StartsWith(prefix, StringComparison.Ordinal) && int.TryParse(args[i][prefix.Length..], out var inline) && inline > 0 && inline < 65536) return inline; } return GcUiContract.DefaultPort; } }