前端
- 移除全部 Avalonia 依赖,模型渲染与界面统一改用 Flutter
- 新增用户页:登录/注册(SHA-512 + 盐)、签到积分(30 天一循环)、
主题色积分购买、二选一随机、今日人品
- 新增百宝箱页、模型内嵌渲染页、自绘标题栏(最小化/最大化/关闭)
- 下载页显示模型下载进度条,下载源读取加速
- 关于页新增「重新下载启动器」并在下载后做 sha256 完整性校验
- 修复浅色主题下标题栏不跟随主题色、无法连接后端等问题
后端
- 新增 UserService:.GC/user/<用户名>.yaml 存用户名/积分/SHA-512 口令,
登录返回 session token,本地 .GC/user/user.yaml 保存登录态
- 新增 /api/user/{register,login,me,signin,theme} 接口
- 去掉 Avalonia 窗口宿主,后端只提供 HTTP API
下载源
- 新增 GitHub 镜像源(Morris-morris-cloud/GC),与 Xhmcl 并发测速
- 单源探测超时收紧到 2 秒,取最快且可用的源;GitHub 复用 GiteaRemote
(contents 带 ref、releases 带 per_page=100)
构建与 CI
- macOS 上默认只出 macOS 包,Windows 交给原生 Windows 构建
- 修复 Windows 交叉编译中 flutter-cpp-client-wrapper 双层目录嵌套
- 新增 GitHub Actions:
· nightly-prerelease:每天 21:00 编译三平台,发布 nightly 预发布
· build-bot:Issue/PR 评论 @build-bot build <mac|win-amd|win-arm|all>,
发布 ip-prerelease 预发布
· pr-review:检查能否编译、静态分析、合并冲突、是否落后 main
- 忽略 79MB 课件产物等高线.html 与工具链临时备份
254 lines
10 KiB
C#
254 lines
10 KiB
C#
using System;
|
||
using System.Diagnostics;
|
||
using System.IO;
|
||
using System.Net.Http;
|
||
using System.Threading;
|
||
using System.Threading.Tasks;
|
||
using GC.Services;
|
||
using GC.UI.Server;
|
||
using Microsoft.AspNetCore.Builder;
|
||
|
||
namespace GC;
|
||
|
||
/// <summary>
|
||
/// 新界面启动壳。
|
||
///
|
||
/// 发布包带 <c>GC-UI</c>(Flutter 前端)时,启动器只做三件事:
|
||
/// 1. 在自己的进程里起后端(本地 HTTP API + 模型窗口宿主),等 <c>/api/health</c> 就绪;
|
||
/// 2. 拉起 Flutter 窗口;
|
||
/// 3. 界面退出后关掉后端。
|
||
///
|
||
/// 后端跑在进程内而不是单独一个 exe:两者用的是同一套 .NET 运行时,
|
||
/// 拆成两个自包含进程等于把 60MB 运行时复制两份,发布包会白白大一倍。
|
||
///
|
||
/// 缺 Flutter 前端时返回 <c>false</c>,由调用方提示用户安装完整发布包
|
||
/// (内置 Avalonia 界面已移除,界面只有 Flutter 一套)。
|
||
/// </summary>
|
||
internal static class FlutterShell
|
||
{
|
||
/// <summary>与前端、后端共用的默认端口(定义在 GC.Services.GcUiContract)。</summary>
|
||
private const int Port = Services.GcUiContract.DefaultPort;
|
||
|
||
// 使用共享 HttpClient(短超时,仅用于健康检查)
|
||
private static readonly HttpClient Http = SharedHttpClientFactory.GetDefault();
|
||
|
||
private static WebApplication? _backend;
|
||
|
||
public static bool TryRun(string[] args)
|
||
{
|
||
var dir = AppContext.BaseDirectory;
|
||
var uiPath = FindUi(dir);
|
||
if (uiPath == null) return false;
|
||
|
||
// 确定要用 Flutter 界面了:本进程只当后端宿主,不要另占一个 Dock 图标
|
||
// (否则「后端 + UI」会出现两个图标)。回退 Avalonia 的分支不会走到这里。
|
||
MacDock.HideFromDock();
|
||
if (OperatingSystem.IsMacOS())
|
||
Console.WriteLine("[shell] 启动器以 UIElement 运行(不占 Dock,界面由 GC-UI.app 显示)");
|
||
|
||
// 本次会话的一次性令牌:进程内后端与 Flutter 前端都从这里拿到同一个值。
|
||
// 只有我们拉起的后端才持有它,同机其他进程伪造的健康响应过不了 IsHealthy 的身份校验。
|
||
// 允许外部预设(自动化测试 / 高级部署固定令牌),未预设才现场生成随机值。
|
||
var token = Environment.GetEnvironmentVariable(Services.GcUiContract.TokenEnvVar);
|
||
if (string.IsNullOrEmpty(token)) token = Services.GcUiContract.NewSessionToken();
|
||
Environment.SetEnvironmentVariable(Services.GcUiContract.TokenEnvVar, token);
|
||
|
||
var port = Port;
|
||
|
||
// 用户可能重复启动:只有当端口上已有一个「持有同一令牌」的后端时才复用。
|
||
// 同机其他程序即便占端口并返回 200,也没有令牌,会被 IsHealthy 拒绝,
|
||
// 于是我们改到下一个端口起自己的后端,绝不把前端交给伪装服务。
|
||
if (!IsHealthy(port, token))
|
||
{
|
||
// 端口可能被别的程序占用:17890 起向后试几个,选第一个能起来且健康的。
|
||
var start = Environment.GetEnvironmentVariable(Services.GcUiContract.PortEnvVar) is { Length: > 0 }
|
||
? Services.GcUiContract.PortFromEnvironment()
|
||
: Port;
|
||
|
||
for (var candidate = start; candidate < start + Services.GcUiContract.PortScanRange; candidate++)
|
||
{
|
||
var app = TryStartBackend(args, candidate);
|
||
if (app == null) continue;
|
||
|
||
if (WaitHealthy(candidate, token, TimeSpan.FromSeconds(25)))
|
||
{
|
||
port = candidate;
|
||
_backend = app;
|
||
break;
|
||
}
|
||
|
||
StopBackend(app);
|
||
}
|
||
|
||
if (_backend == null) return false;
|
||
}
|
||
|
||
AppDomain.CurrentDomain.ProcessExit += (_, _) => StopBackend(_backend);
|
||
|
||
var ui = Start(uiPath, dir, port, token);
|
||
if (ui == null)
|
||
{
|
||
StopBackend(_backend);
|
||
_backend = null;
|
||
return false;
|
||
}
|
||
|
||
// 前端窗口已拉起。这里不再需要 AppKit 事件循环:模型已经全部在 Flutter 里渲染,
|
||
// 后端只是纯 HTTP 服务,主线程阻塞等它退出即可。
|
||
ui.EnableRaisingEvents = true;
|
||
if (!ui.HasExited) ui.WaitForExit();
|
||
|
||
StopBackend(_backend);
|
||
_backend = null;
|
||
return true;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 找不到 Flutter 前端时的提示。
|
||
/// 已经没有任何内置界面可以回退,所以必须在终端/弹窗里说清楚,
|
||
/// 否则用户只会看到一个进程一闪而过。
|
||
/// </summary>
|
||
public static void ReportMissingUi()
|
||
{
|
||
const string message = "找不到 Flutter 前端(GC-UI.app / GC-UI.exe)。请使用完整发布包。";
|
||
Console.Error.WriteLine(message);
|
||
|
||
if (!OperatingSystem.IsMacOS()) return;
|
||
try
|
||
{
|
||
// 发布包是从 Finder 双击启动的,没有终端可看:用系统弹窗告知
|
||
var psi = new ProcessStartInfo("/usr/bin/osascript")
|
||
{
|
||
UseShellExecute = false,
|
||
RedirectStandardError = true,
|
||
};
|
||
psi.ArgumentList.Add("-e");
|
||
psi.ArgumentList.Add($"display alert \"{message}\" as critical");
|
||
Process.Start(psi);
|
||
}
|
||
catch
|
||
{
|
||
// 提示失败也不影响退出码
|
||
}
|
||
}
|
||
|
||
// ---------------------------------------------------------------- 产物定位
|
||
|
||
/// <summary>
|
||
/// Flutter 桌面产物。
|
||
/// macOS 是 <c>GC-UI.app/Contents/MacOS/GC-UI</c>;Windows 是 <c>GC-UI.exe</c>;
|
||
/// Linux 是 <c>GC-UI</c>。
|
||
/// </summary>
|
||
private static string? FindUi(string dir)
|
||
{
|
||
if (OperatingSystem.IsMacOS())
|
||
{
|
||
var exe = Path.Combine(dir, "GC-UI.app", "Contents", "MacOS", "GC-UI");
|
||
if (File.Exists(exe)) return exe;
|
||
}
|
||
|
||
foreach (var name in OperatingSystem.IsWindows() ? new[] { "GC-UI.exe" } : new[] { "GC-UI" })
|
||
{
|
||
var path = Path.Combine(dir, name);
|
||
if (File.Exists(path)) return path;
|
||
}
|
||
return null;
|
||
}
|
||
|
||
// ---------------------------------------------------------------- 进程管理
|
||
|
||
/// <summary>在本进程内启动后端;端口被占用等失败情况返回 null。</summary>
|
||
private static WebApplication? TryStartBackend(string[] args, int port)
|
||
{
|
||
try
|
||
{
|
||
var app = BackendServer.Start(args, port);
|
||
app.StartAsync().GetAwaiter().GetResult();
|
||
return app;
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
Console.Error.WriteLine($"[shell] 后端启动失败(端口 {port}): {ex.Message}");
|
||
return null;
|
||
}
|
||
}
|
||
|
||
private static void StopBackend(WebApplication? app)
|
||
{
|
||
if (app == null) return;
|
||
try
|
||
{
|
||
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(3));
|
||
app.StopAsync(cts.Token).GetAwaiter().GetResult();
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
Console.Error.WriteLine($"[shell] 关闭后端失败: {ex.Message}");
|
||
}
|
||
}
|
||
|
||
private static Process Start(string fileName, string workingDirectory, int port, string token)
|
||
{
|
||
var info = new ProcessStartInfo(fileName)
|
||
{
|
||
WorkingDirectory = workingDirectory,
|
||
UseShellExecute = false,
|
||
};
|
||
|
||
// 把实际端口传给前端:它读这个环境变量拼 baseUrl,换端口不需要重新编译界面。
|
||
info.Environment[Services.GcUiContract.PortEnvVar] = port.ToString();
|
||
// 同一个会话令牌也交给前端,作为每个 /api 请求的身份凭证。
|
||
info.Environment[Services.GcUiContract.TokenEnvVar] = token;
|
||
|
||
// macOS .app 内的二进制也需要可执行位;发布包由 zip 解开时可能丢失。
|
||
if (!OperatingSystem.IsWindows())
|
||
{
|
||
try { File.SetUnixFileMode(fileName, UnixFileMode.UserRead | UnixFileMode.UserWrite | UnixFileMode.UserExecute); }
|
||
catch { /* 权限不足时交给系统判断 */ }
|
||
}
|
||
|
||
return Process.Start(info)!;
|
||
}
|
||
|
||
// ---------------------------------------------------------------- 健康检查
|
||
|
||
/// <summary>
|
||
/// 健康探测必须带本次会话令牌:后端校验通过才说明这是「我们拉起的那个后端」。
|
||
/// 同机伪装进程即使返回 HTTP 200,也因为没有令牌而拿不到 200(后端会 401),
|
||
/// 但这里额外再比对响应体里的密钥指纹,双保险——即便对方原样回一个 200 也骗不过。
|
||
/// </summary>
|
||
private static bool IsHealthy(int port, string token)
|
||
{
|
||
try
|
||
{
|
||
using var request = new HttpRequestMessage(HttpMethod.Get, $"http://127.0.0.1:{port}/api/health");
|
||
request.Headers.TryAddWithoutValidation(Services.GcUiContract.TokenHeader, token);
|
||
using var response = Http.Send(request);
|
||
if (!response.IsSuccessStatusCode) return false;
|
||
|
||
// 状态码 200 还不够:伪装进程可能盲回一个 200。真正的后端会用会话令牌
|
||
// 派生指纹填进 health 响应,这里比对指纹确认对方确实持有同一个令牌。
|
||
var body = response.Content.ReadAsStringAsync().GetAwaiter().GetResult();
|
||
using var json = System.Text.Json.JsonDocument.Parse(body);
|
||
var proof = json.RootElement.TryGetProperty("sessionProof", out var p) ? p.GetString() : null;
|
||
var expected = Services.GcUiContract.DeriveSessionProof(token);
|
||
return string.Equals(proof, expected, StringComparison.OrdinalIgnoreCase);
|
||
}
|
||
catch
|
||
{
|
||
return false;
|
||
}
|
||
}
|
||
|
||
private static bool WaitHealthy(int port, string token, TimeSpan timeout)
|
||
{
|
||
var deadline = DateTime.UtcNow + timeout;
|
||
while (DateTime.UtcNow < deadline)
|
||
{
|
||
if (IsHealthy(port, token)) return true;
|
||
Thread.Sleep(250);
|
||
}
|
||
return false;
|
||
}
|
||
}
|