18 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	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	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	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	e25e51c378	ci(A-5): 体积门禁补强制路径——同码凭证 + CI 无需 Keil 复核 92% 红线 ... 背景：A-5 残余（docs/任务规划/测试与架构专项.md）说得很直白——mem-numbers 在 CI 被跳过（runner 无 Keil/无 .map），上一轮只把"跳过"声明成一条 ::warning::， "盲区本身未消除"：看到 CI 全绿仍会以为体积也守住了。 复核时本地侧同样漏：ram_baseline.py --gate 在无 .map 时自适应 SKIP 且返回 0； mem-budget 甚至没进 CI 的 SKIP 名单——它在 runner 上以"Passed"的面貌出现，实际 什么都没检查。两处共同点是**"没跑 = 通过"**。 做法：给体积数字配一条可提交、CI 可复核的**同码凭证**，而不是要求 runner 装 Keil。 - 新增 scripts/check_size_gate.py（口径与边界的唯一正文在其模块 docstring） · --stamp：只在三条都成立时才盖章——① .map 存在且解析得出执行区与 Grand Totals；② .map 不早于指纹范围内任何源码的 mtime；③ 受管区占比不超过 mem-budget 用的同一常数。凭证因此不是随手可写的。 · --local：工作树指纹必须等于凭证指纹，否则 FAIL（="改了代码但体积从没测过"） · --ci：不需要 Keil 也能判的两条——同码性 + 按凭证记录的数字复核 92% 红线 · --show：排障用。指纹 = git ls-files 范围内逐文件 sha256(路径+内容) 再聚合， 覆盖 App/ Drivers/ Src/ Inc/ Lib/ Middlewares/ test/board/ 与 MDK-ARM 的 .sct/.s - 新增 scripts/size_attestation.json：本树的凭证（由本树一次真实 @build 盖戳） - scripts/ram_baseline.py：--update 顺手盖戳——"每次 @build 后跑 --update"是既有 纪律，不新增人工步骤；在函数内 import 防成环；盖戳失败只告警、不改 --update 返回值（新鲜度由门禁自己 fail-closed 兜）。_util/_read_tsv 提为公开名 region_pct / read_tsv_rows 供其复用（体积口径禁第二处定义）；--gate 的无 .map 文案改成明说"SKIP 不等于 PASS"并指向兜底路径。 - scripts/ci_local.py：新增 L0c 体积门禁步（fail-closed、无条件照跑、约 0.3 s） 与 --size-only 开关；docstring 里把"无 .map 时跳过两根钩子"的语义补全。 - .gitea/workflows/ci.yml：L0 作业末尾加「体积门禁」步（if: always()，无需 Keil）； 主干 push 拦红、其余事件 --warn-only（分支上代码尚未定型，拦红只造噪音，还会 诱发多条道同时抢写 scripts/ 台账）；SKIP 名单补 mem-budget，让它诚实显示 Skipped 而不是假 Passed；文件头的"门禁盲区声明"改写为"已关闭为强制路径 + 仍守不住的三项"。run: 块全部纯 ASCII（PS 5.1 无 BOM 按 GBK 解码的实测坑）。 - scripts/README.md：登记新脚本与凭证文件，补用法行。 验证（工作树 _wt/A5-size-gate，分支 task/A5-size-gate） - @build 0 错 0 警：Code=213780 RO=18860 RW=1204 ZI=131852——与 ram_baseline.tsv 的 2026-10-24 行逐项相同（本改动不碰固件源码，指纹不变，零体积增量）。 - 门禁实跑全 0：check-yaml / trailing-whitespace / end-of-file-fixer / check-added-large-files / no-mojibake / id-check / doc-links / mem-budget。 - 负向 8 例全过：改凭证指纹 → --local 与 --ci 都 rc=1；凭证占比改成 95% → --ci rc=1，加 --warn-only 则 rc=0；凭证写成非法 JSON → rc=1；用 mtime 回拨的 .map 去 --stamp → 拒绝且不动凭证；把区 max 改小到必然超线再 --stamp → 同样拒绝。 - 正向：--stamp 之后 --local / --ci 均 rc=0，并与 tsv 末行互证同源。 - --update 的盖戳联动单独验（把 TSV_PATH 与凭证指到仓库内已 gitignore 的 ci-artifacts/ 探针文件，跑完清理，本树台账未被测试污染）。 - ci_local 全量：L0.5 33 runner / 2227 断言全绿、gitlint 10/10、L0c rc=0。L0 里 test-cppcheck 与 test-coverage 各报过一次"files were modified"——单独重跑两条 均 rc=0 且工作树无改动，判定为三条道并行跑主机单测时 %TEMP% 里按套件名派生 的 obj/exe 互相踩踏（harness 产物名全机共用一个 TEMP 目录），非本改动引入。 RAM 增量：0 B（未动固件源码，凭证数字与本树一次真实链接一致）。 gate：全部通过，未使用 --no-verify。 遗留 / 需要 lead 裁定 1. 合入后主干 push 会要求"同码测量"：done 流程在 @build 0/0 之后要多跑一条 python scripts/ram_baseline.py --update，并把 scripts/size_attestation.json （数字变了则连 scripts/ram_baseline.tsv）一并提交。这就是"强制"的含义，但 确实新增半步——若你想先只在本地强制（L0c），我把 CI 那步改成 --warn-only。 2. 文档口径同步我没做（docs/任务规划/**、docs/门禁说明/**、docs/CI/README.md 归主树）：A-5 销项时建议把"CI 不守体积"改为"CI 守同码性 + 红线，绝对数字仍 由本地真实构建产生"，正文引用 check_size_gate.py 的模块 docstring。 3. 编译器选项（uvprojx）刻意不进指纹：UV4 每次构建改写它且不入库，进指纹会让 门禁在"刚刚构建完"的那一刻自己变红；代价是改优化等级/宏不触发本门禁，需人工 重测——已写进边界正文。	2026-10-25 03:51:19 +08:00
wandering1	2fdc5f6dda	修 ci.yml 注释写死的钩子数：改为"报告数 = 定义数 − 1" ... 钩子数在两个分支上不同（master 18、v2-on-ui 26），注释里写死 18/17 会让 另一分支上的读者按错数字去核对，正是本轮文档清理里修掉的同类漂移。头部 注释改为讲规则并给分分支实测快照；run 块内那行同步改成纯 ASCII 的规则 表述，避免增删钩子后再次过期。 同时作为非文档路径的普通 push：新建分支 v2-on-ui-ci 的那次 push 没有产生 run（runner 在线且空闲，job 日志最新仍是 10-03），怀疑新建分支的 push 拿 不到变更文件集、被 paths-ignore 滤空，用这次提交验证。 验证：YAML 可解析、全部 run 块纯 ASCII、无 BOM、LF；pre-commit 对该文件 通过。	2026-10-12 19:04:09 +08:00
wandering1	d7b9204245	修 ci.yml 头部指向已删文档的失效引用（doc-links 只扫 md 的盲区） ... ba40cc0 把两篇 CI 指南合并为 docs/CI/远程CI完整指南.md 并删除原文件，但 ci.yml 第 24 行那句"（见 CI配置指南 §4.3）"没跟着改——它指向一篇已经不存在的 文档，且章节号也变了（旧 §4.3 内网 action → 合并稿 §5.3）。 为什么漏掉：scripts/check_doc_links.py 只遍历 .md 文档，.gitea/workflows/*.yml 里的纯文本引用（非 markdown 链接、非带扩展名的反引号路径）不在它的规则覆盖内。 已全仓扫描确认：非 md 文件里这类失效引用仅此 1 处，现已修；md 里余下 9 处均为 "两篇均已删除"的状态说明或变更记录历史行（按仓库惯例历史行不改写）。 本提交同时充当远程 CI 的端到端触发：workflow 的 paths-ignore 挡掉 docs/** 与 **/*.md，所以前几轮的纯文档提交不会触发运行；改 .gitea/workflows/ci.yml 本身 落在忽略集之外，可用来验证 runner 恢复后 run 能否真正执行（此前 run 16~21 因 runner 停摆全部 cancelled，尚无一次成功运行）。 验证：check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项 全 Passed（含 check-yaml）。	2026-10-12 18:04:00 +08:00
wandering1	038e2cfba3	合并后对齐钩子计数：master 已 18 个，并补记 stages 的真实来源 ... master 比本分支基线多一个 test-cppcheck 钩子，故"定义数 / CI 报告数"由 17/16 变为 18/17（实测本地跑 --all-files 得 17 条：passed=16 failed=1，那 1 个 failed 是本机 .map 陈旧导致的 mem-numbers，与门禁逻辑无关）。 同时更正一处机制性误述：stages:[commit-msg] 并不在项目配置里，它写在 gitlint 上游的 .pre-commit-hooks.yaml（本机可查证 ~\.cache\pre-commit\repo*\），所以在 .pre-commit-config.yaml 里 grep stages 一无所获、极易误判成"没有限制"。 受影响四处：AGENTS.md、ci.yml 头注释、测试开发标准流程 §9.1、CI配置指南 §6 与 变更记录，另 ci_local.py 文档串。	2026-10-12 13:09:19 +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
wandering1	33a4aa4945	本地工具路径DTU_*环境变量改造落地：10处调用点去硬编码+变量优先解析，本机全链路验证通过，文档同步收口，requirements补pre-commit	2026-10-02 22:14:49 +08:00
wandering1	f3befaed08	CI：补产物存档与结果汇总，明示体积门禁盲区（S3+S14）	2026-10-02 11:55:31 +08:00
wandering1	df9a566982	CI：诊断 pre-commit 仅装于用户态导致 SYSTEM 不可见 ... 第五次运行（run#5）L0 仍失败，但错误信息已指向真因： 自检步骤 3 个候选解释器（msys64 / .venv / anaconda3）全部探测失败。 根因（已实测定位）：本机 pre-commit 装在 C:\Users\Administrator\AppData\Roaming\Python\Python312\site-packages 即 Administrator 的【用户态 user-site】。runner 以 SYSTEM 运行，其 %APPDATA% = C:\Windows\system32\config\systemprofile\AppData\Roaming， 根本看不到该目录 → 换任何 python.exe 路径都无效。 （已盘点本机全部 python：anaconda3 3.12.4 / workbuddy 3.13.12 / msys64 3.14.5，以 -s 禁用 user-site 后 pre-commit 均为 rc=1。） 本次改动（workflow 侧，配合外部的全局安装）： - 探测改用 `& $py -s -m pre_commit --version`（-s 禁用 user-site）， 只有 SYSTEM 真能用的解释器才被选中 - 后续 install / run 同步加 -s，保持判定一致 - 失败信息明确指向 user-site 不可见 + 给出修复脚本路径 （install_precommit_global.ps1，装到 anaconda3 全局 site-packages） 真正的修复需管理员执行该脚本（本会话无提权权限，pip --no-user 报 WinError 5 拒绝访问）。装好后 L0 即可通过。	2026-10-02 01:29:55 +08:00
wandering1	48b33921c0	CI：修正 python 探测被 NativeCommandError 中断 ... 第四次运行（run#4）L0.5 已 PASS（status=1，MSVC 探测 + 39 单测全过）， L0 仍失败于自检步骤自身的一个 PS 5.1 行为： & $c -m pre_commit --version *> $null → NativeCommandError，脚本中止 根因：$ErrorActionPreference='Stop' 下，原生命令写 stderr 会被 PS5.1 当成终止性错误（NativeCommandError），即使 *> $null 重定向也无法阻止； 于是第一个候选（msys64 python，无 pre-commit）就把整个 for 循环打断， 根本轮不到 anaconda3。 处置：探测每个候选时临时把 $ErrorActionPreference 降为 'Continue'， 用 2>&1 | Out-Null 吞掉输出并取 $LASTEXITCODE，循环后恢复 'Stop'。 已在 WinPS 5.1 本地实测该探测逻辑： msys64 rc=1 → .venv rc=1 → anaconda3 rc=0 选中，STEP OK。	2026-10-02 01:24:50 +08:00
wandering1	8e7b22184e	CI：按 SYSTEM 账户视角修正 Python / cppcheck 探测 ... 第三次运行（run#3）已越过 PS 语法问题，环境自检真正执行， 暴露 runner 真实环境缺陷： 1. cppcheck 只在【用户级 PATH】，SYSTEM 账户看不到 → 报 runner missing cppcheck。已在自检步骤加回落到 C:\Program Files\Cppcheck 并写入 GITHUB_PATH。 2. 更隐蔽：SYSTEM 的 python 解析到 C:\msys64\ucrt64\bin\python.exe (3.14.5)，而该解释器【没有 pre-commit】（AGENTS.md 亦明令 不得用它跑依赖第三方库的脚本）。若不修，自检通过后 L0 会在 pre-commit 步骤炸。 处置：在自检步骤按 scripts/ci_local.py 同一探测序 （PATH python -> .venv -> anaconda3）挑出真正装了 pre-commit 的解释器，导出 PYTHON 环境变量供后续步骤使用。 L0.5 是独立 job（GITHUB_ENV 不跨 job），同法就地选一个可用 python（主机侧单测为纯标准库，任意 python3 均可，已用 msys64 python 实测 39/39 PASS）。 附带：run 块保持纯 ASCII（上次修正），全部 shell=powershell。	2026-10-02 01:21:10 +08:00
wandering1	e241fea801	CI：run 脚本改纯 ASCII（PS5.1 按 GBK 解码临时 ps1） ... 第二次 CI 运行（run#2）仍失败，但失败点前移： pwsh 问题已修（环境自检步骤确实由 Windows PowerShell 5.1 执行） 新错误：TerminatorExpectedAtEndOfString @ 含中文那一行 根因：runner 把每个 run: 块写入临时 .ps1（无 BOM）交 PS5.1 执行， PS5.1 按 GBK/CP936 解码 → UTF-8 中文字节与相邻引号错位 → 字符串缺少终止符（报错行号即含中文行，极易误判）。 与 AGENTS.md「字符串字面量必须纯 ASCII」同源。 处置：所有 run: 块内改为纯 ASCII（提示语改英文），中文仅保留在 YAML 的 name:/注释（Gitea 按 UTF-8 读、不喂 PowerShell，安全）。 workflow 头部补该坑说明。已用脚本核验 run: 块内零非 ASCII。	2026-10-02 01:17:24 +08:00
wandering1	09e45573c8	CI：修正 workflow 的 shell 为 powershell（pwsh 不存在） ... 首次 CI 运行（run#1）两个 job 均失败于同一处： Cannot find: pwsh in PATH 根因：workflow 用 shell: pwsh（PowerShell 7，非 Windows 自带）， 而 runner 所在机器只有 Windows PowerShell 5.1。 改为 shell: powershell（7 处）。已核验脚本无 PS7 独有语法 （无 ?? / ?: / && / || / -Parallel），PS 5.1 完全兼容。 workflow 头部补该坑说明，防止将来误改回 pwsh。 注：本次 CI 已验证 actions/checkout@v4 可从本实例正常拉取并 成功检出 v2-on-ui，action 拉取链路无需调整。	2026-10-02 01:11:45 +08:00
wandering1	e90486524d	CI：Gitea Actions 落地 L0+L0.5（补 T-6） ... 新增 .gitea/workflows/ci.yml：push/PR 触发两个 Windows job—— l0-gates 跑 pre-commit --all-files（无 Keil .map 时自适应跳过 mem-numbers）， l05-host-unit-tests 遍历 test/host/**/run_unit_test.py（缺 MSVC 则告警降级跳过）。 刻意不跑 @build（需 Keil 授权）；L1/L2/L3 需真机+ST-LINK，不上 CI。 新增 scripts/ci_local.py：本地跑与 CI 等价的门禁（自动选用装了 pre-commit 的解释器；.map 自适应；退出码 0/1/2 与 CI 对齐），供提交前自查与 runner 就绪前过渡。 文档同步：测试开发标准流程 §9（CI 章节）/§1/§4.1、待处理内容 T-6 销项、 项目部署环境要求 §2.11（runner 前置）、pre-commit 使用说明 §1、scripts/README.md、AGENTS.md。 验证：scripts/ci_local.py rc=0（L0 14 钩子全过 + L0.5 39/39）。	2026-10-01 10:19:38 +08:00