 wandering1
|
4a4ad6bc5f
|
chore(全仓): @build/@test 旧文档别名清退为技能调用名
现状口径：/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名，
不是 shell 命令；「名 + 命令行参数」的命令形态改为可执行体
run_boot_test.py 的真实调用。
- AGENTS.md：别名说明重写为「技能调用名不是 shell 命令」，两条目改
「编译（/keil-build）」「串口回归（/serial-boot-test）」
- keil-build / serial-boot-test 两 skill 调用名与示例同步；task-worktree
方案文档去掉 @build/@test 惯例从句；@task 保留（不在点名范围）
- 123 文件现状陈述全改；台架捕获、变更记录/时间线、rename 映射输入
等 41 行历史证据保留旧名
- gen_memory_svg.py 6 处措辞随改，3 张 SVG 产物同批重跑
- 顺手补并行方案同行漏网计数 51→52 钩子
验证：提交期快钩子对 123 文件实跑全 Passed；check_doc_links --all
rc=0（3038 处、无法判定 0）；check_mermaid --all rc=0；YAML 解析 52
钩子不变；skill-size rc=0；py_compile 全过；字节卫生零漂移。
|
2026-10-30 13:03:12 +08:00 |
|
|
wandering1
|
94cce8b615
|
docs+scripts: 删除测试与架构专项文档并把引用改成就地口径
这是并行的另一路在飞的改动（本会话按用户「全部提交」指示代为落盘）：
移除 docs/任务规划/测试与架构专项.md，并把指向它的引用改成就地口径
（app_assert.h / net_socket.c / ch395f_test.h 头注释改指本文件注释或
对应文档，check_size_gate.py 与 ram_baseline.py 的出处改指 CI 文档，
RAM预算台账、暂缓-RS485、采集与算法层设计说明、cubemx-survival、
id-check、两份 README 同步改引）。
如要拆回：git reset --soft HEAD~1 即可把这一笔退回工作区。
合树后 @build 0 错 0 警（Code=236456 RO=28124 RW=1876 ZI=137084）。
|
2026-10-28 22:00:34 +08:00 |
|
|
wandering1
|
56893709fe
|
feat(S12): 模块级轻量断言宏 APP_ASSERT + net_socket 状态机不变量试点 2 处
规格：docs/任务规划/测试与架构专项.md §2.1（模块级轻量断言宏，必须零生产开销）。
本提交只做道C-1：新增断言宏 + 2 处试点，不开 net 层大口子、不新增 test/host 目录。
改动
- 新增 Drivers/BSP/app_assert.h：APP_ASSERT 两级裁剪。
· 关闭态（默认，产品构建）：编译期消失、零符号零代码；条件仍进 sizeof 的
不求值上下文，写错变量名/比较类型会当场报错，不会出现"裁掉=从没被编译器看过"。
· 打开态：失败交 configASSERT 用的同一个钩子 vApplicationAssertFailed()
（裸控制台打 [ERR] ASSERT FAILED file:line 后软复位）；宿主端（模拟器 /
主机单测）落 stderr + abort()，非零退出码不会被一键回归静默吞掉。
- 开关 APP_ASSERT_ENABLE 默认注释，策略与 ENABLE_DESTRUCTIVE_TESTS 同级。
- 纯宏、无函数、无数据，不新增 .c → 不涉及双端注册（.h 靠 include 路径找到）。
- Drivers/BSP/NET/net_socket.c：2 处试点，都落在"函数头写了限定条件、函数体
一项都没检查"的缺口上。
· net_close_locked：控制块必须落在 s_net_socks 数组内且 in_use——此前给出
越界或已释放指针会一路走到 memset(sizeof(net_sock_t))，直接踩脏 fd 表。
· net_drop_conn_locked：进入时必须 in_use + TCP 流 + 会话处于 ESTABLISHED
或 CONNECTING——函数体无条件置 CLOSED 并登记重建，将来绕过
NET_MSG_DROP_CONN 分派门的新调用路径会拆掉一个健康监听器（症状与 N-30
一族同源难查），断言把这条状态机不变量钉成机器可查。
两处均 netTask 上下文、非中断、非高频；条件纯读无副作用；既有错误返回分支
一条都没改（断言不替代错误码，见 app_assert.h 第四节纪律）。
- test/host/net_socket/run_unit_test.py：include_dirs 补 Drivers/BSP 一行，使该
套单测编 net_socket.c 时用真 app_assert.h，不造桩——假件与真头漂移正是本
runner「常量闸」要防的那类自洽假绿；stub 目录仍在最前，同名头命中不受影响。
- Drivers/BSP/README.md：根级文件表补 app_assert.h 一行。
两处有意偏离示意稿（理由已写进头注释）
1) 断言点不再额外发一条 DBG_ERROR：钩子本身已打印 file:line，而每条 DBG_*
调用点约 90 B Flash + 216 B 栈（AGENTS「日志不是免费的」）；断言点又常在
「内核状态已不可信」的现场，走裸控制台比走日志行缓冲稳。
2) 头落 Drivers/BSP（与 dbg_log.h、bsp_err.h 同级）而非示意稿的 App/util：它是
纯宏叶子能力，落 App/util 会让 BSP 新增一条反向 include App 层头的边，而
layer-deps 存量基线只减不增、加不进去；落 Drivers/BSP 已在 MCU 与模拟器双端
include 路径内 → 双端零工程文件改动（uvprojx / CMakeLists 一字未动）。
验证（工作树 _wt/S12-assert，分支 task/S12-assert）
- @build 产品态：BUILD_OK，0 错误 0 警告。
- 体积与 RAM：Code=213780 RO=18860 RW=1204 ZI=131852，与 scripts/ram_baseline.tsv
的 2026-10-24 基线行完全相同 → Flash/RAM 增量 0 B；.map 中 app_assert 相关
符号 0 条（规格完成判据"无新增符号"）。gate 全绿，无需 mem-budget 例外。
- 打开态实测（临时取消注释编译，跑完已还原成注释态）：0 错 0 警，
Code=213916（2 处断言共 +136 B ≈ 68 B/处，无每调用点栈代价），RW/ZI 不变。
- 宿主 MSVC 三态实测：关闭态断言不求值但条件仍做类型检查（错误标识符报
C2065）；打开态真条件不触发、假条件 stderr 打 [ASSERT] FAILED 后 abort；
net_socket 主机单测 452/452 通过（用真头，开关默认关）。
- 门禁实跑：cppcheck(warning/perf/portability/style)、no-mojibake、coding-standard、
layer-deps、bsp-err、id-check、doc-links、registration-check、mem-budget 全 0。
- 台架 @test 未跑：bench 锁归 Lead；产品态本改动零行为差异，无需烧录回归。
遗留
- 打开态未在台架上真跑一轮（需 bench 锁 + 一个故意造假的注入点）：待台架实测。
- 文档销项（测试与架构专项.md §2.1、并行分道方案.md 对应行、AGENTS 任务表）
归主工作树统一处理，本分支未碰 docs/任务规划/**。
|
2026-10-25 03:04:07 +08:00 |
|