wandering1
4c74cfa825
批次二文档半（道 gate-docs 执行）。先纠三个数的口径账，别再拿任何旧数当准：**234 处是准数** —— 卡片写 52（Lead 用了门禁 Checker 的引用集合，它**刻意排除属主文档内部的定义位**）、道里先报 265（裸正则把 `SDL2-2.32.10` 里的 `L2-2` 当成功能号，误报 10 处）。最终边界口径 = 带左边界 + 跳过反引号代码段。 · 19 只文件 HEAD 共 234 处 → 现 40 处，**40 处 100% 落在变更记录行**（冻结历史，按 Q3 一条没动）， 非变更记录残留 **0**；改写 163 行 / 16 只文档。站点最多：规划文档 110→37、相量层单测说明 25→1、 采集与数据处理短板评测 21→0、App/algo/README 26→0。 （`App/algo/README.md` 由上一笔代码提交带上车，路径归属已在该笔正文注明，内容是本批改写） · **定义表首列由编号改成语义标识**（编号规范 §3.3「表首格就是短语」的完全形态）：首列原为编号的表 共 **7 张**（不是 5 张），删掉与之重复的「语义名」列；表头标签按域词区分——三张 L3 保护**元件**表 保留 `| 元件 |`，四张 L1/L2 表用 `| 功能名 |`（把「元件」统一洗成功能名会丢掉领域信息）。 七张表逐张核：表头竖线数 == 分隔行 == 首条数据行 == 列数+1；与 HEAD 逐块对拍**净新增不一致块 0**， 并且正是这个对拍抓到第一版「三张表数据行已删列、表头没删」的破表。 · 7 处删号留下的残词/重复解释括号人工收口（如「L1-5（通道标定）」→「通道标定（一次系数 + 零漂）」）， 复扫待收口站点 0；措辞逐字取自映射表，无第二种说法。 · tools/arch_diagram 三只生成器 4 处（3 处 docstring + 1 处图形文案）与产物同批：重跑后**只有位图那张 变 2 个 text 节点的换行位置**，画布 1580x740 与总行数不变，另两张逐字节未变；改前先干跑对照证明三张 svg 原本与生成器一致（不在 stale 基线里）——`check_generated_fresh --only docs-svg` PASS。 本笔另含 **F-* 半批的文档面**（同一轮 `git add docs tools/arch_diagram AGENTS.md` 一并收进 ，非误伤）：BSD 函数调用关系里 9 处反引号紧邻指针、属主文档 §7 的停发句与导读行（**12 条定义行原样保留、不删登记族**）、 以及 `gen_net_instability_svg.py` 与它的产物 `网络不稳根因总览.svg`（「唯一读者红线」那条的框宽自适应 526 → 551，右缘 1411 未越界，画布 1560x1468 不变）——该半批的**代码注释面**在下一笔。 ⚠ 因 `docs/任务规划/登记簿.md` 与 `docs/任务规划/UI补齐.md` 正被另一张卡（UI 叶数复核）改动，本笔**不含 那两只文件**，批次二的 §9 存量收尾与它们同批提交。
任务规划
现在只做 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。 本文件夹不再另维护一份分道、批次和写域方案。 - 暂缓不是完成：条目必须保留重启条件；没有重启条件的“以后再说”应写成观察项或删除。