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
parent 7635480e06
commit 0f7b5a87fb
253 changed files with 2234 additions and 4541 deletions
@@ -41,7 +41,7 @@ ADC 引脚电压 V）+ `adc_health_rail_watch()` ×9（L5-2，码值域）→ `s
 ## 3. 逐文件要点（只留"改代码时必须知道"的；机制与理由见设计文档）

 > **改本目录前先记五条红线**：① 取数只经 `adc_input_raw()`，不写死下标；② **禁止跨转换器**做
-> 相位 / 功率 / 矢量运算（N-18）；③ 帧值已是 L1.5 工程量，但 **未标定（`adc_cal_flags()` 无
+> 相位 / 功率 / 矢量运算（双转换器无共同采样触发）；③ 帧值已是 L1.5 工程量，但 **未标定（`adc_cal_flags()` 无
 > VALID）时单位只是 ADC 引脚电压**，不是端子二次值——下游消费精度判据见「数据可信」§4.2 三态
 > 表；④ 工程量 → 帧的唯一折算点是 `adc_cal_apply()`，禁止旁路再乘系数；⑤ 本层不建任务、
 > 不等事件、不写日志（`adc_cal` 的 `[ERR]` 哨兵留痕是唯一例外，且每通道每开机一次），
@@ -87,7 +87,7 @@ ADC 引脚电压 V）+ `adc_health_rail_watch()` ×9（L5-2，码值域）→ `s
  `freq_get() == 0 && freq_valid() == 1`。
 - 精度靠**自适应窗长**（窗长 = 泄漏纹波周期的整数倍）；定长平均压不到 0.02 Hz，
  换窗长 = 换精度，二者不是独立旋钮。
- 源切换即废相位基准重建（UA / IA 无共同相位基准，N-18）。
+- 源切换即废相位基准重建（UA / IA 无共同相位基准，即双转换器无共同采样触发）。
 - 判据 **J1~J6** 与实测口径 → `docs/算法/采集与算法层设计说明.md` §7.2（与 `test/host/freq/freq_test.c` 文件头同源）。

 ### 3.8 `adc_cal.c` / `.h` — L1.5 通道标定折算（「数据可信」卡 2 / 卡 4）
@@ -129,7 +129,7 @@ ADC 引脚电压 V）+ `adc_health_rail_watch()` ×9（L5-2，码值域）→ `s
 ### 4.1 挂载与模拟器边界
 - 九个 `.c` 已登记在 `MDK-ARM/STM32F407-Demo.uvprojx`；`../App/algo` 已在 `<IncludePath>` 内。
 - 本层**不进** `simulator/CMakeLists.txt`（UI 模拟器不跑采集链路）：九个文件全部登记在
-  `scripts/check_registration.py` 的 `SIM_EXEMPT`（附理由），`registration-check` 钩子反向校验（N-23）。
+  `scripts/check_registration.py` 的 `SIM_EXEMPT`（附理由），`registration-check` 钩子反向校验（登记簿条目「rs485_task 白名单缺口」）。

 ### 4.2 主机侧单测（L0.5）——生产源文件以 `#include` 原样纳入

@@ -70,7 +70,7 @@ static adc_cal_bcfg_t  s_bcfg;        /* 生效零点副本 */
 * （16 位 ±5 V 档），UB/UC/IB/IC/IN 走 STM32 ADC1；逐路对过
 * docs/硬件平台/ADC通道映射说明.md §3（IN=ADC11/STM32，勿再按分组顺序误写）。
 * ROM 表按**当前 V0.1 来源排布**显式书写（不查 desc 运行期派生），因为它是
- * 卡 1 定稿的存档事实；V0.2（N-18）改版时本表与 adc_input 映射表同步改，
+ * 卡 1 定稿的存档事实；V0.2 改版（消除双转换器无共同采样触发）时本表与 adc_input 映射表同步改，
 * 上层语义与 API 不动。CLIPPED 位则**运行期按来源派生**（见 adc_cal_flags） */
 static const adc_cal_kcfg_t s_kcfg_rom = {
    /* idx0 UA / idx1 UB / idx2 UC / idx3 UN */
@@ -272,7 +272,7 @@ uint32_t adc_cal_flags(adc_semantic_t sem) {
        f |= ADC_CAL_F_VALID;
    }
    /* CLIPPED 由**来源**派生（R5：STM32 侧单极性无偏置 → 负半周削顶）——
-     * V0.2 改版（N-18，8 路全接 TPAFE）后本位自动恒 0，无需改码，
+     * V0.2 改版（8 路全接 TPAFE，消除双转换器无共同采样触发）后本位自动恒 0，无需改码，
     * 对应「数据可信」§10「页面与 104 绑定零改动」的要求 */
    if (s_rom_k_stm32((unsigned)sem) != 0) {
        f |= ADC_CAL_F_CLIPPED;
@@ -15,7 +15,7 @@
 *           标定（卡 12）完成前不得把输出当二次值消费。TEMP 不参与线性标定
 *           （决策 5），adc_cal_apply() 原样透传码值。
 *         本层**纯算法 + 纯数据**：不碰寄存器、不等事件；adc_cal_init() 内核前
- *           可调（注册进引擎必须先于 cfg_file_load，N-19 契约）；apply/flags
+ *           可调（注册进引擎必须先于 cfg_file_load，FTP 鉴权确立的契约）；apply/flags
 *           任意上下文可读（cfg RAM 副本 4 字节对齐字读写在 Cortex-M4 上原子，
 *           与 defaultTask 的 load/poll 复位存在 µs 级混窗——设计接受，见 .c 头）。
 * 适用平台：STM32F407ZGTx（Cortex-M4F）；主机侧 L0.5 单测 test/host/adc_cal/
@@ -8,7 +8,7 @@
 *          ④ 错误计数增量：FRSTDATA 跳变 / HAL ADC·DMA 错误 / STM32 停摆计数。
 *          ⚠ 本层**纯逻辑**：不碰寄存器、不取数、不打日志——输入是调用方
 *            采集的计数快照，输出是故障位；日志与自检上报由消费者
- *            （`App/task/adc_task.c`）按位执行 → 主机侧可单测（L0.5，A-4）。
+ *            （`App/task/adc_task.c`）按位执行 → 主机侧可单测（L0.5）。
 * 适用平台：STM32F407ZGTx + TPAFE5160
 * 作者：王建锋
 * 创建日期：2026-10-11
@@ -41,7 +41,7 @@
 * 权威口径：docs/硬件平台/ADC通道映射说明.md（2026-10-09 硬件确认的语义分配）。
 * index 含义：TPAFE 源 = 驱动 buf 下标 0..7；STM32 源 = ADC1 通道号 0..15。
 * ⚠ 消费侧一律经本表按语义取数，**不得写死下标**（V0.1 有 13/17 路被置换，
- *   网名编号与通道号不等价）；V0.2 改版（N-18）只改本表内容。 */
+ *   网名编号与通道号不等价）；V0.2 改版（消除双转换器无共同采样触发）只改本表内容。 */
 static const adc_channel_desc_t k_adc_map[ADC_SEM_COUNT] = {
    [ADC_SEM_UA]   = { ADC_SRC_TPAFE, 6U },                        /* TPAFE buf[6]（ch7） */
    [ADC_SEM_UB]   = { ADC_SRC_STM32, (uint8_t)ADC_CHANNEL_14 },   /* PC4 */
@@ -240,7 +240,7 @@ int adc_input_init(void) {
 *          STM32 侧无新帧不影响 TPAFE 快照与返回值语义（其状态另由
 *          adc_input_stm32_rc() / adc_input_stm32_seq() 暴露）。
 *          ⚠ STM32 侧数据比 TPAFE 侧**滞后 1 拍**（乒乓双缓冲的固有延迟，
- *            9 路一致）；按 N-18，V0.1 本就禁止跨转换器做矢量运算。
+ *            9 路一致）；因双转换器无共同采样触发，V0.1 本就禁止跨转换器做矢量运算。
 */
 int adc_input_poll(void) {
    int r = tpafe5160_snapshot(s_tpafe_raw, (uint8_t)ADC_INPUT_TPAFE_CH_NUM);
@@ -5,7 +5,7 @@
 *          ① 语义通道映射表（L1-4）——权威口径 docs/硬件平台/ADC通道映射说明.md；
 *          ② STM32 ADC1 9 通道采样（L1-3）——由 **TIM3 TRGO 硬件触发 + DMA 双缓冲
 *             搬运**，本层只消费、不触发、不等待。
- *          V0.1 上 8 路电气量分属两片转换器（硬件缺陷 N-18）：UA/UN/IA 走
+ *          V0.1 上 8 路电气量分属两片转换器（硬件缺陷：双转换器无共同采样触发）：UA/UN/IA 走
 *          TPAFE5160（16 位 / ±5 V 双极性），UB/UC/IB/IC/IN 走 STM32 ADC1
 *          （12 位 / 0~3.3 V 单极性）。V0.2 改版（8 路电气量全部接 TPAFE）
 *          只改映射表内容，本层 API 与上层语义不动。
@@ -47,7 +47,7 @@ typedef enum {
    ADC_SEM_COUNT       /* 语义通道数（哨兵） */
 } adc_semantic_t;

-/* 数据来源：V0.1 的 8 路电气量分属两片转换器（N-18） */
+/* 数据来源：V0.1 的 8 路电气量分属两片转换器（双转换器无共同采样触发） */
 typedef enum {
    ADC_SRC_TPAFE = 0,  /* TPAFE5160：16 位、±5 V 双极性、8 通道同步 */
    ADC_SRC_STM32       /* STM32 ADC1：12 位、0~3.3 V 单极性、9 通道顺序扫描 */
@@ -21,7 +21,7 @@
 *   - 信号源优先级：UA 基波 → IA 基波（UA 无幅值时用 IA，台架只注电流亦可测频）。
 *
 * ⚠ 本层**纯算法**：不碰寄存器、不碰 RTOS、不自己取数（输入 = phasor 使用区）
- *   → 主机侧可免桩单测（L0.5，落实登记簿 A-4）。
+ *   → 主机侧可免桩单测（L0.5）。
 * 适用平台：STM32F407ZGTx（Cortex-M4F，硬件 FPU）
 * 作者：DTU 项目组
 * 创建日期：2026-10-12（B8）
@@ -7,7 +7,7 @@
 *          覆盖规划 §3.2：L2-1 系数表 / L2-2 实例 / L2-3 有效值输出 /
 *          L2-6 每 1 ms 滑动窗 / L2-7 双区指针原子交换。
 *          ⚠ 本层**纯算法**：不碰寄存器、不碰任务调度、不自己取数（输入由
- *            `sample_ring` 提供）→ 主机侧可单测（L0.5，落实登记簿 A-4）。
+ *            `sample_ring` 提供）→ 主机侧可单测（L0.5）。
 * 适用平台：STM32F407ZGTx（Cortex-M4F，硬件 FPU）
 * 作者：王建锋
 * 创建日期：2026-10-10
@@ -4,7 +4,7 @@
 *           同 phasor 实例表模式）。判据为**纯逻辑**（吃测量值 + 定值），
 *           主机侧可离线单测；出口/SOE（L4）与任务编排为后续。
 *
- * V0.1 有效实例（N-18：仅 TPAFE 三路）：
+ * V0.1 有效实例（双转换器无共同采样触发 → 仅 TPAFE 三路）：
 *   OC1/OC2/OC3 三段式相间过流（A 相 IA，L3-1）
 *   OL          过负荷（A 相 IA，L3-3）
 *   OV/UV       过压/欠压（UA，L3-4）
@@ -53,7 +53,7 @@ extern "C" {
 * 入口参数：无
 * 返 回 值：无
 * 限定条件：**内核启动前**调用（app_main_init，adc_cal_init 之后）；注册必须先
- *          于 defaultTask 的 cfg_file_load（N-19 契约，同 adc_cal 先例）；幂等
+ *          于 defaultTask 的 cfg_file_load（FTP 鉴权确立的契约，同 adc_cal 先例）；幂等
 * 函数说明：注册失败（段名重复/段数超限）打 [ERR] 后继续——工厂默认照常生效，
 *          仅文件整定失效（adc_cal_init 同款降级）。
 */
@@ -118,7 +118,7 @@ uint8_t run_par_dirty_peek(void);
 * 入口参数：无
 * 返 回 值：0 成功（或无脏可存）；-1 写盘失败（脏保持，下轮重试）  int
 * 限定条件：**defaultTask（配置引擎属主）上下文**，由 SYS_EVT_RUN_PAR_SAVE 驱动
- * 函数说明：save 走引擎唯一写闸（超长拒写/原子改名，E-01 契约）；本函数不清
+ * 函数说明：save 走引擎唯一写闸（超长拒写/原子改名）；本函数不清
 *          引擎以外模块的脏语义（[adc_cal] 副本值已由写路径就位）。
 */
 int run_par_store_save(void);
@@ -1,7 +1,7 @@
 /*
 * 模块名称：采样环缓冲（L2 相量计算的输入）
 * 模块功能：按**语义通道**保存最近若干周波的采样值，供 L2 相量计算按窗取数。
- *          V0.1 上 8 路电气量分属两片转换器（硬件缺陷 N-18），本层只做"按时序
+ *          V0.1 上 8 路电气量分属两片转换器（双转换器无共同采样触发），本层只做"按时序
 *          存/取"，**不做任何跨通道运算**——同刻性由上游（L1）保证，本层不假设。
 *          容量取 **2 个周波（40 点）**，与参考系统 `CN_BUFSAM_CYCLE = 2`
 *          （规划 §10.1）一致，为后续加长数据窗（1.5~2 周波，抗衰减直流，