 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
|
506eccc68f
|
docs: 错误码传播审计收口并删除该文档（E-xx 转历史编号族）
本次会话先后销项与关闭：
- E-61 SD2506 清 INTAF：原实现只读取 CTR1，而按手册 ARST=0 时读操作
不清标志，属空操作；改为读-改-写 CTR1，并按手册订正 CTR1 位宏
（INTAF/INTDF/BLF 位置，ARST 归 CTR3）
- E-16 cfg_file：新增 CFG_FILE_MAX_NAME_LEN（段名/键名 ≤15），注册时
拒绝超长键名；s_gen_document 两处 snprintf 改检查式；补 TC-CFG-024
用例（主机单测 149→151 PASSED）
- E-23 TC704：PHASE7_MULTI_COUNT 8→5（并发上限 = 8 − 3 个常驻监听），
accept 失败分支加网络代次检查（网络重建即重建监听）
- E-26（UDP）按“保留 API + 文档定案”关闭；E-30 评估为不必要后关闭；
N-4（ACCEPT 决定不实施）关闭
审计文档剩余 5 项 P2 + 2 项监督，经用户裁定“都不重要”后整体删除：
- 删除 docs/问题记录/错误码传播审计.md（634 行）
- 九类缺陷模式表迁入 docs/编号规范.md §4.2.1（PAT-01~09）
- E-xx 转为纯历史编号族：编号规范 §4.1 属主改“无（原属主已删除）”，
§4.3 保持冻结；全仓 26 处引用按“保留编号、去悬空文档名”处理
- 顺带修正 N-4 收口遗留：排期详述 C1 才是 E-25/E-27/E-28 的承载处
（审计 §4 曾误写为登记簿）；README 两处 C1 旧名改回“net 层跨上下文收口”
一并提交此前遗留的体系层评审报告 2026-10-14 复核 WIP（六维评分复核、
未闭环 Top 5→3、三区水位实测刷新）。
校验：Keil 构建 0 错误 0 警告（Code=212344）；check_doc_links
--sections-strict 与 --all（142 文档）通过；内存双台账刷新后均 PASS。
|
2026-10-15 07:39:38 +08:00 |
|
|
wandering1
|
d9425ddd23
|
测试：补启动段可观测性与模拟器差距清单，run_all_suites 加只编译模式（S10+S13+S6）
CI / L0 静态门禁 (pre-commit) (push) Successful in 1m10s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 25s
|
2026-10-02 13:57:25 +08:00 |
|
|
wandering1
|
22559365b9
|
整理 App 与 test 目录：按职责分子目录并同步全库引用
|
2026-09-26 12:52:39 +08:00 |
|
|
wandering1
|
39bd06adea
|
为自建代码目录补齐 README，建立目录级导航体系
- 新增 26 份目录 README：App/(+log,task,util,protocol)、Drivers/BSP/(+8子系统)、
Src/、Inc/、scripts/、tools/(+6子工具)、test/、MDK-ARM/、simulator/(+sim,tests)
- 每份含：定位、文件清单表、关键约束/陷阱、指向 docs 权威文档
- 第三方库与生成代码目录排除（CMSIS/HAL/Middlewares/Lib/SDL2）
- docs/文档规范.md 新增 §1.1b 代码目录 README 约定；根 README 目录结构加入说明
|
2026-09-26 12:25:36 +08:00 |
|
|
wandering1
|
83b599a4b4
|
SD2506 init 移除 0x7B 死写说明注释（评审精简，纯注释无代码变化）
|
2026-09-21 17:59:19 +08:00 |
|
|
wandering1
|
115ed00039
|
SD2506初始化18H改回读校验+漂移时写允许窗口修复，充电宏位与注释订正（E-32修复）
|
2026-09-21 17:36:48 +08:00 |
|
|
wandering1
|
bb76cfd779
|
修复规范矛盾并定案5项规则，保护宏统一XXX_H
规则定案：常量在右（a>5）、保护宏XXX_H（禁双下划线）、
头文件常量用#define、存储类前缀（g_/s_）优先、允许void返回值
全库32个.h头文件保护宏 __XXX_H → XXX_H 改名（字节级替换）
S1检查规则同步更新（拒绝双下划线），Inc/gpio.h 反向验证被正确拦截
规范示例矛盾修复：K&R括号、标准类型、变量初始化、命名常量、注释字段补全
|
2026-09-01 16:07:00 +08:00 |
|
|
wandering1
|
ae8b1aead5
|
清理全库行尾空格与文件尾换行（pre-commit 自动修复基线）
|
2026-09-01 10:24:50 +08:00 |
|
|
wandering1
|
d68a46b4fd
|
时钟测试完毕
|
2026-08-28 21:59:04 +08:00 |
|
|
wandering1
|
1781833767
|
时间终于同步，存储成功
|
2026-08-28 21:10:51 +08:00 |
|
|
wandering1
|
01ad5e476f
|
增加文件系统
|
2026-07-21 00:30:59 +08:00 |
|
|
wandering1
|
e862009bcd
|
修复多连接的问题
|
2026-07-19 15:27:49 +08:00 |
|
|
wandering1
|
c841bf4668
|
关键芯片都驱动，且测试成功
|
2026-07-18 16:09:06 +08:00 |
|