fix: 修复模型检测/自动下载与启动器更新 #25

Merged
Morris merged 1 commits from fix/model-source-and-updater into main 2026-11-19 13:48:50 +08:00
Owner

背景

修复用户报告的四个下载相关症状(下载页检测不到模型 / 加载不到 / 无法下载 / 没有自动下载)以及「无法更新启动器」。逐一实测定位到三个独立根因。

根因与修复

1. 无 git 环境检测不到模型(GC-DOWNLOAD/ModelSourceClient.cs)

ArchiveCandidates 对自托管 Gitea 源(git.xhmcl.com)不匹配 github/gitlab/gitee 任何分支,落到 yield break,不产生任何 zip 候选。于是模型检测只剩「系统 git clone」一条路:用户机器没装 git 时 FetchAsync 返回 dl.error.unreachable,下载页就显示空列表、无法下载、也无法自动更新。

修复:为自托管 Gitea 生成 archive/<branch>.zip 归档地址(实测 https://git.xhmcl.com/Morris/GC/archive/main.zip 可用),下载走已有的 ResumableDownloader,不再依赖系统 git。git clone 仍作为兜底保留。

验证:用「必失败的假 git」跑 FetchAsync,仍成功检测到全部 5 个模型。

2. 无法更新启动器(GC-DOWNLOAD/LauncherUpdater.cs)

HashZipPayloadAsync 只在发布包里找 GC.dll / GC / GC*.dll。但产物自 1.0.10 起改为 GCL-<版本>-<平台> 单文件(zip 内主程序是 GCL-1.1.0-win-amd64.exe 之类),旧逻辑永远找不到 → sha256 无法比对 → 「版本相同按最新处理」,同版本自行编译的构建不会被提示更新。

修复:优先匹配 GCL- 开头的主程序(排除 GC-UI、GC-SAVEDOG、.GC/ 下的附属文件),找不到再退回旧 GC 命名,兼容历史发布包。

验证:更新检查日志从「版本相同但无法比对 sha256」变为能算出「远端包 sha256 = AB38AA…」。

3. 没有自动下载模型(version.json / model/version.json)

5 个模型的 manifestSha256 与仓库里实际的 <id>.json 不符(发布时 updatedAt 漂移导致清单记录的 hash 过期)。模型自动更新下载后按签名清单里的 hash 复算,一律「清单哈希不符」被丢弃 → 表现为「没有自动下载」。

修复:按当前模型 json 的实际 sha256 修正 5 个 manifestSha256,用 gc-2026-12 重新签名,根清单与 model/version.json 保持一致。不改模型定义、不改 launcher 包 sha256/size、不改版本号。

验证

  • dotnet build GC.sln -c Release:0 warning / 0 error
  • GC.Savedog.Tests、GC.Tests:全部通过
  • 无 git(假 git)端到端:5/5 模型可检测
  • 发布包 sha256 比对:能正常算出远端包 hash
  • 两份清单 re-sign 后 verify 均为 Verified(gc-2026-12)
  • 模型 json 实际 sha256 与修正后的清单逐项对齐(5/5)

注意

  • 纯修复,不改版本号,不删除任何 Release / tag / 资产。
  • 清单 hash 修正需在合并后随下次发布生效(客户端读的是远端仓库的 version.json)。
## 背景 修复用户报告的四个下载相关症状(下载页检测不到模型 / 加载不到 / 无法下载 / 没有自动下载)以及「无法更新启动器」。逐一实测定位到三个独立根因。 ## 根因与修复 ### 1. 无 git 环境检测不到模型(`GC-DOWNLOAD/ModelSourceClient.cs`) `ArchiveCandidates` 对自托管 Gitea 源(`git.xhmcl.com`)不匹配 github/gitlab/gitee 任何分支,落到 `yield break`,**不产生任何 zip 候选**。于是模型检测只剩「系统 git clone」一条路:用户机器没装 git 时 `FetchAsync` 返回 `dl.error.unreachable`,下载页就显示空列表、无法下载、也无法自动更新。 修复:为自托管 Gitea 生成 `archive/<branch>.zip` 归档地址(实测 `https://git.xhmcl.com/Morris/GC/archive/main.zip` 可用),下载走已有的 `ResumableDownloader`,**不再依赖系统 git**。git clone 仍作为兜底保留。 验证:用「必失败的假 git」跑 `FetchAsync`,仍成功检测到全部 5 个模型。 ### 2. 无法更新启动器(`GC-DOWNLOAD/LauncherUpdater.cs`) `HashZipPayloadAsync` 只在发布包里找 `GC.dll` / `GC` / `GC*.dll`。但产物自 1.0.10 起改为 **GCL-`<版本>`-`<平台>` 单文件**(zip 内主程序是 `GCL-1.1.0-win-amd64.exe` 之类),旧逻辑永远找不到 → sha256 无法比对 → 「版本相同按最新处理」,同版本自行编译的构建不会被提示更新。 修复:优先匹配 `GCL-` 开头的主程序(排除 `GC-UI`、`GC-SAVEDOG`、`.GC/` 下的附属文件),找不到再退回旧 `GC` 命名,兼容历史发布包。 验证:更新检查日志从「版本相同但无法比对 sha256」变为能算出「远端包 sha256 = AB38AA…」。 ### 3. 没有自动下载模型(`version.json` / `model/version.json`) 5 个模型的 `manifestSha256` 与仓库里实际的 `<id>.json` 不符(发布时 `updatedAt` 漂移导致清单记录的 hash 过期)。模型自动更新下载后按签名清单里的 hash 复算,一律「清单哈希不符」被丢弃 → 表现为「没有自动下载」。 修复:按当前模型 json 的实际 sha256 修正 5 个 `manifestSha256`,用 `gc-2026-12` 重新签名,根清单与 `model/version.json` 保持一致。**不改模型定义、不改 launcher 包 sha256/size、不改版本号**。 ## 验证 - `dotnet build GC.sln -c Release`:0 warning / 0 error - `GC.Savedog.Tests`、`GC.Tests`:全部通过 - 无 git(假 git)端到端:5/5 模型可检测 - 发布包 sha256 比对:能正常算出远端包 hash - 两份清单 re-sign 后 `verify` 均为 `Verified`(gc-2026-12) - 模型 json 实际 sha256 与修正后的清单逐项对齐(5/5) ## 注意 - 纯修复,不改版本号,不删除任何 Release / tag / 资产。 - 清单 hash 修正需在合并后随下次发布生效(客户端读的是远端仓库的 version.json)。
Morris added 1 commit 2026-11-19 13:18:44 +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
023e9468db
- ModelSourceClient: 自托管 Gitea 源(git.xhmcl.com)ArchiveCandidates 之前
  直接 yield break,只能靠系统 git clone。没装 git 的机器「检测模型/下载/
  自动更新」全部失效。补上 archive/<branch>.zip 归档地址(已实测可用),
  下载经 ResumableDownloader 完成,无需系统 git。fake-git 实测 5/5 模型可检测。
- LauncherUpdater.HashZipPayloadAsync: 只找 GC.dll/GC/GC*.dll,但产物自 1.0.10
  起是 GCL-<版本>-<平台> 单文件,找不到主程序 -> sha256 无法比对 -> 不提示更新。
  改为优先匹配 GCL- 主程序(排除 GC-UI/GC-SAVEDOG/.GC),兼容旧 GC 命名。
  实测已从「无法比对 sha256」变为能算出远端包 sha256。
- version.json / model/version.json: 5 个模型的 manifestSha256 与仓库实际模型
  json 不符(发布时 updatedAt 漂移导致),使模型自动更新每次因校验失败被丢弃
  (「没有自动下载」)。按当前模型 json 实际 sha256 修正并重新签名(gc-2026-12),
  两份清单保持一致;launcher 包 sha256/size 与版本号不动。
Morris merged commit 2cd18b4e5f into main 2026-11-19 13:48:50 +08:00
Morris deleted branch fix/model-source-and-updater 2026-11-19 13:48:55 +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#25