28 Commits

Author	SHA1	Message	Date
wandering1	4ceb5b41e6	docs(任务规划): 故障录波卡片登记簿销项——判据并入设计说明后删除 ... 用户指令（2026-10-30）：确认录波任务完成度，把除实际操作之外的所有 步骤做完，然后删除规划文件，避免已完成的工作被误读为未做。 审计结论：代码面确已全部收口——wave_read.py --selftest 92/92、 三套主机单测 113/170/110 复跑全 rc=0、bench 自抓与 PC 读段脚本在仓、 数据可信/复刻明细/短板评测/UI 两处回写均已做过。**唯一未跑的是 板级台架那一轮（实际操作）**，判据不得丢，故先迁后删： - 设计说明 §9 承接落盘道失败留痕名全清单（13+1 条，打印点现值 default_task.c:816/:831 实测核对） - 设计说明 §10 承接原卡 2/卡 3 的板级段（触发来路一行、回放页 一行）与本波执行顺序图（mermaid，原规划 §3 逐字迁） - §4/§11 头部定位、§11 尾注、§14 关系行改属主口径 - 全库 32 处引用改挂设计说明 §10/§9（18 文件）：任务规划 README 独立行（顺带订正单测数 100→113 为实测）、登记簿、数据可信 ×2、 复刻明细、产品需求 ×2、ADC 注入 ×3、短板评测 ×2、页面补齐规划、 App/algo README、配图生成器注释、录波三套单测注释 ×6 - git rm docs 该规划文件；人类索引任务规划 6→5 个文件（沿革注照 屏板链路先例走裸句，不留反引号死引用） 验证：残留两形态（任务规划/故障录波、裸文件名）全树扫描 0； mermaid 预检新发 0；doc-links 11 个被改文件逐文件 PASS；生成器 注释改动重跑产物逐字节不变（svg 60a0dd39e4）；三套单测与 wave_read selftest 复跑全绿；18 文件 BOM/CR/U+FFFD 全零。 本笔不含固件编译单元（test/host 仅注释行与文档），构建留待合并 轮统一跑；板级轮启动判据与顺序见设计说明 §10。	2026-10-30 18:20:37 +08:00
wandering1	2525c2d948	docs(104): 端口口径统一成「工厂默认」，登记「改后立即重 bind」待办 ... 用户裁定两条：① 剩余裸写端口的地方加「工厂默认」限定词，不改固件行为； ② 生效语义按需求口径「保存即生效」定，现实现（端口下次重 bind 才生效）是 要改的一侧 → 建任务登记，本笔不动代码行为。 限定词（24 处 / 17 文件）：AGENTS 数据主线、App/protocol/README、根 README 文档索引、Src/freertos.c 三处任务注释、docs/README、项目启动顺序管理、存储 架构说明、软件架构与运行时规格（2）、RAM 使用分析、产品需求设计文档（5）、 项目架构总览（3）、test/host/README、iec104_master 流程注释、IEC104 上行设 计说明、继电保护功能复现规划。配图两张同批重跑：gen_arch_svg.py 与 gen_memory_svg.py（脚本与产物同一笔）。 两处陈旧计数（都做过双源核证）： - 测试开发标准流程 像素层「60 内容页」→ 内容页黄金参考 66 张（64 页）； 双源 = simulator/tests/ref/shot_*.bin 实数 66 与 check_content_pages.py 的 PAGES 66 条（含两个 _p2）。 - .pre-commit-config.yaml 的 uinav-selftest 注释「18 张黄金参考」→ 写成 「接线当时 18 张、现 66 张」：git log -S 定到 6a904c1b（2026-10-25），那 天 ref 目录确实 18 张，写时为真，但它描述的是钩子现有行为，属当前态。 口径修正与登记： - 页面扩充详细方案「通讯设置 = 无配置模型（端口与 CA 都是 #define）」→ 标 「当时」，并写明现已在 /config.ini 的 [comm] 段可配、UI 通讯设置页可改。 - 产品需求 §通讯配置：删掉「改后需重启生效」这句把两件事混为一谈的话，改成 需求要求「保存即生效」+ 现实现（公共地址重启、端口下次重 bind）+ 指向登记簿。 - docs/任务规划/登记簿.md §1 新增「104 端口改后立刻重 bind」：含隐性耦合 —— .serialtest/config.json 的必检锚点写死 listening on 2404，端口一改串口 回归必假失败；改行为时要么锚点只查 listening on，要么由脚本注入端口。 复扫（旧形态归零判据）剩 20 处未带限定词，逐条定性为刻意不改：默认值定义处、 出厂模板与断言、usage 与 argparse default、UI 黄金参考显示值、台架主站地址 （同数不同义）、串口锚点、叙事句、引用关系图坐标。逐条理由见一次性台账。 门禁：check_doc_links --sections-strict 对 16 篇改动 .md 逐个 rc=0； check_mermaid --all 31 文件 62 围栏新发 0；check_nested_comment --all 449 文件新发 0；check_bom_drift --all 99 个名单内文件无漂移； check_generated_fresh PASS（25 生成器 / 21 一致 / 4 只减不增基线）；字节体检 无新增 BOM / CR / U+FFFD / 行尾空格（三连空行与 HEAD 逐项相同 = 存量）。 /keil-build 0 错 0 警，Program Size Code=246720 RO=29836 RW=2052 ZI=149708 与凭证同码：本笔只碰注释与配图文字，无固件行为变更。	2026-10-30 15:40:27 +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	d0e73d6553	docs: 录波立项波及的口径同步（索引、登记簿、需求与 UI 状态行） ... 任务规划 README 顺序表：录波从「当前不排」移到独立行；动态波形验证让位给录波 数据面（段文件是现成的样本出口）。 登记簿：录波与 104 文件传输拆成两行，前者解除暂缓并指向新文档。 产品需求：立项未排行、录波文件存储行、文件传输行、录波采样率行补偏离登记指针。 UI：页面补齐规划第 26 叶与 UI补齐「不做」表改指故障录波立项，旧重开条件已满足。 短板评测记录链行、ADC前端注入验证流程的读数出口注、图形绘制流程与 tools/arch_diagram/README 的生成器清单同步。	2026-10-29 13:19:12 +08:00
wandering1	8f8d97b3d8	docs(编号): 批次六余账文档面——CubeMX 层号、双写疤、采集链旧层名共 61 站点 ... - 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	83011abb16	docs(编号): 测试验证层级文档面清号 + 修上一批改名留下的双写与错族疤（27 篇） ... 同族第三道（文档面）。上一批只改了 10 篇测试文档，本笔清掉余下 27 篇的层级号，并修 那批机械替换留下的两类疤。 - 层级号改语义名：各单元测试说明的「**门禁层级** | L0.5 层（介于 L0 静态门禁与 L1 板端套件之间）」→「主机侧纯逻辑单测（介于静态门禁与板端测试套件之间）」； 「板端（L1）」「L1/L2」「L3 人工」等表头与列值同批改写；测试文档模板规范的模板 字段同步（它决定以后每篇测试说明怎么写这一栏）。 - 「模拟器回归」旧号（原文标 L3/L2）**不映射**成新语义名，就地写「模拟器回归」： 它与「主机侧回归」是两回事，硬映射等于造一处新的口径错。 - 修双写疤 17 处（替换串套替换串的产物）：文档道改完 Lead 点名的 8 处后中途失败， Lead 接手余下 9 处——测试开发标准流程 7、CI README 1、门禁说明/host-unit-tests 1、 任务规划/测试与架构专项 1。 - 修**错族替换疤**（比双写更坏：字面改对、意思改错）：ADC输入层单元测试说明与 相量层单元测试说明的「介于 L0 静态门禁与 语义取数与有效性板端套件之间」——上一批 把测试层的 L1 换成了采集链层名；本笔随该行改写一并修正。产品需求 §7.4 同类问题 在上一笔（代码道）修。 - 变更记录历史行按「行内换号、日期与技术事实不动」处理（与「卡」族先例一致）， 换算表与撞族警示在 scripts/archive/id_gate/编号治理历史.md §10 / §10.1。 - 刻意未动：docs/芯片手册（外部手册原文）、UI 菜单层级残留 2 处与采集链旧层名残留 （已登记 task-12）、test/board 的链路时延段号残留（task-11）。 - 门禁：check_doc_links --all --sections-strict 通过（195 篇、章节引用 3292 处）； id-check-new --worktree rc=0（剩 2 处 WARN 是变更记录行里的已停发测试专项号， 不拦提交，本笔不越族去动它）；112 个改动文件 U+FFFD=0、无 CR、BOM 与 HEAD 一致； git diff --check 干净。	2026-10-28 17:56:21 +08:00
wandering1	94b0d79026	feat(ui)+chore(docs): UI 补齐清单清空；数据可信销项与「卡」号清退 ... 本笔含两组收尾工作（同一工作区内交错在 6 个共享文档/门禁配置里， 拆开会产生"文档声称的页数与树里黄金数不一致"的中间提交，故合为一笔）： 一、UI 补齐（清单清空） - 新建 6 个内容页模块：ui_page_accident / oper / alarm / start / yk 复用 ui_w_records 共享组件（分页、空态"无记录"、按实例读盘缓存）， 记录层与五个写入点已由道F task-10 / 道G task-12 落地，本批只补页面； ui_page_runreport 为 13 行 2 页只读统计，四个数逐个挂范围标签 （自电池周期 / 本次开机），boot_ready=0 显 "--" 不显 0。 - 数据面：ui_data_info_t 尾部追加 9 字段，ui_data_feed 用 boot_stats_get() + iec104_serv_get_stats() 纯搬运；模拟器填确定值假数据 （差异登记 docs/测试说明/模拟器差距清单.md §2.3 两行）。 - 接线：菜单树 6 叶绑 #page=，绑定叶 22→28、UI_PAGE_MAP_COUNT=28； 字库 185→218 字 / 280→313 字形；双端注册 uvprojx +30、CMakeLists +6。 - 回归：内容页黄金 53→60（含 runreport_p2 真拍第 2 页），文本断言 425 正向 / 36 反向；存量 53 张逐字节零漂移；记录 5 页各用独立空目录 （模拟器把操作留痕写进 cwd 的 sim_oper.log，共用 tmp 会让空态拍不到）。 二、数据可信销项 + 「数据可信」任务卡号整族清退 - 删除已闭环的"已知电压注入验证"行与闭环结论块（证据在 docs/硬件平台/ADC通道映射说明.md §8.1 与 docs/测试说明/ADC前端注入验证流程.md §5~§7），§5 标识列改语义短语。 - 卡 0/0b/1~12 共 14 个号全仓 288 站点 / 56 文件清退成语义短语， 代码注释、测试、门禁配置与文档一并改；换算表入 docs/编号规范.md §9.3。 这一族是中文前缀，不进 check_ids 语料，刻意不入 id_aliases.json。 验证（实测） - @build 0 错 0 警：Code=236456 RO=28124 RW=1876 ZI=137084； RAM +464 B（RW +304 / ZI +160），RW_IRAM1 62.2% / RW_CCM 87.9%， 体积同码凭证与 RAM 台账已回填。 - check_menu_rows 8 状态 rc=0（池 5368/5448 常量未动）； check_content_pages 60 页 rc=0；check_font_charset / registration / coding-standard / bom-drift / mojibake / doc-links --all / layer-deps / nested-comment 全 rc=0；check_ids --strict 无错误；主机单测 ui_data 295 / boot_stats 21 / sys_log_mcu 141 / soe 32 / soe_store 27。 未做（不是遗漏） - 六页真机判据（真记录翻页、掉电保持、清除后归零、boot_count 自增、 拔 RTC 电池落 RESTARTED、IWDG 复位落 rst_cause、主站连一次 conn_up+1） 已登记 docs/任务规划/登记簿.md §7；模拟器结构上照不到。 - docs/产品需求/产品需求设计文档.md 属另一条在飞改动，本笔不含； 其中我已同步 6 处现状数字（28 叶 / 60 页 / 218 字），随该笔入库。	2026-10-28 07:23:16 +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	50e5877882	docs(任务规划): 只留待办——删除已完成条目与变更记录 ... 「只保留待办」此前只落了一半：UI补齐 / 排期详述 / 测试专项已瘦身，并行分道 方案与数据可信还留着批 1/批 2 的收口说明、销项括注与里程碑达成记录。本次按 README.md §3 清干净。 并行分道方案.md（353→238 行）： - 删「批 1/批 2/批 2.5 全部收口」块、道A~道D 表行、11 张已销项数据可信卡 - 删 L1-5 通道标定 / L5-2 码值越界两条已落项、§5 批 1 三道详解（5.1~5.5） - 删 §6.1 冲突矩阵；章节重编号 9→8，并修 §9→§8 自引用 - §4.3 删「ui_data 为什么当初排批 2」历史插叙 数据可信.md（384→290 行）： - 删 §1「为什么是这一波」、§2.2 量纲错配、§2.4 点表现状、§2.5 引擎约束 - §5 任务卡表只剩 0 / 0b / 12；§3 里程碑只剩 M4 未收口行，M5/M6 压成一行口径 - §6 顺序图只留剩余三张；§8 删两张已销风险行；§4.4 落地注改为现状口径 - §2.1/§2.3/§2.6/§4.1~§4.5/§7/§8/§9/§10 与卡 0/0b/12 全部保留：它们是 adc_cal.* / meas.* / cfg_file.* / protect_task.c / ui_data* 头注释引用的 口径出处，不是"已完成记录" - §2 编号不连续是刻意的（被代码引用故不重排），已在节首加注说明 README.md / docs/README.md： - 文件地图去掉「卡 1~11 已销项」「八条道」等历史表述 - §1 网络行删掉三处 merge 号与批 1/批 2 销项经过 - 道A~道H 改为道E~道H，与并行分道方案一致 排期详述.md / 采集保护收尾.md / 登记簿.md / UI补齐.md： - 删 N-2/N-17/N-22 销项注、M1/M2 已达成括注、批 1/批 2 道名 - 修 E-27/28「批 3」与「批 4」自相矛盾；B10 硬依赖改指卡 12 未动：测试与架构专项.md——S12 / A-5 / P1-10 三节分别是 net_socket.c、 check_size_gate.py、ch395f_test.h 与门禁说明引用的锚点，删了会断校验 6。 门禁：check_ids --strict 通过（可判定 84.73%，基线 84.0%）； check_doc_links --all --sections-strict 通过（180 文档 / 2691 处章节引用）。	2026-10-25 22:47:54 +08:00
wandering1	68cbf8ea75	docs(任务规划): 按现状重排波次——UI 补齐转为当前波次，数据可信转收口态 ... 用户要求按现状重新规划。盘点后现状与文档已有实质偏差，本次一并纠正。 一、盘点结论（2026-10-25） - 批 1 / 批 2 / 批 2.5 全部收口，工作树清零、两锁空闲。 - 数据可信：软件侧 100%（卡 1~11 全销项；M4 ②③④⑥、M5 ①②③、M6 全达成）， 只剩卡 0（万用表）/ 0b（子板变比）/ 12（标准源）三张台架与外部卡。 - UI：33 叶已绑 12、剩 21。原口径「余批 5 = 整定 4 页」按页面批次统计， 漏了批 1 剩的 3 页（时钟/复归/清除记录）与批 3 的 12 页，实际差 17 叶。 - 结构债：剩 net 收口、白名单、性能簇、dhara、卷锁、USART1 六项。 - 工具链 S12 / A-5 / P1-10 / S1-c 全销项。 二、关键发现：保护整条链现在是闭锁态 protect_task.c:98 要求 UA/UN/IA 的 ADC_CAL_F_VALID 全置位才走判据，而 VALID 只在 两点标定写入 [adc_cal] valid 后才置位（adc_cal.c:338）。产品构建（非 DTU_BENCH） 下保护不动作——这是卡 5 的有意设计，但意味着核心功能当前关闭，解锁只有 卡 0 -> 0b -> 12 一条路。已写进 README §1.1、数据可信 §3、采集保护收尾、AGENTS.md。 三、三条用户判断（2026-10-25） 1. 台架不在手边 -> 卡 0 顺延，本波整体不占编码道。 2. 保护保持未标定闭锁到标准源到位，不用万用表标定走捷径。 3. 下一波只做 UI 补齐，结构债押后。 四、新波次顺序（README §2.0） 采集保护收尾 -> 数据可信（收口态）-> UI 补齐（当前）-> 结构债（押后）-> 预算与内存（暂缓）-> 验证常态 -> 仓库决策 -> 暂缓 -> 硬件改版。 排序原则补一条元规则：优先级只在「能开工」的项之间比较——高优先级波次全被 外部资源或硬件代次卡住时，按「现在能整波闭环」重排，阻塞原因写进「为什么在这」列。 五、新增 UI补齐.md（当前波次任务卡） 21 叶按数据源就绪度分三梯队：第一梯队 9 叶零依赖（整定 4 + 维护 3 + 遥测 2）、 第二梯队 4 叶需新配置段（通讯设置 + 遥信 3，后者无开入硬件不立卡）、 第三梯队 6 叶需写入方或计数器（记录 5 + 运行报告）；不排 2 叶（手动录波 / SNTP）。 共 7 张任务卡，单道串行——ui_menu_tree.txt 与 ui_page_registry.c 是单写者生成物。 六、顺带清掉的文档漂移 - 排期详述 §1/§2 还挂着 3 条已销项条目（日志管线 N-2、写回 flush N-22、 探针心跳 N-17），与 README §2 自相矛盾 -> 删除并补销项说明。 - 测试与架构专项：§1 P1-10 与 §2.1 S12、§2.3 A-5 已销项却仍留详述 -> 压缩成证据指针。 - README §1「网络 4」只列 3 条（漏 N-30）-> 补齐。 - docs/README 文件夹地图与登记簿卷首仍称「数据可信 = 当前波次」-> 改指 UI补齐.md。 - 页面补齐规划的就绪度表：遥测死区/系数随卡 10/卡 2 已具备数据层、SOE 页已落地， 三行状态更正；统计口径改为「27 叶中 6 叶已落地，剩 21 叶」。 七、踩到的坑（写进日志备查） 测试与架构专项卷首那段「已完成事项的证据沉淀」清单是 S4/S5/S7/S9/S11 的**定义出处**， 压缩时一并删掉会让校验 2 在 6 个文件上爆 14 类新账（实机测试实施指南 S4x7/S5x5、 check_test_traceability.py S4x5 等）。清单已原样恢复——它看着像历史，实际是门禁的锚点。 八、门禁 check_ids --strict 通过（可判定 9306/11003 = 84.58%，基线 84.0%）； check_doc_links --all --sections-strict 通过（180 文档 / 2684 处章节引用）。	2026-10-25 22:07:29 +08:00
wandering1	17ece864d1	docs(登记): F2/F3 台架分箱定案销项 + 饿死型签名新行（并档 E-27/28 批 3） ... 台架两轮（1a624b1，v1.1 判据）分箱结论落账： - 销「复合连击串窗」：按位分账 66f862e，轮①复合零误报 + 轮②真单串 8 行 零漏报，DoD 双向达成 - 销「重建窗内回执排队拖 800ms」：sink 往返喂位 9d90e00，:7003 churn 轮 2200 周期 stall=0、uisn 在途峰从 154s 级收敛到 103ms（阻塞型射程内治愈） - 新增「reconcile 突发饿死 uiTask」：探针轮 3 事件 8 行全 UI 单串 ≥8 连窗、 cf=0 seg=1、uisn=0、uip 在途 1083ms 而 uis 峰 183ms——被拖的是 feed/port 纯计算段墙钟，§11.3 脆弱点 1 首个实测样本；处置并档 E-27/28 批 3 两案并评 证据 = boot_log_data 两 gz（a92baa2 入库）；README 网络行同步 4→3 条目	2026-10-25 20:57:34 +08:00
wandering1	4777ed2373	docs(登记): 大窗销项三条 + 新签名两条 + §4.4 落地注 ... 台架大窗（2026-10-25 15:51-17:00，V5 复跑 + 104 读回 + UI 取图）判读落账： - 登记簿删 N-2（附录 A 结论 6f18f8d + 大窗静默零段）、N-17（修复 a3c6e89： 9 条 stall 行 NET 位全程在场，44/44 旧签名归零；证据 §4.6 + 日志留档）、 N-22（vol_idle_sync 484d068 + V5 全程 0 idle sync FAIL） - 网络表新增两条语义标识（lane-f 定名）：「复合连击串窗」（看门狗全局连击 把多任务各自亚秒抖动误累计成 800ms 停喂，🟦批2.5 修复=按位分账）与 「重建窗内回执排队把 net 等待者拖过 800ms」（UI 睡 portMAX_DELAY 回执， 距 IWDG 最坏余量仅 0.1-0.3s，🟦批2.5 有界化；根治 E-27/28 批 3） - README 网络行改写（4→N-3/N-16 + 两条新）、结构行 4→3、结构债波次线 删已销两项 - 数据可信 §4.4 落地注：CFG_VAL_INT/[run_par] 已实现、5/8 段、系数真源 仍 [adc_cal]、p_cb 未用口径不变	2026-10-25 17:29:16 +08:00
wandering1	15aa08552c	docs(问题记录): 删除项目审查与优化建议报告，结论并入模块文档与编号规范 ... 用户裁定：该报告大部分内容已闭环，可删除；仍有价值的迁到合适文档。删前逐条核对， 确认绝大多数结论在仓内早已有权威副本（LV_DRAW_SW_COMPLEX / osFlagsNoClear / SPI 分频 8 / 分层反向依赖存量基线等），只迁真正独有的四类内容： 1. 暂缓理由与重开条件（三条量化门槛）→ RAM 使用分析与优化方案 §4，并明确「本节是唯一 权威」，其它文档只留指针；同时把 10 处指向报告 §5.3 的重开条件引用改指该节。 2. 2026-10-22「常驻 vs 动态」三项诊断（静态前五块 43,462 B = 58%；动态面只有 heap_4， 故栈余量=CCM 余量；栈深主因是日志/配置写链）→ 同文档 §2.5。 3. `_fp_digits` 1,018 B 删不掉的机理与 F-6 根因修法（Q10 宏改单精度，−332 B，4.49e6 例 逐位等价）→ §2.6.4。 4. 「UI 侧缓冲进 CCM」要按 DMA 可达性二分（LVGL 池可进，帧缓冲/推流缓冲不可）→ 暂缓清单。 编号侧（报告曾是 6 个族的属主登记处）： - 原报告 §9 的 26 行「号 → 现在详述于」对照表迁到 docs/编号规范.md 新增 §4.5，6 族 owner_docs 改指该节。规范正文含大量写法示例，直接当定义集会误伤，故 check_ids.py 新增 `_def_owners`：snapshot_only 族剔除规范正文，只恢复可判定、不参与悬空/撞号/裸形 /紧邻判定（实测若不分，裸形 S1 误报 238 条、S-3 与登记簿 S-3 误判重复定义）。 - 11 个已死号（N-03b/N-10~N-13/N-20/N-21/N-24/N-26/S-1/S-2）在 id_aliases.json 登记 status=void 并写明去处——它们被约 110 处代码注释与文档引用，原先只靠「报告里顺带提过 一句」才算有定义，报告一删就集体悬空。N-21/S-1/S-2 一号两义，注记已分别标明。 - 顺带修 id_aliases.json 的 note 被脚本累积重复 26 次；修 registry 里 3 处仍指向改名前的 任务卡文件名（W1-采集保护收尾.md / W8-数据可信.md），以及 iec104_master.py 两处同类注释。 门禁：check_ids --strict 通过（可判定 8747/10410 = 84.02%，基线由 82.6% 抬到 84.0%）； check_doc_links --all --sections-strict 通过（177 文档）；pre-commit 相关钩子全过。	2026-10-25 02:08:58 +08:00
wandering1	1e6996ecd0	docs(任务规划): 波次号 W1~W8 改为语义名，两个任务卡文件改名 ... 用户裁定：W4 这类字母+数字让人难以理解。W 号看着像执行顺序，实际 W8 排在 W3/W4 之前，读者必须先查表才知道谁先谁后；去掉编号后执行顺序就是 §2.0 表 从上到下，少一层映射。 - 波次改语义名：采集保护收尾 / 数据可信 / 预算与内存 / 结构债 / 验证常态 / UI 扩展 / 仓库决策 - 文件改名（git mv）：W1-采集保护收尾.md → 采集保护收尾.md， W8-数据可信.md → 数据可信.md - 删掉只为编号存在而写的两条注记（W2/W3 槽位保留、W3 不重编号） - 并行分道方案的分支 ID 同步：task/W8-scale-doc → task/cal-scale-doc 等 - 编号登记表：WAVE 族标为废止并关闭悬空检查（属主文档已不再定义 W 号）， C-WAVE / D-WAVE 两族 title 补废止说明 - 同步 15 处跨文档引用（README 文件夹地图、产品需求 §9.2、编号规范 §4.1、 报告 §0.3 波次表、RAM 台账、保护规划变更记录等） - 不动的同形异义：网表 W4.0 封装宽度、芯片手册 W1 载带尺寸、MSVC /W4	2026-10-25 01:44:25 +08:00
wandering1	7048e9cb9a	docs(任务规划): 瘦身为只留待办，波次条目改用语义名 ... 任务规划目录只保留将来要做的事：删掉已完成的证据链与已作废的历史快照， 并把波内条目的 C/D 短码全部换成语义名。 为什么删 C/D 短码：它们同字母不同义——C 组在 UI_界面制作流程.md 里是 UI 设计约束（屏幕/字符集/文本/编码），D 组在控制台单写者日志设计说明.md 与配置文件设计说明.md 里是决策记录。同一串短码在三处指三件事，读的人 只能猜，所以条目一律改用一行短语作标识。 - 排期详述.md 重写为「结构债与验证常态」，条目全语义名，出处列留冻结号 - README.md 删修订记录块（本文件自述不留变更记录），波次行改语义描述 - W1-采集保护收尾.md 67→30 行，只留 M3 送检与 B10 卡 - 基线与待确认.md 73→15 行，删已作废的旧栈表与旧余量数字 - 登记簿.md 逐行收缩到未闭环残余，N-29 的 .git 订正为实测 233 MB - 测试与架构专项.md 删 S1-c（106 例已落地，且被覆盖率总闸覆盖） - 并行分道方案.md 删批 0，修两处会返回 rc=3 的 new 命令形态 - 覆盖率口径：套件 16→33、未挂钩子 12→17、墙钟 25s→67s（实测） - 同步 10 处跨文档引用，指向合并或删除后的新位置	2026-10-25 01:35:21 +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	d4867ddbe2	fix(algo): Q10 定值宏改单精度；收口 Flash 优化簇并更正审查报告三处误判 ... 影响面：一个头文件宏（App/algo/prot_set.h）+ 七份文档口径；固件行为逐位 等价，无功能变化。门禁全绿后提交，未推送。 验证链 - @build：0 错 0 警；Code 213,520 → 213,188（−332 B），RO/RW/ZI 不变。 - 真机 @test PASS：戳 fw build: Oct 22 2026 10:36:15 suite=NONE；无 [ERR]/ERROR/FAIL/Fault；708 ms 到 net init: OK；protect task start、 i104: listening on 2404、[STACK] 三面水位齐。 - 主机单测：prot_set 90/90、prot_elm 47/47、iec104 97/97。 - 等价性穷举：宏内 42 个字面量；int32 全域 ÷1024 往返 4,494,305 例零 差异；×1024 方向 20 万随机 float 零差异（×/÷1024 是 2^10 指数平移， 不产生尾数舍入）→ 定值默认值/上下限、校验和、104 上送值全部不变。 F-6 双精度软浮点（已落地） - 两个 Q10 宏去掉显式 (double)、1024.0 → 1024.0f：保护判据每 20 ms 每 元件 3 次定值读取改走 F407 单精度 FPU，不再软件模拟。 - .map 里 dflti/d2f/f2d/dfixi/fepilogue 共 300 B 消失；自研侧对双精度 helper 的引用归零。 - 更正报告归因：全库 0 处 %f（扫 App/Src/Inc/Drivers 共 173 个 .c/.h）， 剩下 dadd/dmul/ddiv/depilogue/dfixul = 1,018 B 由 MicroLIB printfa.o 的 _printf_core → _fp_digits 无条件引用，只要还用 snprintf 就删不掉； 报告"把 %f 改整数刻度"没有可执行对象。 F-4 LVGL 死代码（判定不做） - 报告列的五项字节数逐字节仍准（合计 10,060 B），但没有一项有开关： 根因是 lv_draw_sw.c 的 execute_drawing() 无条件 switch 引用全部 task 类型，链接器 --remove 无从下手。 - 唯一总开关 LV_DRAW_SW_COMPLEX 被 ui_deco.c 的"浅 V"3 px 粗斜腿依赖 （斜段与其所需 mask 核心都在该开关内）；2026-09-03 已实测失败并把两端 =1 固化 → UI_设计架构.md §1.4 第 7 条。 - 报告原"mask/grad 是文字与矩形绘制必经路径"证伪：字形走 blend 层 mask_buf，不经 lv_draw_sw_mask_*。 - 剩余路线需给 Lib/lvgl 打本地补丁（上限 ≈16 KB），而 Flash 仅占 22.1%、 无 OTA/双镜像预算 → 收益不抵代价；图片链同理不打补丁。 F-5 uvprojx 空 TU（降级为观察项） - 实测 326 个 .c / LVGL 201 个 / .map 零产出 127 个；但增量构建 4~5 s、 空 TU 只在全量重建或改 lv_conf.h 时才重编，且远程 CI 刻意不跑 @build。 - 报告原"编译时长 −40%"无基线记录，不复述；真要做用 Keil 原生 <IncludeInBuild>0</IncludeInBuild>，且排在任何 lv_conf.h 改动之后。 文档与台账 - 审查报告 §0.1/§0.4/§1/注册表/§5.1/§5.4/§6.4/W4 行按实测更正，补 2026-10-22 变更记录行与 F-4/F-6 记录去处行；登记簿 N-28 改写为"三项 已判定、仅剩 F-5 观察项"。 - 更正 FTL 写回缓存旧口径（sys_log_mcu.c 注释、运行与自检记录设计说明 §4.4、实机测试实施指南 §9.1）：f_close 经 sync_fs → CTRL_SYNC → ftl_flush_cache 已落盘，"写另一个文件逼出脏页"不是必要条件；2026-10-02 那次"复位后写入整段丢失"根因是 dhara resume 锚错 checkpoint。 - 部署环境要求 §3.3 资源预算由 2026-09-11 快照刷新为 2026-10-22 实测， 并补 CCM 红线行（旧"SRAM 95.4%/极度紧张"的说法早已失效）。 - ram_baseline.py --update/--write、check_mem_numbers.py --write 已回填： mem-budget（SRAM1 57.4% / CCM 87.9%，阈值 92%）与 mem-numbers 转绿。	2026-10-22 11:03:05 +08:00
wandering1	720f841494	fix(storage): dhara 移植层 is_free 整页精度 + HAL 越界守卫；日志读写批量化 ... 登记簿 N-21（报告 N-12/N-13）与 N-24（报告 N-16）两项未闭环问题修复并销项。 N-12：dhara_nand_is_free() 旧实现只读页首 64 B 判全 0xFF，会把"页首 0xFF、后段有数据"的已编程页误判空闲，dhara 遂往已编程页再编程 = 位碰撞、 journal/map 指向垃圾且不报任何错。改整页扫描（栈上 64 B 分块、页首命中即 早退，故"已编程且页首有数据"的绝大多数页成本与旧实现同价）。 N-13：报告原建议经核对不成立——本仓裁剪版 dhara 既无 DHARA_NO_PAGE（哨兵 实为 DHARA_PAGE_NONE，journal.h:46）也无 DHARA_E_UNSUPPORTED（error.h 枚举 里没有，照抄直接编译失败），且 map.c 三处 dhara_journal_copy 调用点各自已 挡掉哨兵。真风险是移植层零上界校验：越界页号被芯片地址位截断成某个真实页 → 静默读写错页。改为六个 HAL 入口统一几何上界守卫 + DHARA_E_CORRUPT_MAP。 错误码选择是刻意的：BAD_BLOCK 会让 journal.c:904 标坏无辜好块，RECOVER 会 让 map.c:275 启动回收；无错误通道的 is_free/is_bad/mark_bad 一律取保守值。 N-16 写侧：一次排空合并成"每文件一次 open/write/close"（≤8 条 = 512 B 静态缓冲）。掉电语义不变——批次仍在同一次 drain 调用内 close，而 close 回写目录项这个不同 LPN 会把 FTL 单页写回缓存逼出到 NAND；失败尾部回投 队列，条目不丢（旧实现 -2 卷忙会直接丢掉那一条）。容量轮转仍只在按条慢 路径做，批量路径发现装不下一批就返回 -3 退回。 N-16 读侧：s_read_raw() 加 8 条滑动读窗口 + 写者代数失效，API 与 UI 零改动。 验证：@build 0 错 0 警（Code 213,540 / ER_IROM1 232,280 B = 22.2%， RW_IRAM1 75,232 B = 57.4%，ZI +1,640 B 全为静态缓冲、不吃任务栈）； @test PASS，且台架 journal 恢复点与修复前同轨——连续四次启动 sectors used 恒 14,094、Map head 每轮 +128 单调推进、epoch 稳定 3 → 整页 is_free 未 改变恢复语义、无双编程、无回退；stack_report 9 个任务全 PASS（defaultTask 静态最坏链 3,024 B / 余 40%，实测峰值 2,164 B / 余 57%）。 新增主机侧移植层单测 test/host/nand_port/（第 16 个 -unit-test 钩子）： RAM 假芯片 + 真实 dhara map/journal 源，149 断言，含"旧算法只看页首 64 B" 对照用例（将来有人把 is_free 改回去会立刻红）与 dhara 级 resume 双编程计数 为 0 的场景。L0.5 由 15 runner / 955 断言 → 16 runner / 1,104 断言。 文档：存储架构说明 §5.3 加移植层两条硬约束；运行与自检记录设计说明 §4.4/§4.5 写批量化与读窗口；GD5F Trap Records 新增 Trap 07（含三条遗留 代价与一条待办编译期断言）；登记簿 N-21/N-24 删行销项并同步 README §1/§2.0/§2.1、排期详述 C3、报告 §0.1/§0.2/§0.4/§4.x/§7 与去处表； 钩子计数 33→34、主机侧单测 15→16 全库同步。	2026-10-15 12:34:39 +08:00
wandering1	8739faa7fe	docs: 裁定——内存优化簇整簇暂缓（R-2 后半 / R-3 / R-4 / R-6） ... 用户判定"把 LVGL 池与 UI 帧缓冲（现 ≈29.6 KB）搬进 CCM 作为后续 功能预算来源"这个决定不合适，内存优化的事先放一放。据此把这条 主线降级为暂缓，同时明确：不回退已落地的部分，不拆治理面。 报告（docs/问题记录/项目审查与优化建议报告.md）： - §0.2 Top 3 → Top 2：R-2 剩余移出，表下加一条 ⏸ 说明 - §0.3 主线一由"把内存从卡死变富裕"改写为"这条线到此为止" - §0.4 两条内存条目 🟡/❌ → ⏸ 暂缓 - §5.1 结论段与 §5.2 诊断补"不代表现在要动" - §5.3 加暂缓横幅：三条理由（没有功能等这块预算 / 搬迁有风险和 工时 / 收益与代价不对称）+ 保留常开的治理面 + 三条重开条件 - §5.3 表内 R-2 / R-3 / R-4 / R-6 优先级一律 ~~P1/P2~~ → ⏸ 暂缓 - §7 路线图 W3 划掉标暂缓，映射行改为"暂缓期间无验收动作" - 去处表 R-9 行注明"该簇其余部分已暂缓"；变更记录加一条 任务规划：登记簿 N-27 波次 W3 → 暂缓，并写清代价——CCM 只剩 7,904 B、FreeRTOS 堆实测 min_ever 8,464 B，**加任务 / 抬栈 / 加堆 会先在这里撞墙**，届时 mem-budget 会先报警，那就是重开信号。 README §1 结构/健壮性 7 → 6、暂缓块 1 簇 → 2 簇、§2.0 第 3 条 订正（顺带修掉旧值 ≈8,160 B → 实测 7,904 B）、W3 行与 §2.1 链路 图标暂缓、§3 暂缓规则推广到"只在原处标注"的簇。**W3 槽位保留 不重编号**，避免全库改 W4~W7 引用。 内存管理三篇：RAM预算台账 §2 把 UI 超配额改判为"已知长期挂账" （R-2 暂缓后这条 ⚠ 会一直挂着，别每轮当新问题追）、§3 解锁链标 暂缓并去掉"← 现在卡在这一步"；RAM使用分析 §4 加实施状态横幅 （测量与长效机制常开 / 已落地不回退 / 1.2、1.3、2.2、2.3 与 8KB 试探暂缓）、§5 加"别拿目标列当现状"、§6 S5 补 ✅ 2026-10-15、 S6/S7/S8 改暂缓、S9 台账门禁补 ✅、1.5 里"缓冲已迁 CCM"订正为 "实际仍在 SRAM1"；存储栈RAM优化调研加同款横幅（P0-2 / P1-5 / 第三步）。 校验：check_doc_links --all 通过（142 文档、无法判定 0）； check_mem_numbers 与 .map 一致；6 个文件无 BOM/CRLF/U+FFFD。 纯文档改动，不涉及代码与构建，故未跑 @build / @test。	2026-10-15 10:27:02 +08:00
wandering1	a7f526569a	perf(mem): R-9 落地——LVGL 池 40→16 KB，SRAM1 74.9%→56.1% ... 取值依据是实测水位，不是预估：菜单根框 5,368 B、开页-关页往返 5,448 B、最重页面峰值 6,568 B（占 16 KB 的 40%）、真机开机 used=3,192 B。注意 16,384 B 建池后 lv_mem_monitor 报的 total 是 15,020 B（TLSF 控制块与对齐元数据 ≈1,364 B），核算余量用后者。 两端 lv_conf.h 同步改值（lv-conf-sync 生效值比对 163 项 PASS）， Lib/lv_conf.h 的 UTF-8 BOM 已按原样补回（Edit 会静默剥掉）。 验证： - @build 0 错 0 警；ZI 154,456 → 129,880，精确 −24,576 B - SRAM1 98,144/74.9% → 73,568/56.1%（余 57,504 B）；CCM 不变 87.9% - 模拟器菜单回归 PASS（8 状态像素 + 池基线 5,368 B 未变）；11 页 黄金参考逐字节 10/11 一致，往返池水位 5,448 B 分毫未变 - 唯一差异 netcfg_save 保存态：用 40 KB 旧池做 A/B 复测同样失败， 确认与本改动无关（属 506eccc 的 cfg_file 行为变化），未刷黄金 参考掩盖，留给该改动属主处置 - @test PASS：fw build Oct 15 2026 07:31:34，无 [ERR]/Fault， 开机 622 ms 到 net init: OK，menu build done: used=3192 - 本地 CI 全绿（L0 + L0.5，15 runner / 955 断言） - 台账受管区与内存快照区已 --write 回填，mem-budget / mem-numbers 由红转绿 连带结论：R-2 后半待迁体量 54,146 → 29,570 B，瓶颈由 SRAM1 换到 CCM（只剩 7,904 B）；解锁链第 ① 步完成，下一步只差缩堆 56→32 KB （B5 是反向扩容，缩回前须重跑 stack_report.py + 上板 min_ever）。 文档同步 20 处：本报告按修复即销项删除 R-9 行，并改写 §0.2/§0.3/ §0.4/§5.1/§5.2/§5.3/§6.4 与变更记录、去处表；RAM使用分析 §2.6.2 新增实测水位表、阶段 1.1 标已执行；台账 §3 解锁链、登记簿 N-27、 任务规划 README W3 行与链路图；UI 四篇、产品需求、内存内容分配 策略、运行与自检记录、项目部署环境要求、测试开发标准流程、 simulator/README、ui-verify skill 常量。顺带订正三处与脚本不符的 旧值：池水位常量 4784/4864 → 5368/5448、FreeRTOS 堆 48 → 56 KB。	2026-10-15 09:56:15 +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	617c84f570	docs: 文档去阶段化——清理"自愈收敛阶段 / L3 pending / 一期二期"标签 ... 代码注释去阶段化已在 task-arch-docs-sync 分支 d770e36 落地，本次把 同一口径补到文档正文（文末变更记录行作为历史保留不动）。 - BSD 使用指南 / 函数调用关系：删 自愈收敛阶段 N、N-32 P1/P2、 L3 pending、一期二期；职责边界与实现位置改为现状口径 - CH395F_Trap_Records：TRAP-NET-17 / -21 / B10 状态行改述为现行形态 - 链路延迟测试说明：L3 pending → 挂起 recv；P0-a 阶段标签删除 - 模拟器差距清单：N-3 / N-4 / N-6 行改述（对账形态③④、无手动 relisten） - 错误码传播审计：L3 pending → 挂起 recv；"N-4 二期" → N-4 - 任务规划 README / 登记簿 N-4 / 排期详述 C1 / 基线与待确认 §2.1： 一期二期 → recv 挂起已落地 / ACCEPT pending 化（§2.1 标题同步） - CH395F_Test_Guide：阶段 15 标题去掉撞名的"自愈收敛阶段 2" - IEC104 上行设计说明：门控迁移改现状口径；"随二期" → 未登记具体条目 - 保留可检索锚点：TRAP-NET-*、E* / U* / D10、形态③④、N-4、Phase 15 门禁：check_doc_links.py --all 通过（143 文档、可判定章节引用 1282 处、 0 错 0 警）；check_mojibake 全过；CR=0、U+FFFD=0、无 BOM 变化。 本轮只改 .md，无代码改动，故不跑 @build。	2026-10-14 23:05:17 +08:00
wandering1	0edbfaf08b	fix(NET): 监听重建单一所有者收口 + 沉降窗 800ms 上限只留痕 ... T0 降噪 + T1 单一所有者：四处重建触发（recon/accept/eof/drop）与 pending 第五处统一走 net_listener_request()，由 net_listener_tick 单点执行； 沉降重试日志改"只留首末"（E0 口径），每次恢复少打 3 行重复行。 force open 降级为只留痕（E19 反事实 A/B 实测）：芯片未回 CLOSED 时强行 open 注定吃 USE 错（TRAP-NET-09），放行与不放行的端口恢复时刻同一分布 （放行 +512 / 不放行 +505·533 / 降级后 +509 ms）——恢复由芯片何时回 CLOSED 决定。真正兜住"监听器永久失效"的是 D10 预算到期 + 对账形态④ 重新登记，不是放行。新增 s_relisten_capped[] 使上限留痕只打一次， 隔离标志不清 → 下一轮继续排空残渣（构建 B 实测每 30ms 两行会刷屏）。 负向注入三轮打靶（E18，注入代码不入库）：形态① 吞掉 DISCONNECT 后 4/4 救回、③ 空闲监听器静默失位两轮独立复现、⑤ 开盲区吞掉芯片自发中断 + 收回 LISTEN 后 -> resync 命中且挂起 recv 被取消 → 三条均不可降级为 只留痕。顺带稳定复现 [ERR] relisten retry budget exhausted = 对端不配合 拆链的签名，非回归。 台架：boot PASS；ftp_abort_probe RST 10/10 + FIN 5/5；relisten_stress :21 50/50（p50 507ms）；n30_repro 30/30。构建 0 错 0 警 Code=212316； netTask 静态最坏链 1920→1912 B；RAM 台账受管区已 --write 同步（RW +8B）。 文档：E17/E18/E19 三行 + §4.1 常态 0 命中归因 + §4.3 兜底归属改正； 登记簿 N-31 销项（结论沉淀进 §4.3 与 E19）。	2026-10-14 15:57:10 +08:00
wandering1	f849c79b7a	feat(NET): SEND pending 二期落地 + 末块挂起越界缺陷修复（台架复测闭环） ... net_pending.c/h 增设第二张挂起表 s_net_send[]（与 recv 表完全独立，收发 互不阻塞）；net_send_locked 快速路径改为有界自旋，单次等待超出 NET_SEND_SPIN_MS(2ms) 即登记挂起 send，由 net_send_pending_tick 按主循环 节拍分块推进，netTask 最坏停滞由 1s 压到 2ms。net_listener_retry_tick 的 挂起保险扩展到 send 侧；net_close_locked / 网络重建 / 状态对账三路均先 取消再动作（取消必通知，调用方永不挂死）。 台架复测（A/B 对照 + 插桩定位）发现并修复末块挂起越界缺陷：内层"等本块 发完(SENBUF_FREE)"位于写块之后，写完末块时 sent 已 == len，若该次等待越过 2ms 预算便会调用 net_send_pending_register，而登记函数按 sent >= len 拒收 并回 -1，把一次实际已完整交付芯片的发送报成失败。修复为内层等待开头判 sent >= len 即跳出（末块已交付、SENBUF_FREE 等待是纯保守自旋），并置于 超时/自旋判定之前；该守卫同时保证后续登记必伴随 sent < len。 复验：ftp_regression 连续 19 次 11/11；ftp_integrity_test 20 轮 x 64KB STOR/RETR SHA-256 20/20 一致（两轮），吞吐稳定约 80KB/s；设备日志零 write error；ST-LINK 回读 No difference found。 文档：Net层阻塞模型架构设计.md 补二期设计与新增 9.1 缺陷记录，netTask 栈实测峰值按本次台架 920B 订正为 1116/3840（FTP 传输期 1164）；网络自愈 架构设计.md 吸收原监听生命周期文档、新增编号术语导读表，并把 5.2 "实验锚点速查"的 E 编号含义与 E-02 审计编号歧义写在表头（用户反馈该表 E 编号无法读懂）。 门禁：Keil 0 错 0 警；cppcheck / 编码规范 / 乱码零告警； check_mem_numbers PASS；check_doc_links --all --sections-strict 142 篇 PASS。	2026-10-14 12:05:21 +08:00
wandering1	491dd031f1	docs(任务规划): N-32 销项——监听生命周期根治已在 N34 全量落地 ... - 登记簿删 N-32 行：P1（`session_dead` 电平）/P2（单一重建所有者）均已 实施转正；pump 于 N34 阶段 3 并入 `net_reconcile_tick` 形态③④ - 结论沉淀核对齐备：设计文档 §10（已执行）+ D1~D10、N34 实施方案阶段 0~3、 陷阱记录 B10 行（✅ 已修 + `net_drop_conn` 根治出口） - 设计文档勾掉两条 N-32 时代遗留清单项：U11~U15 实际落点=N34 机制盘点 + E6 观察项；B10 行 2026-10-13 复核在位 - N34 README 提交表补终笔 `925058a` 行 - 正文其余 N-32 引用均为架构溯源名（pump/不变量 I），不动 - 门禁：`check_doc_links --all` 149 文档通过；ci_local L0+L0.5 全绿	2026-10-13 21:50:48 +08:00
wandering1	8cd815d046	docs(ram): N-33 销项回填——台账登记抬栈 +1536 B，M1 台架闭环达成 ... - RAM预算台账 §6：defaultTask 1024→1280 / timeSyncTask 512→640 words， 堆内用量 +1536 B（配额 56 KB 不变）；min_ever 预算 8464 = 实测吻合 - RAM使用分析 §2.3：N-33 注记 + 表更新（default 3016/2104 41%、 timeSync 1264/1296 50%、netTask 复测 1944（N32 监听模块化后链）、 adcTask 复测 1320） - Src/freertos.c 栈注释：netTask 1872→1944、adcTask 补 2026-10-12 复测值 - W1 卡：N-33 销项删行；M1 判据全满足 ✅ 达成；mermaid 台架道清空、 M1((✅))；B8/B9 行转 🟦（worktree 进行中，方案已审） - 登记簿：N-33 行删除（证据已沉淀两份内存文档 + W1 卡 §1 指针） - 合并侧已完成：merge c95a9cd（done N33，9 任务 0 FAIL + @test PASS） - 验证：doc-links 全绿（142 文档）	2026-10-12 18:36:04 +08:00
wandering1	dafcf8098b	test(b6): 台架 @test 闭环复测收口 + 启动行门控修复 + PC 104 主站 ... B6 台架 @test 闭环复测（B4/B5 验收窗口）完成，DoD 全判据过。 门控修复（首跑 FAIL 实锤的 B5 遗留竞态）： - 现象：protect task start 锚点行字节级交错损坏 （st[art: cycle=220ms elm=70，两次开机同形复现） - 根因：启动行在控制台写者注册前打印走无锁裸发，与 defaultTask 启动日志交错——违反 2026-10-10 门控纪律 （控制台单写者日志设计说明.md §3.4，adcTask 同款先例） - 修复：启动锚点行改 dbg_console_writer_ready() 首拍补打 台架与工具： - .serialtest/config.json：Required 增 protect task start / i104 listening on 2404 / [STACK] protect|iec104|heap - test/host/iec104_master.py：纯标准库 104 主站客户端 （STARTDT→总召四组+actterm→C_SE 两段写触发 YX15/16 变位 COT=3→恢复复归→YK11 两段正答→C_RD 读回），往返 18/18 PASS（d3107f3 与 B7+fix 两版固件） - 复测 @test PASS：锚点完好 +577ms、9/9 Required、零 [ERR]、 回读一致；protect free_min 1220（59%）、iec104 2136（83%）、 新 56KB 堆 min_ever=10000（N-33 抬栈背书就绪） 证据与文档回填： - boot_log_data 四份快照（含缺陷复现 MISS 件）+ README 登记 - 保护规划 §7 B6 行（B5 台架遗留闭环）；控制台单写者 §3.4 纪律示例 + §11 变更记录；IEC104 §7/§8 主站工具就绪； W1 卡 B6 ✅ + N-33 背书 + B7 台架腿注；登记簿 N-33 - 内存台账：+16 B 构建后 ram_baseline/check_mem_numbers 回填 验证：@build 0 错 0 警（Code=205516）；ci_local 全绿 （L0 30 钩子 + L0.5 13 套件 826 断言）。	2026-10-12 16:31:33 +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