wandering1
13ef0715bb
销项（登记簿删行 + 结论沉淀指针）： - 数据可信.md：卡 1~7 行删除，表下补销项记录（merge 231dc81/d39e5c9/ 59da40b）；§2.1 口径冲突注改 ✅ 已定死；§6 顺序图与失效预警改写为 "批1 已销项 + 批2 在途"现状；卡 0/0b/12 与 M4①⑤台架面保留待跑 - 测试与架构专项.md：未闭环一览删 S12 / A-5 两行；§1 标题 1 项→0 项， P1-10 剩余两条改已销项记录（5 档构建 + f3 PASS，数字正文在 test/board/ch395f_test.h）；§2.1 S12、§2.3 A-5 标题 ⬜→✅ 带落点 - README.md：一览删 P1 收步行；网络/结构/UI 行加 🟦批2 在途标记； 测试基础设施 5→3；数据可信行改"在途 7 卡"；验证常态两处删 P1-10/S12/A-5 口径联动（A-5 已落地，文档追平）： - CI 远程CI完整指南.md §0.0 整节重写（盲区→同码凭证强制 + 三项仍 守不住 + 变更记录行）；CI README 索引行同步 - 门禁说明/mem-numbers.md §1/§6、mem-budget.md §6 第 4 条：远端缺口 已由 check_size_gate.py 关闭，唯一正文 = 其 docstring
16 KiB
16 KiB
任务规划（统一待办登记簿 · 索引与排序权威）
这个文件夹是什么：全项目唯一的未闭环事项清单 + 全项目唯一权威的工作先后顺序。 2026-10-12 按「变更频率 + 职责」解耦成多文件——并行任务写范围互不相交，各改各的文件。
文件地图（谁改哪个）：
文件 内容 变更频率 / 写者 README.md（本文件）编号空间（§0）· 未闭环一览（§1）· 推进顺序权威（§2） · 维护约定（§3） 低频；仅主工作树 采集保护收尾.md「采集保护收尾」剩余：只剩 M3 送检（B10） 低频——送检窗口前后改 数据可信.md当前波次（2026-10-23 用户定项）：通道标定 → 遥测链 → 运行参数段；含事实基线、折算模型、14 张任务卡（含"已知电压注入验证"与"端子变比确认"两卡）、前置决策 高频——开工后状态流转只改它 排期详述.md「结构债」/「验证常态」波内详表 低频 并行分道方案.md待办横向归道：文件级写域（域1 域8）· 八条道（道A道H）· 批次与合并次序 · 不能并行的事项低频——分道或批次变化时改；明细不复制，只做归道 暂缓-RS485.mdB2 RS-485 整簇冻结清单（用户决定） 极少 登记簿.mdN-x / S-x / T-x 长期登记（网络 / 存储 / 硬件 / 测试 / 报告并轨） 中频——新发现进对应表 测试与架构专项.mdS1x / A-x 专项（P1-10 / S12 / A-5 已于 2026-10-25 销项） 低频 基线与待确认.md只放还没答案的问题（OQ 族属主登记处）；基线类内容已移出到模块文档 参考，少改 怎么用：想知道"现在该做什么、按什么顺序" → 本文件 §2；想知道"当前波次任务卡状态 / 验收判据 / 并行道" →
数据可信.md； 想知道"某条待办的来龙去脉" → 按编号查登记簿.md/测试与架构专项.md；想知道"还差哪些验证" →排期详述.md§2。只保留待办：已完成条目直接删除，不留变更记录（历史见
git log与各模块文档）； 已闭环项的结论与证据沉淀进对应模块文档/问题记录，本文件夹不再重复。 消化即销项：事项修复/关闭后，直接删除对应条目，并同步清理其它文档对本编号的引用。不在本文件夹范围：
../测试说明/实机测试实施指南.md（执行流程）。
0. 编号空间与来源
| 编号 | 含义 | 备注 |
|---|---|---|
| 语义标识（2026-10-14 起新条目唯一形式） | # 列填一行短语直接说清是什么事，如 沉降窗 800ms 上限只留痕、RS485 采集接线 |
新条目一律用它，不再新增字母+数字编号；同一表内语义天然不重复 → 结构上防号；引用时带文档名 |
P0-x~P3-x |
审计缺陷/改进项（2026-09-15/09-21 审计） | P0=功能 bug、P1=疑似 bug/健壮性、P2=改进、P3=卫生 |
N-x / S-x / T-x |
台架/审计观察登记项 / 存储·日志管线 / 测试与工具链 | 存量冻结沿用、不再新增（新条目见上一行）；N-x 含硬件改版项（需下一版硬件，固件侧只记口径，如 N-18） |
S1~S14 / A-1~A-7 |
2026-10-02 复审的测试充分性与架构专项 | 编号不回收 |
E-xx |
错误码传播审计发现（历史族） | 属主文档已于 2026-10-15 删除；编号冻结（docs/编号规范.md §4.1 / §4.3），存量引用仅作历史指称，新发现一律 DEF |
B 前缀 |
功能主线排期条目 B0~B10（见 §2） |
存量冻结、不再新增。原 C（结构债）/ D（验证窗口）两族 2026-10-25 废止，条目改语义名——它们与 UI 设计约束、设计决策记录同字母不同义 |
报告 N-x/R-x/F-x/S-x/U-x/D-x |
《项目审查与优化建议报告》自有编号（该报告 2026-10-25 已删除） | ⚠ 曾与本登记簿同名不同义（报告 N-16 = 日志逐条开关，登记簿 N-16 = A2/A4 负向台架）。其未闭环项已于 2026-10-11 并入本登记簿（N-19~N-29 + U 簇），现存引用只是历史指称，不再新增 |
⚠ 为什么 2026-10-14 改用语义标识（一条实测失效案例）：原规则写着"编号不回收"，但 销项 = 删行，删完仓库里就不留任何痕迹——登记簿
N-31（2026-10-11 的 Phase 7 复跑项） 销项后，2026-10-14 新建条目按"现存最大值 +1"又取了N-31，与CH395F_Test_Guide.md、自动化测试流程.md里那两处历史引用撞号。"不回收"要靠人先想起去翻git log= 不可执行的规则。语义标识自带唯一性（重名一眼可见）；已随销项消失的字母+数字号一律作废， 不得作为新条目候选，历史引用（如上述两处N-31）指向的是当年的旧条目。
严重度定义（沿用审计口径）：P0 = 确认功能 bug｜P1 = 疑似 bug 或健壮性风险｜P2 = 改进｜P3 = 卫生。 置信度：high = 代码级确证｜medium = 依赖外部条件（手册/硬件/产品定义）。
1. 未闭环一览（按类别）
| 类别 | 数量 | 条目 |
|---|---|---|
| 网络 | 4 | N-2（49s 日志静默，低风险观察项）🟦批2道F · N-3（L5 基线重验）· N-16（A2/A4 负向台架）· N-17（探针窗口心跳缺口）🟦批2道F |
| 存储 / 日志 | 3 | S-3（USART1 TX-only 根治） · S-4（dhara 重试自旋）· S-5（可选全序列卷锁） |
| 结构 / 健壮性 | 4 | N-22（写回 flush）🟦批2道F · N-23（注册校验残余白名单）· N-25（性能/语义簇）· N-28（uvprojx 空 TU 观察） |
| 仓库 | 1 | N-29（.git 233 MB，已决策暂不处理、登记观察） |
| 硬件 | 1 | N-18（V0.2 改版项） |
| 测试 / 基础设施 | 3 | T-7（CI 远端两 job 闭环 + 第二机交叉验证）· A-4（采集链路测试约束，RS485 侧随 B2 暂缓）· 串口助手 A6/A7 补验（待 CH340） |
| UI | 1 | U5 页面落地 🟦批 2 道E 在途（2026-10-25 开工；ui_data 快照层 + 27 叶 + 3 页回炉） |
| 暂缓 | 2 簇 | B2 RS-485 整簇（暂缓-RS485.md）· N-27 内存优化簇剩余（R-2 后半 / R-3 / R-4 / R-6；重开条件见 ../内存管理/RAM使用分析与优化方案.md §4）。⚠ 已落地的 R-9 与 mem-budget 门禁/台账/趋势不回退 |
| 数据可信（当前波次） | 1 簇 · 在途 7 卡 | 🟦批2道D：遥测快照 200 ms · 104 读快照+死区运行参数化 · 运行参数段 · 频率点绑定 ｜🔴台架/外部：已知电压注入 · 端子变比确认 · 标准源两点标定。卡 1~7（口径/CFG_VAL_INT/折算/落盘/闭锁/三常数/量纲回归）已于 2026-10-25 销项（详表 数据可信.md §5） |
网络侧 E-xx 存量项（历史编号族，属主文档已于 2026-10-15 删除，编号冻结见
docs/编号规范.md§4.3）：E-27 / E-28 挂「net 层跨上下文收口」（见排期详述.md§1）； E-47 待 CH395F 驱动侧定案；E-12 为FF_FS_LOCK/ 单写者纪律记录项；E-31 后续与 E-62 为回归监督项（纪律已固化于AGENTS.md，无需改动）。 UI 标准化只剩 U5 页面落地，见 §2「UI 扩展」；lftpd 主机测试缺口为整簇排期项。
1.1 结构性判断（排序依据）
- 功能主线优先（用户决定 2026-10-12）：把"采集→相量→保护→上送"链路收口到"台架闭环 + 功能面完整 + 可送检"。前两项已达成，「采集保护收尾」只剩 M3 送检（
采集保护收尾.md）。RS-485 对下采集（B2）暂缓（暂缓-RS485.md），主线不等它。 - 内存预算红线已机械化：
mem-budget钩子拦 RW_IRAM1/RW_CCM >92%，子系统配额 / CCM 台账 / 趋势基线 →docs/内存管理/RAM预算台账.md。R-2 后半与 R-3 / R-4 / R-6 整簇暂缓（CCM 只剩 7,904 B，重开条件见../内存管理/RAM使用分析与优化方案.md§4）——门禁与台账继续常开，它们正是"何时该重开"的传感器。 - 验证债仅剩窗口性事项（L5 基线重锁 / A2-A4 负向台架 / 探针窗口心跳 / 串口助手补验），不单独排期、逢窗口顺手做。
2. 统一推进顺序（全项目唯一权威）
本节是全项目所有工作流唯一的权威顺序：
产品需求设计文档.md§9.2、../算法/继电保护功能复现规划.md、 各模块文档里的路线图均为局部视图，顺序变更只改本节，其它文档只留指针。 排序原则：安全风险 > 产品功能主线 > 数据正确性 > 预算/结构债 > 验证常态 > UI 扩展 > 仓库决策（当前无未闭环安全项）。 波内详表在挂接文件里（采集保护收尾.md/排期详述.md/暂缓-RS485.md），但波次增删与先后只改 §2.0。
2.0 波次总览
波次不带编号（2026-10-25 起）：波次名本身就是标识。原先的
W1~W8已废止——它们看着像 执行顺序，实际W8排在W3/W4之前，读者必须先查表才知道谁先谁后。现在执行顺序就是 本表从上到下，不再多一层映射。
| 波次 | 内容 | 为什么在这 |
|---|---|---|
| 采集保护收尾 | 只剩 M3 送检（B10，Fixed Date）——任务卡与判据见 采集保护收尾.md |
收口目标"台架闭环 + 功能面完整 + 可送检"的前两项已达成；真约束只剩送检窗口，窗口一到全道让路、窗口前 2 日特性冻结 |
| 数据可信（当前） | 通道标定 → 遥测链 → 运行参数：M4 系数与量纲 / M5 遥测链 / M6 运行参数与点表；14 张卡与事实基线见 数据可信.md |
用户决定（2026-10-23）：下一步做通道标定，先于 UI 页面与结构债。它是唯一"改一处、全链受益"的入口（App/task/adc_task.c:335 是码值→工程量的唯一位置），也是「UI 扩展」页面与 104 遥测的共同前置——先做页面则 ui_data_feed 组装的码值帧要返工。本波紧随「采集保护收尾」，排在「预算与内存」「结构债」之前。⚠ 2026-10-23 补记：ADC 至今从未采过已知电压（连极性都没验过，见 数据可信.md §2.6），故第一张卡是"已知电压注入验证"——只需一块万用表，不需要信号源/示波器，是开工的第一刀 |
| 预算与内存 | ⏸ 整簇暂缓：R-2 后半（缩堆 56→32 KB → 29.5 KB 迁 CCM）· R-3 · R-4 · R-6；R-5 已判定不可行 | 不再排期：没有功能在等这块预算，而搬迁要动 scatter、要逐条过 DMA 可达性清单、缩堆还要上板复测。重开条件 → ../内存管理/RAM使用分析与优化方案.md §4 |
| 结构债 | USART1 改为只发不收 → 日志管线与 S8 合并评估 → net 层跨上下文收口 → 注册校验白名单清理 → 写回 flush / 性能语义簇 / 空 TU（详表 排期详述.md §1） |
无紧急，按性价比排：USART1 那条灭 IWDG 误复位的机制根源；net 层收口体量大、验证重，放后 |
| 验证常态 | T-7 CI · L5 基线重锁 · A2/A4 负向台架 · 探针窗口心跳 · 串口助手 A6/A7（详表 排期详述.md §2） |
窗口性，逢机顺带，不单独排期 |
| UI 扩展 | U5 页面落地——27 是目标数不是差集（现存 7 个页面实现；27 个空叶子已归并为 7 模块 + 2 项前置能力） | 🟦批 2 道E 在途（2026-10-25 开工，组件层三件套已于批 1 落地）。地基已齐（U1~U4 落地、ui-golden 与字符集差集检查已挂 pre-commit），新增一页 = 3 处人工 + 1 条生成器命令。最早在「数据可信」的 M4 之后开工——ui_data / ui_data_feed 需要真数据（数据可信.md §10）。逐页规格见 ../UI设计/页面扩充详细方案.md |
| 仓库决策 | N-29 .git 233 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） | 下一版硬件；固件侧已用语义映射隔离，改版只动映射表 |
2.1 顺序一图
采集保护收尾 只剩 B10 送检（M3, Fixed Date） 详表 采集保护收尾.md
↓
数据可信 通道标定 → 遥测链 → 运行参数
M4 系数与量纲 → M5 遥测链 → M6 运行参数与点表 详表 数据可信.md
关键路径: 量程口径 → 标定模块 → 落盘 → 未标定即闭锁 → 量纲回归
「UI 扩展」可在 M4 后开工
↓
预算与内存 ⏸ 整簇暂缓（重开条件见 `../内存管理/RAM使用分析与优化方案.md` §4）
↓
结构债 USART1 只发不收 → 日志管线与 S8 → net 层收口 → 白名单清理 → 写回/性能/空TU
↓
验证常态 T-7 CI · L5 基线重锁 · A2/A4 负向台架 · 探针心跳 · 串口助手
↓
UI 扩展 U5 页面落地（未排期，最早「数据可信」M4 之后）
仓库决策 N-29 .git 233MB（已决策暂不处理） 硬件：N-18 V0.2
暂缓 B2 RS-485 整簇（见 暂缓-RS485.md）
3. 维护约定
- 本文件夹是全项目唯一的未闭环事项登记簿——"盘点 + 排序 + 明细"三合一，明细按职责拆进本文件夹各文件（2026-10-12 解耦），不再分散到其它文档。
- 并行写纪律：任务分支（worktree）不改本文件夹任何文件；任务卡状态列（⬜/🟦）与销项一律由 Lead 在主工作树更新。解耦的收益 = 不同波次 / 不同登记之间互不冲突，不是任务分支可以写。
- 任一项完成后直接删除对应条目（先销本文件夹条目，再清理其它文档对本编号的引用）；不留变更记录，历史见
git log与各模块文档。 - 已闭环条目的结论与证据沉淀进模块文档，本文件夹不再重复。
- 2026-10-14 起新条目用「语义标识」：
#列填一行短语（如沉降窗 800ms 上限只留痕）， 不再新增字母+数字编号（规则见docs/任务规划/README.md§0 表首行）；存量编号 （P-x / N-x / S-x / T-x / S1x / A-x / B 前缀）冻结沿用，而已随销项消失的号永久作废、 不得作为新条目候选——"不回收"在只写规则、不留痕迹的情况下不可执行（撞号实测见docs/任务规划/README.md§0 注）；E-xx（历史编号族）冻结于docs/编号规范.md§4.3。 - 引用审查报告编号一律带文档名（报告 N-16 ≠ 登记簿 N-16、报告 S-3 ≠ 登记簿 S-3）； 报告并轨项用本登记簿新编号（N-19~N-29 + U 簇），出处列保留报告编号。
- §2 是全项目唯一的推进顺序权威：
产品需求设计文档.md等文档中的路线图只留指针，顺序变更只改 §2.0（详表文件跟着挪，不改顺序）。 - 暂缓不是销项：条目仍在簿，只是不占波次。有独立清单文件的（
暂缓-RS485.md= B2）重启或关闭时更新该文件与 §1/§2.0；只在原处标注的（N-27 内存优化簇，2026-10-15 用户裁定，理由与重开条件在../内存管理/RAM使用分析与优化方案.md§4）重启时改登记簿.md该行 + 本文件 §1/§2.0 三处。 - 新增发现按既有惯例分流：能立即修的进 §2 波次（结构债）；需排期的进
登记簿.md/测试与架构专项.md对应编号空间；跨版本观察的进登记簿.md。 - 上游引用关系：
测试说明/实机测试实施指南.md（执行流程）——不在本文件夹合并范围。