docs(规划): 删 §0.3 内存主线复述层，记录 W6 UI 簇启动与并行度约束
§0.3 第 1 条「内存这条线到此为止」是同日暂缓裁定的**复述层**，同一事实已有 三处单点详述（§0.4 内存两行、§5.3 暂缓横幅、登记簿 N-27 与内存管理两份文档 的横幅）。按「同一事实只在一处详述」删复述、留权威。§0.3 现只剩 UI 一条 主线；标题「两条主线建议」→「主线建议」，**编号不变**（任务规划 README §2 前言引用的是编号不是标题）。上一条变更记录里「内存簇暂缓 → §0.3 主线一」 这个去处自此失效，以本次新增行记载为准——变更记录本身是历史，不回改。 启动 W6：用户裁定**覆盖** 2026-10-11 的「本轮不排期」，按覆盖记录而非静默 改掉。已把 U1~U5 拆成 5 个工作包上共享任务板，第一波 U1 令牌层 ∥ U4 门禁 补强两名成员并行，写范围严格不相交。 并行度的真实约束已写进文档：不是任务数量，而是**注册文件**——新增一个 .c 必须同时改 uvprojx 与 CMakeLists.txt 这两个共享文件，同一工作树里两人同改 必然互相踩。所以 U3（原型化 + 生成器）是必须串行的地基段，U2/U5 排在它 后面；U5 的页面批量要等 U3 把注册自动化之后才谈得上并行。 修正两处失真：① 交付物清单里移植层单测还写着拟名 `test/host/dhara/` ❌ 未建，实际落地为 `test/host/nand_port/`（149 断言、第 16 个 -unit-test 钩子）→ ✅；② 报告称「27 页未落地」实为**目标页数**，现存 `ui_page_*.c` 实测只有 7 个，已在 §6.5 注明 U5 开工前先对齐目标/已实现差集，不要照抄 报告数字。 check_doc_links --all：142 篇、无法判定 0。
This commit is contained in:
+1
-1
@@ -103,7 +103,7 @@
|
||||
| **W3 预算与内存** | ⏸ **整簇暂缓**（用户裁定 2026-10-15）：~~缩堆 56→32 KB → R-2 后半（29.5 KB→CCM）→ R-3 / R-4 / R-6 逐项评估~~。本簇已落地的只有 **R-9 ✅（2026-10-15）**；R-5 已判定不可行 | **不再排期**：没有功能在等这块预算，而搬迁要动 scatter、要逐条过 DMA 可达性清单、缩堆还要上板复测。**W3 槽位保留、不重编号**（避免全库改 W4~W7 引用）。重开条件 → `../问题记录/项目审查与优化建议报告.md` §5.3 |
|
||||
| **W4 结构债** | **C6（S-3）→ C3（N-2）→ C1 net 层跨上下文收口 → C5（含 N-23 残余）→ N-22/N-25/N-28**（详表 `排期详述.md` §1） | 无紧急，按性价比排：C6 灭 IWDG 误复位机制根源；C1 消化 E-25/E-27/E-28（原 ACCEPT+SEND pending 化已收口），体量大、验证重，放后（N-23 钩子已落地 2026-10-12，残余并入 C5）。⚠ 原挂 C3 的 **N-24（日志逐条开关）已于 2026-10-15 单独修复销项**，C3 只剩 N-2 观察项 |
|
||||
| **W5 验证常态** | P1-10 收尾 · T-7 CI · D2 N-3 · D5 N-16 · D6 N-17 · D7 串口助手 · S12 · S1-c · A-5（详表 `排期详述.md` §2） | 窗口性，逢机顺带，不单独排期 |
|
||||
| **W6 UI 扩展** | U4 残余（golden + 字符集差集挂门禁）→ U1 令牌层 → U2/U3 → **27 页**落地 | 产品驱动、体量大，需单独立项（顺序按 `docs/问题记录/项目审查与优化建议报告.md` §6.5）；**本轮不排期（2026-10-11 已确认）** |
|
||||
| **W6 UI 扩展** | U4 残余（golden + 字符集差集挂门禁）→ U1 令牌层 → U2/U3 → **27 页**落地 | 产品驱动、体量大，需单独立项（顺序按 `docs/问题记录/项目审查与优化建议报告.md` §6.5）。**2026-10-15 用户裁定启动**（覆盖 2026-10-11 的「本轮不排期」）：已开智能体团队，第一波 **U1 令牌层 ∥ U4 门禁补强** 并行进行中；U3 为地基串行段（独占注册文件），U2/U5 排在 U3 之后 |
|
||||
| **W7 仓库决策** | **N-29** `.git` **235 MB** + 图片 36.3 MB | **已决策（2026-10-11）：暂不处理、登记观察**——推送/协作前重评（`git filter-repo` 历史重写影响未推送提交与协作者） |
|
||||
| **暂缓** | **B2 RS-485 整簇**（`暂缓-RS485.md`） | **用户决定（2026-10-12）：当前不处理 RS-485** |
|
||||
| **硬件改版** | N-18 8 路电气量全接 TPAFE（V0.2） | 下一版硬件；固件侧已用语义映射隔离，改版只动映射表 |
|
||||
|
||||
@@ -30,12 +30,11 @@
|
||||
| Flash 使用 | **A−** | F-1/F-2/F-3 落地省 64,576 B → 占用 **22.2%（232,280 B）** | F-4/F-5/F-6 ≈10 KB + 编译时长（§5.4） |
|
||||
| UI 标准化 | **B** | golden 回归已建（`simulator/tests/` 四脚本，含池水位门禁） | 无令牌层 / 无组件库 / 无页注册表（手写 `case` 仍在）、**27 页**未落地、golden 与字符集差集未挂门禁（§6） |
|
||||
|
||||
### 0.3 两条主线建议
|
||||
### 0.3 主线建议
|
||||
|
||||
> **推进顺序的唯一权威是 [`../任务规划/README.md`](../任务规划/README.md) §2**；本节只是体系评审视角的两条结构性建议，不另立顺序。
|
||||
> **推进顺序的唯一权威是 [`../任务规划/README.md`](../任务规划/README.md) §2**；本节只是体系评审视角的一条结构性建议，不另立顺序。
|
||||
|
||||
1. **内存这条线到此为止**（用户裁定 2026-10-15，**覆盖本报告的原建议**）：R-9 已把 LVGL 池 40→16 KB、SRAM1 降到 **57.4%（余 55,840 B）**，够用了。原建议的"缩堆腾 CCM → 把 LVGL 池与 UI 帧缓冲（现 ≈29.6 KB）搬进 CCM 作为后续功能预算来源"**整簇暂缓，不再作为主线**——没有功能在等这块预算，而搬迁要动 scatter、要逐条过 DMA 可达性清单、缩堆还得上板复测，收益不抵风险与工时。**保留的是治理面**（92% 门禁 + 台账 + 趋势 + 栈/堆观测）：它会在真正吃紧时自动报警，届时再按 §5.3 的重开条件评估，而不是现在预先腾预算。
|
||||
2. **把 UI 从"每页手写"变"声明 + 原型库"**：令牌层 → 原型库 → 生成器补全注册 → golden 入门禁，使新增一页的成本从 8 处手工改动降到 1 处声明（§6）。
|
||||
1. **把 UI 从"每页手写"变"声明 + 原型库"**：令牌层 → 原型库 → 生成器补全注册 → golden 入门禁，使新增一页的成本从 8 处手工改动降到 1 处声明（§6）。
|
||||
|
||||
---
|
||||
|
||||
@@ -549,7 +548,7 @@ const ui_page_desc_t ui_page_deadzone = UI_FORM_PAGE("遥测死区", s_items_dea
|
||||
| U4 | golden + 字符集检查 + 注册检查入 pre-commit | 三个新 hook 全绿 | 🟡 **1/3 落地**：golden 已建；❌ 字符集差集、❌ 注册检查未入门禁（注册检查钩子已存在，缺的是把它算作 UI 门禁的一环） |
|
||||
| U5 | 用原型批量落剩余 **27 页**（每页 ≤30 行） | 菜单树全绿、无 `CONTENT_PAGE_COUNT` 哨兵命中 | ❌ 未动 |
|
||||
|
||||
> **本轮不排期**（2026-10-11 已确认，登记簿 U 簇 / W6）：等功能主线出结果后按产品需求启动；U4 残余（两脚本入门禁）可逢窗口顺带。
|
||||
> ✅ **2026-10-15 用户裁定启动**（覆盖 2026-10-11 的「本轮不排期」，登记簿 U 簇 / W6）：已开智能体团队推进。**并行度受注册文件约束**——新增一个 `.c` 必须同时改 `MDK-ARM/STM32F407-Demo.uvprojx` 与 `simulator/CMakeLists.txt` 这两个共享文件，所以任何时刻只允许一个成员碰它们。实际排法：**第一波 U1（令牌层，不新增 .c）∥ U4 残余（只动 scripts/ 与门禁文档）真并行** → U3（原型化 + 生成器，独占注册文件，串行段）→ U2 → U5（页面批量，须等 U3 的生成器把注册自动化，否则无法并行）。⚠ 本节原写「27 页」是**目标页数**，现存 `ui_page_*.c` 实测只有 **7 个** → U5 开工前先对齐目标页清单差集。
|
||||
|
||||
---
|
||||
|
||||
@@ -562,14 +561,14 @@ const ui_page_desc_t ui_page_deadzone = UI_FORM_PAGE("遥测死区", s_items_dea
|
||||
| ~~**W3 预算与内存**~~ ⏸ | **整簇暂缓（用户裁定 2026-10-15）**：R-9 ✅ 已落地不回退；R-2 后半 / R-3 / R-4 / R-6 不再排期 | 暂缓期间**无验收动作**；`mem-budget` 92% 门禁与台账、趋势、`stack_report.py` / `ram_report.py` 观测**照常跑**（它们是判断何时重开的输入）→ 重开条件见 §5.3 |
|
||||
| **W4 结构债** | N-14、F-4/F-5/F-6、S-1/S-2/S-4/S-5；`rs485_task.c` 随 B2 出注册白名单 | `--strict` 默认化；`bsp_err_t` 进规范 |
|
||||
| **W5 验证常态** | P1-10 收尾（构建实测链接 + `@test` 闭环） | 逢窗口顺手做 |
|
||||
| **W6 UI 扩展** | U4 残余 → U1 → U2/U3 → U5（27 页） | 新增一页 ≤30 行；**本轮不排期** |
|
||||
| **W6 UI 扩展** | U4 残余 → U1 → U2/U3 → U5（27 页） | 新增一页 ≤30 行；**2026-10-15 启动**（见 §6.5 注） |
|
||||
| **W7 仓库决策** | D-1（登记簿 N-29） | **已决策暂不处理**；推送/协作前重评 |
|
||||
|
||||
### 交付物清单（可直接排期）
|
||||
|
||||
| 交付物 | 类型 | 来源条目 | 状态 |
|
||||
|--------|------|---------|------|
|
||||
| `test/host/dhara/`（移植层单测） | 主机侧单测 + pre-commit hook | N-12/N-13 | ❌ 未建——**这是唯一能防住"同类缺陷再犯"的手段** |
|
||||
| `test/host/nand_port/`（dhara 移植层单测） | 主机侧单测 + pre-commit hook | N-12/N-13 | ✅ **已建（2026-10-15，提交 `720f841`）**——原写 `test/host/dhara/` 是拟名，落地为 `nand_port/`。149 断言 / RAM 假芯片 / 真实 dhara map+journal 源 / 含"旧算法只看页首 64 B"**对照用例**，已挂为第 16 个 `-unit-test` 钩子。**这条正是"防同类缺陷再犯"的手段，现已到位** |
|
||||
| `Drivers/BSP/UI/ui_tokens.h` | 令牌层 | U1 | ❌ 未建 |
|
||||
| `Drivers/BSP/UI/ui_w_{list,kv,records,form,msgbox,title}.{c,h}` | 组件库（需双端注册） | U2/U3 | ❌ 未建 |
|
||||
| `tools/menu_gen/gen_menu.py` 扩展 + `ui_page_registry.c` 生成 | 生成器 | U3 | ❌ 未建 |
|
||||
@@ -630,6 +629,8 @@ const ui_page_desc_t ui_page_deadzone = UI_FORM_PAGE("遥测死区", s_items_dea
|
||||
| **2026-10-15** | **裁定：内存优化簇整簇暂缓** | 用户判定"把 LVGL 池与 UI 帧缓冲（现 ≈29.6 KB）搬进 CCM 作为后续功能预算来源"这个决定不合适，内存优化的事先放一放。据此：§0.2 **Top 3 → Top 2**（R-2 剩余移出名列，表下加一条 ⏸ 说明）；§0.3 主线一由"把内存从卡死变富裕"改写为"**这条线到此为止**"；§0.4 两条内存条目 🟡/❌ → **⏸ 暂缓**；§5.1 结论段与 §5.2 诊断 1 补"不代表现在要动"；**§5.3 加暂缓横幅**（三条理由 + 保留常开的治理面 + 三条重开条件），R-2 / R-3 / R-4 / R-6 优先级列一律 ~~P1/P2~~ → **⏸ 暂缓**。**已落地的 R-9 不回退**（−24,576 B 是净收益且已台架验收）；`mem-budget` 92% 门禁、预算台账、趋势基线、栈/堆观测**全部保留常开**——它们是传感器，不是优化动作。同步 `../任务规划/登记簿.md` N-27、`../任务规划/README.md` W3、`../内存管理/RAM预算台账.md` §3、`../内存管理/RAM使用分析与优化方案.md` 阶段 1.2 / 2 |
|
||||
| **2026-10-15** | **执行本报告条目：N-12 / N-13 / N-16 落地并销项** | **N-12**：`dhara_nand_is_free()` 改整页扫描（栈上 64 B 分块、页首命中即早退，成本与旧实现同价）。**N-13：本报告原建议经核对不成立，已按实际契约改修**——本仓裁剪版 dhara 既没有 `DHARA_NO_PAGE`（哨兵实为 `DHARA_PAGE_NONE`，`journal.h:46`）也没有 `DHARA_E_UNSUPPORTED`（`error.h:20-31` 枚举里没有，照抄直接编译失败），且 `map.c` 三处 `dhara_journal_copy` 调用点各自已挡掉哨兵（`map.c:260`、`:434`+`:440`、`:242`）；真风险是**移植层零上界校验**（越界页号被地址位截断成真实页 → 静默读写错页），故改为六个 HAL 入口统一几何上界守卫 + `DHARA_E_CORRUPT_MAP`（不能用 `BAD_BLOCK`：`journal.c:904` 会据此标坏块；不能用 `RECOVER`：`map.c:275` 会据此启动回收）。**N-16**：写侧一次排空合并成"每文件一次 open/write/close"（≤8 条 = 512 B 静态缓冲；**掉电语义不变**——批次仍在同一次 drain 内 close，close 回写目录项这个不同 LPN 会逼出 FTL 单页写回缓存；失败尾部回投队列，条目不丢）；读侧 8 条滑动窗口 + 写者代数失效（API 与 UI 零改动）。**刻意不批量**：`sys_log_evidence()` 的 `wdev.log` 仍逐条落盘——取证路径要求立刻进 NAND 并靠 flush 诱导逼出脏页。**验证**：`@build` 0 错 0 警（Code 212,344→**213,536**、ZI 129,880→**131,520**，+1,640 B 全为静态缓冲，不吃栈）；`@test` PASS 且**台架 journal 恢复点与修复前同轨**（`sectors used` 恒 14,094、`Map head` 每轮 +128 单调推进、`epoch` 稳定 3 → 整页 `is_free` 未改变恢复语义、无双编程）；`stack_report.py` 9 个任务全 PASS（defaultTask 静态最坏链 3,024 B / 余 40%，实测峰值 2,164 B / 余 57%）；新增主机侧移植层单测 `test/host/nand_port/`（假芯片 + 旧算法对照用例）。实施记录 → `../架构设计/STM32F4-Base存储架构说明.md` §5.3、`../子系统设计/运行与自检记录设计说明.md` §4.4/§4.5 |
|
||||
| **2026-10-15** | **删除 §0.2「未闭环问题」小节** | Top 2 修复销项后该节只剩指针与暂缓说明，而三条内容都已在别处**单点详述**：未闭环清单 → §0.4；内存簇暂缓 → §0.3 主线一与 §5.3 横幅；Top 2 修复证据 → 上一条变更记录与文末「已销项条目的记录去处」。按 `../文档规范.md`「同一事实只在一处详述」删除，不留空壳。**§0.3 / §0.4 编号保持不变、不重排**——`../任务规划/README.md` §2 前言引用本报告 §0.3，本报告内部另有 §0.4 交叉引用，重排会全断（与本表 2026-10-14 行第 ⑤ 条"报告自有编号不回改、不重排"同一口径）。文首「销项状态」行的指针由「§0.2 / §0.4」改为「§0.4」 |
|
||||
| **2026-10-15** | **删除 §0.3 主线建议第 1 条（"内存这条线到此为止"）** | 该条是同日暂缓裁定的**复述层**，同一事实已有三处单点详述：§0.4 内存两行（⏸ 暂缓）、§5.3 暂缓横幅（三条理由 + 保留常开的治理面 + 重开条件）、登记簿 N-27 与 `../内存管理/` 两份文档的横幅。按 `../文档规范.md`「同一事实只在一处详述」删复述、留权威。⚠ 上一条变更记录里"内存簇暂缓 → §0.3 主线一"这个去处**自此失效，以本行为准**（变更记录本身不改，它是历史）。§0.3 现只剩 UI 一条主线；标题「两条主线建议」→「主线建议」，**§0.3 编号不变**（`../任务规划/README.md` §2 前言引用的是编号不是标题） |
|
||||
| **2026-10-15** | **启动 W6 UI 标准化簇**（用户裁定，覆盖 2026-10-11 的「本轮不排期」） | §0.3 删掉内存主线后只剩 UI 这一条，随即启动。已按 §6.5 的 U1~U5 拆成 5 个工作包上共享任务板，第一波 **U1 令牌层 ∥ U4 门禁补强** 两名成员并行（写范围严格不相交：U1 只写 `Drivers/BSP/UI/` + `App/task/ui_task.c`，U4 只写 `scripts/` + 门禁与规范文档）。**并行度的真实约束不是任务数量，而是注册文件**：新增 `.c` 必须改 `uvprojx` + `CMakeLists.txt` 两个共享文件，同工作树两人同改必互相踩，故 U3（生成器/注册表）是必须串行的一段，U2/U5 排在它后面——U5 的页面批量要等 U3 把注册自动化之后才谈得上并行。同步 §6.5 注与本表 W6 行；`../任务规划/README.md` §2.0 W6 行同步。另修正交付物清单：移植层单测拟名 `test/host/dhara/` 实际落地为 `test/host/nand_port/`，状态 ❌ → ✅ |
|
||||
| **2026-10-14** | **清理：删除已完成与过时内容** | ① **已修复项按销项删除**（去处见下表）：N-02（FTP 鉴权）、N-03c（`Error_Handler` 降级）、**N-11（DMA 可达性三层防线 + 规则族 R1~R4）**、S-3（注册反向校验）、P2-5/P2-6（SD2506 负温度与 WRTC）、P2-8（`NET_RECV_TIMEOUT_MS` 已删）、P2-9（`mkdir` 幂等重试）、§5.5 前三条（内存治理三件套）、交付物清单已建项。② **删除过时层**：2026-09-16 / 2026-10-11 双列基线表与"复核期间未提交改动"口径说明、旧"组合结果预估"表、逐条"2026-10-11 复核"批注、历史变更记录行——内存数字改由 `../内存管理/RAM预算台账.md` 与 `scripts/ram_baseline.tsv` 持有。③ **按 2026-10-14 `.map` 与代码重测**全部保留结论的数字（含 `lftpd_log.c` 已删除并入 `lftpd_auth.c`，N-06 残余只剩 `rs485_task.c` 一条刻意缺口）。④ **修正三处错误**：R-5（`configMAX_PRIORITIES` 56→32）**判定不可行**（CMSIS-RTOS2 `#error`）；原 §7 把报告 S-5（驱动统一错误码）与登记簿 S-5（卷锁覆盖面）混为一谈；原 §5.5 第 4 条建议的 `_Static_assert` 形态在 AC5 上取不到链接期地址，已被"窗口断言 + 启动自检 + 运行时守卫"三层取代。⑤ 报告自有编号**不回改、不重排**（`../编号规范.md`） |
|
||||
|
||||
### 已销项条目的记录去处
|
||||
|
||||
Reference in New Issue
Block a user