wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity
672 Commits 3 Branches 0 Tags
529c58da392f00286fcf68a7a375fe8edd6c526a
Commit Graph

7 Commits

Author SHA1 Message Date
wandering1 dc5d6a0680 fix(ci): ui-golden 需要机器级 SDL2 SDK——补 DTU_SDL2_DIR、配置期护栏与 build 缓存自愈
CI / L0 静态门禁 (pre-commit) (push) Failing after 7m4s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 3m6s
Details
2026-10-27 17:32:35 +08:00
wandering1 2d18193d38 fix(ci): 去掉 actions/checkout 外网依赖，MSVC 探测改 vswhere 并钉住工具集世代 
两个 job 的第 1 步原先是 `uses: actions/checkout@v4`。`uses:` 的解析发生在
Prepare all required actions 阶段——先于任何步骤、无条件联网（默认 github.com），
且每个 job 各自解析进自己的 .cache/act/<hash>、跨 job 不复用。这条链在本机实测
不稳：run 36（10-21）/ 41（10-25）/ 42（10-26）三次都是 ~45 s 后整 job 死亡、
零钩子输出，而同一分钟手工 curl 同一地址返回 200——手工可达 ≠ CI 可用（解析器
跑在 SYSTEM 下）。Gitea 1.25.4 又去掉了自定义 DEFAULT_ACTIONS_URL，服务端没有
可拧的键，唯一归本仓库管的修法就是不再依赖它：两个 job 第 1 步换成原生 git 全量检出。

关键选择（依据与实测表见 docs/CI/远程CI完整指南.md 同文 §5.3，此处只记结论）：
- 完整 refspec + 全量，不是 --depth 1：提交信息门禁要解 base..head 的 range；
  且目标 sha 不在历史里就 ::error:: 硬失败，绝不默默构建一棵错的树；
- clean -ffd 而非 -ffdx：-x 会删被忽略文件，而 runner 工作区跨运行复用它们；
- GIT_TERMINAL_PROMPT=0 + 空 credential.helper：否则认证挑战会等人类输入，
  把 30 分钟 job 超时白烧掉，表现得像 CI 挂了；
- 令牌只走 per-invocation -c http.extraheader（Basic + x-access-token，与
  checkout@v4 同拼法），不落 .git/config、不回显；仓库公开时匿名即可；
- 不抓 tag：本仓库 tag 数 0、无脚本用 describe --tags（实测）。

另修 scripts/ci_runner_bootstrap.ps1 的 Find-MsvcCl。旧版只扫 %ProgramFiles%
派生根且取首个命中：本机 C 盘 VS2019 已于今日 01:00 卸载（C 盘 x64 cl.exe 实测
0 个），旧版因此是「找不到 → 只 Warn → 不写」，机器级变量一直指着那条失效路径，
而 harness 对「显式设置但无效」是硬失败、不做自动回退。现在改为 vswhere 取实例
（能看见非默认盘）+ 工具集版本降序 + -MsvcToolset 前缀钉住世代（默认 14.51.，
与覆盖率基线同版本；钉不上连 WARN 再回落最新，绝不静默）+ -MsvcLatest；
-SetEnv 与 -Status 同步纳入 DTU_MS_COVERAGE。

验证（内层一律 powershell.exe 5.1，忠实复现 runner 执行方式）：临时工作区六项
A/B/C/D/E/F——E 是执行**从 ci.yml 里抽出的正文**，测的就是文件那份字节。
A rc=0、commits=665、refspec 完整、分离 HEAD；B 复用工作区后 dirty_files=0、
被忽略文件保留、17ece86..HEAD 解出 18 个提交；C rc=1 且 HEAD 不动；D 坏令牌
fatal: unable to get password 秒失败；令牌改造后再跑 ANON/BOGUS/ANON2=0/1/0。
ci_local 全量：L0.5 = 40 runner、3188/3188 断言、fail=0（MSVC 14.51）；
test-coverage 与 ui-golden 均 Passed。.ps1 非 ASCII 字节 0、语法错误 0、无 BOM、
LF；ci.yml 无 BOM 无 CR、13 步、0 个 run 块含非 ASCII、uses: 计数 0。
 2026-10-27 08:00:14 +08:00
wandering1 3557b60ceb CI runner 修日志噪声与 -Status 假警：PS5.1 把原生 stderr 包成 ErrorRecord 
双看门狗缺陷已实测收敛：管理员 -StartNow 清掉 3 个残留（孤儿看门狗 26900/19716 +
占锁 daemon 53848）→ "daemon up: pid 40360 (single instance)"，监管链恢复为
svchost(任务) → 看门狗 → daemon，看门狗日志 25 秒零增长，runner 回 online。
切换瞬间新看门狗先失败 1~2 次（旧 daemon 刚死、锁未释放）后自愈，属预期。

顺带查出并修掉两个由验证动作暴露的问题：

1) 日志噪声：daemon 把日志写到 stderr，PS 5.1 的 2>&1 会把每行原生 stderr 包成
   ErrorRecord，Out-File 渲染出 "gitea-runner.exe : " 前缀 + 4 行 CategoryInfo 块。
   实测对比（用无效子命令产生真实 stderr）：& exe 2>&1 | Out-File 把 2 行真日志写成
   8 行——每 4 行有 3 行是 PowerShell 噪声，而且就在文档让大家第一个打开的文件里。
   改为 2>&1 | ForEach-Object { "$_" } | Out-File -Encoding utf8：实测与 cmd 包装等价
   但不用操心 cmd 对含空格路径的引号剥离，ErrorRecord.ToString() 即原始行，
   $LASTEXITCODE 不受影响（看门狗靠它打印退出码）。§7.2 方式 B 的示例原本正是
   "> log 2>&1"（UTF-16LE + ErrorRecord 双坑），已改；新增 §7.3 汇总这两条陷阱。

2) -Status 两处不诚实：① 非管理员读不到 SYSTEM 进程的 CommandLine（返回 null），
   过滤器静默匹配 0 个 → 会谎报"没有看门狗"（今天两次被这个假象误导），改为明说
   "需提权"；② 重启循环判据原本靠"日志尾部 40 行里有没有 lock 字样"，而日志不轮转，
   修好之后旧失败仍留在尾部 → 对健康 runner 报假警。改看 daemon 进程存活时长
   （活过 10 秒重拉间隔就不可能在循环里）；用 CIM CreationDate，因为
   Process.StartTime 对 SYSTEM 进程不可读。

验证：bootstrap parse 0 错 / 纯 ASCII / -Status 与 -DryRun 均正常；
check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项全 Passed。

注：磁盘上的 run_runner_watchdog.ps1 仍是旧模板，噪声修复要下次管理员 -StartNow
（或开机自启）时才生效，纯观感问题，不必专门再重启一次 runner。
 2026-10-12 17:59:45 +08:00
wandering1 49f3e2dac5 CI runner 修"双看门狗抢 .runner.lock"：-StartNow 先清残留进程再启动 
实测发现（比文档问题更要紧）：runner 网页 online、-Status 说 daemon 在跑，
但 runner-watchdog.log 每 10 秒刷 "starting daemon → daemon exited, exit code 1"，
daemon 日志写 "another gitea-runner process is already using .runner" /
"runner file is already locked by another process"。

根因：Unregister-ScheduledTask 不会带走旧实例启动的进程。13:22 重跑 bootstrap 时，
12:53 起的旧看门狗成为孤儿并继续养着旧 daemon，旧 daemon 占住 .runner.lock，
新注册任务启动的看门狗永远抢不到锁。online 是旧 daemon 在硬撑——任务实际谁也没管，
日志还在以约 20 MB/天 增长。

- ci_runner_bootstrap.ps1：-StartNow 新增 Stop-StaleRunnerInstances，先停孤儿看门狗
  再停残留 daemon（顺序不能反：只杀 daemon 会被活着的看门狗 10 秒内重拉），启动后
  等 12 秒回显单实例确认；-Status 新增重复实例计数 + daemon 日志锁冲突检测
- 指南 §3.4 补注销不停进程的说明与"纯注释改动不需重启任务"；§7 排障表加
  "online 却每 10 秒重启"一行（含手工应急命令）
- §3.2 / README：deploy_runner_task.ps1 与 run_runner.cmd 状态由"仍在磁盘、建议删除"
  改为"已删除"；README 补重跑部署前的锁冲突警示

机器侧同步（不在版本库）：config.yaml 头部"常驻改用 sc.exe / New-Service"是 §3.0
已证伪的错误指引，改为看门狗口径并指向本文——改后 YAML 可解析且所有配置值逐项与
改前一致（只动注释）；删除两个废弃脚本前核实计划任务动作目标是
run_runner_watchdog.ps1，删除不影响在跑 runner；check_env.ps1 指向废弃脚本的提示
改指 bootstrap（带 BOM 文件，改后 BOM 完好、语法 0 错）。

验证：pre-commit run --all-files 17 项全 Passed；bootstrap parse 0 错、纯 ASCII、
-DryRun 正常。当前 runner 仍 online（旧 daemon 硬撑），彻底归一需管理员跑一次
-StartNow 清残留。
 2026-10-12 17:37:19 +08:00
wandering1 e6bcad86cb 修看门狗日志编码：*>> 在 PS5.1 默认写 UTF-16LE，污染同一个日志文件 
现场（2026-10-12 注册计划任务后实测）：runner-stdout.log 尾部按 UTF-8 读出来
是 "t i m e =   2 0 2 6 - 1 0 - 1 2 ..."，即每个字节后面跟一个 NUL。

根因正是我自己刚写进文档的那条坑：PS 5.1 的 *>> 重定向由 Out-File 实现，而
Out-File 的默认编码是 UTF-16LE。同一个文件里 Log() 用 Add-Content -Encoding
ascii 写 ASCII 行、daemon 输出却以 UTF-16LE 追加，于是"一个文件两种编码"，
排障时按 UTF-8 读就是乱码——等于把唯一的 runner 现场日志弄成不可读。

- daemon 输出改到独立文件 runner-daemon.log，显式 Out-File -Encoding utf8
  （不用 ascii：提交标题与作业输出可能含非 ASCII，ascii 会打成问号）
- 看门狗自身日志改名 runner-watchdog.log，与 daemon 输出彻底分离
- 模板与生成物均校验通过：parseErrors=0、nonASCII=0
- 旧 runner-stdout.log 保留作历史，不再写入
 2026-10-12 13:21:06 +08:00
wandering1 0f0ea03ff4 修复bootstrap注册崩溃：StartWhenAvailable属任务设置而非触发器 
现场：用户以管理员跑 -SetEnv -StartNow 时脚本抛
SetValueInvocationException（触发器上没有 StartWhenAvailable 属性），
而它是在"已注销旧任务、尚未注册新任务"之间抛的，等于把 runner 任务删没了。

- StartWhenAvailable 改设到 settings（MSFT_TaskSettings 继承属性，
  CIM 属性列表里看不见但可直接赋值，实测 StartWhenAvailable=True）
- 任务对象改由 New-WatchdogTaskPlan 统一构建，先构建、后注销旧任务
- Register-ScheduledTask 失败时显式告警"旧任务已删、CI 裸奔"并 exit 1
- 新增 -DryRun：免管理员即可全量校验 action/trigger/settings
- -Status 增补上次运行时间与返回码，并提示"非管理员看不见任务"

同时更正根因：旧计划任务其实一直存在（非管理员会话看不见，先前误判为
"从未注册"），但它跑的是单次 run_runner.cmd——daemon 属"正常退出"而非
"失败"，计划任务的失败重启根本接不到，必须靠看门狗循环重拉。
 2026-10-12 12:52:27 +08:00
wandering1 20ee35b76a 修复CI门禁三因：runner掉线致12个job零日志、L0探测回归全灭、gitlint在CI从不执行 
1) runner 掉线：run 16~21 共 12 个 job 零日志。gitea-runner v4 的
   daemon 无服务支持、首次 Declare 失败即退出进程，Gitea/机器重启
   一次 CI 就静默停摆；叠加 cancel-in-progress 后症状是"任务凭空
   消失"。新增 scripts/ci_runner_bootstrap.ps1：等 Gitea 就绪 +
   崩溃自拉起看门狗 + 开机计划任务 + -SetEnv 写 MACHINE 级 DTU_*。
2) L0 自 33a4aa4 起在 runner 上必挂：Python 候选被收窄成 PATH python
   (msys64，无 pre-commit) + 仓库 .venv(gitignore)，cppcheck 目录兜底
   亦被删，而机器级 DTU_* 从未设置。探测收进 ci_find_python.ps1
   （两 job 共用、可离线自测、恢复机器级安装兜底）。
3) gitlint 声明 stages:[commit-msg]，而 --all-files 只跑 pre-commit
   stage → 17 个钩子定义 CI 只报 16 个且全绿。新增
   ci_gitlint_range.ps1 逐条校验本次范围，ci_local.py 增 L0b 段。
另：GITHUB_ENV/PATH/OUTPUT 写入显式 -Encoding ascii（PS 5.1 的
   Out-File -Append 默认 UTF-16LE，会把带 NUL 的行追加进 UTF-8 文件）
 2026-10-12 12:39:27 +08:00