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
This commit is contained in:
+1
-1
@@ -23,7 +23,7 @@
|
||||
| 想干什么 | 去看 |
|
||||
|---|---|
|
||||
| 先搞清 CI 需要哪三样东西就位、本机拓扑、部署前置清单 | §0 / §0.1 / §0.2 |
|
||||
| **CI 不守哪些门禁**（体积门禁盲区 S14、gitlint 空转） | §0.0 + §7 排障表"钩子条数对不上"行 |
|
||||
| **CI 体积门禁现在怎么守**（同码凭证强制，S14 盲区已关闭；gitlint 空转仍在） | §0.0 + §7 排障表"钩子条数对不上"行 |
|
||||
| 服务端开启 Actions、`DEFAULT_ACTIONS_URL` 到底管什么 | §1（含 §1.2.1，**这条最容易搞反**） |
|
||||
| 下载 / 注册 runner（`--instance` 用回环、labels 必须精确匹配 `runs-on`） | §2.2 |
|
||||
| `config.yaml` 各字段语义（capacity / timeout / labels / 日志目录…） | §2.3 |
|
||||
|
||||
+15
-13
@@ -36,22 +36,23 @@
|
||||
|
||||
---
|
||||
|
||||
## 0.0 ⚠️ CI 不覆盖的体积门禁（必读，S14）
|
||||
## 0.0 ⚠️ CI 体积门禁：从盲区到同码凭证强制（必读，S14 → A-5 残余已销项）
|
||||
|
||||
> **CI 不守 Flash/RAM 体积门禁。** `mem-numbers` 钩子的事实源是 Keil 构建产物
|
||||
> `MDK-ARM/**/*.map`（已 gitignore），而 CI 刻意不跑 `@build` → **无 `.map` → 该钩子被跳过**。
|
||||
> **曾经的盲区已关闭为强制路径（2026-10-25，A-5 残余销项，`task/A5-size-gate`→564715c）。**
|
||||
> `mem-numbers` 钩子的事实源是 Keil 构建产物 `MDK-ARM/**/*.map`（已 gitignore），CI 刻意不跑
|
||||
> `@build` → 该钩子在远端只会被跳过（现以 `SKIP` 名单诚实显示 Skipped，不再伪装 Passed）。
|
||||
> 补上的强制路径 = **同码凭证**：本地 `@build` 0/0 后 `ram_baseline.py --update` 顺手盖
|
||||
> `scripts/size_attestation.json`（三道前置：`.map` 可解析 / `.map` 不早于指纹内源码 mtime /
|
||||
> 受管区 ≤92%）；CI 无需 Keil，L0 作业末尾的「体积门禁」步用 `scripts/check_size_gate.py --ci`
|
||||
> 复核两件事——**工作树指纹 == 凭证指纹**（改了代码从没测过 = 拦）+ **按凭证数字复跑 92% 红线**。
|
||||
> 主干 push 拦红，其余事件 `--warn-only`；本地 `ci_local.py` 的 L0c 步无条件 fail-closed。
|
||||
>
|
||||
> 后果：**新增任务 / 栈 / 缓冲 / 代码导致的体积增长（或文档内存数字失真）不会在 CI 被拦下。**
|
||||
> 仍守不住的三项（正文唯一口径 = `scripts/check_size_gate.py` docstring）：CI 不重算绝对数字
|
||||
> （只复核同码性与红线复算）；编译器选项（`.uvprojx`）不在指纹内；凭证由本地真实构建产生，
|
||||
> 链路本身不经 Keil 授权就无法伪造，但"盖戳后换机器环境"的差异只能靠 mtime 前置兜。
|
||||
>
|
||||
> 兜底（每次改代码后必做）：
|
||||
> ```powershell
|
||||
> & '.venv\Scripts\python.exe' .dsh\skills\keil-build\scripts\keil_build.py # 0/0 且生成 .map
|
||||
> & '.venv\Scripts\python.exe' scripts/check_mem_numbers.py --scan
|
||||
> ```
|
||||
> 若 CI 允许在带 Keil 的 runner 上跑，则该钩子会在有 `.map` 时**照常执行**（workflow 自适应）。
|
||||
>
|
||||
> CI 运行时该跳过以 **`::warning::`** 明示（不是弱化的 notice），并写入 job 的
|
||||
> **step-summary** 醒目行，避免被忽略。
|
||||
> 本地兜底动作不变（每次 `@build` 后）：`ram_baseline.py --update`（含盖戳）+
|
||||
> `check_mem_numbers.py --scan`。若 runner 以后装了 Keil，`mem-numbers` 会在有 `.map` 时照常执行。
|
||||
|
||||
---
|
||||
|
||||
@@ -1351,6 +1352,7 @@ powershell -ExecutionPolicy Bypass -File scripts\ci_runner_bootstrap.ps1 -DryRun
|
||||
|
||||
| 日期 | 变更 |
|
||||
|---|---|
|
||||
| 2026-10-25 | 🔒 **A-5 残余销项联动（§0.0 重写）**：体积门禁由"CI 不守"改为**同码凭证强制**——本地 `@build` 0/0 后 `ram_baseline.py --update` 盖 `scripts/size_attestation.json`，L0 作业末尾 `check_size_gate.py --ci` 复核同码性 + 红线复算（runner 无需 Keil）；主干 push 拦红、其余事件 warn-only；`mem-budget` 补进 SKIP 名单诚实显示。指纹取 git 索引 blob（跨 checkout 稳定，修 7c4628b）；三项仍守不住的口径唯一正文 = 脚本 docstring |
|
||||
| 2026-10-12 | 🐛 **第一次真跑出 run，当场暴露 gitlint 门禁空转**：把本轮修复推到新分支 `v2-on-ui-ci` 后拿到 task 31/32——**L0.5 成功**（`10 runner(s), 647/647 assertions passed, fail=0`，与本地逐字一致），**L0 失败**却与提交信息毫无关系：`exit code: 254` + `Missing git configuration: please set user.name`。根因是 `actions/checkout` 把 HOME 指向每次任务的临时目录、SYSTEM 账号没有 git 身份，gitlint 在读到规则之前就配置错误退出；旧脚本还把失败原因**写死**成"标题超 100 字符"，加上该步 `exit 1` 让后面 26 个钩子**一个都没跑**。修法：脚本先探测身份，缺失就用 `GIT_CONFIG_COUNT/KEY/VALUE` 注入一次性身份（不写文件、不碰开发者机器），并区分 254（门禁没跑起来 → `exit 2`）与真实违规（→ `exit 1`）。另记一条新坑：**新建分支的首次 push 不产生 run**（§7 排障表 ④） |
|
||||
| 2026-10-12 | 🔀 **随 `master` 合入 `v2-on-ui`：数字口径改为分支中立**。本指南原先写死 master 的数字（18 钩子 / 17 报告、3 runner / 288 断言），而 `v2-on-ui` 是 **26 钩子 / 10 套件**——同一篇文档在两个分支上必然有一个是错的。§6 验收第 8 行、§7 排障表、§10 验收标准三处改为讲规则（**报告数 = 定义数 − 1**；**runner 数 = `test/host/` 下 `run_unit_test.py` 个数**）+ 分分支实测快照。本次合并只带文档与脚本，**零 C 代码改动**；合并后本分支 `@build` 0 错 0 警、`ci_local.py` 全绿（L0 25 钩子 + L0.5 10 runner / 647 断言） |
|
||||
| 2026-10-12 | ✅ **双看门狗缺陷实测收敛** + 修掉日志里的 PS 5.1 stderr 包装噪声与 `-Status` 假警。① 管理员 `-StartNow` 杀掉 3 个残留（孤儿看门狗 26900/19716 + 占锁 daemon 53848）→ `daemon up: pid 40360 (single instance)`，监管链 `svchost → 看门狗 → daemon`，看门狗日志 25 秒零增长、runner 回 online。② 新坑：daemon 日志写 **stderr**，PS 5.1 的 `2>&1` 把每行包成 ErrorRecord → `gitea-runner.exe : ` 前缀 + 4 行 `CategoryInfo` 块，实测 2 行真日志写成 8 行（**每 4 行有 3 行是噪声**，且就在文档让大家第一个打开的文件里）。启动器改为 `2>&1 \| ForEach-Object { "$_" } \| Out-File -Encoding utf8`（实测与 cmd 包装等价但免引号剥离坑，`$LASTEXITCODE` 不受影响）；§7.2 方式 B 的示例原本正是 `> log 2>&1`（UTF-16LE + 包装双坑），已改；新增 §7.3 汇总这两条。③ `-Status` 两处诚实化：非管理员**读不到 SYSTEM 进程命令行**（`CommandLine` 为 null → 过滤器静默匹配 0 个），改为明说"需提权"而不是谎报"没有看门狗"；重启循环判据不再靠"日志尾部有没有错误串"（文件不轮转，修好后旧失败仍在尾部 → 对健康 runner 报假警），改看 **daemon 进程存活时长**（CIM `CreationDate` 非管理员可读，`Process.StartTime` 对 SYSTEM 进程不可读） |
|
||||
|
||||
Reference in New Issue
Block a user