发布包改为 GCL 单目录布局,.GC 增加 safedog 与中英双语日志 #11

Merged
Morris merged 1 commits from feat/gcl-package-layout into main 2026-11-18 20:27:28 +08:00
Owner

目标

  1. 压缩包内只有 GC 本体(一个顶层目录),不再是一屏散落的 dll;
  2. 启动后 .GC 里有 safedog/ 与 logs/;
  3. 日志中英双版本;
  4. 产物统一 GCL- 前缀。

包结构(构建产物实测)

GCL-1.0.9-win-amd64.zip
└── GCL-1.0.9-win-amd64/
    ├── GCL-1.0.9-win-amd64.exe   启动器
    ├── GC-UI.exe                 Flutter 前端
    ├── flutter_windows.dll
    ├── data/flutter_assets/
    ├── GC.UI.Server.exe          后端
    └── safedog/GC-SAVEDOG.exe

zip 顶层只有一个目录;unzip -l 可见所有条目都在 GCL-…/ 下。

运行目录(首次启动后)

GCL-1.0.9-linux-amd64/
  GCL-1.0.9-linux-amd64
  .GC/
    config/  model/  cache/  update/
    safedog/GC-SAVEDOG      ← 从包内复制;整目录更新永远不碰它
    logs/gc-20261118.log    ← 中文
    logs/gc-20261118.en.log ← English

实现要点

  • AppPaths:新增 LogsRoot、SafedogRoot,EnsureCreated 一并创建。
  • 新增 GcLog(双语、按天滚动)+ RuntimeLayout(建目录、同步守护进程、写启动记录)。
  • 启动器 / 后端 / SAVEDOG 共用同一组日志文件;SAVEDOG 通过 GcLog 链接复用同一实现,每条日志都提供中英两份文案。
  • SavedogLauncher.Find 优先 .GC/safedog,其次安装目录与包内 safedog/。
  • 包名 GCL-<版本>-<平台>:LauncherArtifacts、LauncherUpdater、Applier 的主程序正则、版本清洗都同步;旧 GC- 包仍识别,可从老版本升级。
  • 构建脚本:pack_launcher 先生成 GCL-<版本>-<平台>/ 目录再压缩,守护进程移入 safedog/。

验证

  • ./build.sh build:win-amd64 70MB / win-arm64 68MB / linux-amd64 65MB,命名全部 GCL-。
  • 解压 Linux 包实跑:.GC/safedog/GC-SAVEDOG、.GC/logs/gc-20261118.log、.GC/logs/gc-20261118.en.log 均生成,两份日志内容对应。
  • GC.Tests --update-test:自动更新链路全部通过(含 GCL 包名、旧 GC 包升级)。
  • flutter analyze / flutter test:无改动,仍全绿。

兼容性

  • 1.0.9 及更早的客户端只认 GC- 包;本次改名后老客户端下载新包会按旧名找不到,因此建议合并后发 1.0.10,并由 1.0.10 起使用 GCL- 命名。
  • 本 PR 未改版本号。
## 目标 1. 压缩包内**只有 GC 本体**(一个顶层目录),不再是一屏散落的 dll; 2. 启动后 `.GC` 里有 `safedog/` 与 `logs/`; 3. 日志中英双版本; 4. 产物统一 `GCL-` 前缀。 ## 包结构(构建产物实测) ``` GCL-1.0.9-win-amd64.zip └── GCL-1.0.9-win-amd64/ ├── GCL-1.0.9-win-amd64.exe 启动器 ├── GC-UI.exe Flutter 前端 ├── flutter_windows.dll ├── data/flutter_assets/ ├── GC.UI.Server.exe 后端 └── safedog/GC-SAVEDOG.exe ``` zip 顶层只有一个目录;`unzip -l` 可见所有条目都在 `GCL-…/` 下。 ## 运行目录(首次启动后) ``` GCL-1.0.9-linux-amd64/ GCL-1.0.9-linux-amd64 .GC/ config/ model/ cache/ update/ safedog/GC-SAVEDOG ← 从包内复制;整目录更新永远不碰它 logs/gc-20261118.log ← 中文 logs/gc-20261118.en.log ← English ``` ## 实现要点 - `AppPaths`:新增 `LogsRoot`、`SafedogRoot`,`EnsureCreated` 一并创建。 - 新增 `GcLog`(双语、按天滚动)+ `RuntimeLayout`(建目录、同步守护进程、写启动记录)。 - 启动器 / 后端 / SAVEDOG 共用同一组日志文件;SAVEDOG 通过 `GcLog` 链接复用同一实现,每条日志都提供中英两份文案。 - `SavedogLauncher.Find` 优先 `.GC/safedog`,其次安装目录与包内 `safedog/`。 - 包名 `GCL-<版本>-<平台>`:`LauncherArtifacts`、`LauncherUpdater`、`Applier` 的主程序正则、版本清洗都同步;旧 `GC-` 包仍识别,可从老版本升级。 - 构建脚本:`pack_launcher` 先生成 `GCL-<版本>-<平台>/` 目录再压缩,守护进程移入 `safedog/`。 ## 验证 - `./build.sh build`:win-amd64 70MB / win-arm64 68MB / linux-amd64 65MB,命名全部 `GCL-`。 - 解压 Linux 包实跑:`.GC/safedog/GC-SAVEDOG`、`.GC/logs/gc-20261118.log`、`.GC/logs/gc-20261118.en.log` 均生成,两份日志内容对应。 - `GC.Tests --update-test`:自动更新链路全部通过(含 GCL 包名、旧 GC 包升级)。 - `flutter analyze` / `flutter test`:无改动,仍全绿。 ## 兼容性 - 1.0.9 及更早的客户端只认 `GC-` 包;本次改名后**老客户端下载新包会按旧名找不到**,因此建议合并后发 1.0.10,并由 1.0.10 起使用 `GCL-` 命名。 - 本 PR 未改版本号。
Morris added 1 commit 2026-11-18 20:27:18 +08:00
发布包改为 GCL 单目录布局,.GC 增加 safedog 与中英双语日志
PR 审核 / 后端编译 (pull_request) Canceled after 0s
PR 审核 / 后端自检 (pull_request) Canceled after 0s
PR 审核 / 前端检查(Flutter) (pull_request) Canceled after 0s
PR 审核 / 安全扫描 (pull_request) Canceled after 0s
PR 审核 / 审核汇总 (pull_request) Canceled after 0s
31b0c93b25
包结构
- 压缩包内只有一个顶层目录 GCL-<版本>-<平台>/,解压后不再散落一屏 dll
- 启动器改名为 GCL-<版本>-<平台>(.exe),Flutter 前端与后端仍在同一目录
- 守护进程移入包内 safedog/,运行时复制到 .GC/safedog

运行目录
- .GC 新增 safedog/:实际运行守护进程,整目录替换永远不会覆盖正在运行的它
- .GC 新增 logs/:按天写 gc-YYYYMMDD.log(中文)与 gc-YYYYMMDD.en.log(英文)
- 启动器、后端、SAVEDOG 共用同一组日志文件,整条启动/更新链路可一起排查

更新链路
- 包名/目录统一 GCL- 前缀,同时兼容旧 GC- 包(可从旧版本升级)
- 更新包解压后展平单顶层目录,仍按整目录替换安装
- Linux 无扩展名启动器仍可识别,兼容脚本清理旧版时覆盖 GCL-*

验证
- ./build.sh build 通过,产物 GCL-1.0.9-{win-amd64,win-arm64,linux-amd64}.zip
- 实跑 Linux 包:.GC/safedog/GC-SAVEDOG 与 .GC/logs/gc-20261118[.en].log 均生成
- GC.Tests --update-test 全部通过
Morris merged commit 097bfd198e into main 2026-11-18 20:27:28 +08:00
Author
Owner

此PR由 DeepSeek 生成

此PR由 DeepSeek 生成
Morris deleted branch feat/gcl-package-layout 2026-11-18 22:47:49 +08:00
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#11