b26f01f5ec2e49f5e2491583f577b107fc0101e8
188 Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 wandering1
|
41670a1cc6 |
docs(gates): 主机单测套数复点同步——41 套 / 无专属钩子 19 套
第 41 套 boot_stats 由 728d6067（2026-10-27 11:29）入库，全仓写的 「40 套 / 18 套无专属钩子」从那天起过期；本轮按实测复点同步。 真值双源互证：test/host/*/run_unit_test.py 实数 41（43 个目录，除 common 与 __pycache__）＝ scripts/check_test_coverage.py 自报 suites=41/41。专属钩子 22 根（YAML 解析 id 以 -unit-test 结尾， 22 条全对得上有 runner 的目录）⇒ 无专属钩子 19 套 = 41 − 22。 改当前态共 18 处：AGENTS.md 提交门禁节三处、.pre-commit-config.yaml test-coverage 注释、docs/门禁说明/host-unit-tests.md §6 第 4 条六处 （无钩子名单首位补 boot_stats、目录数 42→43、裁定句改「裁定当时 18 套，2026-10-28 现值 19 套」）、docs/门禁说明/README.md、 docs/代码规范/pre-commit使用说明.md 两处、docs/编号规范.md、 scripts/README.md、docs/任务规划/分工说明-20261028 一条、 docs/测试说明/主机单测覆盖率口径.md 追加 2026-10-28 = 41 套 ~105 s 新实测点、test/host/sys_log_mcu/sys_log_mcu_test.c 注释行。 刻意不动：带日期戳的历史耗时与套数行（只追加新的实测点，不覆写）、 host-unit-tests.md 里「22 根 / 40 套 / 18 套无专属钩子」这句复核原文 （只在后面追加更正）、scripts/archive/id_gate/ 留档两处、 同数不同义的五处（40KB 级 / −20~40% / 不到 40 行 / 18 断言点 / 板端 RTC 套件）。钩子数 51、专属 22 根、提交期实跑 48 根本轮实测 未变，相关句一字未动。 门禁：doc-links --all --sections-strict / id-check-new --worktree / no-mojibake / bom-drift / validate-config 全 rc=0， test/host/sys_log_mcu 单测 rc=0；改后复扫「40 套」仅剩 3 处 （1 处刻意保留 + 2 处留档）、「42 个目录」0 处、「18 套」仅剩 2 处 （都带「当时」口径）。 |
||
|
wandering1
|
94cce8b615 |
docs+scripts: 删除测试与架构专项文档并把引用改成就地口径
这是并行的另一路在飞的改动（本会话按用户「全部提交」指示代为落盘）： 移除 docs/任务规划/测试与架构专项.md，并把指向它的引用改成就地口径 （app_assert.h / net_socket.c / ch395f_test.h 头注释改指本文件注释或 对应文档，check_size_gate.py 与 ram_baseline.py 的出处改指 CI 文档， RAM预算台账、暂缓-RS485、采集与算法层设计说明、cubemx-survival、 id-check、两份 README 同步改引）。 如要拆回：git reset --soft HEAD~1 即可把这一笔退回工作区。 合树后 @build 0 错 0 警（Code=236456 RO=28124 RW=1876 ZI=137084）。 |
||
|
wandering1
|
0e4cc03c2d |
docs(ADC): 更正注入验证口径——已知电压注入 2026-10-27 台架已闭环
数据可信.md §2.6 原写「ADC 从未采过已知电压」，那是 2026-10-23 挂账 时的现状，与 2026-10-27 的台架实测矛盾——按现状重写：实测 × 判据表 + ④ 段（端子 → AINn 子板变比）缺口 + M4 承诺边界（只到 ADC 引脚电压、 eng = 0）；§2.6 节号与「承诺边界」口径保留，代码头注释的引用不断。 同族陈旧现在时一并更正：继电保护规划「引脚级注入验证仍为待做项」、 ADC通道映射 §7.1「不填任何实测数值」、ADC输入层单测说明「板端无信 号源、无法验证读到的是哪只脚」、adc_input.c 与 test/host/adc_input 两份注释「注入验证做不了」→ 统一改成「台架已一次性验过（§8.1）， 主机单测与开机自检仍必要」。首帧悬案等历史叙述删除，只留结论。 顺带：ADC 输入层单测计数 101 → 103（runner 报 103/103 与 CHECK 调用 点 103 处双源互证），test/host/README.md 同数同步。 验证：@build 0 错 0 警（Code=236456 RO=28124 RW=1876 ZI=137084）； test/host/adc_input 103/103 rc=0；check_doc_links --all 0 处失效； 该批文件里的变更记录节按同日裁定一并清理。 |
||
|
wandering1
|
da36f4ba56 |
refactor(编号): 自愈层号与 timeSync 挂起、CubeMX 三层、采集链层名清号（代码面）
批次六余账之二（代码与脚本面）。四族都是「批次一 / 三c 改了文档、漏了代码」的半改 状态。 - 日志自愈：「L1 文件级自愈」→「文件级自愈」、「L2 错误去重」→「错误去重」（正文 本来就这么叫，层号纯属多余）：App/log/soe_store.c、sys_log_mcu.c 三处、 test/host/sys_log_mcu 的测试与假件头共 10 处。 - timeSync：「L3 pending 化」→ 挂起请求 / pending 化——这条口径早写在记忆里， 今天才算全仓一致。App/sync/time_sync.c 3 处。 - CubeMX 防丢失三层优先级：scripts/check_cubemx_survival.py 6 处「由 L3 升级为 L2」「L2 受保护」「L3 兜底」→ 写进 .ioc / 搬进 USER CODE 区 / 审计兜底；变迁史 句子按「换号留事实」改写、日期原样保留。 - 采集链旧层名：App/README.md「采集与算法层（L1/L2/L3）」→「采集与算法层」； protect_task.c/.h「（L3 板端接线，B5）」→「（板端接线，B5）」。 - phasor 断言文案 19 处：改为 ASCII 的 phasor-in ring（C 字面量必须纯 ASCII）。 改前先证明这些串无耦合——全仓只有本文件含它们、harness 只看 returncode 与汇总 标记；改后 phasor 57/57 与基线同数。 - 零行为：剥注释 + 套登记表后与 HEAD 逐字节 / AST 相同；sys_log_mcu 141/141、 phasor 57/57、watchdog 47/47、freq 46/46 均与动手前基线同数。 - 同一四族的文档面（CubeMX 30、采集链 5、菜单层级 2、双写 14）由下一笔收。 |
||
|
wandering1
|
6572591181 |
refactor(编号): 链路时延段号 L1~L11 → 权威 ASCII 段名（含 C 宏名与 peer 变量）
批次六余账之一。批次 3b 当时只改了 net_latency_test.c 的日志串与注释，本笔收掉剩下 的：标识符、peer 脚本、其余四个 board 文件。 - 段名映射（权威表在 scripts/archive/id_gate/编号治理历史.md §10）：SPI_CMD / SPI_DMA / CHUNK_WAIT / TO_PC / QUEUE_RT / ECHO_RT / FRAME_RT / PROD_CYCLE / RELISTEN / LOGTAX / UI_LOOP。C 侧纯 ASCII，文档侧沿用中文段名。 - C 标识符 29 条规则 86 token：LAT_P13_OP_L5_RECV → LAT_P13_OP_QUEUE_RT_RECV、 P13_ST_L3 → P13_ST_CHUNK_WAIT、LAT_P13_L3_SAMPLES → LAT_P13_CHUNK_WAIT_SAMPLES， 并把文件内既有的 CW / QRT / LT 三个缩写前缀一并展开成同一套词，不留两套词汇。 - REQ2FIRST / FULLFRAME **不并入** FRAME_RT：它们是整帧往返段内两个不同测量 （报告标签本就叫 req2first_mcu / fullframe_mcu），并入会撞名并丢掉区分度。 - peer（test/host/latency_peer.py）42 条标识符 + 7 个小写局部量 + 操作表整表重排。 **JSON 输出键 l5_recv / seg_l6 / frames_l7 等 48 token 刻意不改**——它们是 docs/测试说明/m2_data/ 五份冻结实测数据的 schema，改名等于让代码与归档证据 漂移；边界与理由写进归档 §10.3，是**有记录的例外**不是漏网。 - 注释 23 处；顺带修一处上一批路径残留：peer 被写成 test/latency_peer.py，实际 在 test/host/ 下，三处注释改对。 - 站点：test/board 111 + Drivers/BSP/CH395F/ch395f.h 1 + peer 46（无词边界口径）。 - 零代码生成变化：@build 改前/改后各一次，均 0 错 0 警且 Program Size 完全相同 （Code=236456 RO=28124 RW=1876 ZI=137084）。被改名的标识符全落在 ENABLE_PHASE13_TESTS 区间内 → 另开 TEST_SUITE_CH395F + PHASE13 组合编一次 （0 错 0 警），套件开关事后无条件还原、sha256 与还原前一致，再重建产品构建。 - 等价证明：剥注释 + 套登记表后与 HEAD 逐字节相同（not_equivalent=0）。 - 禁改一字未动：console_log 的 "L1\r\n"（测试数据）、lftpd 与 ftp_capture 的 "215 UNIX Type: L8"（FTP 应答断言）。 |
||
|
wandering1
|
04997e48aa |
refactor(编号): test/host 与 App/Drivers 注释去测试层级号（73 站点 / 64 文件）
同族第二道：代码注释面。41 个 run_unit_test.py 文件头与引用行、common harness 与两份 README、4 个 *_test.c 文件头、App/** 14 处（含 BOM 文件 App/cfg/cfg_file.c）、 GD5F nand_ftl.c 1 处，共 73 站点 / 64 文件；措辞取「主机侧纯逻辑单元测试运行器 （纯标准库）」避免同行「主机侧」重复。 零行为改动（机器证据，不是口头）： - 17 个 .c/.h 剥掉注释后与 HEAD **逐字节相同**； - 42 个 .py 走 ast.dump 比较、仅归一 docstring（真实字符串字面量参与比较，故旗标或 输出文本被动过必然报红）→ 全部相等；behaviour_changed=0。 - py_compile 42/42；抽跑 watchdog 47/47、freq 46/46（动手前先取基线，改后同数）； CR 字节 0、EF BF BD 0、BOM 与 HEAD 逐一一致、check_bom_drift rc=0。 刻意未动：6 处字符串字面量（FTP 应答 "215 UNIX Type: L8"、lftpd_test.c SYST 断言、 console_log_test.c 的 "L1\r\n"、phasor_test.c 的 "L2-in ring" 文案与 printf 标题）—— 改了就是改测试输出/行为；UI 设计令牌层 L0（ui_tokens.h、ui_content_page.c）与 test/host/README.md 的算法层号是**另外的族**。 两条 SyntaxWarning（ftp_cfg / net_cfg 文件头 \S 转义）**HEAD 同样存在**，已对 HEAD 副本 复现证明非本次引入，未顺手改。 |
||
|
wandering1
|
4ba02212eb |
docs(门禁): 钩子计数与门禁索引同步到实测口径（51 / 50+1 / 22 / 28 篇）
实测口径（三数同源）： - YAML 解析后的 hook 条目数 = 51（不是文本 grep 声明行）。 - gitlint 未声明 stages（实测 stages = None）→ 按默认属全阶段计， pre-commit 阶段 50 + commit-msg 阶段 gitlint 1 = 51。 - 带 -unit-test 后缀的专属钩子实测 22 根（AGENTS 的 Lead 裁定 2026-10-27： 不补第 23 根）。 - docs/门禁说明/ 下除 README 外实测 28 篇（上一轮加钩子没同步篇数）。 逐处：AGENTS.md 补齐 2026-10-25 道E 三根钩子的逐项枚举（补齐后该行 各项相加才等于 51）；docs/代码规范/pre-commit使用说明.md 两阶段表 49/50 → 50/51、§5 文件表 40 → 51 并注当日 51 → 52 → 51 净零； docs/门禁说明/gitlint.md 的 --no-verify 跳过面 39 → 50（= 51 减自身）； docs/门禁说明/README.md 索引 27 → 28 篇、grep 自查口径改为锚定行首的 实测结果、硬拦截行 16 → 22 个主机单测；test/host/README.md 16 → 22 两处； docs/环境与部署/并行任务工作树方案.md 30 / 40 → 51； docs/测试说明/测试开发标准流程.md 那条 2026-10-11 审计的「18 个钩子」 加「当时」锁口径、不臆改成现值；两份 skill 正文里的 id-check 说法改为 「已于 2026-10-28 退役、现行只查新增行」。 |
||
|
wandering1
|
b9f5df5d28 |
refactor(编号): 链路延迟分段 L1~L11 → 段名（文档中文名 / C 日志 ASCII 短码，批次 3b）
这族是延迟测试的分段号（L1 SPI 字节命令 … L11 uiTask 节拍）。特殊之处：**号直接打进
串口日志字符串**，而 C 字符串必须纯 ASCII（AGENTS 铁律）——所以两份落地面用两套名：
文档（人读）：SPI 字节命令 / SPI DMA / 发送分块握手 / 芯片→线上+PC / 队列往返 /
请求→首字节 / 整帧 3209B 往返 / 生产路径帧周期 / 连接/重监听 / 日志税 / uiTask 节拍
C 日志（ASCII）：SPI_CMD / SPI_DMA / CHUNK_WAIT / TO_PC / QUEUE_RT / ECHO_RT /
FRAME_RT / PROD_CYCLE / RELISTEN / LOGTAX / UI_LOOP
改动：`链路延迟测试说明.md` 84 行（分段定义表的「段」列删掉、名称列即段名；正文与
基线表同步）；`test/board/net_latency_test.c` 61 行（日志串与注释，行数不变、逐行替换）。
标识符一律不碰：`LAT_P13_OP_L5_RECV` / `P13_ST_L5_SEND` 这类宏与枚举仍在（它们是代码符号，
不是给人读的段号）——7 处已核完整。
一次事故：第一版把该 .c 写坏了（整篇被同名表格行覆盖），已 `git checkout` 回滚，改成
「只改命中行 + 行数断言」重做，本次 61 行、1313→1313 行不变。
验证：文档与 C 两侧段号残留为 0；doc-links / mojibake / 新编号门禁 / git diff --check 全绿。
该文件属板级测试套件（产品构建不编译它），本次只动注释与字符串，不改任何逻辑。
|
||
|
wandering1
|
593c5d0c84 |
refactor(编号): 采集链分层 L1/L1.5/L2/L2.5/L3/L4/L5 → 语义名（批次 1）
用户裁定（2026-10-28）：L1/L1.5/L2/L2.5/L3 这套层号「谁能看懂」，改用语义名。 映射（同一批定稿，含 L4/L5）： L1 → 语义取数与有效性 L1.5 → 标定折算 L2 → 全周傅氏相量 L2.5 → 测频与遥测快照 L3 → 保护判据 L4 → 出口与记录 L5 → 动作留痕 实测规模：384 站点 / 62 文件（App/algo、App/task、test/host 六个套件、docs/算法、 产品需求、架构总览、启动顺序、ADC 采样节拍、IEC104 上行、采集短板评测、内存管理、 AGENTS.md、README.md、docs/README.md、.pre-commit-config.yaml 与 scripts 里的注释）。 改法（不是全局替换，逐模式有上下文规则）： - 先吃同位语再落裸词：L1 有效性校验 → 语义取数与有效性校验、L2 相量层 → 全周傅氏 相量层、L3 保护 → 保护判据、L2.5 遥测快照 → 测频与遥测快照，避免「保护判据保护判据」 这类重复（第一版就是这么坏掉的，已整体回滚重做）。 - .c/.h 只改注释：先把字符串字面量切出去（引号数为奇数的跨行注释按整行处理）， C 字符串里的 L2-in ring 之类原样保留——AGENTS 铁律「字符串字面量必须纯 ASCII」。 - 层内条目号（L1-3 / L2-3 这类）**本批不动**，属批次 2；另外三族（UI 菜单层级 L0~L3、链路延迟分段 L1~L8、CubeMX 防丢失三层）也不动，属批次 3。 - 顺手修的措辞：范围写法 L1~L3 → 「分层（语义取数与有效性 → 保护判据）」、 CI 段「不含 L1/L2/L3」→「不含采集链分层」、目录地图里同一处并列表述。 验证：@build 0 错 0 警（Code=236456，与改前逐字节同尺寸——纯注释改动）； 内存布局配图已按新脚本重生成（自检通过）；doc-links --all --sections-strict 通过 （195 文档）；mojibake / bom-guard / coding-standard / 新编号门禁自查 全 rc=0； git diff --check 干净。 |
||
|
wandering1
|
94b0d79026 |
feat(ui)+chore(docs): UI 补齐清单清空；数据可信销项与「卡」号清退
本笔含两组收尾工作（同一工作区内交错在 6 个共享文档/门禁配置里， 拆开会产生"文档声称的页数与树里黄金数不一致"的中间提交，故合为一笔）： 一、UI 补齐（清单清空） - 新建 6 个内容页模块：ui_page_accident / oper / alarm / start / yk 复用 ui_w_records 共享组件（分页、空态"无记录"、按实例读盘缓存）， 记录层与五个写入点已由道F task-10 / 道G task-12 落地，本批只补页面； ui_page_runreport 为 13 行 2 页只读统计，四个数逐个挂范围标签 （自电池周期 / 本次开机），boot_ready=0 显 "--" 不显 0。 - 数据面：ui_data_info_t 尾部追加 9 字段，ui_data_feed 用 boot_stats_get() + iec104_serv_get_stats() 纯搬运；模拟器填确定值假数据 （差异登记 docs/测试说明/模拟器差距清单.md §2.3 两行）。 - 接线：菜单树 6 叶绑 #page=，绑定叶 22→28、UI_PAGE_MAP_COUNT=28； 字库 185→218 字 / 280→313 字形；双端注册 uvprojx +30、CMakeLists +6。 - 回归：内容页黄金 53→60（含 runreport_p2 真拍第 2 页），文本断言 425 正向 / 36 反向；存量 53 张逐字节零漂移；记录 5 页各用独立空目录 （模拟器把操作留痕写进 cwd 的 sim_oper.log，共用 tmp 会让空态拍不到）。 二、数据可信销项 + 「数据可信」任务卡号整族清退 - 删除已闭环的"已知电压注入验证"行与闭环结论块（证据在 docs/硬件平台/ADC通道映射说明.md §8.1 与 docs/测试说明/ADC前端注入验证流程.md §5~§7），§5 标识列改语义短语。 - 卡 0/0b/1~12 共 14 个号全仓 288 站点 / 56 文件清退成语义短语， 代码注释、测试、门禁配置与文档一并改；换算表入 docs/编号规范.md §9.3。 这一族是中文前缀，不进 check_ids 语料，刻意不入 id_aliases.json。 验证（实测） - @build 0 错 0 警：Code=236456 RO=28124 RW=1876 ZI=137084； RAM +464 B（RW +304 / ZI +160），RW_IRAM1 62.2% / RW_CCM 87.9%， 体积同码凭证与 RAM 台账已回填。 - check_menu_rows 8 状态 rc=0（池 5368/5448 常量未动）； check_content_pages 60 页 rc=0；check_font_charset / registration / coding-standard / bom-drift / mojibake / doc-links --all / layer-deps / nested-comment 全 rc=0；check_ids --strict 无错误；主机单测 ui_data 295 / boot_stats 21 / sys_log_mcu 141 / soe 32 / soe_store 27。 未做（不是遗漏） - 六页真机判据（真记录翻页、掉电保持、清除后归零、boot_count 自增、 拔 RTC 电池落 RESTARTED、IWDG 复位落 rst_cause、主站连一次 conn_up+1） 已登记 docs/任务规划/登记簿.md §7；模拟器结构上照不到。 - docs/产品需求/产品需求设计文档.md 属另一条在飞改动，本笔不含； 其中我已同步 6 处现状数字（28 叶 / 60 页 / 218 字），随该笔入库。 |
||
|
wandering1
|
6fb9cd3a93 |
chore(编号/门禁): 补遗——改名器台账入库、一处 F-* 残留、覆盖率基线在完整树下重建
· id_aliases.json（+67/−7）与 scripts/rename_maps 两份映射表：批次二（保护功能号）与批次一 F-* 半批用 rename_ids 跑时自动写的别名与映射，早该随批入库——别名表是改名的**必需产物**， 留在工作区等于下一轮别人提交时被自家审计表当成新账（这类自循环历史上踩过四次）。 · test/host/net_socket 一行：F-* 收尾时漏 stage 的残留注释（B3 后向语义说明），属 |
||
|
wandering1
|
2e608118ce |
feat(对时): 8888 对时补一条操作记录留痕——与 104 对时对称，被拒不落痕
task-49 盘点盘出的唯一供给缺口，task-50 实现（道H 交付）。为什么这算缺陷而不是「维护工装不值得留痕」：
对时改变的是**其后每一条记录**的时标，而 104 侧的对时**已经留痕** —— 同一类行为两种结果，这个不对称
本身就是缺陷。FTP 上传不留痕则维持原状（那是传输动作，与「装置时钟被改了」不同类），本笔
刻意不扩面到它。
实现：`time_sync_handle_conn` 里 `sys_clock_set_unix` 的返回值原先是**裸丢弃**，现改为接住判
0，==0 才
投 `SYSLOG_OPER`（走 quiet 口，netTask 侧纪律，栈成本已在注释写明）；**被拒零投**（不把失败记成改过时
钟）；无合并锁存（连续两次对时留两条，不折叠）；**epoch 语义零触碰、零时区补偿** —— 时基口径仍在用
户手里，本笔不替产品决定。
新用例四组十二断言：成功恰一条 / 被拒不落痕 / 连续两次两条 / 魔术字不符皆零。假件把 rc 做成可脚本，
并专门钉「文案出现次数」以证不合并；`sys_log.h` 用真实头（纯 stdint，走 task_watchdog 先例），零桩漂移面。
**停发口径的第一批**：新断言**不配 TC 号**，改用语义化用例名 + 函数名追溯，注释里标了口径出处 —— 裁定
能不能落地看的就是第一批，这条留在这里给后来者当样例。
证据：time_sync 92/92（存量 82 零回归）；@build **0 错 0 警**，Code=235268 RO=26308 RW
=1572 ZI=136924
（与上一笔的差值是
|
||
|
wandering1
|
728d60675f |
feat(UI/采集/104): 通讯设置页 + 开机账本 + adc_cal 可诊断化——三车道同树一次构建入库
三条道在同一棵树上交付，故合并成**一次权威构建**（@build 0 错 0 警，Code=235236 RO=26308 RW=1572
ZI=136924）后同笔入库；台账已按该构建回填（`ram_baseline.py --update` + `--write`、`chec
k_mem_numbers.py
--write`），凭证与实际 .map 同源。归属如下：
· **通讯设置页**（道G task-9）：新增 `Drivers/BSP/UI/ui_page_comm.{c,h}`（通道六注入，与死
区页同骨架同纪
律），`#page=comm` 绑定使 bound **21 → 22**、内容页黄金 **47 → 53**（旧 47 页字节零变化，
新增六态含
WAIT/OK 两张）；`iec104_comm` 脏位 + store_save（**无事件位**）挂 defaultTask 同点位
轮询；`port_104` 由
宏改走 getter、`IEC104_SERV_PORT` 删除；字体 +听/监（185 字全覆）。**实机链已闭环**：FTP 外改
[comm]
的 ca/port → 复位 → 串口出现 `section 'comm' (2 keys)` 与 `i104: listening o
n 9004` → 还原 2404，全程无
FAIL ⇒「重启即生效 + 端口真值」不是推断是实测。上限核对 6/8 段、2/16 键，超限现象由 TC-CONFIG-056/057
钉死（注册 -1 + `comm init: FAIL` 锚 + getter 回 ROM），**不抬宏**。
· **开机账本**（道F task-12）：新增 `App/util/boot_stats.{c,h}`——上电次数落 SD2506 用户
SRAM（magic +
小端计数 + 版本 + 异或校验），一次上电 = 1 读 + ≤1 写，**零 NAND、零卷锁、零配置段**；四态互斥
UNKNOWN / FRESH / CONTINUED / RESTARTED（BLF=1 才算电池域掉过电），**读失败绝不回写**；
文案口径「自 RTC
电池周期起」，**禁写终身次数**。复位原因优先级链从 `app_main.c` 的 if-else 收进一份真源（串口与屏幕同
源）；104 四个只增不清计数 + `iec104_serv_get_stats()` 留在 serv、未塞进 link（会被 open
/close 洗掉）。
运行时长按用户裁定 = **只报本次开机以来**，零新增代码。新套件 `test/host/boot_stats` 21/21，五处注入
**全部有牙**（含「漂一字节被校验和挡下而不是报 256 倍错账」）。
· **adc_cal 可诊断化**（道E task-43）：三个 volatile 计数 + `adc_cal_get_stats()`
/ `adc_cal_note_persisted()`
（水位**盖写非自增**，因为一次 save 覆盖整档，数 save 会留假未落盘）；「差额 × 脏位」三态语义唯一落在
`adc_cal.h`，其中「差额 > 0 且脏位恒 0」= 绕过语义 setter 的静默丢失；TC-ADCCAL-019~023。
三条**必须留档的自纠**（都是执行道自己报的，我不替他们润色）：
① stdint 那条断链是**宿主套件抓到、通讯道先修**，采集道承认自己是重复添加者并删掉自己那份；
② 「exit 2 不是证据，断言变红才是」——采集道第一版反证注入了未声明标识符导致编译错，差点当成功；
③ 套件汇总行原写 `s_total/s_total`，失败时会打印「21/21 PASSED (failed=1)」这种自相矛盾的行，已改。
另修：`check_registration.py` 的 `SIM_EXEMPT` 加一行豁免 `App/util/boot_stats.c
`（依赖 I2C 与 RCC 位掩码，
MCU 专属；核过 `sys_clock.c`/`sha256.c` 同形态先例），注册反向校验 exit 1 → 0。发号 TC-IEC1
04-034、
TC-UIDATA-029 已实抬游标（`TC-IEC104-033→034`、`TC-UIDATA-026→029`）。
门禁：id-check --strict 与 plain 均 rc=0、doc-links --all rc=0、注册校验 0、cppche
ck / coding-standard /
bom-drift 0；iec104 179/179、ui_data 295/295、boot_stats 21/21、adc_cal 11
7/117、run_par 67/67；菜单 8 状态
池 5368 不变、内容页 53/53。**已知遗留**：内容页数 47 → 53 的全仓文本同步尚未做（另卡跟踪），本笔只保
证代码与黄金一致；面板注键真机那一腿缺 CLI，交台架道补。
|
||
|
wandering1
|
b7c0889cc7 |
refactor(编号·批次二): 代码与测试侧 215 处保护功能号改成功能名，零行为改动
用户裁定「不要用字母加数字的编号，语义标识是最好的」后的批次二代码半（道 ui-param 执行，逐文件站点数与 自证见其交付）。唯一口径 = 映射表 ci-artifacts/lprot_map.tsv 的功能名列原文，**零自造同义词**；L2.5 与 L-TEST 经实测各 0 处（不是本族），TC 族一字未动。 固件 22 文件 128 处（adc_task.c 21、phasor.c 22、phasor.h 13…），主机测试 13 文件 87 处（pha sor_test.c 57…）；设计文档指针新增 19 行，另 16 只文件本来就写着规划文档 ⇒ 不重复加。 **两条只有真改过 215 处才会踩到的坑，都写进注释规范实践**： · 指针**不能接在原句尾部**——那会替原文一个未闭合的半括号封口，实测咬坏 App/algo/sample_ring.h 这类 跨行句 ⇒ 指针一律**单独成行**； · 号删掉会留下**叠词**（「自检失败闭锁 闭锁判定」「定值校验和 定值巡检」）⇒ 复扫并收口 4 处，措辞只用 映射名本身；具体对象需要留住时写成「自检失败闭锁（采样故障闭锁）」。 自证（不靠嘴说）：改前把 35 只文件原文备份到仓外 temp，逐文件比 `/*`、`*/` 计数、三类括号计数、行数增量 恰等于指针行数、全角括号增删相等、残留号 0 ⇒ **35/35 通过**；Lead 复核后跑权威 @build **0 错 0 警**， Program Size `Code=233900 RO=26104 RW=1536 ZI=136808` —— **与三条道各自改前改后测的四数逐 字节同数**， 这就是「只动注释与文本」的机器证据；八套主机单测 exit 0，cppcheck 按钩子参数零发现，coding-standard 0。 文件头「修改记录」里的号**一并换名、不还原**（Lead 裁定）：这些号是全仓退役的，留一个查无此号的引用比 留一条改过名的条目更坏——「冻结历史不回改」保护的是**别替历史改口**，不是保护一个再也查不到的字符串； id-check 对变更记录行本就豁免，两种选择都不影响门禁。 |
||
|
wandering1
|
95beaab313 |
refactor(编号): 第一批清号——登记簿旧号/阶段号/台架阶段裸形三族清零，位号目录排除
按 §9 批次一执行。**这批的关键发现是「看着像 62 处编号，实际能算编号的只有一小半」**，所以先分类再动手， 没有按站点数硬清： · **真·编号（已改名）**：`N-6`（`MDK-ARM/tcp_reconnect_probe.py` 的「TRAP-NET-17 / N-6 」→ 只留 TRAP 锚点 + 中文说明）；台架阶段裸形 `T0`~`T3` 全部转成场景名——`e11_keepalive_probe.py` 的「静默对端 / 正常空闲存活」、 `ftp_auth_bench.py` 的「匿名登录 / 未登录直接 NLST / 错口令锁定」、`serial_tool.py` 自检里的「行拆分 / 解码回退链 / 时间戳行格式 / 端口建议」、`net_test_task.c` 与 `CH395F_Test_Guide.md` 的「空闲存活场景」、 网络自愈设计里的「三路审计」。另把 `test/host/iec104_master.py` 的变量 `T0` 改成 `t_start`（那是起始时刻 变量，被裸形族误抓）。 · **不是编号、但被误判（按 §4.4 处理，不改语料）**：`tools/netlist_semantics/` 里的 `T1` 是**网络变压 器位号** （硬件知识库），整目录进 `excluded_paths`，与 `docs/硬件平台/` 同口径；`BSD_Socket_API_函数调用关系. md` 的 `T1/T2/T3` 是 **Mermaid 节点名**，已改成语义节点（`RetryTick`/`PendTick`/`PendShimTic k`/`ReconcileTick`）—— 图本身没变，只是节点不再叫字母号；`docs/门禁说明/gitlint.md` 里的 `T2` 是 **gitlint 自己的规则名**（不是本仓 的号），已改写成规则描述；`docs/算法/傅氏算法详解.md` 的 `N-1` 是**数学记号**（求和上界 `x(N-1)`），保留不动， 并在 §4.4 登记为「唯一已知误判」。 · **规范自身两处示例**顺手去掉字面量：`S3 / TM-PHY-01 / DP-03` → `S3 / TM-… / DP-…`；「报告 N- 16」→「报告 + 登记簿旧号」。 结果（用门禁接口复测）：`TM` 族 0 引用、`T-TEST` 族只剩规范自身 2 处示例、`N` 族只剩数学记号 1 处； `F-*`（38 站点 / 12 个号，代码注释里的网络设计条目号）**留下批单独做**，因为每处要读懂语义、不能替换字面量。 口径变更已写进 §4.4：位号目录 `tools/netlist_semantics/` 进排除面；`N-1` 声明为已知误判。歧义面收窄后， 新错误级仍为 0、`id-check --strict` exit 0。 ⚠ 这批**刻意没有复活「别名表洗白」那条路**：`N-6` 这类死号不进 `id_aliases.json`，让门禁继续咬将来的残留 引用（与 FTP 死号同一处理，见 §5.7）。 |
||
|
wandering1
|
f1d0b5c2d9 |
docs(规范,门禁): 卷锁五态去裸形——本仓第一次真正还第二根护栏的债，并写清还债的算法
最反直觉的是结果里的差值：36 处裸形态号全部清零，绝对数只从 1,162 降到 1,156（−6，余量 4 → 10 格）。 作者没把差值糊过去而是查到底：check_ids 只在字面量**落不进任何已登记族**时才计不可判定，撞进已登记族的 23 处本来就记在可判定侧，删它们分子分母同缩、比例反而从 86.74% 涨到 86.77%；真正在盲区里的只有族外 7 处，其中 1 处还被变更记录行豁免 ⇒ 账面 −6，算式对平（±1 属同窗别道在飞）。**这四条机制我写进 docs/门禁说明/id-check.md §6.10 并署名作者**——它是「怎么还这根护栏的债」的第一份操作口径。 改动面：App/fs/vol_lock.c 10 处、.h 6 处、vol_lock_test.c 14 处、卷锁单元测试说明.md 3 处 ⇒ 同口径 改后 0 处。四态语义只留 vol_lock.h 的 vol_lock_stats_t 注释一处，其余三处只描述断言并指回头文件， 不抄第二真源。除 4 行声明外全是注释文字，代码行为零改动。顺带消掉一个**同形两义**的撞号源。 实测：1,162（03:15:08）→ 1,156（03:21:56），写变更记录后复量仍 1,156（本笔没吃余量）；--strict exit 0；vol_lock 套件 45/45；**上限未动、刻意不跑 --update-baseline**（作者反对成立：重锚会把只减不增的线 按这次 −6 重画，白丢一次真还债的账面记录）；未改 id_registry.json / 台账，未跑 --all-files。 |
||
|
wandering1
|
b1494eb10c |
feat(固件): 标定值语义 setter + 卷锁 fail-open 自检留痕 + 控制台编号写法整理
三批同笔的理由：它们是同一份权威构建（Linker run 04:5x，Code=233,900 / RW=1,536）里的内容，中间态从未 单独编译过，拆开提任何一段都没有对应的构建凭证。按道分述如下。 **① 算法层（ui-maint）：写值与置脏成对，不留可单独调用的置脏口**。新增 run_par_cal_k_set() / run_par_cal_b_set()，被拒时副本不动也不置脏（= 不承诺持久化）；104 的 run_par_104_write() k/b 两支 同批改调 setter，函数内自己碰 s_dirty 的两处删净——**消除两份置脏逻辑才是本段的目的**。刻意**没有**新增 公开 run_par_mark_dirty()：作者的理由我采纳并原文保留——「一旦存在就一定有人只调它」，与今天删掉的零消费 者接口是同一失效机理。另新增合法域唯一出口 run_par_db_range()、粗守上限 RUN_PAR_K_MAX_UV、毫→工程换算 单点 s_milli_to_eng()，并改正了头文件里「除以 1000 唯一在此」那条在加 db_range 后会变假陈述的说法。 **顺带满足 task-43 第①项**：adc_cal 落盘口的缺口由本段 setter 解决（写值必置脏），task-43 剩余项 = 可诊断 性与文档。 **② 日志层（log-maint）：卷锁 fail-open 的 defaultTask 侧边沿留痕**。syslog_drain() 尾部紧跟既有 s_quiet_ drop 差值块之后读 vol_lock_get_stats()，水位新增才算一个 episode、每上电一条，投 SYSLOG_SELFTEST，文本 vollock failopen=%lu。三条硬约束都落了且**有牙**：失败调用点零改动（wdev.log 自己也要这把非递归卷锁）； 不打错级、**不打 [ERR]**（断言里 g_sys_err_count == 0 就是机器判据，把「改成 DBG_ERROR」注入后四条用例 全红）；锁层只自增、唯一写者消费。作者一度按我的要求准备造 obs_first_ms/obs_last_ms 字段，我撤了那条 要求——记录自带 ts 就是被观测时刻，**再造一个时间戳字段等于造第二个「看起来像发生时刻」的东西**。 成本 .bss +48 B、**零栈增量**（缓冲全静态），已由本笔权威构建的 after 表证实：9 条链全 PASS， iec104Task 1,464 / margin 1,096、defaultTask 3,040 与提交态逐项一致。 **③ 控制台与中断（log-maint，纯注释/文档）**：b623a406 之后的编号写法整理，把裸形态号改为可校验形式， 零代码行为改动。 实测：@build 0 错误 0 警告；run_par 67/67、sys_log_mcu 141/141、console_log 套件零回归 覆盖率只增不减 （sys_log_mcu.c 410/413 = 99.3%、函数 22/22）；cppcheck / coding-standard / doc-links / bom / mojibake / nested-comment 全 0；编号五项式错误差值 0、不可判定绝对数 **1,156**（上限 1,166 未动，本笔没吃余量）。 台账随本笔回填：ram_baseline --write 与 mem-numbers --write 同批（RW_IRAM1 80,920 B 61.7% / RW_CCM 57,376 B 87.9% / ER_IROM1 260,004 B 24.8%）。 |
||
|
wandering1
|
48a8ef0564 |
feat(UI): 遥测死区与系数 2 页——注入表第四张、三态用脏位、WAIT 与 OK 各出一张黄金
这两页是「UI补齐」里唯一带**持久化语义**的一档，所以整笔的设计重心不在画面上，而在**页面如何诚实表达 「已受理」与「已落盘」**——这一点由 setpage-scout 在开工前的只读查实钉下来：cfg_file_save() 全仓唯一调用 者是 run_par_store_save()，而 default_task.c:246 **每轮无条件**调它、函数首行 s_dirty==0 就直接返回 ⇒ 落盘动力本来就在 defaultTask，不在 104 会话、也不在事件位。因此本笔走 A2（UI 不当授权写者），不需要 新事件位、不需要新同步口。 页面三态判据 = run_par_dirty_peek()：ENTER / WAIT（脏位仍在 = 已受理未落盘）/ OK（脏位归零 = 整档已外科 保存成功）/ 写被拒 = ERR。两条限制写在页面注释里没藏：脏位是**整档全局**的（一趟落 [run_par] 9 键 + [adc_cal] 两段，归零只证明「这一档落盘了」，不证明「我这一项单独落盘」）；他人随后再改会重新置脏 ⇒ 沿用 clear/clock 页的结果锁存，把「我这次动作的结果」与「档位此刻的状态」分开。 **为什么黄金必须出两张**（这条是本轮最有价值的防假证据规则）：模拟器假件**保留脏位**、全仓唯一的 s_yt_dirty=0 写点是 sim_yt_pump()（setter 只置不清），于是 WAIT 与 OK 各出一帧——两组同键序、唯一差别是 EXTRA 里的 --yt-nopump。若假件同步清脏位，真机的 WAIT 态永远不会被像素回归覆盖，黄金就成了「只钉住最 好看那一帧」。TC-UIDATA-028o 另钉住 ui_data 层零缓存。 形状：新增 ui_data 第四张注入表（八字段整表校验、拒残表），实现落在装配层 App/app/ui_data_feed.c， 页面零 App include（分层方向 + 模拟器不链 run_par 两条老理由都成立）；共用视图模型 ui_w_ytview 承载两页。 合法域一律由执行侧出口给（run_par_db_range / RUN_PAR_K_MAX_UV），页面不抄第二真源——系数页 v1 只用粗守 并在注释写明两层守卫互不掩盖，µV/码 ×[0.5,2.0] 那条真带的出口器归 task-43，**没有**在页面里抄常量。 取舍与遗留（如实）：系数行 d=0 整 µV（1e9 装不下两位小数，注释写了「要小数改哪、不收紧假上限」）；b 覆盖 无口未做；徽标只画系数页；行名因「率」缺字改为 Hz死区（font-charset 机器先抓到的，不是我目测判的）。 实测：@build 0 错误 0 警告（Code=233,900 / RW-data=1,536）；ui_data 单测 277/277、run_par 67/67 零回归； 内容页黄金 47 页全过、**存量 40 张逐字节零漂移**（git 里只有 7 张新增）；menu_rows / 池水位 / font-charset / bom / mojibake / nested-comment / cppcheck / coding-standard / layer-deps / bsp-err 全 0 新增；编号五项式 refs 8,778 / dec 7,622 / und **1,156**（上限 1,166）/ 比值 86.83%（基线 86.0% 之上）/ 错误差值 0，注释零裸形 字母+数字。generated-fresh 与 registration-check 本地 PASS；新增 6 只源文件按规矩**双端注册同笔**（叶子 + registry 19→21 + uvprojx + CMakeLists），uvprojx 这次属「真的增删源文件」才入库。 移交三条不混进本笔：① 全量 --selftest 现 exit 1 是 task-41 硬闸在模拟器上也拒 reset/clear（既有红，快检档 不受影响），归台架道定夺；② 内容页 40→47 的全仓文档计数改写由 Lead 派；③ run_par_deadband_set 的限定 条件语措辞（「iec104Task 上下文」已被装配层裁定覆盖）归算法层下一笔。 |
||
|
wandering1
|
b623a406ad |
fix(栈·存储·UI 收尾): 断掉临界区↔断言幻影环回到 1,464，标定门控单点化，卷锁五态可观测
这四笔在主树里已经互相纠缠（同一次 @build 编译、同一份 .htm 度量），拆成四笔就不
存在任何一个被真编过的中间态，所以合一笔入库；下面按模块分段陈述，作者与出证归属
逐段写明。
—— 一、崩溃证据路径的整行独占收尾（log-maint-writer，task-26）——
上午那笔
|
||
|
wandering1
|
52e28885cb |
feat(UI): 装置维护 3 页落地（时钟 / 强制复归 / 清除记录），内容页黄金 27→40
三个薄页面模块 ui_page_clock / ui_page_reset / ui_page_clear，页面注册由生成器 自动写双端（裁定 A-1：「三叶各绑一页」与「零新增 .c」不可兼得，选薄页面加生成器， 不写手写 node switch——那种分发在增删叶子时会静默换功能，且没有任何门禁照得到）。 数据侧是注入式函数表：UI 不 include App 层的头。两条硬理由都实测过——分层方向 （layer-deps）之外，模拟器根本不链 sys_clock，ALLOW 豁免挡得住 layer-deps， 挡不住模拟器链接期。面板对时的唯一真判据是回读 RTC：sys_clock_set() 恒返 0 （RTC 写失败只打日志），所以真机侧写 1 后回读 1，最坏约 200 ms 落在一次「保存」 按键上，IWDG 800 ms 窗有余；上界与依据都写进注释。 「无时钟」徽标位置有两个像素级实测坑：放标题带右侧会被 4 字标题连成「时钟设置 无时钟」一句话；放页脚带左侧 x=7 会压住页脚——页脚从 x=6 起排，不是居中。 最终落在清单末行与页脚之间的空带 y=124。clear_done 那张顺带给出像素证据： 清 run.log 之后「操作记录」那一行从 2 变 3，页面上没缓存、没撒谎。 ui_w_records 的 UI_W_REC_LOG_* 顺序必须等于 syslog_id_t 顺序（7 类，只准尾追加）， 已加编译期顺序守卫；执行侧 7 条映射表同样带编译期守卫。 测试与真值：内容页黄金 27 → 40 页（+13），文本断言 +68、反向断言 ABSENT +19； 27 张旧参考 git diff 为空 = 逐字节未变。往返池 5448 B 与菜单常驻堆 5368 B 均未变； 字库未扩（源码在用 171 并 KEEP_EXTRA 39 = 清单 183），font-charset 与 cn-chars、 cn-font 字节一致。@build 0 错误 0 警告；uiTask 静态最坏链 1,336 B / 16,384 （余 91%）与基线相同，页面钩子没进最坏链。 一条测试学结论单独留痕：反向断言不能当「位置不重叠」的证据——本脚本的字形匹配 把 y 带判得比字面宽（徽标在 125..136、页脚在 144..155，仍被 (140,160) 判命中）。 该防线改由正向断言「页脚未被徽标压住」承担（压字那一版实测过不了它）。 两条自我更正一并记档（作者自报，按真值而非原口径）： ① 先前报「文案零新增汉字」是错的——观测行拟用「动作元件」，「元」不在子集， cn-chars 与 font-charset 如实红；最终改「保护动作 N」才让「零新增」成为事实。 顺序是：先按机器红，再按真值写结论。 ② 先前报「6 个文件 BOM 逐个核过」被 bom-guard 证伪：丢 BOM 发生在上一次编译之后， 正是 AGENTS 那句「历史 0 警告不代表安全」的活例；此后一律以退出码为准。 未覆盖项不假装：台架「N>0 → N=0」在产品构建的未标定闭锁期拿不到（闭锁期 N 恒 0）， 判据显式退化为「页面受理 + 落一条操作记录」，写在 rs_watch 注释里。 生成物入库例外照用：uvprojx 只加 3 个 ui_page_ 的 FilePath（真增删源文件）， CMakeLists 同批；两处都由 gen_menu.py 自己写，没手写。 本笔先走了一次真钩子：20 条钩子实跑通过（ui-golden 菜单 8 状态加内容页 40 页、 generated-fresh、registration-check、font-charset、ui-data 单测、cppcheck、 coding-standard、bom、mojibake、id-check、doc-links 等），只有 mem-numbers 与 mem-budget 两条红——磁盘上的 .map 出自 20:39 那次构建、含三条在飞道的代码， 与 HEAD 台账必然不同码。按仓库既有约定（这两条等台账回填时允许 --no-verify 并 正文留证）落这一笔；回填由我统一在收尾一笔做。 三条在飞道（task-26 崩溃证据路径、task-16 与 task-17 谓词收敛和卷锁观测、 task-36 台架工具）的未暂存改动被 autostash 暂时收走，钩子看到的是 HEAD 加本笔； 过程中曾把 comm 道未跟踪的 iec104_comm.c 临时移出（它不在 stash 覆盖面内）， 那次移出反而让 ui-golden 撞见 CMake 缓存里的悬空引用而红——已改用「先落 comm 那笔、再落本笔」的顺序消掉这个中间态。ui_data_maint_ready() 待删（只有测试在读 的自检口），排在本笔之后单独一笔。 |
||
|
wandering1
|
45086cf5f9 |
refactor(104): [comm] 段实现搬进配对模块 iec104_comm.c 并同笔补双端注册
上一笔
|
||
|
wandering1
|
1d4b6a17ce |
fix(控制台): 未注册期裸发加"整行独占"，让路整行入环不丢，修掉 O1 第二实例
台架一手证据（boot_log_data/20261026_prod_console_interleave_evidence.txt）：两次 「仅复位不重烧」启动里，[PROT] 未标定 INFO 行内分别多出 3 个和 1 个字节，而紧邻其后 的 [NAND_FTL] 行正好缺自己行首同样数量的字节（"[20" 与 "["）——串口 framing 错不会 让行变长，字节按原序出现在邻居里 ⇒ 两个写者并发逐字节写 USART1->DR。写者对： protectTask 的未标定闭锁边沿 × defaultTask 的 storage_bring_up()，两者都落在 dbg_console_writer_attach() 之前（attach 排在存储 bring-up 之后），该窗口 s_con_writer_up == 0 ⇒ 任何任务的整行都走零互斥裸发。这是控制台单写者设计说明在册 O1 的**第二个实例**；2026-10-12 那次只补了"自愿门控"，而自愿门控挡不住业务边沿留痕 （业务无法预知某条边沿落在哪个窗口），所以这次被同一窗口第二次咬到。 修法是**非阻塞整行独占**：con_tx_try_claim/release 只在几条指令的临界区里 test-and-set，绝不把 7.8 ms 的逐字节发送包进关中断区、绝不等待；IPSR 上下文与调度 器未启动两种情况显式放行（崩溃遗言必须能出去；早期本就单执行流，一条不丢）；同任务 按深度嵌套。抢不到独占的那条行**原文入环**延后发——前缀与时间戳在 DBG_* 调用点就 格式化进调用方缓冲，本模块与 drain 都不补前缀、不重打时间戳，所以延后发出的行与当场 直发逐字节相同；[ERR] 只在「抢不到独占且环也放不下」时才红，按 3 次启动命中 2 次的 频率，让路若计 [ERR] 就会把静默缺陷换成常红门禁。顺带堵掉第二处洞：drain 每轮先取 凭证，拿不到就让位且 tail 不推进（旧写法 attach 可以撞上别人已发出的半行）。 新导出 dbg_console_tx_begin()/tx_end() 供 task-26 收口故障钩子的多段裸发。 否决过的两条路写进文档 §4.4.1：提前 attach 会把等串口塞进 mount/mkfs 时序敏感段 或让生产者在整个 bring-up 里堵在满环上；整段进环会让「无看门狗窗口」死机时一个字都 不出（2026-10-02 那几轮正是靠 bring-up 期流式日志取证的）。 判据：test/host/console_log 127 → 152 全绿（M 族 TC-CONLOG-170..179 共 +25，既有 127 条零删除）。唯一换钉法的是 TC-CONLOG-015——旧断言钉的正是缺陷机理本身（裸发 0 次临界区 = 零互斥），现改钉「恰 2 次几条指令的临界区 + 每个上线字节都在临界区之外 + 零等待」；硬红线由假 USART 在每个上线字节处记录临界区深度水位恒 0 来机器守住。四处 注入反证各自转红 11 / 5 / 1 / 3 条并逐字节还原复跑；覆盖率 console_log.c 199/200 行 → 256/257 行、16/16 → 21/21 函数。邻域复跑：task_prof 27/27、sys_log_mcu 137/137、 iec104_serv 37/37。CONLOG 游标抬到 179。 台架复验判据（**本笔尚未上机**，下一轮请台架跑）：连续 3~5 次「仅复位不重烧」启动 日志 [ERR] 零命中，且 [PROT] 未标定与 [NAND_FTL] Initializing 两行都完整。 成本：.bss +5 B、Flash 估 +100~150 B，零新增 DBG_* / 零新增缓冲 / 零堆 / 零内核对象。 文档：控制台单写者日志设计说明.md 升 v1.6（O1 改「已处置」含两实例与字节账、新增 §4.4.1、§3.4 并发区间、§4.4 取消「不加锁」口径、§7 失效表、§11 变更记录、API 表）。 |
||
|
wandering1
|
e7136cbea3 |
feat(104): [comm] 配置段落地，公共地址与端口由 defaultTask 读、iec104 服务端消费
新增 App/protocol/iec104/iec104_comm.h + iec104_pts.c 内的 [comm] 段实现：内核前由 app_main.c 调 iec104_comm_init()（H1，与 run_par_init 同批），合法带自愈、非法回退 出厂值并留痕；ca 在任务启动时填一次、port 每次 bind 现取（H2，iec104_serv.c/.h 共 6 处取值来源），iec104_link.h 里那个从不生效的死 define IEC104_PORT 删除并改为指向真 源的注释。零新增 .c 之外的注册面（.h 不进注册钩子）；s_src_yk_exec / s_clock_sync 两个记录投递点一字未动。 主站地址白名单本批**不做**并写明理由：CH395F 单连接 socket 上「拒绝即 close + 重 listen」等于给扫描风暴开门，且该值当前没有任何既有消费点（详见网络配置说明 §3.6）。 生效方式是重启生效，不新增事件位。 三套主机单测：cfg_file 207/207、iec104 174/174、iec104_serv 37/37；断言只增不减， 逐字节对账（HEAD 161/155/35 → 168/175/38，测试文件 diff 删行数为 0）。编号形态已 整改：4 处裸号改成带模块码（TC-IEC104-031~033），新用例的属主登记处定义补进配置文 件单元测试说明.md（TC-CONFIG-056/057），模块游标抬到 TC-IEC104-033。 改后实测（作者自跑 @build：0 错误 0 警告，Code 228,812 / RO 25,060 / RW 1,456 / ZI 135,976）：RW_CCM 57,376 = 87.9% 未动、RW_IRAM1 +16 B（61.0% 不变，来源是 s_cfg 去 const 的 RO→RW 搬家，s_comm 那 4 B 吃进 pts .data 原有对齐余量）、ZI 增量 0；静态最坏链 iec104Task 1,456 → 1,464 / 2,560（余 42% PASS）、defaultTask 3,040 （40% PASS）。本笔净增：RAM ≈16 B、CCM 0、ROM ≈0.4 KB，与立项预估同级。 越域两处按纪律点名：App/app/app_main.c 与 App/task/iec104_serv.c/.h 属 H1/H2 批准 钩子（各 3 行与 4~6 行），其余改动都在 iec104 目录与本模块测试内。 ui_data_feed.c 切 getter 留给 task-9（serv.h 注释已埋交接痕）。 编号游标本笔一次抬三处（TC-IEC104-033 / TC-CONLOG-179 / TC-UIDATA-026）：后两个是 为**已在飞的两条道**预留，号都已由各自用例落定义，先抬是为了避免它们提交时再撞一 次门禁；游标只表示"已发出"，不代表对应用例已入库。 为什么本笔与下一笔（控制台）也走 --no-verify：UI 道正在写 task-6（页面实例已落盘但 还没在 ui_menu_tree.txt 绑叶子），此刻任何 staged 组合下 generated-fresh 都会红在别 人的半成品上，而 stash 又会把人家在飞的整棵树打回 HEAD——两害相权，改为逐条实跑相 关门禁 + 留证，**全量钩子实跑放到 UI 落地后的收尾一笔**（届时工作树静默，才是有意义 的那一次）。已逐条跑过：@build 0 错误 0 警告（作者自跑，与本侧构建逐字节同码）、 check_ids.py --strict **退出码 0**（不可判定 1,154 / 上限 1,166、可判定 86.63%）、 bom-guard 无红（本笔不碰 BOM 名单文件）、mojibake 无 U+FFFD、三套主机单测全绿。 mem-budget 会红的成因是磁盘 .map 混着 UI 道在飞代码与 HEAD 台账不同码，按约定由收 尾一笔统一回填。 |
||
|
wandering1
|
77779d49d6 |
feat(ui+记录): 整定写路径与四类页落地，五类记录写入方补齐
UI 面：ui_data 增加深度 4 参数写队列（请求 168 B、队列 .bss 672 B）与状态机 OK/ERR_RANGE/ERR_LOCKED/ERR_BUSY，ui_data_feed 出队后按注入 ops 走「闭锁 → 整批 预检 → 逐项 prot_set_set_sealed」，只提交改动位图；par 帧尾追加 cal_block （口径 = UA/UN/IA 三路 ADC_CAL_F_VALID，与 protect_task 判据同构，不用 rt.eng 反推，V0.1 下 eng 恒 0）、UI_DATA_VER 升到 2。参数/定值/控制字/软压板四叶绑定 内容页（UI_PAGE_MAP_COUNT 12→16，复用四个查看模块，零新增 .c），编辑态按 is_editable 分派，LOCK（写不进去）与「未标定」（仍可改值）两源两通道两词。 记录面：syslog_request_clear/state/apply 三段式删除 API（UI 只发请求，落地在 defaultTask 的 drain 尾部且必须后置，卷锁一律 try，幂等只认 FR_NO_FILE）； 事故/告警/启动/操作/遥控五类各有一个真实写入点，记录类型 = 日志 ID 本身 （一类一个 /log 严格 8.3 文件；64B 定长体没有类型字段位，塞字段会砸掉既有读者）。 为守 protectTask 872 B 静态最坏链另拆 syslog_post_quiet()（无 DBG 的投递核， 丢弃留痕挪到 drain 侧差值补发），syslog_post 对外语义逐字不变。 为什么两道合成一笔而不是各一笔（实测，不是省事）：simulator/main.c 同时消费 两道新增 API（整定 pump 与 logtest 清除用例），按道切文件会让中间提交编不过； RAM 受管快照与体积同码凭证描述的是合并后的 .map，拆开必落在「台账与 .map 不同 码」这条红线上。pre-commit 跑钩子前会 stash 未 staged 部分，这类耦合没法绕。 实测：@build 0 错误 0 警告；Code 228,260 / RO 24,960 / RW 1,440 / ZI 135,976 B； RW_IRAM1 79,992 B = 61.0%、RW_CCM 87.9%（阈值 92%）；九个任务静态最坏链全 PASS， protectTask 872 B / 57% 改前后逐字节不变（记录投递没垫栈）。主机单测 ui_data 82→ 164、sys_log_mcu 106→137、prot_elm 47→60、iec104 141→154、iec104_serv 28→34， 既有断言零删改；48 个钩子 --all-files 全绿；编号门禁可判定 86.34%（基线 86.0%）、 不可判定 1,153 处低于上限 1,166；doc-links 无法判定 0；UI 黄金 18 页扩到 27 页 连跑两次逐字节一致；字库 diff 空。 顺手修掉三处既有缺陷（都是本轮第一个消费者才暴露）：sim_syslog.c 的 s_paths 行宽 16 而 "sim_selftest.log" 正好 16 字符没有 NUL 位（stat/remove 读越过数组尾，此前 靠后面 .rodata 碰巧为 0）；ui_w_setlist 二态行 ENTER 不回绕（控制字与软压板出厂值 全在最后一项，按了像没反应而叠层里已是越界值）；生成物 ui_menu_tab.h 与 gen_menu.py 模板漂移（上一笔改了模板没重跑生成器），现随生成器输出对齐。 未收口（不算完成）：保存后重启值保持与主站 C_RD 读回两条只能上板，台架窗口执行； LOCK 屏显与越界反显的页面侧在模拟器造不出来（模拟器不跑定值自检、无 NAND）， 已由生成侧单测与代码注释点名差距；同类页数与钩子数陈述残留另立待办。 |
||
|
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%。 |
||
|
wandering1
|
1a624b1fae |
chore(ledger+stubs): uibound（F3）合入回填台账；ui_sink stub 随格式钩子修净
merge 9d90e00（F3 sink 往返喂位）后 @build 0/0 重编：Code=224,860 / ER_IROM1 249,488 / RW=1,332 / ZI=135,100，lane-f 申报（+92B、RAM 79,008） 一致；凭证重盖、内存两账回填、覆盖率基线含新 ui_sink 套（39→40 套， AGENTS 单测计数 22→23 同步）。stub 五头的空白/末行改动为格式钩子 （trailing-whitespace / end-of-file-fixer）在合并现场落笔，非语义变化。 |
||
|
wandering1
|
f6e9106f0d |
fix(UI): 推流往返返回点喂位——多个慢 RPC 之和不再串成 UI 停摆（大窗判读 F3）
道F task-24。机制 = ui_net_sink 新增心跳回调钩子 ui_net_sink_set_beat_cb()，在每 个**可等待 net 往返**（accept / recv_nb / send / close / 重建三件套）的返回处调用； uiTask 注册 task_wd_beat(TASK_WD_UI)。风暴期实测 UI bit4 单任务 8 连击窗（9 条 stall 中唯一的真单任务链）的构成正是「单轮里多个都回来了、但各自 150~250ms 的 往返串行排队，心跳只在轮首」——本改把心跳间隔从整轮往返之和收敛到单个往返： 只要每个往返都会回来，UI 就不该记停摆（看门狗设计说明 §5.3 按位判据抓真挂死）。 【边界（lead 裁定口径）】往返语义零改动：不加超时、不动回执协议（§11.6 否决的 「net_* 裸加有界等待」不重演，请求序号方案与事件驱动 accept 均**不做**，上界 收口归登记簿 E-27/E-28 批 3）。残留暴露：单个往返自身仍无上界，netTask 被单 消息拖过 800ms 时 UI 位连击照成立——那是判据抓对了人，处置在 net 侧。 【分层】回调注入而非 sink 直调 task_wd_beat()：Drivers/BSP 不得 include App 头 （layer-deps 门禁方向性铁律，基线只减不增，本次零新增）。 【零行为变化面】钩子未注册（模拟器/黄金回归形态、ui_task 注册之前）= 与改前 逐字一致；协议/帧格式/门控/兜底节拍全不动。ui-golden（菜单 8 状态 + 内容页 11 页）通过。 【测试】新增主机套件 test/host/ui_sink/（stub 假件驱动生产 ui_net_sink.c，17 断言 全绿）：未注册全协议路径逐字 / 门控零 RPC 零心跳（31 轮无数据全挡、第 32 轮兜底 恰好 1+1）/ accept 失败返回也喂位 / 10 连风暴 accept 心跳逐往返 ==RPC / 重建喂位 点与 close 护栏 / EOF（client==listen）永不关监听 + 风暴 accept 每轮喂位。 suite 由 test-coverage rglob 自动发现（无需改台账）。 【文档】UI_设计架构.md 新增 §5.8（推流心跳边界：现象/处置/边界/分层/残留）+ 变更记录行；ui_net_sink.h 钩子契约注释；ui_task.c v1.4 记录与 :271 注释更新。 【门禁】@build 0/0（Code=224860，vs F2 后：Code +92B / ER_IROM1 →249500 / RW+4 / ZI+4 / RAM 79008）。--all-files 44 绿（含 bom-guard / ui-golden / coverage / id-check / layer-deps / cubemx），红仅 mem-numbers + mem-budget = 台账漂移（文档数字待回填），本票 --no-verify。 gate: only mem-budget/mem-numbers pending lead ledger backfill 【台架（待台架实测，等你排）】两轮各自独立 ≥30min：① 单独 relisten_stress :7003 ② 探针轮。v1.1 判据：stall 行 = 0 为硬判据——F2 后每个 stall 行都是真单任务 800ms 链，本改应使 :7003 churn 窗内的 UI 串消失；若仍有 stall，mask 缺位者即 net 侧真占用者，记给我转 E-27/28 证据。MISS start 为诊断行不计违规。 |
||
|
wandering1
|
2d16fdddc0 |
fix(看门狗): 停喂判定按位分账——复合串窗不再误停喂（2026-10-25 大窗判读 F2）
道F task-23。动因 = 2026-10-25 台架大窗判读：9 条 stall 行里 16:24/16:28 两起为 复合判据误升级——旧逻辑喂狗前置 = 全必需位同窗跑过，任一窗缺任一位即断喂， 复合连续 8 窗申报 stall；UI 一窗缺、IEC104 下一窗缺、再下窗 FTP 缺这类互不相干 的亚秒抖动被串成 800ms 假停摆（mg=877/918，两事件中无任何任务达单任务容忍线）。 16:39 那起才是真 UI 单任务串（~1.2s，bit4 到 8 连击——受害者面修复 = F3 票）。 【改造】stall/停喂唯一判据 = 任一必需位自己的连续缺席窗数（s_miss_bits[] 分账， +9B BSS）：同一任务 8 窗（800ms）没跑过 → 申报 + 停喂 → IWDG 自然溢出 （IWDGRSTF 权威归因不变）；所有位连击 <8 的缺席窗照常喂狗；位出现即该位清零， 掩码外位不入账（wd_required_mask 随构建变化自动跟随、不留旧账）。`MISS start` 保留为复合边沿诊断行（不再代表停喂，判读口径以设计说明 §6.1/§11.1 为准）。 代价：真停摆从挂死到复位总时长最坏 +约 0.7s（≈2.5s 最坏 / ≈3.3s 标称），V2 台架判据「声明 stall 后 ≤2.5s 复位」不受影响（申报时点未变，停喂起点即申报）。 【测试】test/host/watchdog 断言按新判据改写 5 处（004/005/006/008/013：缺席窗 照常喂），新增 TC-WATCHDOG-017（20 窗 UI/NET 交替缺席：零 stall + 20 窗持续喂—— 旧复合判据必在第 8 窗误报，回归钉）与 TC-WATCHDOG-018（同位 8/9/10 连击必报停 + 停喂；恢复窗喂、账本重启，第二段亚容忍串重新从零计）。47/47 全绿。 【文档】看门狗设计说明 §0/§2.2（停喂链加「v1.5 起字面成立」注）/§3.2/§5.3/ §6.1/§11.1/§11.6 大窗补记 + 变更记录；看门狗单元测试说明（用例表 + 47 断言 + 变更记录，顺带修正 TC-WATCHDOG-003 行 10-12 后未跟的 `0x37`→`0x1F7`）。 【越界申报】① docs/测试说明/看门狗单元测试说明.md——票面写域外，但该文档 §4 自要求「行为变更须同步改单测与本文」，执行性同步；② 根目录 .cubemx_survival_baseline.json——cubemx-survival 钩子对 task_watchdog.c（watchdog- module 审计项 = 全文哈希基线）明示「有意改动请 --write 重建基线」，重建后 31 通过 / 0 失败。均非他人并行改动面。 【门禁】@build 0 错误 0 警告（Code=224768 RO=24640 RW=1328 ZI=135096）。 --all-files 43 绿；红仅 mem-numbers/mem-budget = 台账漂移（vs 2026-10-25 行： Code +80B / ER_IROM1 249328→249408 / ZI +8B（s_miss_bits）/ IRAM1 约 +8B，待回填）。 id-check 增量拦截通过（首跑拦下变更记录里 TC-003/TC-004 裸形，已改全 ID）、 test-coverage 通过、cubemx-survival 通过。 gate: only mem-budget/mem-numbers pending lead ledger backfill 【台架】等你排窗两轮（各 ≥30min）：单独 relisten_stress :7003 / 探针轮。判据按 v1.1 口径 = stall 行零为硬判据；预期本修复后 16:24/16:28 型复合误升级归零， MISS start 仍会出现（诊断量）；16:39 型 UI 真单串在 F3 落地前仍可能照报—— 那属于「判据抓对了人」，请连同 mask 一起记给我。 |
||
|
wandering1
|
2808ea9fb8 |
fix(104主站工具): RX 解析按本仓 6 字节头取位——PN 在 cause 字节 bit6（道D 批2.5 R1）
大窗实锤（2026-10-25，V5 间隙连 2404 复放两笔越界写）：板端对 51.0@0x8030 与 2.0@0x8034 均回 type=50 / cause 字节=0x47（7|PN 0x40）——固件行为正确、无需重烧。 本工具 _asdu 旧解析按标准 2 字节 COT 的习惯去 byte[3]（本仓语义 = OA+EVI）找 PN （恒 False），且 cause 字节未 &0x3F（拒绝帧读成 cot=71）→ actcon_of(type, True) 永不匹配 → E2_dbig / E2_kband exec / G2 三条 PN 断言超时。历史用例全部 want_pn=False，False 配恒 False 恒真，故 B6~D2 无人暴露；E2/G2 首次真机断言 负确认即命中（审计定位 lane-d，task-21 修复）。 - 提取纯函数 decode_cot(cause_byte) -> (cot&0x3F, bit6)，_asdu 改用；byte[3] 不再 参与 PN；TX 侧 asdu() 未动（与固件 RX 本就对称） - COT_PN 常量处 NOTE 注释：本仓 B4 自定义 6 字节压缩头（T/PN/RBT=bit7/6/4 同字节， byte[3]=OA+EVI），引用 App/protocol/iec104/iec104_asdu.c put_hdr 为准；标注根治 走 COT=2 标准化合并单（登记簿「104 ASDU 头非标-COT1 压缩」，本票不动固件） - 新增离线样本单测 test/host/test_iec104_master_rx.py（纯 stdlib 无台架，6 用例： 两条窗口捕获帧字节重建 + 正例 actcon + 旧错误解码反证 + matcher 语义） - RX log 语义变化：拒绝帧从 cot=71 变为 cot=7 + " PN" 后缀（v5_log_gap_report.py 已核无 cot= 解析耦合） gate：py_compile 双文件过；单测 6/6 OK；全钩子常规跑（见提交记录）；写域仅 test/host/iec104_master.py + test/host/（票面内），未加钩子（yaml 在写域外， 如需常态化由 lead 批 2.5 顺手）。 |
||
|
wandering1
|
4332142680 |
feat(ui-pages): 遥信量 33 行固定名表页接实时快照（新增 yx_dp）
批 4 主体（票 task-15；规格 docs/UI设计/页面扩充详细方案.md §3.1.3 方案 A）。V0.1 只有 6 点有 硬件来源，其余 27 点在屏上就是 "--"——这是真实状态，不是页面没做完。 页面与数据 - 33 行固定名表（Flash const）+ 动态分页（8 行/页 = 5 页）。两处命名不照抄文档简写：idx0~3 屏上写「位置1~4」而非「YK1~4 位置」（遥信页出现 YK 前缀会被读成遥控对象，对应关系留在注释）； idx30 写「保护闭锁」（写侧位号注释的语义即此，用编号反而丢信息）。idx4~13、idx31~32 点表未 定义功能名，如实写点号占位（YX5…、YX32），不编造功能名。 - 值映射次序：先判无效 → 再判单/双点 → 最后看位值。无效位上的位值不代表任何事实，次序颠倒就会 把垃圾位画成「复归」。 - 快照新增 yx_dp 双点位图（+8 B）。不教页面"前 4 点是双点"：单双点是 104 点表事实（YX_DP_N / iec104_pts_yx_is_dp），抄进表现层就是第二真相——点表把双点段挪位或改起始下标，屏上不报错， 只会用错词形容同一个点。写侧逐点问 is_dp() 拼位图。 - UI_DATA_YX_N(33) 与 iec104_pts_yx_count() 编译期比不了（那个 #define 在协议层 .c 内），故写侧 留一条一次性 DBG_ERROR（约 90 B Flash，只在真漂移时打一次）。名表行数 = UI_DATA_YX_N 由数组 宽度法编译期守卫钉住（ARMCC C99 无 _Static_assert，本仓惯用写法）。 - 补 include 一条实测坑：DBG_ERROR 是宏，漏 include "dbg_log.h" 时 ARMCC 把它当隐式声明函数放过 编译期，错落在链接期（L6218E Undefined symbol DBG_ERROR）——报错点离根因隔了一整个链接步骤， 已在 include 处写明「DBG_TAG 必须在 include 之前」。 一个只有像素文本断言能抓到的截断 bug - 照抄批 1 的 *_PUT(dst, 源) 宏（长度取 sizeof(源)），但本表源是 const char *const 数组的 **元素（指针）**，sizeof 得 4 → 「故障总」被截成「故」，而 "YX9" 恰好 4 字节看起来完全正常。 编译器 / cppcheck / 编码钩子全不响。定位来自断言：第 2 页「过流Ⅰ段」匹配不到，同一行值列 「复归」却在原位 = 名字被截、值没错位。修法：长度取目标缓冲容量 UI_BUF_STRLEN。同名宏、不同 参数类别（数组 vs 指针），批 1 那处本身是对的，照抄才中招——教训写在宏定义上方。 模拟器与覆盖诚实性 - 固定帧发布 yx_dp = 0x0F，但刻意不把这几位置进 yx_valid：V0.1 无开入硬件，屏上就是 "--"。不用 「让它显示合位/分位」的假数据填满画面，那等于让黄金参考声称本机有开关位置遥信。 - 代价如实登记：合位/分位这条词映射当前**没有任何自动化证据**（像素恒 IV；页面依赖 LVGL 进不了 主机单测）。已写进方案 §3.1.3 落地注与契约落地进度·四，作为开入落地后的台架判据，不假装测过。 测试 - 主机单测 +2 条（TC-UIDATA-009c 双点位图原样透传、不被 valid 掩；009d 点数 33 的独立见证，注明 绊红时要同步改哪四处）→ 85/85。 - 文本断言 +33 条（yx / yxp2 两态，含页码钉住 33/8 = 5 页的分页数学）；两页像素基线单独一笔。 - font-charset 本批零新增字：名表用字全部命中既有 183 字子集——「置/故/障/总/外/部」正属批 1 成组并入 KEEP_EXTRA 的那批字，第二次兑现（当时若按 extract 输出重写字符集，这些字早被洗掉， 上屏是空白，而门禁只会说「字不在清单里」）。 体积（同一棵树、构建前后的实测增量） - Code 224272→224688（+416）；RO 24040→24640（+600）；RW 1324→1328（+4）； ZI 134844→135088（+244）→ Flash 约 +1020 B、RAM +248 B。 - RO 增量主要是 33 行名表与名称串，是"把 33 个真点名上屏"的代价，不是可省开销。 跳过的门禁（三条同族，同一根因）：mem-numbers / mem-budget / size-gate（L0c）——台账与体积凭证 回填是 Lead 单写者，本分支不做静默处理，数值见上。 |
||
|
wandering1
|
67c469fa40 |
feat(ui-pages): SOE 记录页接 soe_store 只读遍历（类型 7/8 首次上屏）
ui_w_soe 组件（task-14 落）此前两端都没绑 reader，只能显示"无记录"空态。本批补齐三件事：
App 侧只读遍历、两端 reader 绑定、SOE 记录页与菜单注册。
App/log/soe_store 只读 API（Lead 已放行，本批独占这两个文件）
- soe_store_count() / soe_store_read(idx, soe_rec_t*)：与 syslog_count /
syslog_get_record 同构——8 条一窗（512 B）整块读、命中窗口零 I/O、卷锁 try（0 超时）
非阻塞；定长记录逐条 open 等于同一扇区开 4 次，SPI NAND 上这个差距是肉眼可见的卡顿
- 读者不得看到半成品记录，三道保障缺一不可（规则写进 soe_store.h 头注，不只是提交信息）：
① 条数只数整条 64 B 槽（写者留下的半条尾槽天然不计入）；② 窗口代数：写者每次成功落盘 /
容量重建在**卷锁区间内**自增代数，读者比对填窗时记下的代数，不符即重填（对齐 32 位读写
在 ARM 上原子，跨任务无需临界区，最坏多读一轮）；③ 单条硬门槛：soe_rec_parse() 校版本 +
校验和，撕裂/半写一律拒收
- 容忍的竞态只有一个：count 与 read 之间新落一条 → 本轮少看一条，下轮重绘（200 ms）自然
追上；所以边界一律用锁内重取的条数，不信调用方传进来的旧值
- API **不带类型掩码**（Lead 裁定 2026-10-25）：5 个记录页怎么分组是界面语义，不进日志存储
层；环容量小、页渲染全扫无成本，真变大了再加带 mask 的优化 API（YAGNI）
⚠ 顺带修掉一颗定时炸弹：菜单生成器与生成物漂移
- 提交里的 Drivers/BSP/UI/ui_menu_tab.h 带着 5 个表查询 API 的规范注释块，而
tools/menu_gen/gen_menu.py 只会输出"声明 + 行尾短注释"——说明历史上有人**手改生成物**
补注释、没回灌生成器。我这次加 #page=soe 后重新生成，等于把那些注释抹掉，bsp-err 立刻
报 5 条 return-doc
- 修法不是把生成物改回去（下次重新生成还会再抹一次），而是把注释块**回灌进生成器**；
回灌后重跑 gen_menu.py 产出的 ui_menu_tab.h 与 HEAD **逐字节一致**（git diff 为空），
漂移关闭。生成物里的手工优化 = 一定会被覆盖的优化，要么进生成器要么别改生成物
时标口径（跨模块陷阱，注释即防线）
- 页面时标取记录内的 CP56（事件自己的时标，不是"现在"）。它与运行/自检记录页同口径，靠两条
事实叠出来：sys_clock 的 epoch 域本身就是本地时间（App/util/sys_clock.h 的
sys_clock_set_unix 注明"Unix epoch time (秒，本地时间)"），而 soe_rec.c 的 epoch→CP56
分解不加任何时区偏移。**谁"顺手补 8 小时"，SOE 页就会和文本记录页差 8 小时**；要引显式
时区必须两侧一起改
显示名回正：类型 7 用源词"未标定闭锁"
- 组件名字表里原写作"标定闭锁"——缩掉一个"未"字后意思可以读成"把标定闭锁了"，与"因未标定
而闭锁"几乎相反；源词见 App/log/soe_rec.h 与"数据可信"卡 5，UI 表现层无权改写事实词
- 模拟器的 3 条假记录刻意含一条 type 7 + ELM_NONE（非元件支路）：这是 7/8 两个新类型
**真的接上屏**的第一个像素级证据——只有主机断言时，名字表写错也照样一片绿
- 主机测试的宽度护栏随之按"画到哪一列"分列：动作/返回进值列（4 汉字 = 12 字节），其余类型
名进名列（7 汉字 = 21 字节）；原来一刀切 12 字节会把正常名字判成违规
页面与注册
- 新建 Drivers/BSP/UI/ui_page_soe.{c,h}：薄跳板，一条记录两行共用组件内单条读盘缓存，
实例独立（两页共用一份缓存会互相命中对方记录号，task-6 的教训）
- 菜单树 SOE记录 加 #page=soe；重生成 4 个生成物，uvprojx / CMakeLists 两处注册由生成器
自动写入（本批 uvprojx 只含这一条新增，无 UV4 抖动）
- reader 绑定在两端适配层：真机 App/task/ui_task.c（CP56 → UI 视图 + 容量钳位），
模拟器 simulator/main.c（固定 3 条、时标固定串，保证黄金参考可复现）
两处被门禁当场抓住的记录（都是有效拦截，不是噪音）
- id-check 拦下注释里裸引"P2-10"：编号引用必须可判定归属，代码注释也一样 → 改为指向
App/log/sys_log_mcu.c 与事实本身，不留裸编号
- 又一次 BOM 铁律现场复现：一次编辑剥掉 ui_w_soe.c 的 BOM，ARMCC 立刻报一串 #8/#7/#20
假语法错（missing closing quote 之类），而 MSVC 侧 0 警告完全照不出来；补回 EF BB BF
即 0/0。本批提交前逐文件比 HEAD 做了 BOM 漂移审计（临时脚本，不入库）——建议把这条
审计固化进 ui-verify skill 或门禁（不在本道写域，已回报 Lead）
验证
- @build：0 错误 0 警告；模拟器：0 警告
- 内容页回归 15 项 PASS：新增 soe 页 9 条文本断言（两条时标、过流Ⅰ段+动作、+返回、
未标定闭锁、页码），其余 11 页逐字节不变；菜单 8 状态 PASS、池 5368 B
- soe 页刷新黄金参考前出图肉眼确认：6 行两两成对、19 字符时标在 94 px 名列内不越屏、
非元件行的类型名落在名列且值列为空
- test/host/ui_data 83/83、test/host/soe 32/32；13 个代码/文档/注册类钩子（含
coding-standard、bsp-err、id-check、cppcheck、registration-check、layer-deps、
font-charset、doc-links）全 Passed
- 全量钩子红项只有同族三条：mem-numbers / mem-budget / size-gate（L0c），root cause 一条：
Flash/RAM 台账与同码凭证回填归单写者 → 本批 --no-verify
体积（相对
|
||
|
wandering1
|
8c72698666 |
feat(运行参数): 卡10 run_par真源收编+104段0x8020~0x8058读写映射（道D M6-①）
新增 App/algo/run_par.c/h（「数据可信」卡 10，lead 四裁落地）： - [run_par] cfg 段：遥测死区 9 键 int32 毫单位（db_ua…db_freq），工厂默认 = 卡 6 额定 0.5% 档（500mV×4 / 5mA×4 / 500mHz）；注册走 adc_cal 同款内核前 契约（app_main_init），不挂回调 = 引擎副本即生效值；键数 9≤16 不拆段 - 真源收编（裁③）：pts 层 s_yc_db 运行时副本删除，COV 每拍实时读 run_par （协议→算法向下依赖，同 meas 先例；无投递无缓存 = 顺序/幂等平凡成立）； iec104_pts_yc_set_deadband()/deadband() 保留为转发壳，壳内保留"成功清 半截确认计数"语义并由 TC-IEC104-027 追加断言钉住（裁⑤） - 104 地址映射（裁①）：0x8030~0x8038 死区 9 点 / 0x8040~0x8047 k 覆盖 / 0x8048~0x804F b 覆盖（逐项地址本仓自定——复现规划 §5.4 权威表不在仓， 送检点表到位后替换 run_par.c 顶部常量段一处；已在 IEC104 §3.4 表头挂账）； 路由顺序 = run_par 表先、未命中落 prot_set——0x8027~0x802A 属 prot_set 告警段永不覆盖，TC-IEC104-029 双向往返钉死；空隙地址自然 COT14/PN - 通道系数覆盖 = adc_cal_set 代理（裁②a）：合法带/越带 [ERR] 留痕全复用， run_par 不存第二份系数（防双真源）；单侧写 RMW 用另一侧当前生效值； 回显 = 生效值视图（文件坏值被哨兵回退 ROM 时主站看到的就是下游吃到的）； adc_cal 配套：+adc_cal_b_codes() 读取口（回显/RMW 用）+ set() 授权写者 注记扩至 iec104Task 直通路径（单字原子契约同「数据可信」§4.4） - 持久化（裁②b）：新事件位 SYS_EVT_RUN_PAR_SAVE(1<<8)；iec104Task 主循环 peek 投递 → defaultTask run_par_store_save() 一条事件一趟 cfg_file_save 整档外科（覆盖 [run_par] 9 键 + 联动 [adc_cal] 两段）；失败脏保留 = 天然 重试（B7 prot_set 同款）。C_SE 现行无"暂停/测试态"门控——文档现行如此 不造新语义，送检若要求接线点已写进 §3.4 注（裁④） 测试：新建 test/host/run_par（TC-RUNPAR-001~008，67 断言，真实 cfg 引擎 + 真实 adc_cal + 内存虚拟盘同 adc_cal 套件先例；[run_par] 注册契约/落盘往返/ 外改文件即副本生效/两段式不提交不置脏/合法带拒+RMW+生效值回显/init 幂等 重注册留痕）；iec104 套扩真链 TU（cfg_file+adc_cal+run_par 非桩，141 断言： +TC-IEC104-029 路由 + 壳清确认计数 3 断言）；meas 套静态更名 s_snap*→ s_ms_snap*（与 cfg_file.c s_snap 同 TU 相撞，D1 同款改名法，226 断言不变）； iec104_serv 套补 run_par_dirty_peek 假件。id_registry 建族 TC-HOST-RUNPAR （游标 008）+ TC-HOST-IEC104 游标 028→029；新钩子 run-par-unit-test + iec104 钩子触发面随真链扩；uvprojx +run_par.c（合法入库）+ SIM_EXEMPT 登记 （模拟器不编 104 协议，已核实 CMake 面）。 文档：IEC104 §3.4 运行参数段表（含送检替换账/门控未来条件/代理声明）、§7、 §8 第 4 条、变更记录；网络配置说明新增 §3.5 [run_par] 键表；复现规划 §5.4 补运行参数段落实进度。**遗留（交 lead）**：数据可信 §4.4 "引擎 RAM 副本" 一节当时的措辞对象含 pts 侧副本，s_yc_db 删除后该句过时（裁③b 点名，§4.4 在写域外未动）。 gate：@build 0/0（Code=219620 RO=22036 RW=1280 ZI=132864）；vs 0cbae7d： Flash +1912B、RAM(RW+ZI) +8B（37B 新静态被链接器并洞吸收）；iec104Task 栈 1456B/margin 43%、defaultTask 3032B 不变；id-check/doc-links/cppcheck/ coding-standard 实跑过；--all-files 全量 45 钩子实跑（43 绿 + 仅 mem-budget / mem-numbers 两红 = 台账受管区 vs .map 漂移，回填属 lead 单写者区，批 1/道D-1 /D2 同口径）：gate: only mem-budget/mem-numbers pending lead ledger backfill BOM/CR/U+FFFD/字面量 ASCII 逐文件自查通过。 |
||
|
wandering1
|
acc547efaf |
feat(104遥测): 卡9改读L2快照+死区运行化2点确认 + 卡11绑频0x401D（道D M5/M6）
卡 9（App/protocol/iec104/iec104_pts.*，「数据可信」，docs/子系统设计/ IEC104上行设计说明.md §3.1/§4 同步）： - 数据源换轨：板端默认 YC 源从直读 phasor 改为**整体透传 L2 遥测快照** （meas_get 双区无锁；"新不新、能不能信"只在发布侧判一次，M5-② 落地）； iec104_pts_src_t 表尾追加 yc_read_ex（带品质）——旧注入源走 legacy 退路， 品质由返回值推导，行为与卡 9 前**完全一致**（存量假源用例零改动） - 品质映射 s_q_map：MEAS_QDS_* 低字节=线上 QDS 同值直传；CLIPPED→IV （「削顶通道 104 恒 IV」口径不变、从点表绑死 -1 改品质驱动——UB/UC/IB/ IC/IN 五路现绑快照槽，V0.2/N-18 削顶消失后**零改动自动启用**）；IV 优先 NT；快照从未发布（开机 <200ms）→ IV|NT；无效信息体清零（旧线上口径保持） - 死区运行化：运行时副本 s_yc_db（ROM 默认 = 点表列，卡 6 额定 0.5% 档不变） + iec104_pts_yc_set_deadband()/iec104_pts_yc_deadband()——卡 10 运行参数段 （8020H）的接线点已留；非法 idx/负值/NaN 拒绝、成功时清该点待确认计数 - COV 遥测腿升级（lead 裁②"卡 9 是消费者"）：判定 = 相对**上次上送值**（非 上次读值，防慢漂移吃基准）连续 2 个新测量点越死区才确认上送；回摆入带即 撤销候选；品质翻转当拍直报（含 0x401D 的 IV 进出）。测量点推进：板端按 快照 seq 去重（100ms poll vs 200ms 快照——不去重则同一帧把单点噪声计满 2 点，抗噪语义失效）；注入源=每次调用一测点（单测步进自持） 卡 11：YC 表加 src 类型（PTS_SRC_MEAS/FREQ）；0x401D 绑快照 freq_hz（与 freq_get 同源）；snap.freq_valid==0 → IV 清零（卡 11 DoD 原句） 测试与文档：test/host/iec104 97→127 断言——TC-008 语义更新为 2 点确认； 新 TC-IEC104-025~028（024 号被存量 B7 用例裸标签占用，让号并改用全家长 形态）板端默认源走**真实 L2 链**（ring→phasor→freq→meas，非桩）：未发布 NT/值透传/CLIPPED→IV 清零/绑频收敛 ±0.02Hz/未新鲜 IV/死区运行档压旧档/ 回摆撤销/seq 去重同帧不计数/换帧只变品质按集合直报；id_registry 族游标 023→028；IEC104 上行设计说明 §3.1 表+注/§4/§7/§8 第 4 条/变更记录同步。 无新 .c（uvprojx 零改动）；PC 主站读回一致与频率 ±0.01Hz 属网络对端验证 ——步骤清单已发 lead 排窗，本轮零台架动作。 gate：@build 0 错 0 警（Code=218128 RO=21624 RW=1272 ZI=132864）；增量 vs adeef7d：Flash +348B、RAM(RW+ZI) +48B（低于 96B 预估，链接器并洞）， IRAM1 58.5% 不变；iec104Task 栈 worst=1456B margin=1104B(43%) PASS 无抬栈 （stack_report）；--all-files 全量实跑：其余钩子全绿（含修掉一处 cppcheck variableScope 后），仅 mem-budget + mem-numbers 两红 = 台账受管区 vs .map 漂移（回填属 lead 单写者区，批 1/道D-1 同口径）： gate: only mem-budget/mem-numbers pending lead ledger backfill BOM/CR/U+FFFD/字面量 ASCII 逐文件自查通过（未触碰带 BOM 文件）。 |
||
|
wandering1
|
969fc5c132 |
merge: task/n17-probe 合入 v2-on-ui
任务 n17（1 个提交）经 task-worktree 回收： - fix(网络): 主动拆会话登记即返——drop 路径不再占用 netTask（登记簿 N-17 收口） |
||
|
wandering1
|
62987b4596 |
Merge branch 'v2-on-ui' into task/meas-snap
# Conflicts: # scripts/id_registry.json |
||
|
wandering1
|
a3c6e89378 |
fix(网络): 主动拆会话登记即返——drop 路径不再占用 netTask（登记簿 N-17 收口）
道F 批 2 / task-17。定位 + 单点收口，不开 net 层跨上下文大口子。
【定位（链路，全部代码可复核）】
探针挂起 30s → time_sync.c:149 预算耗尽 → :187 net_drop_conn()。NET_MSG_
DROP_CONN 处理器（net_drop_conn_locked）内同步跑 net_sock_reset_sync
(QUARANTINE)（2ms 节奏、400ms 底/600ms 顶，自家注释原记「等待期 netTask
有界占用 ~400-600ms」）：netTask 的 1ms 主循环冻结在同一迭代 → NET 位
停摆；串行总线整窗停摆 → UI 推流/FTP/104 在途消息回执顺延；对时调用方
睡在 net_wait_result 等回执期间无分片心跳 → 五位同窗缺席 → 连续 8 个
100ms 抽样停喂 → 声明 [WD] task stall（V5 时代 req=0x37、快照只剩 bit0，
即日志 mask=0x00000001）。被动断连/EOF 走 net_listener_tick 异步沉降机
（D10 条令）故纯 FTP 负载 0 stall——只有主动 drop 留在同步原语里。
【修复】监听型 fd 的芯片拆除改为 net_listener_settle(QUARANTINE) +
net_listener_request(REQ_DROP) 登记即返，拆链/排渣/等 CLOSED/重建全部
交 net_listener_tick 30ms 节奏——与被动释放同一台机器（E16 台架实证该
自建序列 RST 10/10、FIN 5/5）。非监听 client fd 无监听可保，同步形态
原样保留（全仓零生产调用者）。返回值语义显式改为「拆除与重建已登记」
（net_socket.h 注释按 lead 要求写明，防未来调用方按旧语义写）。
APP_ASSERT（S12 试点）分派门与断言位置未动，登记时序下仍成立。
【评估否决留档（lead 要求论证入文档）】「缩短重建重试 5×2s」不采：
该退避在 time_sync_open_listener() bind/listen 失败路径、已被
time_sync_delay_fed() 分片喂保护、不在缺口链上；缩短反撞 TRAP-NET-09
沉降窗。全文见 docs/网络/网络自愈架构设计.md §4.6（已改写）。
【竞态与信源核对】① 主路径置 CLOSED 后迟到的 DISCONNECT/TIMEOUT 被
net_events 状态门拦截（只认活会话态），不会把刚登记的 QUARANTINE 降级；
② 零新增读清点——全局寄存器唯一读者仍 net_poll，隔离窗两处本 Socket
读清是 net_listener_tick 原位，§4.10 三条准入判据不触发；③ E13 物理
边界（对端不配合 FIN_WAIT_2 长尾）逐字不变，只移动等待发生的位置。
【测试】net_socket 主机套件 457/457：TC-NETSOCK-240f/321b/321b2/460e
重锚到登记式（settle+REQ_DROP、rst 机零启动、tick 预算 ≤20、无 [ERR]），
新增 321g/h/i + 460f 钉住 client fd 旧同步形态。全量 --all-files 40 绿。
【体积增量（vs scripts/ram_baseline.tsv 2026-10-25 行）】
ER_IROM1 237328→237344（+16 B）；RW_IRAM1 75792（+0）；ZI 0。
@build 0 错误 0 警告（Code=215948 RO=21396 RW=1232 ZI=131984）。
gate: only mem-budget/mem-numbers pending lead ledger backfill
test-coverage 本条**绿**（已覆盖行净增，未动用裁决③的覆盖率例外——
旧同步路径行经 client fd 新用例继续被覆盖，净差非负）。其余含
id-check/doc-links/全部主机单测绿。仅 mem-numbers/mem-budget 两红 =
台账 +16B 漂移待回填（lead 单写者禁区）。
【越界申报】① test/host/net_socket/{ns_s3_msg,ns_s4_state,ns_s5_io}.c
（批准③同类：只动本任务相关用例，未碰他人行）；② docs/网络/
网络自愈架构设计.md §4.6 改写（lead 本任务指令明示）。登记簿 N-17
销项与 README 波次行归 lead；docs/内存管理 数字未碰（禁区）。
台架：V5 复跑判据（e02_probe + FTP ≥30min 零 stall / 零复位）属网络
对端类——待 lead 排窗，步骤清单随 done 消息发出。
|
||
|
wandering1
|
48bc50e794 |
feat(遥测快照): 卡8 meas 双区快照模块 + adc_task 200ms 唯一发布点（道D M5）
卡 8（App/algo/meas.*，新增；布局权威 docs/任务规划/数据可信.md §4.5）： - meas_snap_t = §4.5 布局（sizeof 72 B；字段偏移由 TC-MEAS-002 钉死——卡 9/ UI 按整体拷贝消费，破布局=破协议；谐波 k-bin 扩展（docs/算法/继电保护功能 复现规划.md L2-8）只许尾部追加，留口注释已写进 meas.h） - 并发 = phasor 双区 + 单字节索引翻转（L2-7 同型，无锁）；seq 只增供判"换帧"； meas_get 失败路径清零填充（-2 未就绪时调用方可安全读） - 值口径 = A-lite 裁决（lead 2026-10-25 快裁，推翻票面全链）：基波有效值瞬时 透传，复用 phasor_calc 纯核 → 与 phasor 使用区同拍同值（TC-MEAS-005 逐位 相等钉死）；不做 4 点平均/方和根（§4.5"200 ms 是上送节拍不是平均窗"） - 品质注入：CLIPPED 位图唯一源 = adc_cal_flags()（「数据可信」§4.2 三态表， 编排方注入、本层不链 adc_cal）；取窗不足路 = IV|NT 且整帧 valid=0 但照常 发布（品质节拍性刷新）；TEMP = 最新一点透传 + NT（「数据可信」决策 5）； MEAS_QDS_* 低字节 = 104 QDS 线上值（本层不 include 协议层头——分层方向， 卡 9 直接截低字节映射）；OV 留位不填（判据待运行参数化，卡 10 域） - adc_task.c 编排：新帧拍 freq_run() 后按 **tick 经过**分频（非拍计数，idle/ skip 拍会拉长名义节拍）调 meas_tick()——全仓调用点数 = 1（「数据可信」§8 风险表"快照双写"行评审判据）；meas_init 挂 adc_task_init（不动 app_main.c）； 心跳新增 meas: 行（seq/v/ua·un·ia_mv/f/fv）作 M5 台架观测面 - 死区 2 点确认状态机本卡不建（卡 9 迁移 104 语义时随建，lead 裁③）；104 层 现有 deadband 常量未动；频率点绑定归卡 11 - 实测采样类判据（读数 vs 注入源）= 待台架实测，本卡零台架动作 测试与注册：新套件 test/host/meas（226/226，链真源 meas+phasor+sample_ring 免桩；覆盖 seq/双区无撕裂/布局/品质汇总/回绕/守卫）；id_registry 建族 TC-HOST-MEAS（游标 011）；meas-unit-test 钩子 + SIM_EXEMPT 一条 + uvprojx 仅增 meas.c 单条挂载（diff 已核零 UV4 抖动）；App/algo/README.md §1/§2/ §3.9/§4 同步（设计说明大节与 AGENTS 口径留 lead 收口，同批 1 先例） gate：@build 0 错 0 警（Code=216352 RO=21476 RW=1232 ZI=132128）；RAM 增量 RW+ZI = +152 B（快照双区恰 +144 B = 卡面 DoD；余 s_meas_ms 等编排状态）， IRAM1 57.8%→约 57.9%；Flash（Code+RO+RW）+696 B；adcTask 静态最坏链 1408 B / margin 1152 B（45%）PASS（stack_report 实测，无抬栈）；BOM/CR/U+FFFD/ 字面量 ASCII 逐文件自查通过（未触碰带 BOM 文件）。pre-commit run --all-files 实跑：其余钩子全绿（含 doc-links/id-check/ 覆盖率总闸/双端注册/ui-golden/全部主机单测套），仅 mem-budget + mem-numbers 两条红 = 台账受管区 vs .map 漂移（Flash/RAM 台账回填属 lead 单写者区，批 1 同口径）： gate: only mem-budget/mem-numbers pending lead ledger backfill |
||
|
wandering1
|
98664a11ed |
merge: task/ui-data-feed 合入 v2-on-ui
任务 ui-data（2 个提交）经 task-worktree 回收： - feat(ui-data): ui_data 三通道快照 + ui_data_feed 装配 + SOE 显示名映射 - feat(ui-font): 字库补 SOE 显示名用字 采/样/恢/效（179→183 字 / 274→278 字形） |
||
|
wandering1
|
201d713226 |
feat(ui-data): ui_data 三通道快照 + ui_data_feed 装配 + SOE 显示名映射
按 docs/UI设计/UI_数据供给设计说明.md 的 D 方案把 App→UI 数据通道落地：
App 组帧、BSP 存帧、页面只读；UI 侧零 App include，薄包装只在两端适配层。
本笔是纯增层、不接任何页面 → 零像素变化（菜单 8 状态 + 内容页 11 页黄金
参考逐字节不变，simulator/tests/ref 无 diff，未刷基线）。
新增
- Drivers/BSP/UI/ui_data.{c,h}：实时量 rt / 参数 par / 装置信息 info 三通道存储
+ 发布序号盖章 + 只读访问。零 App include、零 LVGL include（分层叶子）；
读写同在 uiTask 上下文串行 → 无锁、无双缓冲、无 seqlock（契约 §5.1）。
- App/app/ui_data_feed.{c,h}：快照唯一填充者。rt/info 每 200 ms 一帧，par 只在
prot_set_checksum() 变化时重发；首轮立即发布，免启动初期闪一下 "--"。
- Drivers/BSP/UI/ui_w_soe.{c,h}：SOE 二进制记录的显示名映射与注入式 reader
契约。未标定闭锁=7 / 标定复归=8 已进表——编号按 App/log/soe_rec.h 与
App/algo/prot_elm.h 现场数过（类型 1..8 + 哨兵 9、元件 0..8、ELM_NONE=0xFF、
FLG_IV=0x80），不采信文档与消息转述。reader 备好但两端未绑定：落盘侧还
没有只读 API（Lead 已裁该 API 归下一工作项），未注入按"无记录"空态渲染。
量纲诚实性（契约 §4.1 同步改成真值口径，不再抄旧码值表述）
- eng 不写"0 = 原始码值"：标定层 ROM 系数是引脚侧 LSB，采样环折算出来的就是
ADC 引脚电压（承诺边界 docs/任务规划/数据可信.md §2.6）；电气 8 路
adc_cal_flags() 的 VALID 全置位才升 eng=1 二次值——整帧共用一个 eng，只要
还有一路是引脚电压就不能贴"二次值"标签，宁可整体保守。
- TEMP 不参与线性标定 → 恒带新增品质位 UI_DATA_Q_RAW=0x20，页面不挂单位。
- UB/UC/IB/IC/IN 无基波相量实例（V0.1 削顶）→ Q_IV|Q_OV；未满一周波 → Q_NT。
- 谐波另开 ph[] 相量实例槽带：yc 的语义通道下标容不下同通道的二次/五次谐波。
接线与双端注册
- App/task/ui_task.c：ui_menu_init 之前 ui_data_init + 首帧发布；主循环每轮
ui_data_feed_tick() 排在 ui_port_step 之前（本轮渲染用本轮刚发布的帧）。
- simulator/main.c：发布固定合成帧（无头与窗口两个初始化点，先于建页）；
定值不手抄 40 个数，改为链入 App/algo/prot_set.c 取出厂默认（抄表等于造
第二真相）；build_date 用固定串而非 __DATE__，否则跨天重建会把装置信息页
黄金参考刷掉，而黄金参考是判据本身。
- 注册：uvprojx 加 3 条（App 组 ui_data_feed.c + UI 组 ui_data.c/ui_w_soe.c）与
simulator/CMakeLists.txt；ui_data_feed.c 不进模拟器 → check_registration.py 的
SIM_EXEMPT 加一行（App/app/app_main.c 先例，已报备）。
主机单测与钩子
- test/host/ui_data：82 断言全绿。钉三类事：快照语义（首帧前读 -1、序号由本层
盖章、三通道互不串台、NULL 防御、init 幂等复位）；跨层不透明下标现场一致
（yc 序 = adc_semantic_t、q10 序 = prot_set_id_t，同一 TU 里 include 两侧头）；
SOE 编号与名字表现场一致（八类事件都有名、采样/标定四个词互不相同、
名长不超列宽、越界回占位）。
- .pre-commit-config.yaml 加 ui-data-unit-test 钩子（第 43 个，Lead 已批自加）。
- scripts/id_registry.json 建族 TC-HOST-UIDATA（属主登记处 = 单测目录，同
TC-HOST-ADCCAL 先例；不建族则新号被编号门禁判"未登记前缀"）。
体积（相对 HEAD 台账 Code 215744 / RO 21396 / RW 1224 / ZI 131984）
- Code +1272 B、RO +108 B（字库 4 字，见上一笔）、RW +24 B、ZI +696 B
→ ER_IROM1 238520 B（22.7%）、RW_IRAM1 76504 B（58.4%，台账 57.8%）。
- .map 逐项：ui_data.o 488 B（Code 184/RW 12/ZI 476）、ui_data_feed.o 221 B
（1034/12/209）；LVGL 池 0 增量；ui_w_soe 未接线不进镜像（.map 无其符号）。
- 台架未跑（本笔零像素、零接线）：首帧时刻、200 ms 刷新、eng 升档与遥信
位图真值全部留"待台架实测"，接线完成后请 Lead 排窗。
遗留与风险（随回报进台账）
- 写路径（契约 §6 的 param_request/state）不落：无消费者就是永不执行的死码，
随整定 4 页一起落；届时须先定"UI 整定 vs iec104Task 写 prot_set"的并发口径
（prot_set_set_sealed 的影子区非重入）。
- 公共地址 CA 未下发：固件里 CA 逐帧从 ASDU 头解析，无集中常量可取。
- 遥信位图与 App/protocol/iec104/iec104_pts.c 板端源是两处镜像（该文件位号
写在函数体内未导出，UI 不得 include 协议头），开入采集落地时应并成单源。
- 版本类字段是本文件内的宏（仓库无产品级版本登记表，值沿用页面既有显示
值）；软件校验位在拿到构建期 CRC 步骤前一律显示 "--"，不抄参考遗留值。
gate: 全量钩子（--all-files）40 项通过；cppcheck/test-cppcheck/coding-standard/
layer-deps（基线仍 3 条）/registration/bsp-err（存量 38 条不变）/font-charset/
id-check（增量无新账）/doc-links/ui-golden/主机单测与覆盖率全绿；唯一红项是
mem-numbers 与 mem-budget——两者只因 Flash/RAM 台账未回填（禁区，归 Lead）。
gate: only mem-budget/mem-numbers pending lead ledger backfill
自查：BOM（Drivers/BSP/UI/* 与 App/task/ui_task.c 保持 EF BB BF，新建 UI 两件
同规范；App/app 与 test/host 无 BOM 与本目录一致）；CR = 0 全 LF；U+FFFD = 0；
字符串字面量纯 ASCII（中文只进注释）。
|
||
|
wandering1
|
484d068250 |
feat(存储): 写回缓存空闲 flush 兜底——卷空闲周期 CTRL_SYNC（登记簿 N-22 收口）
道F 批 2 / task-16。FTL 单页写回缓存（nand_ftl.c s_cache_dirty）与 dhara journal 只在换页/整页写/f_close 时刷出，漏网脏页的掉电驻留窗无上限。本 提交以最小面收口：不碰 GD5F/dhara 驱动，全部走既有 FatFs CTRL_SYNC 路径。 实现 App/fs/vol_idle_sync.[ch]（新增，仅 MCU 端，uvprojx App 组注册）： - 四级门：STORAGE_READY 就绪门 → 5 s 节流（无符号差回绕安全判据）→ vol_lock_wait(0) try（锁被持有=文件序列在做，跳过，不改 STOR 持有期 语义）→ disk_ioctl(0, CTRL_SYNC)； - clean 态脏标志+journal 双短路、零 NAND 触点；脏态最坏 = 一次 f_close 的同步段同型成本，不引入新磨损来源； - 失败按边沿 latch 一条 DBG_ERROR、成功重新武装；失败路径也成对放锁； - TEST_SUITE_STORAGE 构建整体 no-op（卷由 testTask 独占）。 接线：defaultTask 主循环 syslog_drain 之后（default_task.c v1.3）。 文档：docs/架构设计/STM32F4-Base存储架构说明.md §5.5 补空闲兜底与边界； 本板无掉电检测硬件、不做掉电前强制 flush、勿当掉电保护——口径同步落 注释与文档（sys_log_mcu.c 两处旧「暂不做」注释随实现改口）。 测试：新主机单测 test/host/vol_idle_sync/（TC-VOLSYNC-001..012，19 断言 全过）；scripts/id_registry.json 建 TC-HOST-VOLSYNC 族（仿 ADCCAL 先例）； .pre-commit-config.yaml 加 vol-idle-sync-unit-test hook（只加自己条目）。 越界申报（①②③ 均 lead 批准，④ 为门禁连带必要）： ① App/task/default_task.c 单点接线（include + 1 调用 + 头修改记录）； ② docs/架构设计/STM32F4-Base存储架构说明.md §5.5； ③ .pre-commit-config.yaml 单 hook + scripts/id_registry.json 单族； ④ scripts/check_registration.py SIM_EXEMPT 加一行（vol_idle_sync.c 模拟器 侧豁免，registration-check GAP 所需；与批准③同类别但未列名，特此申报）。 体积增量（vs scripts/ram_baseline.tsv 2026-10-25 行）： Flash(Code+RO) 237140→237328（+188 B）、RW 1224→1232（+8 B）、ZI 0； 增量 = 3 个文件级 static + 一处 DBG_ERROR 调用点；栈/堆无变化。 gate: only mem-budget/mem-numbers pending lead ledger backfill 全量 pre-commit --all-files：40 项 Passed，仅 mem-numbers（D-7 体积档）与 mem-budget 两条红 = 台账数字待回填（增量如上，属 lead 单写者禁区）； 其余含 doc-links/id-check/registration/test-coverage/全部主机单测皆绿。 @build 0 错误 0 警告（Code=215932 RO=21396 RW=1232 ZI=131984）。 台架：空闲 sync 实机节奏（clean 零触点、脏态时长、无心跳扰动）属实际 测量采样类——本批跳过，留「待台架实测」。 |
||
|
wandering1
|
db9f256fd0 |
docs(收口): 批 1 台架记录与门禁/产物分家口径落档（道C 文案兑现）
- test/board/ch395f_test.h：f3 轮台架记录追加——VERDICT PASS， task stall 468→14（net 类 431→0，掩码复活实锤），余 13 条为 netTask 自挂起前喂一次 vs 精确匹配判据的语义打架 + 1 条 uiTask 瞬态 + 1 条设计内 P2 留痕；lead 裁决不放宽超集判定 - 主机单测覆盖率口径.md：中间产物路径 L80 与坑 12 重写为 %TEMP%/dtu_host/<工作树哈希>/ 分家 + runs 独占（adabb6a 落地， 旧固定共享名作废；判据正文指向 harness 顶部） - 并行任务工作树方案.md §5 表：单测产物一行——不需要锁但必须 按树分家（对照 build/bench 真独占） - 门禁说明/cubemx-survival.md §6：新增第 7 条「基线漏项=静默不检」 （net-msgq-adopt 实证，--write 后抽查新增条目） - 门禁说明/id-check.md §5：拦下过真事追加——P1-10 注释裸编号被 校验 6 拦（紧邻写法在 C 注释同样生效） |
||
|
wandering1
|
73f9e10492 |
merge: task/P1-10-test-fw 合入 v2-on-ui
任务 P1-10（8 个提交）经 task-worktree 回收：
- chore(size): sync 追平后重盖体积同码凭证（v2 索引指纹，1396 文件）
- docs(P1-10): sync 追平后补记四档复测数字（产品基线已前进，旧注保留）
- merge: v2-on-ui 追平至 task/P1-10-test-fw（含 A-3 卡5~7 与 B-3 记录 reader）
- test(P1-10): 套件回归 forbidden 换成显式四 Fault 标签 + 台架记录 21/21
- fix(WD): HW 测试模式掩码死分支复活——include 缺失自
|
||
|
wandering1
|
8c28f3bfdd |
docs(收口同步): 批 1 落地后 AGENTS/104/算法层口径更新 + SOE 7/8 消费面补齐
- AGENTS.md：钩子 40→42、主机单测钩子 16→18（adc-cal/prot-dim）、 覆盖率总闸 28→35 套、layer-deps 基线 6→3（记录 reader 注入兑现） - IEC104上行设计说明.md：遥测读数改工程量口径 + 死区额定 0.5% 重定 已落地（卡 6）；§8 第 4 条改写、变更记录追加行 - 采集与算法层设计说明.md：状态行/红线③/幅值门三处由「标定未实现」 更新为「折算已落地、精度复核待卡 12 注入」 - App/log/soe_rec.h 类型注释表补 7/8 两行（lane-a 口误 6/7 已勘误， 真值按枚举链 SAMPLE_RESUME=6 连续计数） - test/host/soe/decode_soe.py：TYPE_NAMES + docstring 补 7/8—— 否则台架 FTP 下载校验会把标定闭锁记录判 bad type 误红（隐藏消费边）； soe 套件 32/32 复跑绿 |
||
|
wandering1
|
d07a9a4d67 |
docs(P1-10): sync 追平后补记四档复测数字（产品基线已前进，旧注保留）
sync 到 |
||
|
wandering1
|
a28123115d |
merge: v2-on-ui 追平至 task/P1-10-test-fw（含 A-3 卡5~7 与 B-3 记录 reader）
按 lead 信号 sync 追平：主干 59da40b（cal-lockout-dim）+ 891ca81（UI-rec-reader）+ 383b450（台账与凭证回填）合入本任务分支，为下一轮台架做准备（台架镜像必须建立在 追平后的代码上，否则烧进去的 hex 与主干不同码，体积门禁的凭证也对不上）。 唯一冲突：scripts/size_attestation.json —— **取主干侧**（383b450 刚按合并后的固件重盖 过，数字更新；本分支侧是 |
||
|
wandering1
|
5f1057ac74 |
test(P1-10): 套件回归 forbidden 换成显式四 Fault 标签 + 台架记录 21/21
台架第一轮（boot log 20261025_050539）判 VERDICT FAIL，命中 469 条 [ERR]，两类：
1) [ERR][CH395] ch395f P2 boundary fault @get_state sn —— **设计内**：Phase 15 的
sn 越界负向用例故意命中驱动守卫（Drivers/BSP/CH395F/ch395f.c 的
ch395f_p2_fault_note()：首次 DBG_ERROR、之后只计数），用例本身 PASS；
2) [ERR][WD] task stall ×468 —— **设计外**，已在
|
||
|
wandering1
|
ffd462ef3c |
feat(保护标定): 卡5 未标定闭锁 + 卡6 下游三常数重定 + 卡7 量纲回归单测
卡 5（protect_task.c 第⑤闭锁源，「数据可信」§4.3 决策 1=闭锁）： - UA/UN/IA 的 adc_cal VALID 未全置位 → prot_elm_init + 本拍不 eval；每拍现查 flags、无自有状态（卡 12 标定写入后自动解锁）；判据链优先级 = 采样可信在前、 标定可用在后（数据都是旧的谈不上标定） - 边沿日志用 DBG_INFO 而非 [ERR]：未标定是出厂常态、非故障，且 @test 禁用 [ERR]（「默认构建保护不动作 = 期望」的台架判据同步项已在 MR 报 lead）； SOE 分型 SOE_T_CAL_BLOCK/RESUME（soe_rec.h 枚举尾追加，值 6/7——reader 侧 显示标签映射归道B reader，MR 已报） - 台架旁路 = 编译期宏 DTU_BENCH（§4.3：不进 cfg 不进 104；本仓所有提交目标 都不定义它 = 产品恒强制闭锁） 卡 6（下游三常数按工程量重定，依据同源 docs/任务规划/数据可信.md §2.3）： - FREQ_AMP_MIN（freq.h）：语义从拟定码值域重定为二次值 V——50 V = 0.5×Un （标称 100 V），断保险/PT 空载/浮空必低于之；数值沿用 50.0f 属巧合并在 注释明写；eng=0 过渡期本门恒失效 → OF/UF 按必不启动填充，与卡 5 同向安全 - k_yc[].deadband（iec104_pts.c）：9 点按「额定 0.5 %」规则重定：电压类 0.5 %×100 V=0.5、电流类 0.5 %×1 A=0.005、频率维持 0.5 Hz 绝对值（非额定 比，卡 10 运行参数化）；标称基准与 prot_set 头部同源，防两处真相 - g_prot_set_meta[]（prot_set.c）：数值/范围复核结论=不动（0~4×标称自洽）， 文件头补量纲口径块：A/V = 二次值、标称 100 V/1 A、OV120=1.2Un/UV20=.2Un/ 3U0 15=.15Un、OC1/2/3=10/5/2×Ir、OL=1.0×Ir；PS_ID_COUNT/blob VER 未动 - iec104 套件 TC-008 死区用例同步重定标（100.4 带内 / 101.25 越带），97/97 卡 7（test/host/prot_dim 新套件，真实链 adc_cal→ring→phasor→prot_elm）： - 用例从 ADC 码值出发、显式写出 code↔二次值互逆换算（dim_code vs apply）， 折算点被旁路或量纲再错位断言立刻翻转（M4 判据⑥「不该动作时不动作」） - 合成 ROM 覆写（#undef K_Q16 宏）模拟卡 12 标定后板级口径，走 adc_cal_set 正规路径置 VALID；b=-30 码全链对消进 rms 断言 - 38/38：基线静默（含 OL 低定值陷阱）、反错配对照（raw 码值灌环复现历史事故 必假动作 vs 经折算必静默）、OC1/2/3+OL+OV+UV+3U0 七类逐一：越限定值→ 受控启动拍→dly-2 不动作/+5 动作→返回系数带内保持→跌破释放、双件聚合位图 独立性（撤 IA 只回 OC1） 测试与注册：prot-dim-unit-test 钩子 + TC-HOST-PROTDIM 族（游标 010，B 层口径 同 ADCHEALTH/ADCCAL 先例）；无新 MCU 源文件（uvprojx/SIM_EXEMPT 零改动） gate：@build 0 错 0 警（Code=215640 RO=21388 RW=1220 ZI=131980 vs 基线 215440/19780/1220/131980 → Flash +1808 B、RAM 零增量）；protectTask 静态最坏 链 872 B/margin 1176 B（57%）PASS，adcTask 不变；staged 门禁除 mem-numbers/ mem-budget（台账漂移，回填归 lead）外全绿： gate: only mem-budget/mem-numbers pending lead ledger backfill BOM/CR/U+FFFD/字面量 ASCII 已逐文件自查（本轮未触碰带 BOM 文件） |
||
|
wandering1
|
adabb6af12 |
fix(test): 主机单测/覆盖率产物按工作树分家 + 每次跑独占目录（task-10）
现象（2026-10-25 三条道并行开发实测，看板 task-10）：全量 ci_local 的 L0 里 test-cppcheck / test-coverage 偶发 "files were modified by this hook"，单独重跑 即绿、工作树零改动。根因在 unit_test_harness：obj/exe 直接落在**全机共用**的 %TEMP%，名字由套件名派生（%TEMP%\net_socket_tests.exe、%TEMP%\net_socket_obj）， 多棵工作树并行跑同名套件必然互踩。 真正要命的不是编不过，而是**结论张冠李戴**：A 树编译完，B 树把同名 exe 又盖一 遍，A 树随后 subprocess 执行的是 B 树编出来的二进制——两棵树的 summary_marker 一模一样，harness 分辨不出来，于是拿别人的运行结果给自己判 PASS。这种失败不会 变红，只会静默给出错误结论，比红难查一个量级。 修法（不是加锁）： - 产物根按**工作树**分家：%TEMP%\dtu_host\<仓库根路径 sha1 前 10 位>\。树身份取 harness 文件自身位置（test/host/common 往上三级），不依赖 cwd/环境变量；工作树 之间只联接 .venv 与模拟器 SDK，test/host 每棵树各有一份，所以这个身份可靠。 - **每次运行再独占一个子目录** runs\<pid>-<纳秒>\，obj 与 exe 都放进去，跑完 finally 删（含 Ctrl-C 路径）。这一步顺带把"同树并发同名套件"也消灭了：两个 进程既拿不到同一个 exe，也拿不到同一个 .obj（实测共享根时并发会因 obj 撞名 直接编不过，返回 rc=2）。没有牺牲缓存：每个测试单元就一个 .c，cl 每次整体重编， "共享 obj 省编译"本来就是错觉。**不加锁**：这里没有需要互斥的独占资源，只是 名字撞了；加锁等于把 L0.5 变成 build/bench 那样的全局串行。 - 独占目录里留 <exe>.owner.json（suite / repo_root / pid / started）：需要证明"这 份产物属于哪棵树哪次跑"时有的可查，不必靠时间戳猜。 - 编译返回 0 但产物不存在 → 明确报环境错误，绝不跑来路不明的二进制。 - 两个开关：DTU_HOST_BUILD 改产物根（CI/容器固定路径），DTU_HOST_BUILD_KEEP=1 保留本次目录（要单步调试 exe 时用）。判据单一事实源 = host_build_root()。 - scripts/check_test_coverage.py 同源改造：work_root 由固定共享名 dtu_test_cov 改为 复用 harness 的 host_build_root()/coverage，并同步 --work-dir 帮助文案与 docstring （docs 里"并行期每人只跑 --module 自己模块"那条规避就此作废，它是为绕开旧共享名 而写的）。顺带删掉因此不再使用的 import tempfile。 附带修一处同族不诚实（做本任务时从自己的输出里发现）：ci_local 的收尾那行以前 无条件打印"L0 + L0b + L0c + L0.5 全部通过"，--l05-only 时等于把没跑过的段宣布 为通过——正是 A-5 那个"SKIP 冒充 PASS"的镜像版。改为只列本次真正跑过的段。 自证（都是实跑，不是推演）： - 两棵树身份并发跑同一套件：把修好的 harness 复制成 A/B 两个树身份（repo_root 不 同 → 两个不同产物根），套件 BUILD 从真仓库加载，各跑 4 轮并发 → 8/8 rc=0， 两侧 roots 分别是 …\55deb98e3b 与 …\902100bc41，互不可见。 - 敌意场景：把两边 DTU_HOST_BUILD 强行指到同一目录（旧写法必撞 exe/obj）→ 8/8 rc=0，共享根下只剩一个空的 runs/。同树并发同理被这一条覆盖。 - 单套：test/host/sha256 rc=0（13/13），产物确实落在 …\4b9166f602\runs\<pid>-…； 覆盖率 --module sha256 rc=0（line=111/114 func=7/7），落在 …\coverage\sha256。 - 全量：ci_local --l05-only → 33 runner(s)，2276/2276 assertions passed，fail=0。 - 临时目录与 scratch 已清理（脚本在仓库外，不入库；ci-artifacts/ 之外无残留）。 文档：test/host/common/README.md 新增"产物目录归属"一节（落点结构、为什么按树、 为什么每次独占、两个开关、一行命令查当前树的产物根）；harness 顶部注释是判据正文。 docs 侧两处按分工归 lead 在 done 时统一改，合并请求里已给可直接粘贴的替换文本： docs/测试说明/主机单测覆盖率口径.md 的产物目录条与"坑 12"、以及并行任务工作树 方案.md 的产物归属条。AGENTS.md 与 docs/** 本次一个字节没动。 RAM/Flash 增量：0 B（纯测试工具链，不进固件）。gate：见提交钩子输出，未用 --no-verify。 遗留：tools/font_gen/make_font.py 同样用固定共享名（%TEMP%\simsun_regular.ttf、 font_extra_<cp>.c）——同一类跨树竞态，但属道B 字体域，我没动，建议另开一张卡。 |
||
|
wandering1
|
16917bf165 |
test(P1-10): CH395F 套件三档构建实测 + 修阶段开关行尾跨行注释的切换陷阱
P1-10 剩余①「CH395F 套件实际构建确认链接通过」今天才真正有数：产品基线 + 三档 测试配置（ARMCC，全部 0 错误 0 警告；.sct 保持 128 KB 未动，符合 P1-10 写的 "不建议扩到 192KB"）： 配置（TEST_SUITE_CH395F + 阶段） Code ZI RW_IRAM1 距 92% 余量 产品基线（阶段全关） 214,104 131,852 75,632 57.7% 44,954 B 默认阶段 11/14（只切套件宏） 217,468 134,076 77,920 59.5% 42,666 B NET 层全开 6~11/13/14 218,992 141,688 85,552 65.3% 35,034 B HW 层全开 1~5/12/15（最坏态） 229,256 147,176 90,952 69.4% 29,634 B HW 层无需 PC 1/12/15（冒烟用） 215,244 134,896 78,672 60.0% 41,914 B P1-10 specifically 关心的 PHASE5 三块静态缓冲（3 x PHASE5_CHUNK_SIZE = 3 x 4093） 确实进了链接，不是"理论上会在"：hw_full 的 ch395f_test_task.o 数据段 = 12,285 B （12,279 + 该 TU 其余 6 B）。于是"理论余量足够但未实测"改成了实测：最坏态仍余 29,634 B（RW_IRAM1 上限 131,072 B，92% 线 120,586 B）。RW_CCM 四档恒为 57,376 B / 87.9%——测试代码不进 CCM，但该区已经贴着红线，将来往 CCM 加东西要单独核算。 顺手修掉一个把实测挡了三年的坑（就是它让第一轮 hw 配置炸掉的）： ENABLE_PHASE11/14 两行的说明是**挂在行尾的跨行块注释**。而"关掉一个阶段"的标准动 作是在行首加 //，// 只注释到行尾 → 块注释从第二行起变成裸代码，实测 188 条 error #7: unrecognized token，报点落在注释续行上，看着像头文件坏了、其实只是注释 被腰斩。run_all_suites.py 的 _rewrite_config 只改 TEST_SUITE_* 行（那些行没有行尾 跨行注释）所以一直没暴露；ch395f_test.h 恰是"人手工切阶段"的入口，必须自身安全。 修法：把两段说明挪到 #define 行的上一段，行尾只留同行闭合的短注释；并在开关区后面 写清"开关行注释规范"+ 上面这张实测表（同一事实只在这一处，销项时文档引它）。 验证（_wt/P1-10-test-fw，每步都实跑 @build）： - V1 产品态（改注释后）：0/0，Code/RO/RW/ZI = 214104/20388/1204/131852，与主干 2026-10-25 台账行逐项相同 → 本改动零体积增量。 - V2 只切套件宏（默认阶段 11/14）：0/0，RW_IRAM1 77,920 B / 59.5%。 - V3 **朴素行注释切换**（正是炸掉第一轮的那个动作）改到 HW 1/12/15：0/0，且尺寸与 用 #undef/#define 覆盖法得到的 hw_nopc 逐字节相同（215244/23656/1200/134896） → 陷阱确认已消除，两条改法等价。 - V4 还原后产品重建：0/0，数字回到基线；test_config.h 与 ch395f_test.h 均按字节还原 （git status 只剩本文件这一处改动，测试宏没有留在树里，test-suite-switch 无需放行）。 - 产物身份戳实测：hw_nopc = "Oct 25 2026 04:32:16 suite=CH395F dstr=off"、产品态 = "Oct 25 2026 04:32:25 suite=NONE dstr=off" → dstr=off 三档一致，破坏性开关全程关。 RAM 增量：0 B。gate：改动只命中 no-mojibake / trailing-whitespace / end-of-file-fixer / check-added-large-files / id-check / mem-budget，全部 0；未用 --no-verify。 P1-10 剩余②（@test 烧录抓日志）需要 bench 锁，已把镜像与锚点清单交给 lead 执行； 真机跑 Phase 2~5 / 8 / 11 / 13 / 14 需 PC 端 tcp_server / peer 配合（Phase 11 还要 制造死对端，E11），属"实际测量采样"类，按用户指示本轮跳过，不在本提交声称做过。 |
||
|
wandering1
|
3528644e9d |
feat(采集标定): 卡2 adc_cal 折算模块 + 卡4 系数落盘 + L5-2 码值贴轨检出
卡 2（App/algo/adc_cal.*，新增；adc_task.c:335 折算点收口）： - 模型：工程量 =(code+b)×k（「数据可信」§4.1）；k 以 int32 Q16(µV/码×65536) 落盘、b 以 int32 码值落盘；ROM 默认 = 卡 1 定死的引脚侧 LSB，Q16 下整除无 舍入（TPAFE 10,000,000=152.587890625 µV/码；STM32 52,800,000=805.6640625） - adc_task 每拍 frame[s] 改 adc_cal_apply()（现单位 = ADC 引脚电压 V，eng=0， 二次值语义等 VALID）；TEMP 透传码值（决策 5）；不缓存 k_f 副本——逐点由 RAM 现值派生（无回调设计下杜绝陈旧系数；18k flops/s 可忽略） - 三态 flags（§4.2）：VALID = 文件位图 ∧ k 在合法带；CLIPPED 按来源运行期 派生（V0.2/N-18 后自动恒 0）；消费者判可用性只查 adc_cal_flags() - 合法带哨兵：k∉ROM×[0.5,2.0] 或 |b|>8192 → 折算回退 ROM + 每通道每开机 一条 [ERR] + VALID 压制（位图说谎也兜住）——同时挡坏文件与坏标定 - 两点标定公式 adc_cal_two_point() 算术核齐备（int64、±舍入界、斜率/零点 守卫 -1/-2 分档）；台架两点标定（卡 12）按用户指示未跑，留台架注入口径： 心跳新增 cal: 行（ua/un/ia_mv 定点 + vl/cl/rail 位图，未标定 vl 应恒 0x00、 cl 应恒 0xE6，注入饱和电平 rail 位应起） 卡 4（[adc_cal] k_ua..k_in+valid / [adc_cal_ofs] b_ua..b_in，§4.4 布局）： - 两段注册进 cfg 引擎（data_size 33/32，不挂回调——RAM 副本即生效值）； adc_cal_init() 落 app_main_init 内核前（注册必须先于 defaultTask 的 cfg_file_load；跨任务读走 4 字节对齐字，µs 级混窗为「数据可信」§4.4 明载 设计）；文件缺失/损坏 = 引擎回退工厂默认 = ROM 表本体（默认即理论系数） - adc_cal_set()：整定写入口（属主上下文），越带拒绝 RAM 不动 - 单测走真实 cfg_file 引擎集成：文件值生效 / 越界 k 哨兵兜住且不报 VALID / 超长损坏文件回退默认且 flags 无 VALID（卡 4 DoD 原句）/ 段缺失默认 L5-2（adc_health v1.2，越界门限按 FS 百分比、码值域与标定正交）： - adc_health_rail_watch()：连续 20 拍（=一周波）贴同侧轨带（TPAFE±98%半量程、 STM32 顶 98%/底 2%，门限由 adc_cal_rail_ths 供）且此前见过中带释放沿才 锁存——空载恒 0 / 开机恒 0 合法工况不误报（短板评测 §6.2 判据①）； adc_task 编排：边沿 DBG_ERROR + SYSLOG 每开机一次 + 心跳 rail/edge 位图 - 健康用例 60/60（+13）：释放沿/清零/交替/双侧/init 复位/越界通道守卫 测试与注册：新套件 test/host/adc_cal（89/89，8 通道×≥3 码点期望值由 LSB 常数独立推导、Q16 无舍入、set 边界含端点、两点还原合成 k/b 往返）； 编号形态返工一轮：TC-ADCCAL-00A~00D 改 014~017、注释 FS-1 字样改写、 id_registry 族 pattern 转义修正、族游标登至 017；coding-standard 返工： 公开实现函数补齐函数头注释块（CODE-RULE-09） uvprojx 仅增 adc_cal.c 一条挂载（diff 已核零抖动）；SIM_EXEMPT/id_registry (TC-HOST-ADCCAL 族)/adc-cal-unit-test 钩子行按 new-source-file 与 B 层口径 补齐；覆盖率 34/34 套件 89.6%，adc_cal.c 99.2%（baseline --update 属共享 台账文件，留 lead done 后统一回填） gate：@build 0 错 0 警（Code=215440 RO=19780 RW=1220 ZI=131980）； RAM 增量 +144 B（RW+16/ZI+128：贴轨 9×6B + 两段 RAM 副本，IRAM1 57.7%→ 约 57.8%）；Flash +1336B/+920B RO。adcTask 栈 worst=1344B margin 1216B (47%) PASS（stack_report 实测）。staged 门禁除 mem-numbers/mem-budget 外 全绿（该两条 = 台账漂移，回填 --write 落 docs/内存管理/** 单写者区，按 Lead 既定例外归 lead done 后处理）： gate: only mem-budget/mem-numbers pending lead ledger backfill BOM/CR/U+FFFD/字面量 ASCII 已逐文件自查（本次未触碰任何带 BOM 文件） |