fix: 发布一致性校验、日志轮转与构建脚本对齐 #23

Merged
Morris merged 2 commits from fix/build-consistency-and-tests into main 2026-11-19 06:46:01 +08:00
Owner

背景

项目审查后集中修复的一批可靠性 / 一致性问题,涵盖发布校验、日志、验签、测试与两套构建脚本的对齐。

改动内容

1. 发布一致性校验(新增)

  • buildsh/lib/verify_release.py:拉取 tag 上的 version.json,核对 launcher.version 是否等于 tag、比对清单里每个平台的 name/size/sha256 与 Release 资产、列出多余资产、对比本地清单,并支持把 tag 清单导出供验签。
  • buildsh/release.sh + build.sh release-verify:封装上述脚本并追加 GC-SAVEDOG verify 验签,支持 --skip-download、--dump-manifest。
  • .gitea/workflows/release-verify.yml:手动触发的发布核对工作流(workflow_dispatch)。

2. 日志模块重写(GcLog.cs)

  • 常驻 StreamWriter(AutoFlush)替代每行 open/append/close,消除下载 / 启动高峰期的文件句柄开销。
  • 按天轮转 + 14 天 / 64MB 保留策略,初始化与跨天时清理旧日志。
  • 只清理本模块生成的 gc-YYYYMMDD[.en].log,目录里其他文件一律不碰(有测试覆盖)。
  • 中英双文件、写日志失败绝不影响主流程的行为保持不变。

3. 验签逻辑修复(Applier.cs)

  • 无效签名(被篡改 / 未知密钥)永远拒绝;仅「未签名」在调用方 requireSignature=false(开发态、测试)时按调用方要求放行,不再一律当成验签失败拒掉。

4. 测试补强

  • 新增 GC.Savedog.Tests:整目录替换、.GC/bin 合并、启动失败回滚、路径穿越防护、验签放行/拒绝,共 13 项断言。因与启动器存在同名类型,单独成项目。
  • GC.Tests 增加日志用例(写入 / 轮转 / 清理 / 用户文件保护)。
  • pr-check.yml 接入应用器测试。

5. PowerShell 打包脚本对齐 buildsh(buildps1/)

  • 产物统一 GCL-<版本>-<平台> 命名,zip 内单顶层目录。
  • 守护进程收进 .GC/bin(macOS 为 .app/Contents/MacOS/.GC/bin),安装目录根只留 GC 本体。
  • 启动器与守护进程均发布为压缩单文件;不再预置 .GC 模板。
  • prune / strip 规则与 shell 版对齐;签名 keyId 由失效的 gc-2026-11 改为 gc-2026-12。
  • 新增 release-verify 与应用器测试任务入口。

验证

  • dotnet run GC.Savedog.Tests(-c Release):全部通过
  • dotnet run GC.Tests(-c Release):渲染 / 清单 / 日志用例全部通过
  • PowerShell 脚本经静态括号 / 引号配对检查(本机无 pwsh,CI Windows runner 可复验)

注意

  • 纯修复,不改版本号、不删任何 Release / tag / 资产。
## 背景 项目审查后集中修复的一批可靠性 / 一致性问题,涵盖发布校验、日志、验签、测试与两套构建脚本的对齐。 ## 改动内容 ### 1. 发布一致性校验(新增) - `buildsh/lib/verify_release.py`:拉取 tag 上的 `version.json`,核对 `launcher.version` 是否等于 tag、比对清单里每个平台的 `name/size/sha256` 与 Release 资产、列出多余资产、对比本地清单,并支持把 tag 清单导出供验签。 - `buildsh/release.sh` + `build.sh release-verify`:封装上述脚本并追加 `GC-SAVEDOG verify` 验签,支持 `--skip-download`、`--dump-manifest`。 - `.gitea/workflows/release-verify.yml`:手动触发的发布核对工作流(`workflow_dispatch`)。 ### 2. 日志模块重写(`GcLog.cs`) - 常驻 `StreamWriter`(AutoFlush)替代每行 open/append/close,消除下载 / 启动高峰期的文件句柄开销。 - 按天轮转 + 14 天 / 64MB 保留策略,初始化与跨天时清理旧日志。 - 只清理本模块生成的 `gc-YYYYMMDD[.en].log`,目录里其他文件一律不碰(有测试覆盖)。 - 中英双文件、写日志失败绝不影响主流程的行为保持不变。 ### 3. 验签逻辑修复(`Applier.cs`) - 无效签名(被篡改 / 未知密钥)永远拒绝;仅「未签名」在调用方 `requireSignature=false`(开发态、测试)时按调用方要求放行,不再一律当成验签失败拒掉。 ### 4. 测试补强 - 新增 `GC.Savedog.Tests`:整目录替换、`.GC/bin` 合并、启动失败回滚、路径穿越防护、验签放行/拒绝,共 13 项断言。因与启动器存在同名类型,单独成项目。 - `GC.Tests` 增加日志用例(写入 / 轮转 / 清理 / 用户文件保护)。 - `pr-check.yml` 接入应用器测试。 ### 5. PowerShell 打包脚本对齐 `buildsh`(`buildps1/`) - 产物统一 `GCL-<版本>-<平台>` 命名,zip 内单顶层目录。 - 守护进程收进 `.GC/bin`(macOS 为 `.app/Contents/MacOS/.GC/bin`),安装目录根只留 GC 本体。 - 启动器与守护进程均发布为压缩单文件;不再预置 `.GC` 模板。 - prune / strip 规则与 shell 版对齐;签名 keyId 由失效的 `gc-2026-11` 改为 `gc-2026-12`。 - 新增 `release-verify` 与应用器测试任务入口。 ## 验证 - `dotnet run GC.Savedog.Tests`(-c Release):全部通过 - `dotnet run GC.Tests`(-c Release):渲染 / 清单 / 日志用例全部通过 - PowerShell 脚本经静态括号 / 引号配对检查(本机无 pwsh,CI Windows runner 可复验) ## 注意 - 纯修复,不改版本号、不删任何 Release / tag / 资产。
Morris added 1 commit 2026-11-19 00:06:46 +08:00
fix: 发布一致性校验、日志轮转与构建脚本对齐
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
59a66c8fa8
- 新增发布校验脚本(buildsh/lib/verify_release.py + release.sh),核对 tag/清单/资产
  三者的 sha256 与体积,并复验清单签名;接入 ./build.sh release-verify 与
  .gitea/workflows/release-verify.yml(手动触发)
- GcLog 改为常驻 StreamWriter + 按天轮转 + 14 天/64MB 保留策略,避免高峰期反复
  开关文件句柄;只清理本模块生成的 gc-*.log,不碰用户文件
- 修复 Applier 验签逻辑:无效签名永远拒绝,仅「未签名」在调用方不强制时放行
- 新增应用器测试(GC.Savedog.Tests):整目录替换、.GC/bin 合并、启动失败回滚、
  路径穿越防护、验签;接入 pr-check.yml
- GC.Tests 增加日志用例(写入/轮转/清理/用户文件保护)
- 同步 PowerShell 打包脚本与 buildsh 一致:GCL 命名、单顶层目录、守护进程收进
  .GC/bin、启动器与守护进程压缩单文件、不预置 .GC、prune/strip 对齐、签名
  keyId 改为 gc-2026-12、新增 release-verify 与应用器测试任务
Morris added 1 commit 2026-11-19 00:19:34 +08:00
refactor(build): 末次签名去重、删死代码、zip 可复现
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
4bdfb49600
构建脚本对齐与清理(追加到发布校验 PR):
- 完整 build 只在打包末尾签一次清单(stamp_versions --no-sign +
  pack_launcher 末尾 stamp_launcher_only),去掉中间冗余签名。
  ECDSA 随机 nonce + signedAt 时间戳会让每次签名字节都不同,
  两次签名既浪费又让中间产物反复抖动;单独 stamp/models 工具签名行为不变。
- 删除死代码 publish_backend()(后端已进程内托管,无调用者)。
- 所有 zip 命令加 -X(去掉 extra fields),让相同内容的包字节一致。
- 修复 tools.sh 的 dist 命令文件名过滤 GC-*.zip -> GCL-*.zip。
- PowerShell 版同步上述末次签名改动。
Morris merged commit 9a911089bf into main 2026-11-19 06:46:01 +08:00
Morris deleted branch fix/build-consistency-and-tests 2026-11-19 06:58:34 +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#23