修复 Windows AGC 构建节点的 Godot 原生扩展工具链

- AGC_WINDOWS_PATH 增加 Build Tools 自带 CMake 与 Python 3.12 目录，阶段 PATH 不再漏掉 Godot 原生扩展所需工具 - Toolchain preflight 校验 CMake 3.25 及以上、Python 3 和 Visual Studio 17 2022 生成器，缺失时在构建前失败关闭 - 同步 Godot 编辑器插件接入文档与共享记忆排障记录
2026-09-21 06:41:03 +08:00
parent 4b788fa73a
commit 6dadd76c1b
3 changed files with 26 additions and 3 deletions
@@ -1,5 +1,9 @@
 # 踩坑与排障记录

+## Jenkins Windows 节点的 PATH 白名单决定 Godot 原生扩展能否构建
+
+`Genarrative-Agc-Windows-Build` 在阶段里用 `AGC_WINDOWS_PATH` 整体替换 PATH、不继承节点机器的 PATH，所以 Godot C++ 引导需要的 CMake 与 Python 必须显式写进这份白名单，装在机器 PATH 上并不生效。2026-09-21 的 #97–#99 连续失败都停在 `Get-Command cmake.exe`（#93–#96 是更早的手写 C ABI 在 MSVC C 模式下的对齐问题）：节点只有 Visual Studio Build Tools（`C:\BuildTools`）自带的 CMake 3.31，缺 Python 3。修复后白名单包含 `C:\BuildTools\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin`、`C:\Python312`、`C:\Python312\Scripts`，preflight 校验 CMake ≥3.25、Python 3 和 Visual Studio 17 2022 生成器；把 `cmake.exe` 单独复制到别的目录会丢掉 `share/cmake-*/Modules`，不能替代加入安装目录。
+
 ## Tauri `--no-sign` 会连带跳过 updater 签名

 AGC macOS 发布入口一度传入 `--no-sign`（目的是绕过没有 Apple 证书的代码签名），结果 Tauri 打印 `Warn Updater signing is skipped due to --no-sign flag.`，产物只有 `*.app.tar.gz` 而没有 `.sig`，发布入口按设计在「缺少更新包签名」处失败关闭（2026-09-20 首次 Jenkins 实跑命中）。正确做法是不传 `--no-sign`，改为剥离 `APPLE_*` 凭据让 Tauri 跳过 Apple 签名——minisign 更新包签名与 Apple 代码签名这两个开关在 Tauri 里并不独立。Apple 签名状态要按 `codesign -dv` 实测记录，不能硬编码。