docs(CI): 修 run 46 暴露的 doc-links 违规,并更正「CI 工作区跨 run 复用」错话
CI / L0 静态门禁 (pre-commit) (push) Successful in 5m8s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 2m15s

run 46(你推的 dc5d6a0):L0.5 = Success,40 runner、3188/3188 断言、fail=0;
L0 = 47 Passed / 1 Failed / 2 Skipped —— A 方案确实生效:`ui-golden` 在 CI 里第一次
真编模拟器、真比像素,菜单 8 状态 + 内容页 40 页全过转绿(SYSTEM 命中机器级
`DTU_SDL2_DIR`)。你补跑的 -SetEnv 顺带把 `DTU_MS_COVERAGE` 也钉上了,两个变量成对。

剩下那 1 根红是我自己造的:新加的症状行里写了 gitignored 的构建产物路径,本机
存在、干净检出不存在,于是 `doc-links`「本地过、CI 挂」——正是本文 §4.1.2 记的那
一坑,我一边写它一边踩了它。修法按工具给的提示走(不把不入库的运行时路径当
引用写)。验证没有用本地:在一份**从未构建过模拟器**的干净克隆里先复现(1 处
问题、同一行),再验证修完(0 问题、RC=0),那才是 CI 的处境。

撤回两句错话:我先前写「毒缓存会跨 run 存活」「`-ffd` 是因为 runner 工作区跨运行
复用被忽略文件」——对 CI 都不成立。实测 run 44 / 45 / 46 的 L0 工作区目录哈希互不
相同,**每个 job 一个全新目录**,各付 137~161 s 全量拉取(612 s 的 run 里约 5.4 分钟
是两次拉取)。自愈检查仍然必要,但真正的暴露面是**同一个 job 内**(`ui-golden` 与
板端导航自检共用同一份构建目录,前者中断会毒到后者)以及本机日常开发。§4.5、
§5.3 的 `-ffd` 依据、§7 行与 `ci.yml` 注释四处同步改成实测口径;变更记录按规矩不动
历史行,只在上方加更正行。

自查:两个 job 的检出正文仍逐字一致(7147 字符)、run 块非 ASCII 计数 0、`uses:` 0;
本地暂存钩子 HOOKS_RC=0;干净克隆里 `doc-links` 0 问题、`check_ids` 不可判定 1166 =
上限(未增)。预期这一笔推上去 L0 归零失败——那是自 run 23(10-12)以来第一次
两个 job 全绿。
This commit is contained in:
2026-10-27 17:52:53 +08:00
parent dc5d6a0680
commit 529c58da39
4 changed files with 25 additions and 12 deletions
+1
View File
@@ -85,6 +85,7 @@
## 变更记录
| 日期 | 变更 |
| 2026-10-27 | run 46:`ui-golden` 转绿(`DTU_SDL2_DIR` 生效)。新的 1 根红是我自己写的 `doc-links` 违规(把 gitignored 构建产物当引用),§4.1.2 同族,已修;并更正「CI 工作区跨 run 复用」的错话——实测每 job 全新目录、每次 137~161 s 全量拉取,毒缓存只在同一 job 内与本机流传(指南 §4.5/§5.3/§7 与 `ci.yml` 注释同步) |
|---|---|
| 2026-10-27 | run 44(推送到已存在分支会正常建 run)暴露的教训写进指南 §5.3:run: 块是被**点源**执行的,`$ErrorActionPreference` 继承 Stop 时原生 stderr 会终止整步;且测 run: 块只能用 `-Command ". 文件"`(`-File` 包点源会把失败测成 rc=0)。§7 补「几秒就亡」一行,skill §10 补测法 |
| 2026-10-27 | run 45 首次真跑门禁(L0 46 根绿、L0.5 3188/3188);唯一红 `ui-golden` 定性为 **runner 缺环境**:SDL2 SDK 不入库。新增指南 §4.5:机器级 `DTU_SDL2_DIR` + CMake 配置期硬校验 + `Find-Sdl2Sdk` + `build_sim.ps1` 毒缓存自愈;§4.1.3 变量表补到 5 个、§5.5 与 §7 各补一处;顺带更正 lvgl-simulator skill 的「SDL2 已内置」说法 |