GC-UI:前后端分离,前端改用 Flutter(Windows/macOS) #1

Merged
Morris merged 1 commits from gc-ui into main 2026-11-17 22:18:08 +08:00
Owner

概述

在仓库内新增 GC-UI/,把 GC 拆成前后端两层,前端统一改用 Flutter,并为 Windows / macOS 应用同一套 Flutter 方案。

本 PR 从 gc-ui 合入 main,请由仓库所有者合并。

一、前后端分离结构

GC-UI/
├── backend/GC.UI.Server/     .NET 8 本地 HTTP API(最小 API,只绑 127.0.0.1)
│   ├── Program.cs            全部接口
│   ├── ApiModels.cs          前后端 JSON 契约
│   └── AvaloniaHost.cs       模型窗口宿主
└── frontend/                 Flutter 桌面应用
    ├── lib/                  main / shell / pages / controller / api_client / i18n / theme
    ├── windows/              Win32 原生 runner(CMake)
    ├── macos/                Cocoa 原生 runner(Xcode)
    ├── test/                 单元测试 + 后端契约测试
    └── tool/render_shots_test.dart   页面截图脚本
层 归属 说明
首页 / 下载 / 设置 / 关于 Flutter 前端 纯界面,全部数据走 HTTP
模型扫描 / 下载 / 更新 / 设置持久化 .NET 后端 复用 GC/src(GC.Core) + GC-DOWNLOAD
模型自己的窗口 .NET 后端 模型 dll 通过 IModelRuntime.CreateView 返回 Avalonia Control,渲染栈属于模型契约,换掉等于让所有已发布模型失效,所以只换界面不换渲染

前端只发一条「启动模型」的指令,模型窗口由后端在自己的 UI 线程上创建。

二、Windows / macOS 前端方案

同一套 Flutter + 各自原生 runner:

  • flutter create --platforms=windows,macos 生成 windows/(CMake + Win32 窗口)与 macos/(Xcode + Cocoa 窗口),业务代码 100% 共用。
  • 两个平台都是真正的原生窗口,不是 WebView 套壳,可设最小尺寸、标题栏、DPI 缩放。
  • Skia/Impeller 自绘,两个平台像素级一致,不需要为 WinUI / AppKit 各写一套控件。

对比过的替代方案:继续用 Avalonia(那就不是「Flutter 前端」了)、WinUI 3 + SwiftUI 各写一套(UI 代码和维护成本翻倍)、Electron / Tauri(WebView 套壳,包体大或需 Rust 工具链,且与 .NET 后端仍要额外桥接)。

三、「关于」页新增字段

在版本卡片里、架构行之后新增两行:

  • 源码语言:C#
  • 前端:Flutter

这两个字段由后端 /api/about 下发(AboutDto 新增 SourceLanguage / Frontend),前端 AboutInfo 解析后展示,中英文案都补齐了。

四、验证情况

  • flutter analyze:No issues found
  • flutter test test/widget_test.dart:8 个用例全部通过
  • dotnet build GC-UI/backend/GC.UI.Server:0 error(2 个既有 CA1416 警告,来自 GC-DOWNLOAD 的 Unix 权限调用,与本次改动无关)
  • 后端 /api/health、/api/about 实跑验证,/api/about 确认返回 "sourceLanguage":"C#","frontend":"Flutter"
  • git status 确认 bin/ obj/ .dart_tool/ 均被 .gitignore 排除,没有误提交构建产物

未验证:Windows 和 macOS 上的实际运行与打包(开发环境为 Linux,flutter build windows 需 Windows 工具链、flutter build macos 需 macOS + Xcode,无法交叉编译)。请在对应平台执行 GC-UI/build-ui.sh windows / macos(或 GC-UI/build-ui.cmd)。

五、提交

单个提交,68 个文件 / +7400 行。

## 概述 在仓库内新增 `GC-UI/`,把 GC 拆成前后端两层,前端统一改用 Flutter,并为 Windows / macOS 应用同一套 Flutter 方案。 本 PR 从 `gc-ui` 合入 `main`,**请由仓库所有者合并**。 ## 一、前后端分离结构 ``` GC-UI/ ├── backend/GC.UI.Server/ .NET 8 本地 HTTP API(最小 API,只绑 127.0.0.1) │ ├── Program.cs 全部接口 │ ├── ApiModels.cs 前后端 JSON 契约 │ └── AvaloniaHost.cs 模型窗口宿主 └── frontend/ Flutter 桌面应用 ├── lib/ main / shell / pages / controller / api_client / i18n / theme ├── windows/ Win32 原生 runner(CMake) ├── macos/ Cocoa 原生 runner(Xcode) ├── test/ 单元测试 + 后端契约测试 └── tool/render_shots_test.dart 页面截图脚本 ``` | 层 | 归属 | 说明 | |---|---|---| | 首页 / 下载 / 设置 / 关于 | **Flutter 前端** | 纯界面,全部数据走 HTTP | | 模型扫描 / 下载 / 更新 / 设置持久化 | **.NET 后端** | 复用 `GC/src`(GC.Core) + `GC-DOWNLOAD` | | 模型自己的窗口 | **.NET 后端** | 模型 dll 通过 `IModelRuntime.CreateView` 返回 Avalonia `Control`,渲染栈属于模型契约,换掉等于让所有已发布模型失效,所以只换界面不换渲染 | 前端只发一条「启动模型」的指令,模型窗口由后端在自己的 UI 线程上创建。 ## 二、Windows / macOS 前端方案 同一套 Flutter + 各自原生 runner: - `flutter create --platforms=windows,macos` 生成 `windows/`(CMake + Win32 窗口)与 `macos/`(Xcode + Cocoa 窗口),**业务代码 100% 共用**。 - 两个平台都是真正的原生窗口,不是 WebView 套壳,可设最小尺寸、标题栏、DPI 缩放。 - Skia/Impeller 自绘,两个平台像素级一致,不需要为 WinUI / AppKit 各写一套控件。 对比过的替代方案:继续用 Avalonia(那就不是「Flutter 前端」了)、WinUI 3 + SwiftUI 各写一套(UI 代码和维护成本翻倍)、Electron / Tauri(WebView 套壳,包体大或需 Rust 工具链,且与 .NET 后端仍要额外桥接)。 ## 三、「关于」页新增字段 在版本卡片里、架构行之后新增两行: - **源码语言:C#** - **前端:Flutter** 这两个字段由后端 `/api/about` 下发(`AboutDto` 新增 `SourceLanguage` / `Frontend`),前端 `AboutInfo` 解析后展示,中英文案都补齐了。 ## 四、验证情况 - `flutter analyze`:No issues found - `flutter test test/widget_test.dart`:8 个用例全部通过 - `dotnet build GC-UI/backend/GC.UI.Server`:0 error(2 个既有 CA1416 警告,来自 GC-DOWNLOAD 的 Unix 权限调用,与本次改动无关) - 后端 `/api/health`、`/api/about` 实跑验证,`/api/about` 确认返回 `"sourceLanguage":"C#","frontend":"Flutter"` - `git status` 确认 `bin/` `obj/` `.dart_tool/` 均被 `.gitignore` 排除,没有误提交构建产物 **未验证**:Windows 和 macOS 上的实际运行与打包(开发环境为 Linux,`flutter build windows` 需 Windows 工具链、`flutter build macos` 需 macOS + Xcode,无法交叉编译)。请在对应平台执行 `GC-UI/build-ui.sh windows` / `macos`(或 `GC-UI/build-ui.cmd`)。 ## 五、提交 单个提交,68 个文件 / +7400 行。
Morris added 1 commit 2026-11-17 22:15:09 +08:00
- 新增 GC-UI/:backend(.NET 8 本地 HTTP API + 模型窗口宿主)与 frontend(Flutter 桌面应用)
- 前端一套 Dart 代码 + windows/macos 两个原生 runner,共享全部界面逻辑
- 「关于」页新增「源码语言:C#」「前端:Flutter」两行,字段由 /api/about 下发
- 截图脚本覆盖首页/下载/设置/关于/外壳,需要真实后端时用 runAsync 等待请求
- README 补充平台选型理由、接口列表与截图用法
Morris merged commit 3480cbaa5f into main 2026-11-17 22:18:08 +08:00
Author
Owner

本PR由AI生成 做记录以便发布release

本PR由AI生成 做记录以便发布release
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Morris/GC#1