wandering1/STM32F4-Base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
982 Commits 6 Branches 0 Tags
7b05d7bfd40fafa514e166d3fda5270f2b040c2b
Commit Graph

10 Commits

Author SHA1 Message Date
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 ae09c5737a docs: 删任务规划两份已完成文档，数据可信内容迁入算法层/硬件平台/登记簿 
任务规划目录从 5 个文件收敛到 3 个：只留导航（README）、待办（登记簿）、
暂缓专项（暂缓-RS485）。

删除的两个文件都不再有现行读者：
- UI补齐.md 执行清单 2026-10-28 清空、上板判据 2026-11-06 台架轮已复核；
  叶数口径迁 docs/UI设计/菜单页面设计.md §3.9，三条内容页硬规矩迁
  docs/UI设计/内容页架构.md §7.1，两条未闭环待办迁登记簿 §7/§8。
- 数据可信.md 不是完成记录，而是被约 130 处代码头注释引用的设计约束，
  因此按内容分三处落位后删除，不整篇丢弃。

数据可信内容的新归属（旧节号 → 新家）：
- §2/§4 设计口径 → docs/算法/采集与算法层设计说明.md 新增 §13（13 小节），
  §7 前置决策表 → §13.12 已定案的前置决策。
- §3 台阶与波次退出判据 → docs/硬件平台/ADC通道映射说明.md 新增 §9。
- §5 任务卡 → docs/任务规划/登记簿.md §7（拆成变比确认 / 两点标定两行）。

引用改写 34 文件 77 处路径引用 + 14 文件 24 处昵称引用 + 双重节号 35 处，
覆盖代码头注释、测试、生成器与文档；归档区历史路径改纯文本提及。
四个 SVG 生成器文案同步并重跑，产物随脚本同批提交。

同批处理两件事：
- 9 个 UTF-16 LE 证据文件转 UTF-8。end-of-file-fixer 按字节判末尾换行，
  UTF-16 的换行是 0A 00、末字节 00，钩子会追加裸 0x0a 使文件变奇数长度，
  8 个已实际损坏。转码后逐文件比对 HEAD 原文验证正文零丢失。
- 修回 App/cfg/cfg_file.c 被剥掉的 UTF-8 BOM（补 3 字节，未整文件重写）。

验证：/keil-build 0 错误 0 警告（Code=255160）；check_doc_links --all
--sections-strict 221 篇全通过、无法判定 0；pre-commit 全量全 Passed。
 2026-11-09 16:13:57 +08:00
wandering1 ad87f979b1 docs(规约): 删除编号规范.md，生效规则并入文档规范 §7.1 
用户裁定：docs/编号规范.md 在项目里已无意义，删除。

依据：该文 253 行里真正仍生效的只有两条规则（新条目一律不发编号、
人读文档存量编号继续清退）和一张存量族表；其余内容早有归属——两道
编号门禁的退役记录在 docs/门禁说明/id-check.md 与 id-check-new.md，
手工普查与恢复机器面在 scripts/archive/id_gate/README.md。留着就是
第二真相源，同一事实写在两处迟早漂移。

处理：
- docs/文档规范.md 新增 §7.1「条目与编号：一律不发」，承接规则、
  场景表、三条硬规矩、存量族表、已停发旧号族清单、不是编号的清单、
  清理动作与「没有机器门禁兜底」四段。
- 活跃引用 62 处逐条改指 §7.1 或归档 README：AGENTS.md 2 处、
  门禁说明三篇 18 处、其余文档 11 篇、代码与脚本 10 处、rename_maps
  七个 record 字段、.dsh/skills 四个文件 8 处。
- 归档区 107 处去掉 docs/ 前缀当纯文本提及；编号治理历史.md 45 处
  改为「原编号规范 §N」，避免被 doc-links 当自引用解析。
- 顺带修正 scripts/archive/id_gate/README.md 里仍称旧文为现行规范
  的表述。

门禁：check_doc_links --all --sections-strict 220 篇全通过、无法判定 0；
pre-commit 全 Passed。
 2026-11-06 18:32:04 +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 20617a33f7 docs(编号规范): 编号一律停发——§4.1 五族也不再发新号，只读存量 
用户裁定（2026-10-29）：「啥号都不发」= 任何族都不再新增编号，
含 §4.1 那五个原本"有脚本按字面量匹配"的存量族；既有号只读引用，
族里新增内容一律写语义行名。

规范本体：
- §1 由「先问三句」改成「默认答案：不发号」，三问表换成场景对照表；
- §4.1 由「允许用号的族」改成「存量族」，第四列改「既有号被谁读 /
  新写怎么办」，逐行写明新写怎么做（TRAP 写语义行名、FR 用 §5 行名、
  CODE-RULE / MENU-STATE 先问用户、P-n 只读存量页号）；
- 末框四条对照 + 唯一例外入口（确需机器按字面量匹配 → 先问用户）；
- 新增族 = 一律不许；批准后顺序：本文 §4.1 → 属主文档 → 才动 registry。

跨文件同步（12 份）：门禁说明 id-check-new / id-check / host-unit-tests
（把"校验 5/3 拦新号"这类现状叙述历史化）、两份 TRAP 记录的编号口径、
开机账本用例号说明、AGENTS 两处、id-family 技能与其 steps-alpha 模板、
归档 README 与两份归档脚本 docstring。

AGENTS 主题表那行原写「允许用号的 7 个族」，与规范的 5 行本就对不上，
旧计数一并消掉。

未做：pre-commit 的 default_stages 一行——用户对该项未置可否。

验证：py_compile 与 check_ids_new.py --self-test 均 rc=0；逐篇
check_doc_links.py --sections-strict rc=0（编号规范 70 处引用 /
68 可判定 / 无法判定 0）；13 份改动文件表列数与字节体检相对基线零新增。
 2026-10-29 21:31:42 +08:00
wandering1 51d89cf9d3 gate: 按用户裁定整体退役编号门禁 id-check-new（钩子 52 → 51） 
配置：摘掉该钩子，原位置留一条退役注记（不复述数钩子数的字面量）。
YAML 解析口径实测：声明 51 / 带 manual 3 / 提交期实跑 48。

脚本：git mv 进 scripts/archive/id_gate/check_ids_new.py，与已退役的
check_ids.py 同档；docstring 改退役口径，REPO_ROOT 因归档位置深两级
改取 parents[3]，失败提示与自述路径同步改写。从归档位置实测：
--self-test 5 正例拦下 / 29 反例放行 rc=0；--worktree 与暂存区模式 rc=0。

文档（七份）：AGENTS.md 六处——总数、加钩流水（顺带补上 2026-10-29
漏记的 skill-size 一笔）、枚举项删除、本行相加数、提交期实跑、门禁索引
与主题表两行；门禁说明 README 八处——声明数、实跑数、计数流水、grep
陷阱的举例数、§2 标题、姿态表「只查新增」行、两行索引状态；编号规范
七处——引导块改「本文即唯一事实源」、族总表一处、§8 标题与正文、
§8.5 补第④步、④ 之后无机械牙那段、速查；门禁说明 id-check-new.md
整篇重写为退役留档（查什么 / 落地前的噪声回放 / 退役五条理由 / 手工
跑法 / 此后靠什么 / 认下丢了什么）；门禁说明 id-check.md 与归档目录
README、check_ids.py 里「现行门禁 = id-check-new」的指针同步改写。

技能（三份）：id-family-semantic-migration 一行、stale-doc-count-sweep
的 pitfalls 与 steps 各一行改手工跑法（steps 第 5 条那笔历史计数例不动）。

此后编号形态没有机器面：判据只剩 docs/编号规范.md §1 三句自问、§4.1
族总表与人工评审；2026-10-14 那类"销项删行后号被重新取走"不再有提交期
警报——这条代价已写进留档，别当成"检查没了随便写"。

纯文档与门禁配置，未跑 @build。全程未 push。
 2026-10-29 20:22:47 +08:00
wandering1 8f8d97b3d8 docs(编号): 批次六余账文档面——CubeMX 层号、双写疤、采集链旧层名共 61 站点
CI / 静态门禁 (pre-commit) (push) Failing after 8m4s
Details
CI / 主机侧单测 (MSVC) (push) Successful in 27s
Details 
- CubeMX 防丢失三层优先级 L1/L2/L3（批次 3c 漏网 30 处）：看门狗设计说明 25、
  门禁说明/cubemx-survival 3（含「优先 L1/L2」→「优先写进 .ioc 与搬进 USER CODE
  区」）、ADC通道映射 2。
- 改名遗留的中文重叠双写 14 处：菜单页面设计「一级菜单菜单」×6、「二级菜单菜单」
  ×2；README「语义取数与有效性」重复；存储架构「3字节字节地址」；链路延迟
  「队列往返队列往返」；继电保护「出口出口与记录层」；产品需求「全周傅氏相量」重复。
- 采集链旧层名 5 处：「L2 相量层」→ 全周傅氏相量、「L0 采样驱动」→ 采样驱动层、
  「L2-x 前缀」→ 相量输出标签前缀、「L1 层 v2.3」→ 语义取数与有效性层 v2.3。
- UI 菜单层级 2 处：产品需求「4 级（L0~L3）」→「4 级（主界面 / 一级 / 二级 /
  三级菜单）」、「主界面 (L0)」→「主界面」。
- 登记簿条目改名「L5 队列往返基线待重验」→「队列往返基线待重验」+ 引用侧 5 处
  同步（登记簿 §1/§7、实机测试实施指南 §7.3 与步骤表、编号规范 §1 好例子清单——
  那个混在短语里的 L5 恰恰是个坏例子）。归档里的历史 note 原文不动。
- 归档 §10.3：四族收口记录 + 边界与裁定（peer JSON 键属冻结证据 schema 不改；
  REQ2FIRST / FULLFRAME 不并入 FRAME_RT；L1-3/L1-4 属不可还原死号，就地删号留
  事实；「原 L2 基线 3/10」按上下文读作主机侧回归的早期基线）。
- 判族保留（永久）：硬件位号与封装尺寸 27 处（网表 L1~L3 磁珠电感、
  SOT-23_L2.9-W1.3、CRYSTAL-L3.2）、芯片手册原文 3 处双写；伪命中 4 条没删
  （「遥测量 测量值」「已登记登记簿」「谁来监视监视者」×2）——那些是正常词组。
- 门禁：check_doc_links --all --sections-strict 通过（195 篇、章节引用 3292 处）；
  git diff --check 干净；逐文件 BOM / U+FFFD / CRLF 与 HEAD 一致。
 2026-10-28 18:57:03 +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 89b6132c1f docs(编号): 瘦身——58 KB/473 行 → 22 KB/222 行，过程记录进归档 
用户裁定 A 方案：这份文档的「规范体系」部分已随门禁退役而死，但四件仍活着的东西
只有这里写着——① §1 政策（默认不发号 / 先问三句）；② §3.3 语义标识怎么写；
③ §4.1 族总表 + §4.1.1 已停发栏（现行门禁白名单的机器投影源头）；
④ §4.4 这些不是编号（防把 YX15 / 元件位号当垃圾清）。再留 §5.5 销项、
§8 门禁现状与 §8.5 退役路线、§10 速查。

其余 16 节逐字搬进 scripts/archive/id_gate/编号治理历史.md（40 KB）：
1.2 / 2 八条原则 / 4.2 / 4.5 / 6 模块码表 / 7+7.1~7.3 / 8.1 基线 / 8.3 批次 /
8.4 台账 / 9+9.1~9.3（含「数据可信」任务卡号换算表），以及原变更记录 17 行流水。
归档文件带「这不是现行口径」横幅 + 归档目录，写清哪些节对应哪段历史。

两处刻意的选择：
- 节号沿用旧编号、不重排——外部文档与脚本引的是 §4.1 / §8.5 这些号，重排等于
  制造一批假链接；文首加「本文范围」说明跳号去哪了。
- 文首那段「机器面才是事实源」改写：现行机器面是 check_ids_new.py 的两张
  前缀级白名单（KNOWN_DASH / KNOWN_BARE），旧的 registry / 别名表 / 八项校验脚本
  已随全库审计退役进归档，只在手工复查存量时才用。

引用重修（6 份文档、10 处）：AGENTS 的 §9.3 换算表、数据可信 §9.3 ×2、
门禁说明 id-check 与 host-unit-tests、docs/README 的 §4.5、技能手册的 §9、
以及正文里 §4.2 / §4.5 / §8.1 / §8.3 / §8.4 / §1.2 的裸引用。

验证：doc-links --all --sections-strict 通过（195 文档）；mojibake / bom-guard /
git diff --check 全 rc=0；新门禁 --worktree 自查通过；钩子数仍 51。
 2026-10-28 12:51:17 +08:00
wandering1 1668842d61 chore(id-check): 退役全库编号语料审计（钩子 52 → 51） 
第三步（用户裁定跳过观察期直接做）。第一步 bf2a5c21 把两根护栏转报告制，
第二步 a5832788 立起只查新增行的新门禁，本笔把旧的全库语料审计整体退役：
语义标识已是默认形态，这套 99 族语料不再有人需要维护。

移动（保留可复现性，不再进提交门禁）：
- scripts/check_ids.py → scripts/archive/id_gate/check_ids.py
- id_registry.json（87.6 KB，99 族）/ id_aliases.json（187 KB）/ id_known_backlog.json
  一并归档；新写 archive README：为什么退役、现在用什么、怎么手工跑、归档纪律。
- 归档脚本改了自定位（仓库根往上 4 层、语料与脚本同目录）与一行退役横幅；
  从新路径实跑：811 文件 / 8,051 字面量，--strict rc=0。

钩子：删 id-check（52 → 51）。现役编号门禁只剩 id-check-new（只查新增行、零语料）。
声明数 51 = commit 阶段 50 + gitlint 1，三数已对齐（AGENTS / 门禁索引 / YAML）。

连带改动：
- rename_ids.py 的别名表路径指向归档（改名工具本身没退役）；
- check_ids_new.py 排除面加 scripts/archive/（语料里全是编号字面量，天经地义）；
- doc-links 跳过 .mnemon/ 与 ci-artifacts/（本地记忆状态与草稿，非项目文档）——
  语料搬家后这些目录里的旧路径引用会假红，它们本来就不该参与文档门禁；
- 全库 .md 里的旧路径引用改指 scripts/archive/id_gate/（含两份 skill 手册）；
- id-check.md 加退役横幅并保留原文作留档；门禁索引把该行标成已退役；
- 编号规范 §8 改成「现行只有一道门禁」+ §8.1~§8.4 标为退役留档 + §8.5 ③ 置已完成；
  各加一条 2026-10-28 变更记录行。

验证（实测）：YAML 口径 51 个钩子、id-check 不在其中；doc-links --all --sections-strict
通过（194 文档）；mojibake / bom-guard / coding-standard / git diff --check 全 rc=0；
新门禁自检 5 正例 + 29 反例仍全过。
 2026-10-28 12:38:38 +08:00