 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 对变更记录行本就豁免，两种选择都不影响门禁。
|
2026-10-27 08:59:26 +08:00 |
|
|
wandering1
|
64d8b052b1
|
docs(algo): App/algo/README 缩成目录索引，详细设计迁入 docs/算法
拆分层级
- 新建 docs/算法/采集与算法层设计说明.md（413 行、13 节）承接机制、契约、
判据与设计理由：定位与边界 / 数据流与初始化落点 / adc_input / adc_health /
sample_ring / phasor / freq（7.1 为什么自适应窗、7.2 判据 J1~J6）/
prot_set / prot_elm / 关键约定与禁令 / 资源足迹 / 验证与判读 / 相关文档
- App/algo/README.md 360 -> 128 行：只留文件清单、依赖、逐文件"改代码必须
知道"的红线、构建与测试入口、新增模块动作；深挖改成逐条指针
- README 保留 §3.1-§3.7 原编号，既有"§3.7"引用不失效
索引与引用同步
- 索引：docs/README.md §5.2 新增行；项目架构总览主题表拆成"设计与判据 /
目录索引"两行；AGENTS.md 与 App/README.md 指向（后者原文还写着 L1/L2）
- 按内容重指（编号仍在但内容已搬走，只核编号会静默指错）：App/algo/freq.h、
test/host/freq/freq_test.c、run_unit_test.py、继电保护规划 L2-4 行、
pre-commit使用说明 J4 行 -> 指向设计说明
- ADC采样节拍设计说明的两处指向同步改到新文档
修 README 内过时事实
- 挂载写"八个 .c"，实际 uvprojx 内 7 个
- SIM_EXEMPT 写"prot_set / freq 才登记豁免"，实际七个全在表内
- freq-unit-test 标"待登记"，实际已在 .pre-commit-config.yaml
- 定值项数一处 31->40、一处 32->40；blob 144->176 B 证明是 32->40
- 用例与判据数字不再三处复制：属主是 test/host/<模块>/ 与 docs/测试说明/
门禁
- doc-links --all 无新增问题；--sections-strict 覆盖 10 篇文档通过
- id-check 可判定 82.65%（基线 82.6，容差 0.1）；TC 双向追溯差异 124 处不变
- registration-check PASS（1 条已知 WARN）；freq 单测 46/46；@build 0 错 0 警
- 全部改动文件无 BOM、无 CR、U+FFFD = 0
|
2026-10-21 11:39:53 +08:00 |
|
|
wandering1
|
bda7ab2b50
|
refactor(编号): 16 个测试模块码单词化 + 门禁识别面连带放宽
批 2（用户授权改名 + 「新名要一眼看懂」裁定）
- 16 个有歧义模块码单词化，共 1,146 处随 scripts/rename_ids.py 改写：
AI→ADCIN、AH→ADCHEALTH、PS→PROTSET、PE→PROTELEM、PH→PHASOR、
TS→TIMESYNC、VL→VOLLOCK、NP→NANDPORT、CFG→CONFIG、CLK→SYSCLK、
WD→WATCHDOG、STO→STORAGE、SH→SHA256、FA→FTPAUTH、FR→FREQ、104→IEC104
- 不动 NET/GD5F/RTC/SOE/UI/ADC/LOG/RS485/TOOL（已是单词、芯片名或业界通用词，
改了纯属 churn）
- 别名按全局登记：这批字面量已完全限定（TC-<码>-<nnn>），不存在裸形多义
- 映射表存档 scripts/rename_maps/batch2.json 作审计轨迹；§6 模块码表同步
连带修门禁（关键教训）
- 模块码涨到 9 位（ADCHEALTH/WATCHDOG）后，候选正则与族正则的 {0,4} 上界
会让改名后的号**整批从门禁眼里消失**：实测编号字面量从 8271 掉到 7315、
悬空假降 490 处。已放宽到 {0,9} 并写进 §6 注记
- 结论：改名批次必须连带复核识别面，只改数据不改判据 = 静默放行；
这次是靠「可判定比例跌破基线即失败」那条线拦下来的
现状与遗留
- 校验 1 未登记前缀 0 处；可判定比例 82.71%（基线 82.6%，只涨不跌成立）
- 遗留：7 个模块的「单元测试说明.md」仍缺（PROTSET 116、NANDPORT 109、
PROTELEM 65、FREQ 48、FTPAUTH 45、SHA256 25、SOE 14 处悬空）——改名不解决
缺文档，处置方式待议
- 遗留：T-2/T-3/T-4/T-6 历史任务号悬空（别名表未收全，属本工具批次漏项）
- 未改任何 C/H 可编译语义（仅注释与宏名内的编号），故不需 @build
|
2026-10-21 09:53:28 +08:00 |
|
|
wandering1
|
0264b49489
|
feat(algo): B8 频率测量层 + 过频/低频保护（L3-5）
新增 App/algo/freq.c/h：由 L2 基波相量导出系统频率。相邻两拍共轭
乘积 P=Z(m)·conj(Z(m-1)) 取角 = 每拍相位增量（免显式解缠绕），再按
自适应窗长 K_eff=round(8·Fs/(2·f_hat))（45~55 Hz 段 73~89 拍）做滑动
平均。定长窗受 20 点矩形窗负序泄漏纹波限制（实测扫频最坏 0.317 Hz；
60 拍 Kay 复数和 0.197 Hz，交叉项和角不按 1/K^2 衰减），自适应窗使
窗长恰为纹波周期 fs/(2f) 整数倍 -> 最坏 0.0101 Hz。推导与两轮弯路
写在 freq.c 文件头。
假值钳制带取 35~65 Hz，刻意宽于系统合理带 40.5~60.5：单拍相位差本身
带 ±5 Hz 泄漏纹波，贴边钳制会非对称丢弃纹波半周 -> 均值偏置（实测
45 Hz 点 +0.16 Hz）。系统合理带由 OF/UF 定值范围在消费侧把关。
幅值门 FREQ_AMP_MIN=50 码（拟定，待 L1-5 标定复核）：低于门判无有效
波形，停更新、valid 清零、读数保持 -> 浮空/PT 断线不发散。源优先级
UA(C02)->IA(C01)，按名前缀解析、每拍动态回退，切换即废相位基准。
prot_set：尾追加 8 项（PS_ID_COUNT 32->40，编号不回收）
OF_EN/OF_HZ/OF_DLY/UF_EN/UF_HZ/UF_DLY/RET_OF/RET_UF。OF/UF 逐项通讯
地址不在本仓库 -> 全部 comm_addr=0 本地项（104 C_SE 不可寻址，待对照
参考表补）。频率返回系数独立（0.99/1.01），勿与电气量 0.95/1.05 共用。
bad_mask 随项数扩为 uint64_t。PROT_SET_BLOB_VER 1->2。
prot_set_store：换代与损坏分流。load 返回 2 = 版本/项数换代（本文件
打 INFO "prot set blob version change, defaults in use"），-1 = 真损坏
（defaultTask 按 CORRUPT 报 ERROR + 自检留痕）。B7 旧档（ver=1/32 项）
升级首启属预期路径，不得报成损坏。语义分流收在属主文件内，
default_task.c 不动。
prot_elm：实例表加 src 字段（0=phasor rms，1=freq），PE_OF/PE_UF 尾
追加（PE_COUNT 7->9）。freq 无有效读数按方向填"必不启动"值（过量 0 /
欠量 1e30 -> 滞回比较恒假 -> 元件复位），不整拍跳过——频率源缺失不得
饿死电流/电压类元件（B5 行为不回归）。OF/UF 暂未映射独立 104 遥信点，
动作只经 YX15 保护总聚合可见（送检点表 = B10）。
板端接线：adcTask 在 phasor_run() 之后同拍调 freq_run()；心跳/首拍日志
追加 freq(<tag>): f=%ld valid=%u (x0.01)（MicroLIB 无 %f）。app_main
内核前 freq_init()。
主机单测：freq 46 用例（J1 扫频 45~55 Hz <=0.02 Hz 实测最坏 0.0101；
J2 噪声 1% <=0.10 实测 0.0160；J3 启动收敛 <=40 ms 实测 20；J4 阶跃
50->51 <=120 ms 实测 98；J5 浮空 valid=0 不发散；J6 跳变 60 ms 内回
±0.05；另直流 8000 码 / 3-5 次谐波 20%/10% / UA->IA 回退）。
prot_set 90（+TC-PS-011 OF/UF 行 + 64 位 bad_mask bit39 + 旧档拒绝）、
prot_elm 47（+OF/UF 滞回与方向隔离 + run() 测频接线）。回归：phasor
57、iec104 94 全绿。
J4=120 ms 是"精度优先于响应"的显式取舍（Lead 批准）：4 周波窗换
0.317->0.0101 Hz，测频响应 98 ms << OF/UF 定时限默认 1000 ms（占
总动作时间 <10%），暂态另有 J6 <=60 ms 兜底。
注册：freq.c 入 uvprojx algo 组 + check_registration.py SIM_EXEMPT
（纯算法、模拟器无消费路径，照 prot_set.c 先例）。
@build 0 错误 0 警告（Code=207468 RO=18304 RW=1068 ZI=153084）。
RAM：RW_IRAM1 96096->96728 B（+632 B，73.3%->73.8%）、RW_CCM 不变
57376 B（87.9%）、Flash 224596->226840 B（+2244 B，21.4%->21.6%）；
台账随合并由 Lead 回填。stack_report：adcTask 静态最坏链 1320 B /
余量 1240 B（48%）改前后完全不变（freq_run 帧未进最坏链，无需抬栈）；
protectTask 链 872 B / 余 1176 B（57%）同样不变。
gate: only mem-budget/mem-numbers pending lead ledger backfill
--------------------------------------------------------------
门禁实跑（pre-commit run --all-files，Lead 批准 --no-verify 提交）：
28 Passed / 2 Failed，失败仅 mem-numbers 与 mem-budget 两条——均为
docs/内存管理 受管快照与本 .map 不一致（台账由 Lead 每次合并后
--write 回填，避免多分支同改受管表冲突）。其余含 doc-links /
coding-standard / no-mojibake / cppcheck / registration-check /
13 条主机单测钩子全 Passed（gitlint 属 commit-msg 阶段，不在该次
--all-files 内）。ci_local L0.5 全绿（freq 46/46 等）。
字节卫生自查（--no-verify 跳过卫生钩子，故手工核）：17 个暂存文件
全部 BOM=无 / CR=0（纯 LF）/ U+FFFD=0；自研 .c/.h 去注释后字符串
字面量 100% ASCII（唯一非 ASCII 字面量在 test/host/iec104/iec104_test.c
的既有用例名，非本次改动行；test/ 不在 coding-standard 钩子范围）。
|
2026-10-12 19:16:37 +08:00 |
|