wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity
373 Commits 3 Branches 0 Tags
c95a9cd0cbf1616bb41e3b6cb57e700087ff693b
Commit Graph

90 Commits

Author SHA1 Message Date
wandering1 51bc325b57 fix(stack): N-33 抬栈收口 defaultTask/timeSyncTask 栈余量（2 FAIL -> 0 FAIL） 
既有债收口（非新引入）：B7 定值持久化把 defaultTask 静态最坏链推到
3016 B、timeSyncTask 推到 1264 B，两者跌破 stack_report 判据
（余量 >= max(1024 B ISR, 配置 x 30%)）。本轮只抬栈，不动调用链。

前基线（stack_report，9 任务）：
- defaultTask  cfg 4096 B / 静态 3016 B / 余 1080 B (26%)  FAIL
- timeSyncTask cfg 2048 B / 静态 1264 B / 余  784 B (38%)  FAIL
- 其余 7 任务 PASS（net 2112/1728、ftp 1456/2640、ui 1336/15048、
  test 736/7456、adc 1320/1240、iec104 1456/1104、protect 872/1176）

改动：
- defaultTask 1024 -> 1280 words（4096 -> 5120 B）：余 2104 B / 41%
- timeSyncTask 512 -> 640 words（2048 -> 2560 B）：余 1296 B / 50%
- 后基线：9 任务 0 FAIL（stack_report 退出码 0）

堆开销（任务栈来自 FreeRTOS 堆，.map 静态数字不变）：
- defaultTask +1024 B、timeSyncTask +512 B，合计 +1536 B
- 台架背书基线 heap free=17936 / min_ever=10000 B（B6），抬后
  min_ever 预计 ~8464 B，仍远高于 3072 B 告警线

防丢失（CubeMX 存活 L1 纪律）：
- STM32F407-Demo.ioc 的 FREERTOS.Tasks01 同步改 1024 -> 1280
  （.ioc 是 CubeMX 生成任务栈值的事实源，未跑重生成）
- Src/freertos.c 生成区 .stack_size 与 .ioc 保持一致
- USER CODE BEGIN Variables 核算注释块补 N-33 依据（栈值理由唯一落点）
- .cubemx_survival_baseline.json 经 --write 重建（仅 ioc-task-stacks 一行）

task-table 生成区随栈变更再生成（README.md + AGENTS.md 的
TASK_TABLE 锚点区各 2 行，锚点区外无任何改动）。

验证：@build 0 错误 0 警告（Program Size 与改前逐字节一致）；
ci_local 全绿（L0 + L0.5，826/826 断言）；stack_report 前后各跑一次。
台架 @test 与串口 [STACK] 水位复测在提交后单独跑。
 2026-10-12 17:47:15 +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 90db528032 W1 功能主线完成：内存台账三件套(W1-0) + IEC104 上行(B4) + protectTask 板端接线(B5) 
W1-0 台账三件套：scripts/ram_baseline.py（四模式）+ ram_baseline.tsv 趋势 +
docs/内存管理/RAM预算台账.md + pre-commit mem-budget 钩子（RW_IRAM1/RW_CCM >92%
即 FAIL + Top-10 附表）；审查报告 §5.5 三条闭环。

B4 IEC 60870-5-104 上行（被控站，TCP 2404）：App/protocol/iec104/ 三模块
（asdu 编解码 / pts 点表+数据源 vtable / link APCI+FSM，纯逻辑零 I/O）+
App/task/iec104_serv.c（iec104Task，NET_READY 屏障 100ms 分片喂位）。
82 断言 L0.5 全绿 + iec104-unit-test 钩子（第 31 钩子）；
设计说明 docs/子系统设计/IEC104上行设计说明.md 全量回填。

B5 protectTask（L3 板端接线）：App/task/protect_task.c——20ms 判据节拍
prot_elm_run + L5-4 采样故障闭锁（adc_health 电平位→元件复位）+ L5-1 定值
校验和巡检；新增 prot_elm_request_reset() 收口跨上下文复归（104 YK11 落请求、
eval 头部消费）；定值/元件初始化移入 app_main_init（内核前）。TC-PE-010
（prot_elm 28 用例）。

门禁与内存：TASK_WD_PROTECT=8 入 required_mask（产品 0x77→0x1F7、HW 层
0x1F5，看门狗单测 39 断言同步）；FreeRTOS 堆 48→56KB（.ioc L1 参数 +
FreeRTOSConfig.h 同步，RAM预算台账 §6 登记配额 48→56KB）。
ZI 144,008→152,204（+8,196 B = 堆 +8KB，B5 扩容）；Code=204,348。
stack_report：protectTask 512 words 静态链 872 B/余 57%、iec104Task
640 words 1456 B/余 43% 均 PASS；RW_IRAM1 73.1% / RW_CCM 87.9%（<92%）。

验证：@build 0 错 0 警；ci_local 全绿（31 钩子 + 13 主机侧单测）；
doc-links 135 文档 PASS。登记簿 B4/B5 销项、W1 波次完成；保护规划/看门狗
说明/AGENTS（9 任务）/RAM 三文档全部同步。

遗留（验收窗口，非代码空洞）：台架第三方 104 主站往返（送检窗口）、
标准源注入动作判据、@test PROT 锚点 + protect 栈水位 + 新堆 min_ever 复测。
 2026-10-12 12:36:23 +08:00
wandering1 e4134a4723 feat(skill): 新增 task-worktree 多任务并行工作树 skill 
用 git worktree 给每个任务开独立工作空间，干完由固定命令合回主干，
解决多任务共用同一工作目录时构建产物/日志/登记簿互相踩的问题。

- 机制：worktree + 任务分支 task/<ID>-<slug>（ID 沿用待处理内容编号）
- 目录：仓库同级 _wt/；.venv 与 simulator/SDL2 以 junction 共享
- .workbuddy-ai/ 刻意独占，清场前归并回主工作树
- 命令：new/list/status/sync/lock/done/abort（短命令 @task）
- 锁：build（UV4 不能并发）+ bench（COM6/ST-LINK/设备 IP），
  按时效 TTL 判定，不绑定进程存活
- done：merge-tree 预演 -> merge --no-ff -> 残留审计 -> 重生成产物
  -> 门禁 -> 清场；门禁未绿则保留工作树；不含 push
- 隔离演练（DTU_INTEGRATION_WORKTREE）暴露并修复 4 个缺陷，
  见 docs/环境与部署/并行任务工作树方案.md §11.1

同步：AGENTS.md 主题表、docs/README.md §9.2 与变更记录。
 2026-10-12 11:56:13 +08:00
wandering1 d1e6bb4ba7 W5波+N-19收口：FTP鉴权落地、Trap25三连定案修复(N-30)、N-20/N-23/N-26 
N-19 FTP 鉴权：
- lftpd_auth（USER/PASS 状态机 + 连续5次失败锁60s）+ SHA-256
  (user||pwd) 口令哈希；config.ini [ftp] 段 user/pwd_hash/write，
  出厂 admin/admin 在用有启动告警；lftpd_log.c 删除并入 lftpd_auth
- ftp_cfg 配置读写；台架 ftp_auth_bench.py 13/13

N-30 / Trap 25（CH395F_Trap_Records.md 四次定案全记录）：
- 修复1 closed-with-data accept：客户端发完正常 FIN 后芯片按
  FUN_PARA(0x09) §5.52② 保留 Socket+RX 缓冲，旧代码把 CLOSED 一律
  relisten 自毁缓冲 → STOR 必挂 425；改为接受"已关但可读"连接排空
- 修复2 丢 CONNECT 中断探针 net_lost_connect_probe + last_peer_port
  幽灵甄别（拆链窗口握手完成但中断丢失，双信源去抖补 accept）
- 修复3 send_list/send_nlst 批量单发：背靠背 ~60B 小段毒化芯片 TX
  （芯片报 SEND_OK 但对端全丢），整份目录一次性写入
- 证伪存档：固定沉降/Socket 轮换冷却/listen 门控（台架 v7 矩阵）
- 台架工具 test/board/ch395f_reuse_bench.{c,h} + host 脚本存档
  （不注册编译；实验分支 n30-chip-bench 保留）

N-20：Error_Handler 死循环降级（记录+复位路径）
N-23：scripts/check_registration.py 双端注册反向校验（pre-commit）
N-26：GD5F NAND 直 DMA 调用方缓冲窗口断言

验证：BUILD_OK 0/0；ftp_regression 连跑 4 轮 11/11（修复前
LIST#4/#7 100% 挂、STOR#2 曾 100% 425）；ftp_auth_bench 13/13；
@test 启动标记 PASS；ci_local L0+L0.5 全过；doc-links 通过。
登记簿 N-30 已销项。
 2026-10-11 18:50:24 +08:00
wandering1 eddbedeee8 docs(AGENTS): 入口重构——补宏观概况与边界块，瘦身51KB→25.8KB，子域知识入skills
CI / L0 静态门禁 (pre-commit) (push) Has been cancelled
Details
CI / L0.5 主机侧单测 (MSVC) (push) Has been cancelled
Details 
- AGENTS.md 51,067→25,828 B（−50%）：审计→迁移→删除，逐节 diff 零信息损失
- 按调研（agents.md 官方/aihero/airflow）补「项目概况」：一句话定位、
  数据主线、顶层目录地图、分层边界；平台约束 17 条分 5 组
- 新增「边界（Ask first / Never）」：git commit/push 须明确指示首次入库
- 串口助手、LVGL 模拟器两节移入 serial-assistant / 新建 lvgl-simulator skill
  （开关语义按 main.c 实锤）；LVGL 两条实证坑移入 ui-verify skill
- 9 条入口独有细节迁移至对应设计文档（存储/看门狗/启动顺序/文档规范/
  pre-commit 使用说明/keil-build skill）；@test 细节指向自动化测试流程
- 新增 docs/AGENTS编写指南.md：六原则/模板/反模式/维护纪律 + 本仓案例
- 修正 3 处对 AGENTS 串口节的过时引用；docs/README.md 登记新文档
 2026-10-11 10:44:50 +08:00
wandering1 c936441c83 门禁扩容：新增 lv-conf-sync、simulator/ 纳入全部钩子；含 L3 定值/元件框架落地 
本轮把"自研代码落在门禁之外"的口子收掉，同时落地 LVGL 特性裁剪与
L3 保护定值/元件框架。

门禁（.pre-commit-config.yaml，26 个钩子）
- 新增 scripts/check_lv_conf_sync.py + 钩子 lv-conf-sync：比对两份
  lv_conf.h 的**生效值**（未定义则取 lv_conf_internal.h 兜底默认），
  抓 MISMATCH / LVGL 不认的宏名 / 同文件重复定义
- 顶层 exclude 删掉 simulator/：其下 21 个 tracked 文件全是本项目自研
  代码，生成物（build/、SDL2/、tests/ref/、shot*）已在 .gitignore；
  doc-links 的 exclude 同步删除
- lv-conf-sync 的 files: 覆盖两端配置 → 只改 simulator/lv_conf.h 也触发
  （pre-commit 4.x 已移除 always: true，实测只告警并跳过，无兜底开关）
- 新增 prot-set-unit-test / prot-elm-unit-test 两个主机侧单测钩子
- S11(2.3.5) 判定细化：禁的是"用路径找文件"，尖括号系统头带子目录
  （如 <sys/stat.h>）不再误报；全仓库复核仅 2 处项目代码判定变化

模拟器代码整改（纳入钩子后暴露，全部修代码而非豁免）
- cppcheck 4 处：sim_syslog.c 判空分支内解引用 p_epoch（真实 bug）、
  2 处 struct tm 未初始化、1 处指针可加 const
- coding-standard 61 处：44 处函数左大括号并到右括号同行、8 处补函数
  注释、3 处补文件头注释块、2 处 __ 前缀保护宏改 XXX_H、2 处 sprintf
  改 snprintf（写入字节数与原来完全一致）

LVGL 特性裁剪（F-1/F-2/F-3）
- 两端 lv_conf.h 对齐同一特性子集：删 26 个 LVGL 9.3 不存在的选项名、
  3 处重复定义，10 项靠默认值隐式生效的改为显式固化
- 实测对镜像体积中性；价值在防漂移，且模拟器 golden 回归跑的正是固件
  实际编译的配置

L3 软件侧
- App/algo/prot_set.* Q10 定值模型（范围校验 / 整表 all-or-nothing /
  校验和封存-自检-闭锁）+ prot_elm.* 通用"滞回+定时限"元件框架 7 实例
- test/host/prot_set、test/host/prot_elm 主机侧单测；uvprojx 挂载两处

文档同步
- pre-commit使用说明：§2.8 S11 口径、§2.15 lv-conf-sync 详解、新增 §5.5
  复盘（教训：exclude 只写真正不该进钩子的路径）
- AGENTS.md、UI_设计架构 §1.4 第 10 条、RAM 分析、审查报告刷新与销项

验证
- @build BUILD_OK 0/0（Code=194276 RO=15872 RW=876 ZI=139892）
- 模拟器重建：菜单 8 状态像素逐字节一致（池 5368 B）、11 内容页黄金参考
  全过（往返 5448 B）、remo sink 0/25600 位差异、--logtest/--cfgtest PASS
- 全仓库 cppcheck / coding-standard / no-mojibake --all-files 全过
- check_doc_links --all 129/0；check_mem_numbers --check 内存数字一致
- 端到端：往 simulator/lv_conf.h 注入一行漂移 → 钩子 FAIL（exit 1）
 2026-10-11 08:48:49 +08:00
wandering1 13a4e61c27 L1-6 采样有效性校验：adc_health 判定层 + 告警编排 + 31 用例单测 + 台架闭环 
新增 App/algo/adc_health.c/h（纯逻辑判定层，零平台依赖免桩单测）：
- 静默：两侧帧序号连续 >=100ms 无前进（电平位可自愈，flags() 为 L5-4 闭锁预留）
- 丢帧：TPAFE 序号一次前进 >1 计 tgap（与 STM32 侧 adc1_gap 对称，边沿事件）
- 单调性：序号倒退锁存位；tick/计数差值法 (int32_t)(a-b) 回绕安全
- 错误增量：FRSTDATA / HAL 错误 / STM32 停摆计数增量，事件位与锁存位编号对齐，
  消费者按位图做"每类每次开机留痕一次"编排

adc_task.c v2.9 告警编排（判定与编排分离）：严重事件/电平上升沿 DBG_ERROR +
SYSLOG_SELFTEST（每类每次开机一次防刷屏），下降沿 DBG_INFO 恢复；gap 不告警
（消费者超拍是已知现象，告警会淹没真故障）；心跳行增 tgap 观测字段。

主机单测 test/host/adc_health/ 31 用例全绿（100ms 门限两侧 / 边沿语义 /
倒退锁存 / tick 回绕 / NULL 守卫 / init 幂等），登记 adc-health-unit-test 钩子。

台架 @test PASS：零 [ERR]（健康不误报）、tgap=1->2 与 adc1_gap 同步可见、
frames 1000.0 Hz；证据 boot_log_data/20261011_prod_adc_health_boot_log.txt。

抬栈：adc_health_report->syslog_post 控制台回显尾使 adcTask 静态最坏链
832->1080 B（512 words 余 968 B < 1024 B ISR 底线）-> 512->640 words，
复测余 1480 B / 57%，堆 min_ever 7152->6640 B（-512 B 符合预算）。
AGENTS/README 任务表、RAM 方案 §2.3、规划文档 §3.1 L1-6 已同步置完成。
 2026-10-11 01:28:20 +08:00
wandering1 9bbe117f97 adc: 节拍源 TIM6->TIM3 + ADC1 走 DMA 乒乓双缓冲，消除 2 ms 忙等（P1-5 单拍硬上界办结） 
用户选定最彻底方案（B2）：DMA + 定时器 TRGO 硬件触发 + 消费上一拍
已完成的半区。对应 P1-5 拆出的"单拍硬上界"，现已办结。

硬件事实更正（查 CubeMX 器件库 + 本仓 HAL 头证实）：F4 上 ADC1 的
外部触发清单里没有 TIM6/TIM7 TRGO（只接 DAC）。故 1 kHz 节拍源由
TIM6 改为 TIM3（PSC 83 / ARR 999，TRGO=UPDATE），同一个更新事件
同时 ① ISR 脉冲 TPAFE CONVST ② 经 TRGO 触发 ADC1 一轮 9 通道
③ 置位 ADC_WAKE_FLAG 唤醒 adcTask。TIM6 从 .ioc 整体移除。

代码：
- Src/tim.c/h：新增 MX_TIM3_Init（含 MasterSlaveMode），删 htim6
- Src/adc.c：ExternalTrigConv=T3_TRGO + EDGE_RISING +
  DMAContinuousRequests=ENABLE；MspInit 挂 hdma_adc1（DMA2_Stream4
  循环模式）。DDS 位关掉 = 一轮只发一次请求，静默丢 8 路
- Src/dma.c：DMA2_Stream4 NVIC 优先级 6（CubeMX 换流会把它重置为 0，
  优先级 0 会抢占 FreeRTOS 临界区，违反"外设中断 ≥5"）
- Src/main.c：周期回调加 TIM3 分支；stm32f4xx_it.c 向量同步
- App/algo/adc_input.c：stm32_scan() → stm32_take()，逐通道
  PollForConversion 全删；乒乓半区由完成计数奇偶推出（只读一个
  32 位量 → 与 ISR 无竞态）；STM32 侧数据固定滞后 1 拍
- App/task/adc_task.c：心跳日志拆出四类计数

观测性：adc1_seq（完成计数）/ adc1_gap（seq 前进 >1 = 丢帧）/
adc1_err（连续 ≥2 拍无新帧 = 停摆）/ adc1_hw（HAL 错误回调）。
单拍无新帧是消费者相位伪影（DMA 完成落在唤醒后 ≈67 µs），不计故障。

验证：
- 主机单测 79 → 101 全绿；反向验证四连均咬（半区奇偶取反 11 条、
  停摆拍置 valid 4 条、STALL_RUN_MAX 改 1 为 6 条、gap 阈值 1 条）
- @build 0 错 0 警，Code 256872 → 257660
- @test PASS：adcp 122 µs → 8 µs、adc1_err=0、adc1_hw=0、
  adc1_gap=27/20002 拍、adc1_seq 与 seq 恒定偏移 2
- stack_report 7/7 PASS，adcTask 832 B / 余 59%（不变）
- cubemx-survival 新增 5 项审计（TIM3 分支 / T3_TRGO / DDS /
  DMA 挂载 / 流优先级），28 通过 0 失败

文档：ADC 采样节拍设计说明新增 §11；看门狗停摆分析 §4.4 与 §8 收口；
算法规划 L1-1/L1-3、通道映射、测试说明、各 README 同步。
 2026-10-11 00:31:33 +08:00
wandering1 9231a3c22c adcTask 事件驱动消费（P1-5 方案 a）+ 补 F4 ADC 上电自校准 + 修正 2 ms 忙等过期表述 
P1-5 方案 a（事件驱动消费，Task #32）：
- TIM6 1 kHz ISR 除触发 CONVST 外再调 adc_tick_irq_notify()，置位
  ADC_WAKE_FLAG；adcTask 循环尾改 osThreadFlagsWait(osWaitForever)，
  删除 ADC_TASK_BEAT_MS 定时轮询
- adcTask 优先级 Normal(24) -> AboveNormal(32)（Src/freertos.c USER CODE 区）
- 补消费者就绪门（规划未预见）：TIM6 在 app_main_init 就启动，比调度器
  早约 100 ms，未就绪时 ISR 不得 osThreadFlagsSet
- 实测 6 次上板：idle 由 1~649 降到 0/20000 拍，frames 1000.0 Hz，
  seq-frames=7 正是就绪窗口；UI 侧 uip/uiw/uis 无退化

补 STM32F4 ADC 上电自校准（此前项目从未做过）：
- 核查证实裁剪版 HAL 无 HAL_ADCEx_Calibration_Start、裁剪版 CMSIS 头无
  ADC_CR2_CAL -> 按 RM0090 13.3.6 在 Src/adc.c 的 USER CODE 区手写
  adc1_calibrate()，MX_ADC1_Init() 末尾调用
- 新增 cubemx-survival 审计项 adc1-calibration-call / -impl（清单 21->23）
- 实测校准前后同一拍 STM32 侧 6 路同向偏移 +10~+63 LSB，TPAFE 侧不变

修正两处过期表述（实测反证）：
- 原文 9 通道全超时最坏 = 18 ms 连占 有误：stm32_scan() 在首个超时处即
  Stop+return，单拍上界 = 一次超时约 2~3 ms
- adcm 约 2.1 ms 的峰值归因由 ADC 采集改判为每 10 s 一次的心跳日志；
  6 次对照 adcp = 122 us（无超时）/ 2209 us（超时 1 次）
- 同步修正 adc_task.c 两处过期注释；新发现超时拍 STM32 侧静默沿用
  上一拍值的正确性代价，硬化排序记入 4.4 / 10.4（未实施）

验证：@build 0 错 0 警（Code 256728 -> 256868）；@test 6/6 PASS；
stack_report 7 任务全 PASS（adcTask 832 B / 余 59%）；18 钩子全绿
 2026-10-10 22:41:19 +08:00
wandering1 5009a844a9 收敛 reset.bat 到 stlink-flash skill 并删除该批处理
CI / L0 静态门禁 (pre-commit) (push) Has been cancelled
Details
CI / L0.5 主机侧单测 (MSVC) (push) Has been cancelled
Details 
stlink_flash.py 新增 hard 子命令（-c SWD RM=Hrst -HardRst PULSE=100），
RM= 被 CLI 拒绝时自动降级为系统复位并打印 RESET_NOTE；至此 reset.bat 的
全部子命令（复位/hard/halt/run/list/flash/cmp）均已由 skill 覆盖。

删除 MDK-ARM/reset.bat（git rm）。@build/@download 两条旧批处理入口至此
全部收敛到 .dsh/skills/ 下的 skill，一个能力一个实现。

同步更新引用：AGENTS.md、README、MDK-ARM/README、7 篇 docs、4 个 skill
（stlink-flash/serial-boot-test/new-machine-setup 及 config.example.json）。

真机验证：hard 子命令 RM= 被拒 → RESET_NOTE → 回退系统复位 → STLINK_RC=0。
 2026-10-10 16:41:46 +08:00
wandering1 5defabcabb build: 删除 MDK-ARM/download.bat，烧录收敛到 stlink-flash skill 
- test/run_all_suites.py 是唯一执行它的地方：DOWNLOAD_BAT 改为 STLINK_FLASH
  （.dsh/skills/stlink-flash/scripts/stlink_flash.py）；直烧改
  [py, STLINK_FLASH, "flash"]（原先把 .bat 包给命令行解释器执行）；
  --flash-cmd 改由同一常量拼出，不再硬编码 .bat 路径
- 机制变化（须知晓）：原 download.bat 走 UV4 -f（CMSIS-DAP），现走
  ST-LINK_CLI -P <hex> -Rst -Run —— 与 .serialtest/config.json 的
  flash_cmd、AGENTS.md 烧录铁律、回读 -CmpFile 要求同源；6.5s/1MB
  也快于 UV4 路径
- AGENTS.md / 环境与部署 3 篇 / ST-LINK_CLI 复位说明（原文写"正式流程仍以
  download.bat 为准"，已反转）/ 自动化测试流程 / 串口助手设计说明 /
  链路延迟 / m2_data / README / MDK-ARM/README：引用改指 skill
- .gitignore：download_log.txt 条目保留并注明 legacy（他机残留物不变
  untracked）；build 日志注释同步
- 保留 MDK-ARM/reset.bat：其 hard/halt/run 子命令是 skill 没有的
- 刻意未改：docs/问题记录/项目审查与优化建议报告.md 的 P2-15（史实）
- 验证：run_all_suites.py --dry-run 解析出 skill 路径；doc-links 123 通过
 2026-10-10 16:28:58 +08:00
wandering1 c77c5824f9 build: 删除 MDK-ARM/build.bat，@build 完全收敛到 keil-build skill 
- test/run_all_suites.py 是唯一真正执行它的地方：BUILD_BAT 常量改为
  KEIL_BUILD（.dsh/skills/keil-build/scripts/keil_build.py）；两处构建点
  改传 --timeout（脚本内超时先于 _run 超时触发，超时得 rc=1 + BUILD_FAIL
  文案，而不是被 _run 杀掉）
- AGENTS.md / keil-build SKILL.md / new-machine-setup SKILL.md：删除
  "等价原生入口"口径，改为注明该文件已于 2026-10-10 删除
- 环境与部署 3 篇 / 项目架构总览 / README / MDK-ARM/README /
  download.bat 注释 / check_mem_numbers.py 提示串：移除 build.bat 引用
- 刻意未改：docs/问题记录/项目审查与优化建议报告.md 的 P2-14 / N-18
  （历史审计条目；doc-links 不校验裸文件名，保留不影响门禁）
- 验证：keil_build.py --timeout 300 -> BUILD_OK / rc=0；
  run_all_suites.py --dry-run 正确解析 skill 路径；doc-links 123 文档通过
 2026-10-10 16:23:54 +08:00
wandering1 7a54fdbc73 docs(build): @build 统一为 keil-build skill，build.bat 降为等价原生入口 
- AGENTS.md 构建条：@build = keil-build skill（写明 UV4 解析链、退出码
  0/1/2/3、日志路径）；MDK-ARM/build.bat 明确为等价原生入口，并列出
  它相对 skill 缺的三项（无超时保护 / UV4 只认 DTU_KEIL_UV4 / 失败 dump 整份日志）
- keil-build SKILL.md「本仓库」段同步：skill 即 @build 口径
- 3 个 skill（new-source-file / ui-verify / new-machine-setup）与 8 篇
  docs、README、MDK-ARM/README、环境与部署 3 篇：命令示例与 @build
  标识统一改指 skill
- scripts/stack_report.py 的构建提示串改指 skill
- 环境与部署：DTU_KEIL_UV4 使用方补 keil_build.py；反向测试期望的报错
  文案对齐 skill 实际输出（BUILD_ENV_ERROR: ... is set but not a file）
- 刻意未改：docs/问题记录/项目审查与优化建议报告.md 的 P2-14/N-18
  历史审计条目（属史实记录）；test/run_all_suites.py 的 BUILD_BAT
  常量（是代码、非文档，改动需另做验证）
 2026-10-10 16:19:14 +08:00
wandering1 43c958cac1 docs(agents): AGENTS.md 按项目现状更新（L1 层/钩子清单/栈数字） 
- 提交门禁钩子清单 4 -> 18 个：补齐 test-cppcheck / no-mojibake /
  coding-standard / doc-links / task-table / mem-numbers /
  cubemx-survival / 三个主机侧单测 / test-suite-switch
- 提交信息补"正文每行 <=80 字符"（gitlint 默认 body-max-line-length 未关）
- ADC 取数条补 L1 采集层消费者入口 adc_input_poll/adc_input_raw
- E-59 闸门 adcTask 栈数字 504 B/75% -> 560 B/72%（2026-10-10 实测）
- 任务数 6 -> 7（新增 adcTask），栈表脚注同步
- 新 .c 注册补"新目录还须加 uvprojx IncludePath"（本次踩坑）
- 架构要点新增 App/algo/（L1/L2 落点）一条
- requirements.txt 注释指向已删的 tools/serial_tool -> .dsh 串口 skill
 2026-10-10 16:11:20 +08:00
wandering1 d59c2198eb feat(adc): L1 采集层落地——STM32 ADC1 扫描 + 语义通道映射 
新增 App/algo/adc_input.c/h（L1 采集与预处理层，落实 L1-3/L1-4）：
- L1-4 语义通道映射表 k_adc_map[]：UA/UN/IA → TPAFE buf[6]/[5]/[2]；
  UB/UC/IB/IC/IN/TEMP → STM32 ADC1 CH14/3/6/1/2/5。消费侧一律经
  adc_input_raw() 按语义取数，不写死下标（V0.2 改版只改表内容）。
- L1-3 STM32 ADC1 9 通道软件触发顺序扫描：HAL_ADC_Start + 逐通道
  PollForConversion/GetValue（EOC_SINGLE_CONV + 无 DMA，可逐通道轮询）。
- adc_input_poll() 统一"TPAFE 原子快照 + STM32 扫描"；
  adc_input_init() 做映射自检（STM32 映射通道必落在扫描序列内，否则
  返回 -1），挡住"映射到不扫描的通道 → 恒读陈旧值"的静默错。

集成：
- adc_task.c 取数改走 L1 层（首帧日志补全 8 路 + 温度；心跳增
  adc1_rc/adc1_err 观测 STM32 侧健康度）。
- app_main.c 在 tpafe5160_init() 之后调 adc_input_init()，失败记
  SYSLOG_SELFTEST("ADC map fault")。
- Keil 工程挂 adc_input.c 并加 ../App/algo 包含路径。
- 文档同步：继电保护规划 §1.2/§3.1（L1-3/L1-4 改 ✅）、ADC通道映射说明
  §7/§8/§9、产品需求 §5.9/§9、架构总览 §7、AGENTS.md、App/README.md、
  App/task/README.md、新增 App/algo/README.md、boot_log_data 清单。

验证：
- @build 0 错 0 警；镜像无源文件新于 hex。
- 台架 @test PASS：ADC input layer init OK、adc1_rc=0/adc1_err=0
  （30 s ≈27 万次转换零超时）、seq 仍 1000.0 Hz、adc 栈峰值
  528→584 B（余 71%）、回读一致、零 [ERR]/HardFault。
  证据 docs/测试说明/boot_log_data/20261010_prod_adc_l1_boot_log.txt
- 内存快照已刷新（Flash 269,404→270,712 B）。
 2026-10-10 16:06:31 +08:00
wandering1 970e574433 feat(adc): 1 kHz 采样节拍改由 TIM6 硬件定时器触发 
- CubeMX 加 TIM6（PSC=83 / ARR=999 / ARR 预装载 / NVIC 抢占优先级 6）
- Src/main.c 回调加 TIM6 分支触发 CONVST（USER CODE 区）
- app_main.c 用 HAL_TIM_Base_Start_IT(&htim6) 替换单次触发
- adc_task.c 退化为纯消费者（1 ms 轮询仅作消费节奏）
- @build 0 错 0 警；台架 @test 验收待做
- 同步 ADC采样节拍设计说明 / 继电保护复现规划 / AGENTS / TPAFE README
 2026-10-10 15:24:02 +08:00
wandering1 f0300761ae 串口采集/测试去重：删 tools/serial_tool 与 test/host run_boot_test/verify_log 副本，引用改指 .dsh/skills 串口 skill 2026-10-10 15:13:23 +08:00
wandering1 883c9dd0cc feat(adc): B1 实现 ADC 采集链路（adcTask + 看门狗） 
B1（ADC 采集链路）落地，消化 P1-1：
- adc_task.c：空桩 -> 真实消费者。每 1ms 触发一次 CONVST，
  用 tpafe5160_snapshot() 原子取数（AGENTS 铁律）+ 帧统计 +
  每 10s 心跳日志。只取数，不做保护运算。
- Src/freertos.c：手工创建 adcTask（512 words / Normal，落
  USER CODE 保护区，同 timeSyncTask 先例）。
- task_watchdog：新增 TASK_WD_ADC；required_mask 产品 0x37 ->
  0x77、ENABLE_HW_LAYER_TESTS 0x35 -> 0x75。
- default_task.c：栈水位探针增列 adcTask（extern + 表项）。
- 脚本：stack_report.py 增 ROOTS/RUNTIME_ALIAS；gen_task_table
  增 adcTask（README/AGENTS 任务表已 --write）。
- 单测：watchdog_test.c beat_all/掩码断言同步（39 断言全绿）。
- 文档：待处理内容/看门狗设计/RAM 方案/继保规划 同步。

验证：@build 0 错 0 警；stack_report 静态最坏链 504B（余 75%）；
pre-commit 全绿。剩 @test 实机闭环。
 2026-10-10 14:33:32 +08:00
wandering1 aac5f99fe9 移除 OpenCode 配置与命令，技能与串口单一配置源迁移至 .dsh/skills 与 .serialtest，同步更新全部文档引用 2026-10-10 14:05:36 +08:00
wandering1 0779d3a075 栈整改不抬栈：删旧档迁移、FIL静态化、日志行缓冲按模块收紧、钩子脱离HAL，defaultTask链5312→2776B 2026-10-10 10:17:00 +08:00
wandering1 5c978465c9 TPAFE驱动闭环E-44/E-45/E-58取数契约，固化E-59门禁，adc_task挂进Keil工程 2026-10-10 03:46:50 +08:00
wandering1 61a6061950 串口助手补残行封顶与会话边界复位、截头按行对齐、open 保持 dtr/rts；判定加命中行/顺序/耗时/JSON 与产物清理 2026-10-10 03:17:16 +08:00
wandering1 fccf99bc90 测试闭环补固件身份戳、烧录回读校验与启动锚点计数，并修cmd引号解析与flash-cmd预检缺陷 2026-10-10 02:54:33 +08:00
wandering1 b37fdea21b 修复串口助手6处采集缺陷：wait-idle no_data与首字节门、log先过滤后截尾、HTTP独占绑定修正、超时不再误拉daemon、配置BOM容错 2026-10-10 02:33:44 +08:00
wandering1 29df7bf8fb 4 个 Fault Handler 迁入 USER CODE BEGIN 0（L3→L2）：生成区恢复 CubeMX 原样，重生成零 diff
CI / L0 静态门禁 (pre-commit) (push) Has been cancelled
Details
CI / L0.5 主机侧单测 (MSVC) (push) Has been cancelled
Details
2026-10-10 02:02:58 +08:00
wandering1 e2e1d0fd42 IWDG 延后启动改走宏改名（L3→L2）：生成调用变空操作，重生成后不再需要手工删 2026-10-10 01:30:47 +08:00
wandering1 63ee090fd1 行尾策略写死进 .gitattributes（统一 LF、bat 强制 CRLF、二进制显式标注），根治重生成后的行尾幻影改动 2026-10-10 01:15:16 +08:00
wandering1 5eed2151de CubeMX 生成 ADC1（9 通道）+ 复原重生成定制，FreeRTOS 加固迁 L1、钩子落 USER CODE 4/5，门禁豁免生成文件空白改写 2026-10-10 00:53:20 +08:00
wandering1 6f3891a6b9 ADC 通道映射表建档（V0.1 语义固化）+ .ioc 启用 ADC1 九通道 
新增 docs/硬件平台/ADC通道映射说明.md：17 路语义↔网名↔通道号权威映射
语义：UA/UB/UC/UN=AIN1~4、IA/IB/IC/IN=AIN8~11、V_ZL2=温度，其余备用
勘误：PC4=ADC12_IN14（非 IN12）；PB0=ADC12_IN8（V0.0 B5 定性有误）
勘误：PC5=ADC12_IN15；网名 ADC17 承载 UB，不是 V_ZL2
.ioc：PA0~PA7/PC4 → ADC1_IN0..7/IN14，Rank1~9 + 144 cycles + 软件触发
.ioc 键名与取值逐条比对 CubeMX 自带 DB（aditf2_v1_1_Cube）后写入
尚未 Generate Code：adc.c 与 HAL adc 驱动未入库，生成后需注册 uvprojx
 2026-10-09 17:17:32 +08:00
wandering1 ed463716f6 netTask 栈 1024→960：按静态最坏链核算并同步 .ioc/README/审计基线 
静态最坏链 2664B（日志主导：链上 5 帧各含 192B __con_line + 尾部 696B）
3840B 配置下余量 1176B（30.6%），过 stack_report 规则
net_drain_chip_rx scratch 静态化实测仅省 16B 栈、反增 256B BSS，已回退
.ioc FREERTOS.Tasks01 同步 960（L1 记账，重生成不丢）
 2026-10-09 17:14:52 +08:00
wandering1 f4fea70749 docs: 合并 4 份待办文档为统一登记簿 待处理内容.md 
合并 docs/待处理内容.md（N/S/T-x）、审查记录/项目审计改进清单.md（P-x）、
审查记录/下一步任务规划.md（阶段与基线）、审查记录/测试与架构改进建议.md
（S1x/A-x）为单一《待处理内容（统一待办登记簿）》。

- 结构：编号空间与来源 / 未闭环一览 / 任务排序（阶段 A~D）/
  逐条详述 / 待验证与待确认 / 设计基线 / 诊断基线 / 内存预算 / 维护约定。
- 编号沿用且不回收；E-xx 仍由 错误码传播审计.md 独立维护。
- 删除 3 份被合并文档；重定向下游引用：README、AGENTS、审查报告、
  实机测试实施指南、Net 层架构、NET/cfg 模块 README、脚本注释。
- 同步订正计数：P1=2(+1 收尾) / P2=10 / P3=6。

pre-commit 17/17 Passed。
 2026-10-04 02:28:52 +08:00
wandering1 c441131db6 环境文档小修：CMSIS pack 更正为非必装（keil.com 已下架）、串口配置源端口更正为 COM6 2026-10-02 22:56:48 +08:00
wandering1 33a4aa4945 本地工具路径DTU_*环境变量改造落地：10处调用点去硬编码+变量优先解析，本机全链路验证通过，文档同步收口，requirements补pre-commit 2026-10-02 22:14:49 +08:00
wandering1 d9425ddd23 测试：补启动段可观测性与模拟器差距清单，run_all_suites 加只编译模式（S10+S13+S6）
CI / L0 静态门禁 (pre-commit) (push) Successful in 1m10s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 25s
Details
2026-10-02 13:57:25 +08:00
wandering1 e90486524d CI：Gitea Actions 落地 L0+L0.5（补 T-6） 
新增 .gitea/workflows/ci.yml：push/PR 触发两个 Windows job——
l0-gates 跑 pre-commit --all-files（无 Keil .map 时自适应跳过 mem-numbers），
l05-host-unit-tests 遍历 test/host/**/run_unit_test.py（缺 MSVC 则告警降级跳过）。
刻意不跑 @build（需 Keil 授权）；L1/L2/L3 需真机+ST-LINK，不上 CI。

新增 scripts/ci_local.py：本地跑与 CI 等价的门禁（自动选用装了 pre-commit
的解释器；.map 自适应；退出码 0/1/2 与 CI 对齐），供提交前自查与 runner 就绪前过渡。

文档同步：测试开发标准流程 §9（CI 章节）/§1/§4.1、待处理内容 T-6 销项、
项目部署环境要求 §2.11（runner 前置）、pre-commit 使用说明 §1、scripts/README.md、AGENTS.md。

验证：scripts/ci_local.py rc=0（L0 14 钩子全过 + L0.5 39/39）。
 2026-10-01 10:19:38 +08:00
wandering1 2055de0303 测试：落地测试架构改进 T-1~T-5（套件开关门禁/汇总行校验/通用 harness/公共断言宏/多套件编排） 
背景：L0.5 主机侧单测落地后复审测试架构，给出 6 条改进意见（P0~P3），
登记进 docs/待处理内容.md「测试与验证基础设施」后逐条实施。

- T-1(P0) 测试套件开关门禁：新增 scripts/check_test_suite.py + pre-commit 钩子
  test-suite-switch，默认要求产品构建（全部 TEST_SUITE_* 注释），跑套件回归用
  --allow-test-build / ALLOW_TEST_BUILD=1 显式放行。顺带把 test_config.h 中长期
  开启的 TEST_SUITE_CH395F 改回注释（仓库此前躺着的是测试固件）。
- T-2(P1) verify_log.py 增加 --require-suite-summary：要求
  "=== <名称>: N/M PASSED (failed=0) ===" 且 N>0，堵住"套件没跑到汇总行/
  断言数为 0 仍判 PASS"的盲区；run_boot_test.py 同名参数透传。不传参向后兼容。
- T-3(P1) 抽取通用 harness test/host/common/unit_test_harness.py（工具链探测/
  INCLUDE-LIB 拼接/wd4819/GBK 解码/退出码契约）；watchdog 运行器 170→55 行，只声明 TestBuild。
- T-4(P2) 新增 test/board/test_common.h 集中断言内核（TEST_CHECK_IMPL/TEST_REPORT_IMPL），
  4 套件各用一行宏绑定自身统计变量（保持 g_xxx_stats 独立、防跨套件串数）。
  刻意不 include dbg_log.h——否则冻结 DBG_TAG 默认值触发 #47-D 重定义警告。
- T-5(P2) 新增 test/run_all_suites.py 多套件回归编排，try/finally 无条件还原套件开关。

验证：@build 产品构建 0 错 0 警；4 套件逐一构建均 0/0；看门狗单测 39/39 PASS；
pre-commit 14 钩子全通过；编排脚本 dry-run/开关切换/异常还原均实测通过。
 2026-10-01 07:28:57 +08:00
wandering1 2d414f8aa9 查证 SHCSR 的 Fault 使能位无法在 CubeMX 配置，补入文档与审计提示 
用户问 fault_handler_enable() 能否通过 CubeMX 配置。查 CubeMX 安装目录的
模板源码后确认：不能。三重证据：

1. tpl_main_c.ftl 的 MX_NVIC_Init() 用 [#if vector.systemHandler=="false"]
   才生成 HAL_NVIC_EnableIRQ；而 NVIC-STM32F417_Modes.xml 里
   MemoryManagement/BusFault/UsageFault_IRQn 都标 Y（=systemHandler），
   故 CubeMX 对这三个永不生成使能代码（只生成优先级，且仅当优先级 != 0）。
2. 全部模板中 SHCSR 只出现 1 次（tpl_main_c.ftl:2269），且是 MPU 清理时的
   SCB->SHCSR &= ~SCB_SHCSR_MEMFAULTENA_Msk（禁用），无任何 |= 置位。
3. MPU 路径也堵死：.ioc 的 Mcu.IP 列表无 MPU，且 HAL_MPU_Enable 只置
   MEMFAULTENA 一位，BUSFAULTENA/USGFAULTENA 仍拿不到。

实测印证：Src/stm32f4xx_hal_msp.c 的 HAL_MspInit() 里只有
HAL_NVIC_SetPriority(PendSV_IRQn, 15, 0)，三个 Fault 一行代码都没生成。

结论：只能手工写。但函数体在 USER CODE BEGIN 1 区（L2），重生成不会丢，
另有审计项 fault-handler-enable 兜底 -- 故这不是风险，只是无法享受 L1。

顺带记录一个易踩的误解：.ioc 里 NVIC.MemoryManagement_IRQn=true 的第 1 段
只是"向量在 NVIC 表里可见/已配优先级"，与 SHCSR 使能位无关，
不要以为勾了 NVIC 面板的 Enabled 就等于使能了故障。

改动：

- 看门狗设计说明.md：§10.2 新增"为什么 fault_handler_enable() 写不进 .ioc"
  （三路径对照表 + 实测印证 + 结论）；四个 Fault 采集小节加警示；
  L1 表格补该行；变更记录新增 2026-10-01 条。
- AGENTS.md：新增"SHCSR 的 Fault 使能位无法在 CubeMX 配置"铁律条目。
- scripts/check_cubemx_survival.py：fault-handler-enable 的 hint 补上
  "无法 CubeMX 配置"及其原因，便于日后重生成后看提示就能回忆。

验证：pre-commit 13 钩子全通过；审计 18 通过 / 1 警告 / 0 失败。本次仅改
文档与脚本注释，未动代码，无需重编译。
 2026-10-01 06:20:50 +08:00
wandering1 8a18e388c7 四个 Fault 全部采集现场：MemManage/BusFault/UsageFault 由空死循环升级 
原状：HardFault 已有崩溃采集，但 MemManage / BusFault / UsageFault 仍是空
while(1) —— 这三类故障发生时日志完全静默，且因 SHCSR 默认未使能，实际会
被升级成 HardFault，报告出笼统的 "HARDFAULT"、看不出根因。

改动：

- Src/stm32f4xx_it.c：三个 Handler 升级为手工 __asm 版（取 MSP/PSP 帧指针）
  -> B 到 per-fault C 入口 fault_entry_{mem,bus,usage} -> hard_fault_report()。
  hard_fault_report 增加 tag 参数，日志统一为
  "[ERR] <TAG> PC=.. LR=.. xPSR=.. R0-R3=.. CFSR=.. HFSR=..[/BFAR][/MMFAR]"。
  生成实体经 #define X X_Gen 改名保留，链接器各移除 2 字节（.map 已验）。
  三个各带独立锚点 MEMFAULT/BUSFAULT/USAGEFAULT-ANCHOR。
- 新增 fault_handler_enable()（USER CODE BEGIN 1 区）：使能 SHCSR 的
  MEMFAULTENA/BUSFAULTENA/USGFAULTENA。声明入 Inc/stm32f4xx_it.h，调用在
  app_main_init() 第一行（纯寄存器写，不依赖日志/时钟）。
- 刻意不启用 CCR.UNALIGN_TRP / CCR.DIV_0_TRP：会把普通 bug 升级成死机，
  对本项目弊大于利（说明写进函数注释）。

实现约束（本轮踩坑）：ARMCC 的 __asm 块取不到 C 的数据符号（ADR r1, xxx_tag
报 A1516E: Bad symbol，去 static 也无效），也无法给 C 函数传字符串参数，
故故障名必须由 C 侧 per-fault 入口带上。

配套：

- check_cubemx_survival.py：新增 fault-handlers-3 / fault-handler-enable 两项，
  UNPROTECTED_LEGACY 清掉三个 Fault（WARN 2->1），清单 16 -> 18 项。
- AGENTS.md：新增"4 个 Fault 全部采集"条目；ARMCC 汇编条目补 A1516E 第 3 坑；
  校验标记补 [ERR]（四个 Fault 日志都以它开头 -> 一律判 FAIL，刻意）。
- 看门狗设计说明.md：§6.1 补 4 条 Fault 标记与 @test 禁项关系；
  §10.2 L3 清单与四个 Fault 采集小节；§11 结论表与变更记录。
- 待处理内容.md：新增 N-03d（已完成），N-03c 补第二次重生成结论。

验证：@build 0 错误 0 警告（Flash +156 B，RAM 无变化）；pre-commit 13 钩子
全通过；审计 18 通过 / 1 警告 / 0 失败。
 2026-09-29 09:16:19 +08:00
wandering1 67d26ac37a 修正 CubeMX 重生成防丢失机制：审计脚本实测有效，恢复 5 处被覆盖定制 
第二次重生成验证了审计机制，并证伪了上一轮的一处假设：

- 审计脚本 check_cubemx_survival.py 准确检出全部 5 处覆盖（16 项中 5 FAIL），
  机制有效；Src/main.c 复位原因锁存（USER CODE BEGIN Init 区）完好，
  是"USER CODE 区有效"的正向证据。
- 关键发现：CubeMX 本次换了一代中断函数模板（旧 HardFault_Handler /
  HardFault_Report 自造区 → 新函数体内 HardFault_IRQn 0 / W1_HardFault_IRQn 0），
  "生成区之外的自造标记区"同样不被保留，旧假设被证伪。

恢复方案（第二次升级）：

- stm32f4xx_it.c：报告实现迁入 USER CODE BEGIN 0（区名从未变过的标准保护位）；
  Handler 本体改为生成区整函数替换，用 #define HardFault_Handler
  HardFault_Handler_Gen 把生成实体改名保留，链接器自动移除（.map 实证
  Removing ... (2 bytes)），向量表指向手工 __asm 版（0x080001a1，18 字节）。
- iwdg.c：去掉 HAL_IWDG_Init() 调用，补 IWDG-DEFER-START-ANCHOR 锚点注释。
- FreeRTOSConfig.h：恢复 FREE_RTOS_CONFIG_HARDENING 块（两个加固宏）。
- freertos.c：补回两处任务栈中文注释（栈值未丢，.ioc 已同步）。

配套：

- check_cubemx_survival.py：hardfault-handler 改 wholefile + 锚点检查；
  UNPROTECTED_LEGACY 清单更新。
- AGENTS.md：新增"CubeMX 换模板"与"ARMCC 内联汇编语法"两条铁律，
  以及"uvprojx 被 Keil 自动改写不入库"条目。
- 看门狗设计说明.md：§10.1 补第二次重生成验证结论与模板换代发现，
  §10.2 L2/L3 全面改写（自造区名不可依赖）。

验证：@build 0 错误 0 警告；pre-commit 13 钩子全通过；审计 16 通过 / 2 警告 / 0 失败。
 2026-09-29 07:52:39 +08:00
wandering1 7a18d2ce28 加 CubeMX 重生成存活审计：防标记区外定制被静默覆盖 
背景：.ioc 的 KeepUserCode 只保护 USER CODE 标记区，标记之外的手工改动
重生成即被覆盖，且多数不报编译错（2026-09-29 实测一次覆盖 4 处，含
HardFault_Handler 崩溃采集被打回空 while(1)、两个 FreeRTOS 加固宏被删）。

新增 scripts/check_cubemx_survival.py：
- 16 项易失清单（IWDG 延后启动 / 崩溃采集 / 栈溢出检测 / 堆失败钩子 /
  断言改造 / 看门狗模块与工程挂载 / 复位原因锁存 / HAL 驱动与使能 /
  .ioc 关键项），断言前剥掉 C 注释防误报
- 哈希基线漂移检测（.cubemx_survival_baseline.json），--write 重建
- 标记区外存量以 WARN 提示（3 个 Fault 处理函数、栈注释）

已挂 pre-commit cubemx-survival 钩子（改动 .ioc / Src / Inc /
task_watchdog / .uvprojx 时触发）。

文档：看门狗设计说明 §10.2 新增"重生成不丢的三层手段"方法论
（L1 写 .ioc > L2 搬进 USER CODE 区（可自造标记区）> L3 审计兜底）
及 .ioc / USER CODE 区可用位置 / 存量清单三张对照表；AGENTS.md 平台约束
新增该规则；pre-commit 使用说明 §2.12 新增钩子详解。

门禁：build 0 错误 0 警告；pre-commit 全通过。
 2026-09-29 07:30:00 +08:00
wandering1 22559365b9 整理 App 与 test 目录：按职责分子目录并同步全库引用 2026-09-26 12:52:39 +08:00
wandering1 8d86fb1149 登记簿完成即销项：待处理内容.md 删4项已闭环条目并清理全库引用 
- 删 N-1/N-5/N-6/N-8（结论已沉淀于 Trap21/22/23 与 E-03，先验证后删）
- 同步清理 3 处外部引用（错误码传播审计、CH395F_Trap_Records、Net层阻塞模型）
- 文件头说明改写为「完成即销项，不保留已消化行」
- AGENTS.md 新增登记簿销项规定
 2026-09-26 12:12:14 +08:00
wandering1 a6cdebde62 文档体系重组与 D-7 一致性门禁落地，清理芯片手册孤儿图片 
- D-6 目录规范化：docs 根目录散落文档归入 UI设计/子系统设计/架构设计/审查记录/
  环境与部署/网络 等子目录，去掉目录名空格，重命名 嵌入式C语言代码规范_V1.0.md
- D-7 三档一致性门禁：新增 scripts/check_doc_links.py（链接存在性）、
  scripts/gen_task_table.py（FreeRTOS 任务表数值）、scripts/check_mem_numbers.py
  （内存/Flash 体积），均支持 --check/--write/--diff，pre-commit 钩子同步注册
- D-5 文档索引：新建 docs/README.md，新建 docs/文档规范.md 约束目录命名与链接写法
- D-1 芯片手册瘦身：删除 1069 张无引用孤儿图片（77.06 MB），
  docs/芯片手册 120 MB → 41 MB，已引用图片零断链
- 同步 C 源码注释中的文档路径引用（D-6 重组后），构建 0 错误 0 警告
 2026-09-26 00:51:53 +08:00
wandering1 d0cbeb6b5b 控制台日志实现迁出HAL生成文件至App/log并新增设计说明；defaultTask任务体迁至App/task，freertos.c恢复纯CubeMX接线形态 2026-09-25 01:32:09 +08:00
wandering1 07c97cb3cd UI设计文档与AGENTS.md固化MCU端dark mono主题与I1调色板约束 2026-09-21 05:12:29 +08:00
wandering1 2505cf1e48 文档同步net错误码回传约束与单连接断开语义,关闭已修复的FTP 21待办 2026-09-21 04:46:59 +08:00
wandering1 57632e910a 内存管理文档4→2合并：报告/规划并入主文档，lftpd静态化降栈峰值，同步架构/FTP/部署文档 2026-09-21 04:37:27 +08:00
wandering1 bbdd059e25 修复就绪屏障位被消费致FTP永不监听；新增栈可观测（水位探针+静态调用图报告）并补FTP实测 2026-09-21 04:26:52 +08:00
wandering1 47b38f08ef 修复 I1 绘制缓冲缺 8 字节 palette 头导致的越界写与整帧错位，补存储维护文档 2026-09-21 03:45:55 +08:00