Files
STM32F4-Base/docs/任务规划
wandering1 4a4ad6bc5f chore(全仓): @build/@test 旧文档别名清退为技能调用名
现状口径:/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名,
不是 shell 命令;「名 + 命令行参数」的命令形态改为可执行体
run_boot_test.py 的真实调用。

- AGENTS.md:别名说明重写为「技能调用名不是 shell 命令」,两条目改
  「编译(/keil-build)」「串口回归(/serial-boot-test)」
- keil-build / serial-boot-test 两 skill 调用名与示例同步;task-worktree
  方案文档去掉 @build/@test 惯例从句;@task 保留(不在点名范围)
- 123 文件现状陈述全改;台架捕获、变更记录/时间线、rename 映射输入
  等 41 行历史证据保留旧名
- gen_memory_svg.py 6 处措辞随改,3 张 SVG 产物同批重跑
- 顺手补并行方案同行漏网计数 51→52 钩子

验证:提交期快钩子对 123 文件实跑全 Passed;check_doc_links --all
rc=0(3038 处、无法判定 0);check_mermaid --all rc=0;YAML 解析 52
钩子不变;skill-size rc=0;py_compile 全过;字节卫生零漂移。
2026-10-30 13:03:12 +08:00
..

任务规划

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 不再复制当前 UI 任务,数据可信.md 的其余章节是被代码引用的设计约束, 不是额外待办。


0. 条目与引用规则

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

1. UI 补齐(执行清单已于 2026-10-28 清空)

菜单树共 34 叶(节点行合计 43):按行内 #page= 实测已绑 30 叶、未绑 4 叶(2026-10-29 复扫, 判定规则与重跑命令见 docs/任务规划/UI补齐.md §1「叶数判定与复核」)。未绑的 4 叶因缺少开入硬件 或 SNTP 产品定义而不做(原因与重开条件见 docs/任务规划/UI补齐.md §5)——手动录波与录波回放两叶 已随录波道绑页,「不做」清单里的录波那一项已销。 口径闭合:未绑 4 = 待做 0(§1 清单已清空)+ 不做 4(遥信 3 / SNTP 1);43 是节点行数、不是叶数(= 9 个菜单节点 + 34 叶)。 已绑叶数以生成物 UI_PAGE_MAP_COUNT 为准:不剔 ui_menu_tree.txt 文件头的注释示例行时,按 #page= 文本计数会得 31(= 30 + 1 行示例)。

UI 补齐执行清单已于 2026-10-28 清空:记录 5 页(事故 / 操作 / 保护告警 / 保护启动 / 遥控)与 运行报告页同日落地并绑页,内容页黄金参考 53 → 60 张(runreport 分 2 页,第 2 页单独拍一张;判据 = simulator/tests/ref/ 入库 shot_*.bin 实数,张数 = 页面个数 + 分页多拍的那一张;该集合 2026-10-29 已扩至 66 张,多出的是录波回放页 6 态)。 上板判据(真记录翻页、掉电保持、清除后归零、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-29):动态验证让位给故障录波数据面,段文件落地后判据升级为 PC 独立重算对表(docs/子系统设计/故障录波设计说明.md §11)(已知电压注入已于 2026-10-27 台架闭环并销项);外部资源到位可插入优先处理
5 标准源送检与第三方 104 主站验收 等待标定完成 两点标定完成且保护 VALID 已置位;送检窗口前 2 日冻结特性
6 保护元件与采集增强 等待标准源或硬件改版 保护先解除未标定闭锁;三相同时刻类功能等 V0.2 硬件
7 验证窗口事项 逢条件顺带 CI runner、PC peer、CH340、负向故障注入条件到位时执行
8 独立模块与暂缓项 当前不排 开入开出、SNTP、104 文件传输单独立项;RS-485 与内存优化按各自重启条件
独立 故障录波(1 kHz · 8 路原始码值 · 单通道回放) 代码面已交付(板级判据一轮未跑) 用户裁定 2026-10-29 录波先行:数据面最小闭环 → 手动与保护启动触发 → 回放页。三张卡的代码侧判据已收口(主机单测 100 / 170 / 110 全 rc=0、双端编译 0 错误 0 警告、板端编码器与 PC 侧解码器字节级互验、手动录波与录波回放两叶已绑页、内容页黄金参考扩至 66 张);没跑的是板级那一轮(注 1 V / 50 Hz、FTP 拉回、与 meas: 行和 104 浮点遥测对表、段文件 CRC 不符必须拒收、回放页看真段)。卡片判据见 docs/任务规划/故障录波.md,口径与设计见 docs/子系统设计/故障录波设计说明.md §10;与 UI 道互斥(菜单树与中文字库是整文件生成物,同刻只允许一条道写)——本波按此串行执行:UI 道在数据面与接线冻结之后才动生成物

2.1 关键依赖

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

3. 维护约定

  1. 完成即删除待办条目,同时清理其他文档对它的引用;结论和证据写入模块文档, 历史由 git log 保留。
  2. 当前任务只改 UI补齐.md,后续事项只改 登记簿.md;顺序变化才改本文件 §2。
  3. 数据可信.md 的 §2、§4、§7~§10 仍被代码头注释引用为设计依据,不能按“已完成” 删掉;其待办只认 §5 的任务卡表(标识列用语义短语,卡片增减不改本条口径)。
  4. 专项文档只放还没闭环的约束;已落地事项的规格正文归代码头注释或模块文档, 销项即删文件并把引用改指现行出处(先例:测试与架构专项.md 已删除 2026-10-28, 唯一未闭环的「采集链路测试可验证性约束」并入 暂缓-RS485.md)。
  5. 任务分支不直接修改 docs/任务规划/**;状态更新与销项由主工作树统一处理。
  6. 并行开发机制、工作树和锁的使用见 docs/环境与部署/并行任务工作树方案.md。 本文件夹不再另维护一份分道、批次和写域方案。
  7. 暂缓不是完成:条目必须保留重启条件;没有重启条件的“以后再说”应写成观察项或删除。