WebUI 更新失败：GitExecutable 指向的 .venv/bin/git 无法执行 git fetch（remote-https helper 缺失）

[z1131392774]

在提问之前...

• 我已经搜索了现有的 issues
• 我在提问题之前至少花费了 5 分钟来思考和准备
• 我已经阅读了 Wiki 中的 常见问题(FAQ)
• 我正在使用最新版的 AzurPilot

描述你的问题

在 WebUI 中点击更新后更新失败，报 UPDATE FAILED。根因是 config/deploy.yaml 中 GitExecutable: ./.venv/bin/git 指向的 git 二进制无法执行 git fetch（HTTPS），导致更新流程第一步就失败。

.venv/bin/git 是在 Red Hat 系系统上编译的，内部硬编码了路径：

• --exec-path 为 //libexec/git-core（本机不存在该目录），因此找不到 git-remote-https helper，报 fatal: remote helper 'https' aborted session
• SSL 证书路径写死为 /etc/pki/tls/certs/ca-bundle.crt（在 Debian/Ubuntu 系系统中实际为 /etc/ssl/certs/ca-certificates.crt），证书加载失败

git fetch 失败后，更新流程回退到从 CDN 下载增量包，但增量包 URL 全部返回 404（Failed to download pack, status=404），最终整体更新失败。

如何复现

1. 在 Linux（Debian/Ubuntu 系）环境安装 AzurPilot
2. 保持默认 GitExecutable: ./.venv/bin/git 配置
3. 在 WebUI 点击更新
4. 更新失败

预期行为

更新应正常完成。改用系统 git（/usr/bin/git）后 git fetch 成功，问题即可解决。

相关 Logs

2026-08-09 10:15:52.057 | INFO | "/home/zzj/AzurLaneAutoScript/.venv/bin/git" -c http.userAgent=git/2.41.3.windows.4.5515 fetch origin master
2026-08-09 10:15:52.080 | INFO | [ failure ], error_code: 32768
2026-08-09 10:15:52.092 | INFO | Last command: "/home/zzj/AzurLaneAutoScript/.venv/bin/git" -c http.userAgent=git/2.41.3.windows.4.5515 fetch origin master
2026-08-09 10:15:52.096 | INFO | Please check your deploy settings in config/deploy.yaml and re-open AzurPilot.exe

2026-08-09 10:16:04.175 | ERROR | Failed to download pack, status=404, text=
2026-08-09 10:16:04.177 | INFO | Fetch url: https://ap-update-cdn-cloudflare-a2.haiteluo.com/e5da8f786b4e4c56705d9e46a5b23a7e3ff3ceb5/3504e86417c8205dfb756e3a6503079300b0423f.zip
2026-08-09 10:16:04.446 | ERROR | Failed to download pack, status=404, text=
（所有 CDN 镜像均返回 404）

复现命令：

$ ./.venv/bin/git fetch origin master
git：'remote-https' 不是一个 git 命令
fatal: remote helper 'https' aborted session

$ GIT_EXEC_PATH=./.venv/libexec/git-core ./.venv/bin/git fetch origin master
fatal: unable to access 'https://...': error setting certificate file: /etc/pki/tls/certs/ca-bundle.crt

截图

无截图。

还有别的吗？

环境信息：

• 系统：Ubuntu 24.04.4 LTS (x86_64)
• 版本：commit 3504e86（更新目标 e5da8f7）
• config/deploy.yaml：GitExecutable: ./.venv/bin/git，Repository 被更新流程自动改写为 https://gitcode.com/ddl2/AzurLaneAutoScript

建议修复方向：

1. Linux 平台 GitExecutable 默认值不应使用 .venv/bin/git（module/config/config_updater.py:569/575/581 中 aidlux/docker/linux 模板都写死了 ./.venv/bin/git），应改用系统 git 或随包编译的 git
2. 更新流程中 git fetch 失败后回退 CDN 增量包应能处理 remote-https 缺失的情况