11 Commits

Author	SHA1	Message	Date
wandering1	dc5d6a0680	fix(ci): ui-golden 需要机器级 SDL2 SDK——补 DTU_SDL2_DIR、配置期护栏与 build 缓存自愈	2026-10-27 17:32:35 +08:00
wandering1	ae80bb8e34	fix(ci): run 块按点源语义加固——原生 stderr 变终止性错误曾致两 job 3 秒亡 ... run 44（本分支上一次推送）把上一版原生检出打回原形：L0 用了 3 s、L0.5 用了 2 s 双双失败，日志里是 error: No such remote 'origin' 被包成 NativeCommandError 后整步终止。根因在我上一版：runner 执行 run: 块的方式是 powershell -command 点源那个文件，会话继承的 $ErrorActionPreference 是 Stop，于是原生程序往 stderr 写的任意一行都会被 PS 5.1 包成终止性错误。我写的 git remote get-url origin 2>$null 正是这一类，而 2>$null 不算摊平，反而让它先把整步炸掉。 修法两件事一起做：块首显式 $ErrorActionPreference = Continue（不依赖继承）； 所有 git 调用走同一个漏斗 Invoke-DtuGit，把 stderr 摊平成字符串再决定是否打印。 探针顺手换成 git config --get remote.origin.url：远端不存在时它只返回非零码、 不往 stderr 写，从源头不再触发这类错误。 更阴的一条教训是我的测法本身。第一版复现器用 -File 包一层点源，结果四条失败 路径全测成 rc=0。用最小矩阵把语义钉死后：exit 1 写在被点源的文件里时，-File 直跑 = 1；-File 包一层点源 = 0 且继续执行后续语句；-Command 点源（runner 的真 实用法）= 1。也就是说只要我一直用 -File 测，检出失败也会一路伪装成绿，这个洞 比上面那个 bug 更坏。现在统一用 runner 的真实语义测：powershell -NoProfile -Command 点源块体文件，且前置 $ErrorActionPreference = Stop。 换测法后的实测（全部跑在从 ci.yml 抽出的那份字节上，不是另抄的副本）： - 点源 + Stop、全新工作区：ExitCode=0、checkout ok: c1e7e8c / commits=669、 dirty_files=0、150.9 s（修复前同一模式就是 run 44 的 3 秒亡）； - DTU_REPO_SHA 空 / DTU_REPO_URL 空 / sha 不在远端 / 坏令牌：ExitCode 均 1， 坏令牌 0.5 s 返回 unable to get password，不挂起、不烧 job 超时； - 复用工作区：1.6 s，dirty_files=0，被忽略文件保留，未跟踪垃圾清除； - 结构面：13 步、两 job 第 1 步逐字一致、uses: 计数 0、run 块非 ASCII 计数 0、 无 BOM 无 CR；check yaml Passed；check_doc_links --all 180 篇、无法判定 0。 文档同笔落地（教训要跟它救的那段代码一起进历史）：指南 §5.3 补 run 44 实录与 退出码矩阵、实测表补 G/H 两行、§7 补 job 几秒就亡一行、两份变更记录各加一行； remote-ci-ops skill §10 补 run: 块的正确测法。另记一个运维事实：推到已存在 的远端分支会正常建 run（run 44 即如此，推送后约 4 分钟入库，我先前把轮询窗口 取得太短误判成没建），以后验 workflow 不再需要手动 dispatch 与服务凭据。 下一轮可能红的两处我先标出来，红了正是我们要的证据：SYSTEM 下的 ui-golden （历史上败在 32 位 MSBuild 与 VCTargetsPath）与 test-coverage（缺 DTU_MS_COVERAGE，走自动发现）。	2026-10-27 12:52:56 +08:00
wandering1	51ecd36192	docs(CI): §5.3 重写并记录覆盖率工具链落地，更正 §1.2.1 与本会话先前的错判 ... 补上今天两件 CI 工作的落地记录，并把错误结论改对（历史行不动，只在上方加行）。 新增 §4.4「覆盖率工具链（mscoverage）与 VS2026 BuildTools」。为什么只能装： 那个 exe 没有免安装的独立发行版——实测 NuGet 两个候选包， Microsoft.Testing.Extensions.CodeCoverage 18.12.0 的 109 个条目里 .exe 数为 0， Microsoft.CodeCoverage 18.11.0 只有老版 CodeCoverage.exe（CLI 语法还不同）， 所以它只随 Visual Studio 本体分发。安装入口是 aka.ms/vs/18/stable/ vs_buildtools.exe（release 那条短链不存在，会掉到"未找到"页）；组件 ID Microsoft.VisualStudio.PackageGroup.TestTools.CodeCoverage 由 18.11 的 VisualStudio.vsman 解析得到（清单里唯一引用 DynamicCodeCoverage 与 CodeCoverage.Console.Targeted 的组）。含可直接粘贴的三条管理员命令、-Force 陷阱、Restart-Service Schedule 判据，以及「装在非默认盘 = 门禁与 CI 都看不见」 的成因：Find-MsvcCl 与 _default_vs_roots 都只由 %ProgramFiles% 派生根。 §5.3 整节重写：本仓库已移除 uses:，记录六项实测（A/B/C/D/E/F，其中 E 是执行 从 ci.yml 抽出的正文、测的就是文件里那份字节）与两条自查命令，并明标两条 **未证边界**：PR 的 refs/pull/<n>/merge 兜底在本实例无法证实（0 个 PR、 ls-remote 该命名空间为空）；Basic 令牌那一支本地验证不了（公开仓库匿名即过， 伪造令牌只能证明坏的会被拒）。旧版那段"可直接抄"的示例标为禁抄：shell: pwsh 在 runner 上 PATH 无 pwsh 会直接失败，--depth 1 让 base..head 报 unknown revision，两条都会让下一个照抄的人多红一轮。 更正两处过时/错误说法：① §1.2.1 表第三行——自定义 DEFAULT_ACTIONS_URL 在 1.25.4 已无可用取值，旧写法会把排障的人引向一个不存在的开关；② 我自己先前 写的「旧探测会把机器级变量覆回 C 盘 14.29」——本机实情是 C 盘 VS2019 已于 10-27 01:00 卸载（C 盘 x64 cl.exe 实测 0 个），旧探测的行为是「找不到 → 只 Warn → 不写」，于是变量一直指着失效路径。§7 的 checkout 行相应改为「看见此 症状＝有人把 uses: 加回来了」。 另：口径文档 §7 第 8 条加实测补注（「CI runner 与本机同一台」对量基线那台不 成立，本机当日 vswhere 只有 VS2019）；新增 remote-ci-ops skill 并接上 AGENTS 与 docs/CI/README 两处指针；指南与 README 各加变更记录。纯文档，按 workflow 的 paths-ignore 不触发 CI。	2026-10-27 08:01:40 +08:00
wandering1	0f7b5a87fb	chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打 ... 登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号） 一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、 采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。 门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏 undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8 reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF； id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。 test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字， 是本批唯一改变构建产物的文件集合。 为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged 部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、 不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。 实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01% （基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 / 告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。 基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处 引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使 识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。 ⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二 根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有）， 今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。 固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0； App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889 断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿； check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带 BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。 .cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法： Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。 同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%， RW_CCM 57,376 B / 87.9%，阈值 92%。	2026-10-26 12:28:14 +08:00
wandering1	13ef0715bb	docs(销项): 批 1 登记簿收口 + A-5 口径联动到三处门禁文档 ... 销项（登记簿删行 + 结论沉淀指针）： - 数据可信.md：卡 1~7 行删除，表下补销项记录（merge 231dc81/d39e5c9/ 59da40b）；§2.1 口径冲突注改 ✅ 已定死；§6 顺序图与失效预警改写为 "批1 已销项 + 批2 在途"现状；卡 0/0b/12 与 M4①⑤台架面保留待跑 - 测试与架构专项.md：未闭环一览删 S12 / A-5 两行；§1 标题 1 项→0 项， P1-10 剩余两条改已销项记录（5 档构建 + f3 PASS，数字正文在 test/board/ch395f_test.h）；§2.1 S12、§2.3 A-5 标题 ⬜→✅ 带落点 - README.md：一览删 P1 收步行；网络/结构/UI 行加 🟦批2 在途标记； 测试基础设施 5→3；数据可信行改"在途 7 卡"；验证常态两处删 P1-10/S12/A-5 口径联动（A-5 已落地，文档追平）： - CI 远程CI完整指南.md §0.0 整节重写（盲区→同码凭证强制 + 三项仍 守不住 + 变更记录行）；CI README 索引行同步 - 门禁说明/mem-numbers.md §1/§6、mem-budget.md §6 第 4 条：远端缺口 已由 check_size_gate.py 关闭，唯一正文 = 其 docstring	2026-10-25 08:36:44 +08:00
wandering1	ea10dbae53	修 gitlint 门禁在 CI 空转：runner 无 git 身份致 254 被误报成信息违规 ... task 31（首次真跑出的 L0）失败与提交信息无关：actions/checkout 把 HOME 指向每次任务的临时目录，SYSTEM 账号没有全局 git 身份，gitlint 在读到任何 规则之前就以 Missing git configuration: please set user.name 退出——254 是配置错误，不是规则违规。旧脚本还把失败原因写死成"标题超 100 字符"，加 上该步 exit 1，后面 26 个钩子一个都没跑。 改三处：① 先探测身份，缺失则用 GIT_CONFIG_COUNT/KEY/VALUE 注入一次性身 份，只进子进程环境、不写任何文件，开发者机器不受影响；② 254 与真实违规 分开报（2 = 门禁没跑起来，1 = 信息确实违规），不再替 gitlint 猜规则； ③ 钩子输出改走 ForEach-Object { "$_" }，避免 PS 5.1 把原生 stderr 包成 ErrorRecord 污染日志。 实测：空 HOME 下同一条命令改前 254、改后 0 failed；正常环境 10 条提交全 过；脚本纯 ASCII、解析 0 错。同批文档：§7 排障表新增本坑与"新建分支首 次 push 不触发 run"，两份变更记录各加一行。	2026-10-12 19:17:11 +08:00
wandering1	4bad54b607	merge: master 的远程 CI 修复带入 v2-on-ui（门禁数字改为分支中立） ... 把 master 上本轮 10 个 CI 相关提交合入 v2-on-ui，使该分支同样具备可用的 runner 保活与本地门禁自查能力。合并只涉及文档与脚本，零 C 代码改动。 冲突两处，均按"保留 v2-on-ui 新版结构 + 搬入语义"解决： - AGENTS.md：丢弃 master 侧已被瘦身版取代的旧门禁 bullet，保留其分层边界 行；把"CI 资料集中在 docs/CI/README.md、只跑本机一台 runner"这条指针 并入新版 CI bullet 与文末索引表。 - docs/README.md：两侧都是变更记录历史行，按日期先后并列保留。 数字口径改为分支中立：本分支 26 个钩子 / 10 个主机单测套件，master 是 18 / 3，写死任一数字都会让同一篇文档在另一分支上失真。指南 §6 验收第 8 行、§7 排障表、§10 验收标准改为讲规则（报告数 = 定义数 − 1；runner 数 = test/host 下 run_unit_test.py 个数）+ 分分支实测快照。 验证：@build 0 错误 0 警告；ci_local.py 全绿（L0 25 钩子 + L0.5 10 runner / 647 断言，fail=0）。首轮 mem-numbers 失败系 master 构建遗留的 .map 所 致，本分支重新构建后即一致。	2026-10-12 18:28:02 +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	8b35769a5c	CI 文档单一口径清理：以本机实测现状为准，旧方案降级为"勿照抄"警示 ... 合并稿初版对 4 处分歧采取"两说并存 + 衔接注"，长期看是隐患（读者可能照抄失效方案）。 本次先实测取现状，再统一口径：gitea-runner v4.0.1 / D:\Docker\act_runner / --instance http://127.0.0.1:3001 / labels windows:host / config.yaml 实际值。 - 注册口径：删掉 act_runner v0.2.11 + C:\act_runner + 公网域名的可复制命令块，只留 "勿照抄"警示——核实 C:\act_runner 至今不存在，且 v0.2.x 与 v4 命令集不兼容， 照抄会装出连不上 Gitea 的 runner - config.yaml：示例 fetch_timeout 由 5m0s 改为磁盘实际值 1m0s（超 RPC timeout 1m 会被 截断并刷告警）、timeout 统一 30m0s，两处示例块对齐真实文件 - 常驻口径：§3.2 deploy_runner_task.ps1 标为已废弃并写清失效机理（单次 daemon 是 "正常退出"，计划任务失败重启永不触发）；§3.3 手动等价命令重写为看门狗版任务对象 （旧版会教人手搓出坏配置）；§10 TL;DR 第 4 步改指 ci_runner_bootstrap.ps1 - 数字口径：L0.5 期望值更新为 288/288（2026-10-12 实测），run#8 的 39/39 与 278/278 标注为历史快照——判定只看 fail=0 与 A==B，不拿历史数字当基准 顺带同步到现状：健康三查与排障表改用现行日志名（runner-daemon.log / runner-watchdog.log；runner-stdout.log 标为遗留并说明其 ASCII+UTF-16LE 混编码）； BOM 示例对象换成 check_env.ps1 并注明看门狗是纯 ASCII 无需 BOM；配套脚本表补 run_runner_watchdog.ps1，并警示磁盘上仍存的 deploy_runner_task.ps1 / run_runner.cmd 误执行会把看门狗任务覆盖回单次任务；补"Next Run Time 为空属开机触发器正常表现"。 保留不动：机器级 DTU_* 为正式通道、全局 site-packages 为兜底——这是设计的降级链， 不是文档分歧。 验证：check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项全 Passed。	2026-10-12 17:06:29 +08:00
wandering1	ba40cc0d20	远程 CI 文档独立成 docs/CI/：两篇重叠指南合并为一篇，AGENTS.md 压成一行指针 ... 动因：远程 CI 只跑在本机一台 runner（win-stm32-ci）上，其他机器与项目都不涉及， 但内容散在 4 处约 2000 行——两篇高度重叠的指南躺在「环境与部署」里与换机核对清单 并列，AGENTS.md 提交门禁节还塞了 4 条 runner 运维经验，导致每次会话都被这些机器 专属细节干扰。 结构：新建 docs/CI/，README.md 作唯一入口（适用范围 + 章节速查 + 常用命令）， 远程CI完整指南.md 为合并稿。 - 合并：CI配置指南 477 行 + Gitea_Runner部署指南 917 行 → 一篇 1300 行；骨架内容 逐行比对核实无丢失（仅章节重编号与相对链接按新位置改写），重复段按"留新版"去重， 独有内容全部搬入（下载/config.yaml 字段语义/不能用 Windows 服务的根因/内网 action 三种处置/check_env 自检/TL;DR/排障表 13 条独有行/MySQL 直查核验） - 再分配：测试流程 §9.2 两个 job 的步骤细节并入指南 §5.5、§9.4 部署前置表并入 §0.2； 测试流程 §9 只留测试分层视角（覆盖哪些层、触发与 paths-ignore、本地等价、 "CI 不替代本地门禁"） - AGENTS.md：4 条 CI 经验（看门狗 / gitlint stage / UTF-16LE / CI 概览）压成 1 行指针 - 引用同步 6 个文件：docs/README 目录树与索引、项目部署环境要求 3 处、本地工具路径 环境变量方案、待处理内容、scripts/README（补登 3 个 CI 脚本并标注为本机专属） 验证：check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项全 Passed。 两篇旧文档以 git rm 删除（历史仍在 git 中）；各文档变更记录的历史行按仓库惯例不改写， 只新增 2026-10-12 行。	2026-10-12 14:03:44 +08:00