提交后台跑 scripts/ci_local.py 时 end-of-file-fixer 报 Failed 并就地修复: 17 篇补文件末尾换行、1 篇去掉行尾空行。 内容零变化:git diff --ignore-all-space 只有 1 处空行删除;18 篇均在 上一笔流水清理里被改过,恢复补丁时把上一轮的 EOF 修复冲掉了,这一 笔补回。
任务规划
UI 补齐执行清单已于 2026-10-28 清空(记录 5 页 + 运行报告页落地)。 下一顺位 = net 层跨上下文收口,开工待用户点头;顺序权威见 docs/任务规划/README.md §2.0。 详细任务与验收见
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 补齐(执行清单已于 2026-10-28 清空)
菜单树共 33 叶(节点行合计 42):按行内 #page= 实测已绑 28 叶、未绑 5 叶(2026-10-28 复核, 判定规则与重跑命令见 docs/任务规划/UI补齐.md §1「叶数判定与复核」)。未绑的 5 叶因缺少开入硬件、 录波模块或 SNTP 产品定义而不做(原因与重开条件见 docs/任务规划/UI补齐.md §5)。 口径闭合:未绑 5 = 待做 0(§1 清单已清空)+ 不做 5(遥信 3 / 手动录波 1 / SNTP 1);42 是节点行数、不是叶数(= 9 个菜单节点 + 33 叶)。 已绑叶数以生成物 UI_PAGE_MAP_COUNT 为准:不剔 ui_menu_tree.txt 文件头的注释示例行时,按 #page= 文本计数会得 29(= 28 + 1 行示例)。
UI 补齐执行清单已于 2026-10-28 清空:记录 5 页(事故 / 操作 / 保护告警 / 保护启动 / 遥控)与 运行报告页同日落地并绑页,内容页黄金参考 53 → 60 张(runreport 分 2 页,第 2 页单独拍一张;判据 = simulator/tests/ref/ 入库 shot_*.bin 实数,张数 = 页面个数 + 分页多拍的那一张)。 上板判据(真记录翻页、掉电保持、清除后归零、boot_count 自增、RESTARTED、rst_cause=IWDG、conn_up +1) 已登记登记簿 §7「UI 六页真机判据」,六页文件头各留「台架待补」段;模拟器差距见 docs/测试说明/模拟器差距清单.md §2.3「开机账本 boot_stats」一行。
执行纪律:单道串行。 菜单树与页面注册表是生成物,字库也是整文件生成物; 不要同时开多条 UI 页面分支。上板验证可累积成一批,但保存、重启、主站读回等判据不能删除。
2. 全项目推进顺序
本节是全项目唯一的顺序权威。模块文档只描述局部设计,不另排一套路线图。
2.0 顺序表
| 顺序 | 工作 | 当前状态 | 开始或切换条件 |
|---|---|---|---|
| 1 | UI 补齐 | 清单已清空(2026-10-28) | 记录 5 页与运行报告页已落地并绑页;余下 5 叶属 §5「当前不做」,重开条件见 docs/任务规划/UI补齐.md §5;上板判据见 docs/任务规划/登记簿.md §7 |
| 2 | net 层跨上下文收口 | 下一顺位(未开工) | UI 清单已清空,切换条件已满足;开工需用户点头——换主线是产品决策,不由本批顺带做掉 |
| 3 | 其余结构与可靠性评估 | 排队 | net 收口后;逐项见 登记簿.md,观察项不为了“清清单”而强做 |
| 4 | 数据可信剩余两项 | 等待外部资源 | 端子/子板变比确认 → 标准源两点标定(已知电压注入已于 2026-10-27 台架闭环并销项);资源到位可插入优先处理 |
| 5 | 标准源送检与第三方 104 主站验收 | 等待标定完成 | 两点标定完成且保护 VALID 已置位;送检窗口前 2 日冻结特性 |
| 6 | 保护元件与采集增强 | 等待标准源或硬件改版 | 保护先解除未标定闭锁;三相同时刻类功能等 V0.2 硬件 |
| 7 | 验证窗口事项 | 逢条件顺带 | CI runner、PC peer、CH340、负向故障注入条件到位时执行 |
| 8 | 独立模块与暂缓项 | 当前不排 | 开入开出、故障录波、SNTP 单独立项;RS-485 与内存优化按各自重启条件 |
| 独立 | 屏板链路(对上屏板) | 规划已出(未开工) | 独立立项,插在任一顺位之间都能做,不占主序列;端口已裁定(2026-10-28):屏板占 USART1,日志迁 RS-232 通道,所以原来的 250 kbps 收发器阻塞已解除;剩下两条前置——台架串口线挪到 CN1、日志口迁移(见 docs/任务规划/屏板链路.md §0 与 §3 批 0);软件可先用 PC + USB 转 TTL 台架验证,不必等屏板实物 |
2.1 关键依赖
- UI:写路径、整定 4 页、装置维护 3 页与遥测死区/系数 2 页已收口(含上板判据与真机回读); 菜单树、页面注册表与字库都是生成物,同刻只允许一条道写。
- 送检:已知电压注入(✅ 2026-10-27 闭环)→ 端子/子板变比确认 → 标准源两点标定 → 保护解除闭锁 → 送检。
- 保护扩展:标准源未到位前不新增无法验证的判据;跨转换器相位、功率、对称分量类 功能必须等 V0.2 硬件。
- 结构债:UI 完成后先做 net 收口;RS-485 白名单、内存优化、仓库体积等观察项不抢占 当前编码道。
3. 维护约定
- 完成即删除待办条目,同时清理其他文档对它的引用;结论和证据写入模块文档,
历史由
git log保留。 - 当前任务只改
UI补齐.md,后续事项只改登记簿.md;顺序变化才改本文件 §2。 数据可信.md的 §2、§4、§7~§10 仍被代码头注释引用为设计依据,不能按“已完成” 删掉;其待办只认 §5 的两项。- 专项文档只放还没闭环的约束;已落地事项的规格正文归代码头注释或模块文档,
销项即删文件并把引用改指现行出处(先例:
测试与架构专项.md已删除 2026-10-28, 唯一未闭环的「采集链路测试可验证性约束」并入暂缓-RS485.md)。 - 任务分支不直接修改
docs/任务规划/**;状态更新与销项由主工作树统一处理。 - 并行开发机制、工作树和锁的使用见
docs/环境与部署/并行任务工作树方案.md。 本文件夹不再另维护一份分道、批次和写域方案。 - 暂缓不是完成:条目必须保留重启条件;没有重启条件的“以后再说”应写成观察项或删除。