Files

T

wandering1 c121eb9773 docs(任务规划): 复核菜单树叶数（42 节点 / 33 叶 / 已绑 21 / 未绑 12）并写清判定方法

按 ui_menu_tree.txt 用生成器自己的解析器（tools/menu_gen/gen_menu.py 的
parse_tree）重算：节点行 42、叶 33、已绑 #page 21、未绑 12；与生成物
UI_MENU_TAB_COUNT=42、UI_PAGE_MAP_COUNT=21 逐项对上。两份规划文档现有的
33/42/21/12 表述全部成立，故只补判定方法与复核命令，不改数字。

原 §1 写「重算方法见本节末」是悬空引用——§1 末尾并没有这一段。本次补
「叶数判定与复核」子节：节点行定义（非空、非注释行）、叶的缩进判据
（等价 ui_menu_tab_has_children==false）、#page 绑定判据、可重跑的复核
命令与预期输出，并记下三个错算法：把 42 个节点行当叶（多算 9 个菜单）、
grep -c 取 #page= 得 22（文件头注释里的示例字样也被算入）、按叶子名去重
得 29（参数/定值/控制字/软压板 在「整定」「查看」下各一份）。

README §1 同批加方法指针。只改这两份文档，未动代码与生成物，未推送。

2026-10-27 07:45:11 +08:00

5.6 KiB

Raw Blame History

任务规划

现在只做 UI 补齐。剩余三项按表序单道推进：通讯设置 → 记录 5 页 → 运行报告。 详细任务与验收见 UI补齐.md；UI 完成后的第一项是 net 层跨上下文收口。

怎么用这份规划

你想知道什么	只看哪个文件
现在做什么、接下来做什么	本文件
当前任务怎么做、怎样算完成	`UI补齐.md`
UI 之后还有什么、哪些事在等条件	`登记簿.md`
ADC 标定为什么没做、保护为什么不动作	`数据可信.md`
RS-485 为什么冻结、重启要满足什么	`暂缓-RS485.md`
测试与架构还剩什么约束	`测试与架构专项.md`

一件事只有一个归属。 本文件只负责导航与顺序，不复制各任务的验收明细； 登记簿.md 不再复制当前 UI 任务，数据可信.md 的其余章节是被代码引用的设计约束，不是额外待办。

0. 条目与引用规则

新条目使用语义短语，一行直接说清是什么事，不再新增字母加数字编号。
旧编号只用于追溯历史，不复用、不重新发号；编号族与冻结规则见 docs/编号规范.md。
引用条目时写清所在文档和语义名，例如：docs/任务规划/登记簿.md 的「net 层跨上下文收口」。不要只写一个短号让读者猜。
任务状态只维护在任务所属文件；本文件不另建一套状态表。

1. 当前执行：UI 补齐

菜单树共 33 叶（节点行合计 42）：按行内 #page= 实测已绑 21 叶、未绑 12 叶（2026-10-27 复核，判定规则与重跑命令见 docs/任务规划/UI补齐.md §1「叶数判定与复核」）。未绑里 7 叶纳入当前执行 （通讯设置 1 + 记录 5 + 运行报告 1），另外 5 叶因缺少开入硬件、录波模块或 SNTP 产品定义而不做。装置维护 3 页与遥测死区/系数 2 页已于 2026-10-27 落地入库。唯一执行清单见 UI补齐.md。

顺序	要做的事	交付结果
1	通讯设置	`[comm]` 段与端口真源已在库，还差页面与「重启生效」真机判据
2	记录 5 页	事故、操作、保护告警、保护启动、遥控记录有写入方并可查看
3	运行报告	上电次数、运行时长、复位原因、104 统计

执行纪律：单道串行。 菜单树与页面注册表是生成物，字库也是整文件生成物；不要同时开多条 UI 页面分支。上板验证可累积成一批，但保存、重启、主站读回等判据不能删除。

2. 全项目推进顺序

本节是全项目唯一的顺序权威。模块文档只描述局部设计，不另排一套路线图。

2.0 顺序表

顺序	工作	当前状态	开始或切换条件
1	UI 补齐	当前执行	已开始；剩余 3 项按 §1 的 1→3 顺序推进（原第 1、2 两项已落地）
2	net 层跨上下文收口	下一步	UI 当前清单完成后；裸指针收口与 reconcile 突发饿死 uiTask 同批评估
3	其余结构与可靠性评估	排队	net 收口后；逐项见 `登记簿.md`，观察项不为了“清清单”而强做
4	数据可信剩余三项	等待台架或外部资源	已知电压注入 → 端子变比 → 标准源两点标定；资源到位可插入优先处理
5	标准源送检与第三方 104 主站验收	等待标定完成	两点标定完成且保护 VALID 已置位；送检窗口前 2 日冻结特性
6	保护元件与采集增强	等待标准源或硬件改版	保护先解除未标定闭锁；三相同时刻类功能等 V0.2 硬件
7	验证窗口事项	逢条件顺带	CI runner、PC peer、CH340、负向故障注入条件到位时执行
8	独立模块与暂缓项	当前不排	开入开出、故障录波、SNTP 单独立项；RS-485 与内存优化按各自重启条件

2.1 关键依赖

UI：写路径、整定 4 页、装置维护 3 页与遥测死区/系数 2 页已收口（含上板判据与真机回读）；菜单树、页面注册表与字库都是生成物，同刻只允许一条道写。
送检：已知电压注入 → 端子变比确认 → 标准源两点标定 → 保护解除闭锁 → 送检。
保护扩展：标准源未到位前不新增无法验证的判据；跨转换器相位、功率、对称分量类功能必须等 V0.2 硬件。
结构债：UI 完成后先做 net 收口；RS-485 白名单、内存优化、仓库体积等观察项不抢占当前编码道。

3. 维护约定

完成即删除待办条目，同时清理其他文档对它的引用；结论和证据写入模块文档，历史由 git log 保留。
当前任务只改 UI补齐.md，后续事项只改 登记簿.md；顺序变化才改本文件 §2。
数据可信.md 的 §2、§4、§7~§10 仍被代码头注释引用为设计依据，不能按“已完成” 删掉；其待办只认 §5 的三项。
测试与架构专项.md 的断言与体积门禁章节仍是代码和门禁的规格锚点，即使事项已完成也不能删；当前未闭环的只有 RS-485 侧采集链路测试约束。
任务分支不直接修改 docs/任务规划/**；状态更新与销项由主工作树统一处理。
并行开发机制、工作树和锁的使用见 docs/环境与部署/并行任务工作树方案.md。本文件夹不再另维护一份分道、批次和写域方案。
暂缓不是完成：条目必须保留重启条件；没有重启条件的“以后再说”应写成观察项或删除。

5.6 KiB Raw Blame History Unescape Escape