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