wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions Packages Projects 2 Releases Wiki Activity
918 Commits 4 Branches 0 Tags
master
Commit Graph

20 Commits

Author SHA1 Message Date
wandering1 4a4ad6bc5f chore(全仓): @build/@test 旧文档别名清退为技能调用名 
现状口径：/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名，
不是 shell 命令；「名 + 命令行参数」的命令形态改为可执行体
run_boot_test.py 的真实调用。

- AGENTS.md：别名说明重写为「技能调用名不是 shell 命令」，两条目改
  「编译（/keil-build）」「串口回归（/serial-boot-test）」
- keil-build / serial-boot-test 两 skill 调用名与示例同步；task-worktree
  方案文档去掉 @build/@test 惯例从句；@task 保留（不在点名范围）
- 123 文件现状陈述全改；台架捕获、变更记录/时间线、rename 映射输入
  等 41 行历史证据保留旧名
- gen_memory_svg.py 6 处措辞随改，3 张 SVG 产物同批重跑
- 顺手补并行方案同行漏网计数 51→52 钩子

验证：提交期快钩子对 123 文件实跑全 Passed；check_doc_links --all
rc=0（3038 处、无法判定 0）；check_mermaid --all rc=0；YAML 解析 52
钩子不变；skill-size rc=0；py_compile 全过；字节卫生零漂移。
 2026-10-30 13:03:12 +08:00
wandering1 f754d59218 docs(测试说明): 按用途分六个子目录并同步全库引用 
分层：流程与规范/ 单元测试/ 板级测试/ 专项验证/ 测试工具/ 测试数据/，
顶层只留新增的目录导航 README.md（归层判据 + 硬约束 + 本次处置记录）。

- 搬迁 28 个路径：测试数据三个目录 58 个文件为纯改名（R100，内容逐字节不变）
- 全库引用同步 124 个文件：AGENTS / docs 索引 / skills / 门禁注释 / scripts
- 门禁面：scripts/check_test_traceability.py 的 glob 改 rglob
  （分层后不递归扫描＝追溯门禁直接瞎掉）
- scripts/rename_ref.py：收尾的 ℹ 提示在 GBK 代码页抛 UnicodeEncodeError，
  让进程以退出码 1 收场而改写其实已落盘（RC 与真实结果相反）；改为把
  stdout/stderr reconfigure 成 UTF-8，与 check_doc_links.py 等同法
- docs/文档规范.md §1.1 补「子目录文件过多时再分一层」；§3.6 补 rename_ref
  搬整目录的两个实测坑：① 会改写目录内部文件的内容 ② 内部文件的 ../ 出链
  不补层级（本次 23 个被误改的证据文件已按 HEAD 原始字节逐字节还原）
- docs/README.md §6 改为与六个子目录一一对应，并补登原先漏登记的
  「启动日志原子性复验流程」一行
- .cubemx_survival_baseline.json：App/util/task_watchdog.c 的注释路径也随分层更新，
  该文件是存活审计的 watchdog-module 漂移锚点，按脚本自己的提示跑 --write 重建基线
  （实测重建后仅 watchdog-module 一条哈希变化）
- 铁律 4 例外（本次在任务树里改了单写者文件）：AGENTS.md 与
  .pre-commit-config.yaml 只被 rename_ref 改写路径字面量（后者全在注释行），
  任务表块与钩子声明一字未动

验证：check_doc_links.py --sections-strict 覆盖全部 88 个改动 .md 全绿；
check_test_traceability.py 输出与主树逐行一致；196 个文本文件无 BOM、无新增
CR、无 U+FFFD、无行尾空白；陈旧引用面由主树 25 处降到 6 处（无新增断链）。
 2026-10-30 07:16:07 +08:00
wandering1 88601422c3 docs(文档规范): 清空壳变更记录节，例外清单改成可复跑口径 
17 篇文档的变更记录（含修订记录、带编号与中文序号标题）节里只剩一句
「不再记流水账」的占位话，整节删掉，连带它前面的分隔线。
仍保留真台账的只有 5 篇（看门狗 / 配置文件设计 / RAM 预算台账 /
内容页架构 / 本地工具路径方案），外加 scripts/archive 归档区。

份数口径改成可复跑的普查：文档规范 §5.1 补自查命令，
stale-doc-count-sweep 的速查表与陷阱各加一条——只 grep 裸标题会漏
带编号与中文序号的两种写法，实测 5 篇只数得出 3 篇，差点据此把
全仓正确的份数改错。

门禁：逐篇与全量 check_doc_links 除 simulator/SDL2 联接假红外 0 问题；
skill-size rc=0；表格列数与字节体检相对 HEAD 零新增问题。
 2026-10-29 21:21:59 +08:00
wandering1 c63bd029a9 feat(门禁): 新增 skill-size 钩子——SKILL.md 不得超插件写侧上限 65536 
dsh-mnemon 的 MAX_SKILL_BYTES = 65536 只在写侧校验，加载侧从不检查，
所以正文越界的技能照常加载、却永远生成不出草案：同日两次卡死
（83194 字节与 72601 字节）都是这个形态，复位台账无效，只能瘦身。
故把上限机械化，越界与悬空指针在提交期就拦下。

- scripts/check_skill_size.py：纯标准库（裸 python 也能跑，故不解析
  .venv）；FAIL >65536、FAIL reference/ 指针悬空、FAIL UTF-8 BOM、
  WARN ≥49152（75%——实测一次「采纳」把主文从 49821 顶到 62806）；
  总是全树扫，只拿 reference/x.md 触发的提交正是漏网场景；
  --root 可复指到用户级 ~/.dsh/skills；--selftest 五形态（干净 0 /
  临界 0+WARN / 超限 1 / 悬空+BOM 1 / 根不存在 2）全过
- .pre-commit-config.yaml 加 skill-size，files: ^\.dsh/skills/
- 新增 docs/门禁说明/skill-size.md，含盲区：拦不住插件自身的采纳写盘、
  用户级技能目录不在触发面、不解析 frontmatter、不查 U+FFFD
- 计数同步 51 -> 52（实跑 48 -> 49，索引 28 -> 29 篇）：AGENTS.md 与
  门禁索引，另 7 处文档旧计数改写、CI 指南带日期实测行只加注

本笔先落地，技能正文的渐进展开拆分在下一笔。
 2026-10-29 15:02:23 +08:00
wandering1 49cddac0dd docs(门禁计数): 工作树方案的「31 钩子」改回声明的 51——同文件第 22 行本就写着 51 
真值三源互证：YAML 解析条目数 51（仓库口径的自查命令）、带 stages:[manual] 的 3 根、AGENTS.md 的
「共 51 个钩子 / 提交期实跑 48 根」、门禁说明 README 的「声明的 51」与「51 个 hook → 28 篇」、
pre-commit 使用说明的「51 声明数，一次 git commit 实跑 48 根」——全部一致，唯一离群值就是方案文档
那条表格行里的 31；而同一份文档第 22 行自己写着 51，属文档内部自相矛盾，这是最硬的判据。

:248 取 51 而不是 48：该行主语是 ci_local，本次实跑日志实证它覆盖静态 passed=47 + manual 三根 rc=0
+ gitlint 十条，正好是声明的 51 根全跑；48 是「一次 git commit 实跑」的口径（47 静态 + gitlint），
两个数分列、不许混写。同时把裸数字改成带出处指向的写法，下次加钩子这里少一个查不到来源的数。

远程CI 指南那处只加「当时」两个字：26 是 2026-10-12 那次 gitlint 环境事故的观测值，数字本身不算错，
但句子是现在语气，会被读成今天静态段的条数（现 47）。按计数同步 playbook 的最小动作加注，不重述数字。

冻结并写明类别：pre-commit 使用说明的「当时 40 个 hook」、主机单测覆盖率口径的 39/16（句中已有
「当时」）；同数不同义不动——run_boot_test.py 的「31 份 boot_log」是日志份数、verify_log.py 的
rec[31:59] 是字节偏移；命中面之外不动——.venv/ 与 Lib/ 第三方、.git/ 内的 stray 报告。
邻族实测自洽、本轮未碰：22 根专属钩子 + 19 套无专属 = 41 套、28 篇索引、51/48/47 三分列。

门禁：编号门禁 [OK]；doc-links --all --sections-strict RC=0（2602 处引用、无法判定 0、194 文档，
章节引用 +1 就是新增的这处 §2 指向）；两文件无 BOM、CR=0、无 U+FFFD、无行尾空格、结尾单 LF、
表格仍为 5 列；旧形态复扫「31 钩子 / 31 个钩子 / 31钩子」全仓命中 0。改动不落体积门禁指纹面，
不需要 @build。
 2026-10-29 08:54:41 +08:00
wandering1 295eb9911f ci(gates): 覆盖率总闸与全量 cppcheck 移到远端 CI 强制（提交期实跑 48 根） 
用户裁定 2026-10-28：慢钩子不再压在每个 git commit 上，由远端
CI 强制；本地等价入口 = scripts/ci_local.py 的 manual 段。

实测三根耗时：cppcheck 20.5 s、test-cppcheck 38.1 s、
test-coverage 105.2 s，合计 ~165 s ≈ 一次带代码提交耗时的
三分之二（test-coverage 的 files: 覆盖 App/，改一行就跑光 40 套）。

- .pre-commit-config.yaml：cppcheck / test-cppcheck /
  test-coverage 加 stages: [manual] + 理由注释；替换掉
  test-coverage 上方「没写 stages → 所有阶段都跑、输出出现两次」
  的旧坑注释（固定 manual 后不再有这一坑）。
- .gitea/workflows/ci.yml：static-gates job 在静态门禁步之后
  新增「手动阶段门禁（覆盖率总闸 + 全量 cppcheck）」步，
  if: always()，逐根 --hook-stage manual（pre_commit run 不支持
  多 id），日志 ci-artifacts/manual-stage.log + 归档 + STEP_SUMMARY，
  rc≠0 即失败；run 块纯 ASCII。
- scripts/ci_local.py：新增 MANUAL_STAGE_HOOKS 与 run_manual_stage()
  （静态段之后默认跑），删 run_coverage() 死代码，--coverage
  降级为兼容别名。
- AGENTS.md + 12 篇 docs/scripts/README：三数同源口径改为
  声明 51 / 提交期 --all-files 实跑 47 / +gitlint = 48，
  其余 3 根在 manual 阶段；历史测量数字只加「当时」不回改。

验证：pre-commit run --all-files = 47 Passed / 0 Failed rc=0；
manual 三根 Passed（test-coverage line 89.8% func 93.2% 41/41 套）；
ci_local.py --static-only 全绿；check_doc_links --all
--sections-strict rc=0、mojibake / bom-drift / id-check-new rc=0；
ci.yml yaml.safe_load 通过。未改任何 .c/.h，故未跑 @build。
 2026-10-28 23:04:59 +08:00
wandering1 16be01915d chore(docs): 补齐文件末尾换行（end-of-file-fixer 实测 18 篇）
CI / 静态门禁 (pre-commit) (push) Failing after 46s
Details
CI / 主机侧单测 (MSVC) (push) Failing after 43s
Details 
提交后台跑 scripts/ci_local.py 时 end-of-file-fixer 报 Failed 并就地修复：
17 篇补文件末尾换行、1 篇去掉行尾空行。

内容零变化：git diff --ignore-all-space 只有 1 处空行删除；18 篇均在
上一笔流水清理里被改过，恢复补丁时把上一轮的 EOF 修复冲掉了，这一
笔补回。
 2026-10-28 22:12:59 +08:00
wandering1 511fd30cc6 docs: 清理全仓变更记录流水（43 篇整节删 / 23 篇留一行 / 5 篇保留） 
用户裁定：文档只写现状，历史流水一律删掉，过程查 git log。

- 43 篇「变更记录 / 修订记录」整节删除：继电保护规划 12.6 KB、产品
  需求 11.8 KB、项目部署环境 5.5 KB、BSD Socket 指南 5.3 KB、架构
  总览 5.0 KB、实机测试实施指南 3.8 KB 等
- 23 篇别处仍有指向：只留节名 + 一行「本文件不再记流水账，过程查
  git log」，节号与锚点不位移（doc-links 不因此断链）
- 5 篇整表保留（被当唯一证据 / 活台账引用）：看门狗设计说明、配置
  文件设计说明、RAM预算台账、内容页架构、本地工具路径环境变量方案
- 规范同步：文档规范 §5.1 改新裁定；测试文档模板规范删示例节与
  登记句；测试开发标准流程 / UI 两篇 / 实机测试实施指南 / 四篇单测
  说明 / 并行任务工作树方案 / 编号规范 的「登记变更记录」改「写进
  正文」
- 技能同步：stale-doc-count-sweep / ui-verify / id-family 三个 SKILL
  正文不再要求追加流水行（顺带消掉 SKILL.md:121「产品需求 §12」
  失效引用）
- 修 5 处悬空指针：采样有效性校验目录锚点、BSD 指南「文末变更
  记录」、docs/README 过期描述、网络自愈架构两处指向面

72 篇文档净减 600 余行；check_doc_links --all --sections-strict 可判
定比例 61% → 78%、失效引用 0；静态门禁 passed=50 failed=0；gitlint
10 条历史提交信息 0 failed。

未提交他人在飞改动：.dsh/skills/keil-build/*（%SystemDrive% 守卫）。
 2026-10-28 22:00:34 +08:00
wandering1 842d711ed6 refactor(编号): 测试验证层级去号——CI job / 门禁输出 / 命令行旗标换语义名 + ASCII 段名 
用户裁定「我不想看到编号」。测试验证层级这一族的整族清退分三道并行：本笔是**代码与 CI 道**
（CI 步骤与门禁输出面），代码注释面另走、文档面由文档道走。

口径（旧 → 语义名 → ASCII 段名，段名只进日志/旗标/job id/文件名）：
  L0 静态门禁 static ｜ L0a 钩子解释器预检 preflight ｜ L0b 提交信息门禁 commitmsg
  L0c 体积门禁 size ｜ L0.5 主机侧纯逻辑单测 host-unit ｜ L0.5c 覆盖率 coverage

- scripts/ci_local.py 43 站点：段标题与 [SUMMARY] 标签改 ASCII 段名（static: /
  host-unit:），函数 run_l0/run_l05 → run_static_gates/run_host_unit_tests，
  收尾「已跑：」列表用段名。旗标改 --static-only / --host-unit-only，**旧旗标
  --l0-only / --l05-only 保留为 argparse 别名**（肌肉记忆与既有脚本片段不断档，
  实测 --help 两名列出）。
- .gitea/workflows/ci.yml 42 站点：job id l0-gates → static-gates、
  l05-host-unit-tests → host-unit-tests；步骤名与 step-summary 标题改语义名；
  日志名 l0-pre-commit.log → static-pre-commit.log、l05-<模块>.log →
  host-unit-<模块>.log；::error::/::notice:: 文案同步。yaml.safe_load 核过
  两个 job id 与步骤名。
  host-unit-tests；步骤名与 step-summary 标题改语义名；日志名 l0-pre-commit.log →
  static-pre-commit.log、l05-<模块>.log → host-unit-<模块>.log；::error::/::notice::
  文案同步。yaml.safe_load 核过两个 job id 与步骤名。
- 门禁脚本 18 站点：check_registration（登记簿理由串 7）、check_test_coverage 5、
  README 8、check_generated_fresh 2、ram_baseline 2、check_size_gate 1、
  ci_find_python.ps1 2、ci_runner_bootstrap.ps1 2、.pre-commit-config.yaml 2、
  requirements.txt 1（保持纯 ASCII）。
- skills 7 站点：task-worktree（含 [SUMMARY] 样例两行）、mem-budget、ui-verify、
  task_worktree.py 的实跑标签。
- AGENTS.md 3 站点：CI 段「只跑静态门禁 + 主机侧纯逻辑单测」、自查命令段、
  「2026-10-11 静态门禁全灭」事件名。
- 归档：编号治理历史.md 新增 §10 换算表 + **撞族警示**（同形 L0/L1/L2/L3 还属 UI 设计
  令牌层 / UI 菜单层级 / 采集链 / 链路时延段 / CubeMX 三层 / 硬件位号与 FTP 应答字面量
  等六个族，其中 6 处在字符串字面量里，改了就是改行为——故全程只按行内置换、先判族）。
- docs/产品需求 §7.4 测试分层表：去号 + 顺带修掉上一批**错族替换疤**（该表 L1/L2 行曾被
  采集链层名「语义取数与有效性 / 全周傅氏相量」「保护判据」顶替，现按内容改写为板端测试
  套件 / 主机侧回归两行）。同文档 §1.5 G5 判据行同步。

门禁：ci_local --help 两面旗标并列；py_compile 7 个 .py 全过；yaml 解析通过；
check_ids_new --worktree rc=0；git diff --check 干净；17 个改动文件 FFFD=0、无 CR、
BOM 与原文件一致（含 requirements.txt 纯 ASCII）。本族无机器识别面（单字母+数字是
新增行门禁的自述盲区），口径来自自建逐行扫描器，复扫本族形态归零。
- 交接说明：文档道 teammate 在改 CI 指南时中断，剩余 9 处双写疤与 29 处 CI 标识
  （job id / 日志名 / 汇总行字面量）由 Lead 接手改完，逐处仍走断言式行内置换。
 2026-10-28 17:46:52 +08:00
wandering1 599f05be22 refactor(编号): 测试验证层级 L0/L0.5/L1/L2/L3 → 语义名（批次 3d·文档层） 
这族是验证层级：静态门禁 / 主机侧纯逻辑单测 / 板端测试套件 / 主机侧回归 / 人工目检。
实测它出现在 **97 个文件**（40+ 个 test/host 的 run_unit_test.py、.gitea workflow、
ci_local.py 的阶段标签、以及十来篇文档）。本批只做**文档层**，代码层单列一批（见下）。

改动：10 篇文档 110 行 + 三处收尾——
  测试开发标准流程 / 实机测试实施指南 / 主机单测覆盖率口径 / 门禁说明 README 与
  host-unit-tests / CI README 与远程CI完整指南 / docs README / 测试与架构专项 /
  pre-commit 使用说明。
映射：L0 → 静态门禁、L0.5 → 主机侧纯逻辑单测、L1 → 板端测试套件、L2 → 主机侧回归、
L3 → 人工目检；`L0b`（ci_local 的内部阶段标签）在文档里写成「提交信息门禁」。
测试层级那张表的「层级」列被删掉（名称列已承载同一信息，留着就是两列重复）。

**未做（代码层，单列批次 3d-2）**：`scripts/ci_local.py` 的阶段标签、`.gitea` workflow、
`test/host/*/run_unit_test.py` 的输出前缀、以及代码头注释里的 L0/L0.5 —— 那些是**程序标识**，
改名要连带 CI 日志格式与文档里对 `[SUMMARY] L0: ...` 的引用，属跨端改动，需单独验证。

验证：三篇主文档的层号残留 = 0；doc-links 通过；mojibake / git diff --check 干净；
表格列数已收敛为 3 列（名称 / 载体 / 抓住什么）。
 2026-10-28 13:20:28 +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 7048e9cb9a docs(任务规划): 瘦身为只留待办，波次条目改用语义名 
任务规划目录只保留将来要做的事：删掉已完成的证据链与已作废的历史快照，
并把波内条目的 C/D 短码全部换成语义名。

为什么删 C/D 短码：它们同字母不同义——C 组在 UI_界面制作流程.md 里是
UI 设计约束（屏幕/字符集/文本/编码），D 组在控制台单写者日志设计说明.md
与配置文件设计说明.md 里是决策记录。同一串短码在三处指三件事，读的人
只能猜，所以条目一律改用一行短语作标识。

- 排期详述.md 重写为「结构债与验证常态」，条目全语义名，出处列留冻结号
- README.md 删修订记录块（本文件自述不留变更记录），波次行改语义描述
- W1-采集保护收尾.md 67→30 行，只留 M3 送检与 B10 卡
- 基线与待确认.md 73→15 行，删已作废的旧栈表与旧余量数字
- 登记簿.md 逐行收缩到未闭环残余，N-29 的 .git 订正为实测 233 MB
- 测试与架构专项.md 删 S1-c（106 例已落地，且被覆盖率总闸覆盖）
- 并行分道方案.md 删批 0，修两处会返回 rc=3 的 new 命令形态
- 覆盖率口径：套件 16→33、未挂钩子 12→17、墙钟 25s→67s（实测）
- 同步 10 处跨文档引用，指向合并或删除后的新位置
 2026-10-25 01:35:21 +08:00
wandering1 c077e9a481 merge: 远程 CI 分支 v2-on-ui-ci 合入 v2-on-ui
CI / L0.5 主机侧单测 (MSVC) (push) Has been cancelled
Details
CI / L0 静态门禁 (pre-commit) (push) Has been cancelled
Details 
将 origin/v2-on-ui-ci（13 个提交：远程 CI 文档独立成 docs/CI/、
runner 保活/日志编码/gitlint 空转修复、ci_local L0b 等）合入开发主线。

冲突 5 处，按「两侧意图取并集」解决：
- AGENTS.md / docs/README.md：保留主线 待处理内容.md→任务规划/ 重构，
  并入 CI 分支的 docs/CI/ 索引行与更新日志
- 测试开发标准流程.md §9.1：取 CI 分支，引用改指
  ../CI/远程CI完整指南.md 对应小节
- docs/待处理内容.md：接受主线删除，已重构为 docs/任务规划/
- docs/环境与部署/CI配置指南.md：接受 CI 分支删除，已并入 docs/CI/

合并引入的 doc-links 失效已修（doc-links 合并态走 --sections-strict，
自引用解析失败即硬错误）：
- CI 指南 §0.0 标题把 ⚠️ 移到编号后（编号须打头才解析得出）
- CI 指南对 待处理内容.md 的引用改指 docs/任务规划/登记簿.md T-7 条
- CI 指南并入来源《测试开发标准流程》§9.4 / §9.2 改为全路径限定
- 测试开发标准流程 §9.4：§0.2/§2/§2.4/§4.1.3 原与 CI 文档路径间隔
  超过链式继承上限 40 字符，改为紧跟路径并拆分明细句
- 测试开发标准流程 §9.1：步骤级细节引用同样全路径限定到 CI 指南
 2026-10-12 19:42:24 +08:00
wandering1 ea10dbae53 修 gitlint 门禁在 CI 空转：runner 无 git 身份致 254 被误报成信息违规
CI / L0 静态门禁 (pre-commit) (push) Successful in 3m41s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 33s
Details 
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