 wandering1
|
7b05d7bfd4
|
docs: 任务规划目录收缩——只留推进顺序与硬件缺陷，其余待办归模块文档
按用户裁定（2026-11-10）把 docs/任务规划/ 从"全量待办表"收成两个文件：
1. 登记簿.md 只记 V0.1 硬件缺陷 → V0.2 改版要求（双转换器无共同采样触发、
IA 前端差分滤波限制谐波带宽）。原 §1/§2/§4/§5/§6/§7/§8/§9 的待办按
"待办跟着所属模块走"清空，四类事实在删除前先落到新归属：
- 两点标定开工前要先拍板的三件事 → 算法层设计说明 §13.13（新节）
- 通讯设置页真机判据 → 网络配置说明 §3.6 内联
- 缩堆迁 CCM 后半、开入开出重开条件 → 原本各模块文档即唯一权威
2. 暂缓-RS485.md 删除，其唯一不可丢的"采集链路测试可验证性约束"三条与
完成判据并入 产品需求设计文档 §5.10。
3. 任务规划/README.md 去掉全部历史叙述（UI 补齐销项流水、net 收口过程、
故障录波近千字台账），只留：怎么用、条目规则、生成物单写者纪律、
推进顺序表（每行只写当前状态与卡点）、维护约定。
同步改写全库引用（约 60 处）：AGENTS.md、docs/README.md、产品需求、UI、
子系统设计、内存管理、环境与部署、算法、测试说明、门禁说明、问题记录，
以及 App/ 与 Drivers/BSP/ 的头注释、脚本与 .pre-commit-config.yaml 注释。
顺带修掉三处已失效的引用目标：链路延迟测试的队列往返重验项改指实机测试
实施指南 §7.3；并行工作树的 <ID> 行去掉已退役的 N-x/S-x/T-x 编号族；
任务规划 README 的 §1 旧编号在技能示例里的引用。
门禁：check_doc_links --all --sections-strict 214 篇通过、无法判定 0；
pre-commit 全 Passed（doc-links / mermaid / 任务表 / 内存数字 / BOM /
UI 像素回归 / generated-fresh / layer-deps / bsp-err / skill-size）；
keil-build 0 错误 0 警告（Code=255160 RO=31204 RW=2080 ZI=152152），
RAM 预算门禁 PASS（RW_IRAM1 73.9%、RW_CCM 87.9%）。
|
2026-11-10 20:33:30 +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
|
67fbdd9897
|
refactor(结构债): S-4 删零消费点占位宏；S-2 消两处与 Inc 重复的 extern
用户批准「先只跑 1+2」（报告 §0.4 结构债三项 S-1/S-2/S-4 的评估结论）。
**S-4 闭环**：删除 `App/app/app_cfg.h` 里 4 个**全库零消费点**的宏
（`APP_NET_ENABLE` / `APP_ADC_ENABLE` / `APP_RS485_ENABLE` /
`APP_SYS_TIME_SRC`），文件降格为「决策占位说明」——修改记录 v1.2 写明为什么删、
将来在真实初始化点接入门控时怎么接回；同时去掉 `app_main.c` 里只为它存在的
include。留「看着能裁剪、其实不生效」的宏比不留更糟：它不产生任何编译期效果，
却会让评审误信模块可裁剪——此前为了对冲这个误解，AGENTS 之外还得在 6 处文档各
写一句「未接线占位，别当开关用」。
**文档口径同步 17 处**：`App/app/README.md`、`App/README.md`、根 `README.md`、
`项目架构总览.md`、`项目部署环境要求.md`（§3.2 两行 + 配置表一行）、`产品需求
设计文档.md`（B0 结论 + 配置表）、`基线与待确认.md`、`排期详述.md` C5、`登记簿
.md` N-23 残余、`RAM使用分析与优化方案.md` 三处。
**顺带纠出另一个「文档里有、代码里从来没有」的东西**：`RAM使用分析与优化方案
.md` 把 `APP_CCM_ENABLE` 写成「加在 `App/app/app_cfg.h`」，全库只有那篇文档提
到它，从未落地——已就地标注「未实现，重开本簇时一起落地」，免得下一个读者以为
CCM 有回退开关。
**S-2 第一步**：删 `gd5f2gq5ue.c:47`、`sd2506.c:20` 两处与 `Inc/spi.h` /
`Inc/i2c.h` 重复的 `extern`；GD5F 改 `#include "spi.h"`（沿用 `ch395f.c:22`
的既有做法）。
**镜像体积逐项不变**：`Code=213,188 RO-data=18,580 RW-data=1,184
ZI-data=131,504` 与改动前完全相同，`@build` 0 错 0 警告 → 两步均为行为中性。
报告 §0.4/§9 同步为实测口径并**认错**：S-2 不是旧写的「4 处」而是 **25 处**
（`App/task/default_task.c:52-69` 一次就 18 行任务句柄/属性 extern；
`stm32f4xx_it.c` 的 `fault_entry_hard` 属 ARMCC `__asm` 合法例外，不该「
修」）；S-1 不是「语义层错位」而是**真实的 BSP→App 反向依赖**（NETCFG 10 处
include `App/cfg/cfg_file.h` + UI 3 个文件）。这两个旧数字是 v3.0 重写时沿用
未测所致。
途中被自家门禁正确拦下一次：在 .c 注释里写「S-2a」→ `+1 [校验1] 未登记编号
`，改成平实语言后转绿（正合既有纪律「代码注释禁用不可检索的内部编号」）。
门禁：`@build` 0/0；`check_ids.py --strict` 增量拦截通过、存量债 650 → 640、
可判定比例 82.83%（地板 82.6%+0.1pp）；`check_doc_links.py --all
--sections-strict` 146 文档 0 问题；`pre-commit` 相关文件全 Passed；字节卫生 15
个文件 BOM/CR/U+FFFD/行尾空格全清（`end-of-file-fixer` 修掉 app_cfg.h 的一个
多余空行）。未推送。
|
2026-10-22 18:22:58 +08:00 |
|
|
wandering1
|
d3107f374f
|
docs: 待处理内容.md 解耦为 docs/任务规划/ 文件夹（README 排序权威 + 6 个职责单一文件）
- rename_ref.py 搬迁：git mv + 全库引用改写 33 文件 82 处
- README.md 保留 §0 编号空间 / §1 未闭环一览 / §2 推进顺序权威 / §3 维护约定
- 拆出 6 文件：W1-采集保护收尾（任务卡五字段）、排期详述、暂缓-RS485、
登记簿、测试与架构专项、基线与待确认
- 外部引用重定位 ~50 处：裸「登记簿 §X」、§5.1→基线与待确认 §2.1、
§2.4→暂缓-RS485、§6→基线与待确认 §3、脚本注释 T-x/N-x→登记簿
- 新增并行写纪律：任务分支不改本文件夹，状态列由 Lead 主工作树更新
- 验证：doc-links 141 文档全绿；mem-numbers 一致；refgraph 重生成；
@build 0 错误 0 警告；新文件无 BOM / LF / 零乱码
|
2026-10-12 13:42:47 +08:00 |
|
|
wandering1
|
e0b02d397c
|
修复 P2 全部 10 项：错误传播/竞态/门控/文档失真
待办池 docs/待处理内容.md §3.2 的 10 个 P2 全部闭环；逐项落代码 + 注释说明。
P2-1 cfg_file: 受管键行超 CFG_LINE_TEST_MAX 拒绝保存（防重复键行）
P2-2 ch395f: DMA 失败传播状态 + 锁存通道故障 + 读不拷不可信数据
P2-7 net_select: LISTENING 不再恒判可读（消除 select 忙轮询地雷）
P2-8 time_sync: 核实 L3 pending 改写已闭环（net_recv_to 分片 + 总预算）
P2-9 sys_log: 挂载改幂等 + 卷锁，defaultTask 2s 重试建 /log
P2-10 sys_log: s_read_raw 纳入卷锁 try（读者/写者 unlink 互斥）
P2-11 net_task: RECONFIG 改 osEventFlagsWait 原子取走 + 清除
P2-12 app_cfg: APP_*_ENABLE 如实标注为未接线占位，删“开关”说法
P2-13 freertos: 产品构建 vTaskDelete(testTask) 回收 8KB CCM 栈
P2-15 download.bat: 先删旧日志 + 增“未产出日志”判定
P2-13 用 USER CODE 区回收而非生成区 #if 门控：生成区改动会被 CubeMX
重生成覆盖，本方案重生成不丢。P2-12 因产品定义 B0 未定、APP_NET_ENABLE
无单一接线点，按修复建议备选（删“开关”说法）处理。
验证：@build 0 错 0 警；主机单测 watchdog 39/39 + sys_clock 100/100 +
cfg_file 149/149（新增 TC-CFG-044）；pre-commit --all-files 17/17。
|
2026-10-04 08:30:30 +08:00 |
|
|
wandering1
|
22559365b9
|
整理 App 与 test 目录：按职责分子目录并同步全库引用
|
2026-09-26 12:52:39 +08:00 |
|