Files
STM32F4-Base/docs/任务规划
wandering1 e2d3f5114e docs(波次): 批 2 主体收口注记(并行分道方案)+ AGENTS 现状句补快照层
并行分道方案:批 2 从"在途"改"主体已收"(卡 8~11 销项、黄金 18 页、
道F 三销项 + F2/F3 已合入待台架两轮判据 + R1 附修),批 2.5 尾单与
批 3 未开明示。AGENTS 现状句链路补 L2.5 遥测快照与遥测/UI 消费者
(与数据主线行同口径)。
2026-10-25 19:22:59 +08:00
..

任务规划(统一待办登记簿 · 索引与排序权威)

这个文件夹是什么:全项目唯一的未闭环事项清单 + 全项目唯一权威的工作先后顺序。 2026-10-12 按「变更频率 + 职责」解耦成多文件——并行任务写范围互不相交,各改各的文件。

文件地图(谁改哪个):

文件 内容 变更频率 / 写者
README.md(本文件) 编号空间(§0)· 未闭环一览(§1)· 推进顺序权威(§2) · 维护约定(§3) 低频;仅主工作树
采集保护收尾.md 「采集保护收尾」剩余:只剩 M3 送检(B10) 低频——送检窗口前后改
数据可信.md 当前波次(2026-10-23 用户定项):通道标定 → 遥测链 → 运行参数段;含事实基线、折算模型、14 张任务卡(含"已知电压注入验证"与"端子变比确认"两卡)、前置决策 高频——开工后状态流转只改它
排期详述.md 「结构债」/「验证常态」波内详表 低频
并行分道方案.md 待办横向归道:文件级写域(域1域8)· 八条道(道A道H)· 批次与合并次序 · 不能并行的事项 低频——分道或批次变化时改;明细不复制,只做归道
暂缓-RS485.md B2 RS-485 整簇冻结清单(用户决定) 极少
登记簿.md N-x / S-x / T-x 长期登记(网络 / 存储 / 硬件 / 测试 / 报告并轨) 中频——新发现进对应表
测试与架构专项.md S1x / 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-3(L5 基线重验)· N-16(A2/A4 负向台架)· 复合连击串窗(time_sync 探针大窗修复 a3c6e89 的判读副产物)修复已合入 66f862e——看门狗连击按位分账,此后每个 stall 行都是真单任务链 · 重建窗内回执排队把 net 等待者拖过 800ms(UI 首例)修复已合入 9d90e00——sink 往返返回点喂位(最窄档,不改等待语义;单往返 >800ms 残留归 E-27/28 批 3)。两条待台架两轮 30min 双零判据(v1.1 口径)后才销项。本波道F 原三张条目(日志静默观察 / 探针窗口心跳 / 写回 flush)已于 2026-10-25 台架大窗销项删行——心跳主签名在 9 条 stall 行中 NET 位全程在场 = 旧 44/44 必发归零;复跑暴露的两个新签名以语义标识上行为本表独立条目,详 登记簿.md §1
存储 / 日志 3 S-3(USART1 TX-only 根治) · S-4(dhara 重试自旋)· S-5(可选全序列卷锁)
结构 / 健壮性 3 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 大部落地(批 1~4:ui_data 三通道 + 遥信 33 行 + 定值查看 4 页 + 记录页 reader 链,黄金 18 页入库;余批 5 = 整定 4 页 + param_request 写路径,板端有状态导航器已备)
暂缓 2 簇 B2 RS-485 整簇(暂缓-RS485.md)· N-27 内存优化簇剩余(R-2 后半 / R-3 / R-4 / R-6;重开条件见 ../内存管理/RAM使用分析与优化方案.md §4)。⚠ 已落地的 R-9 与 mem-budget 门禁/台账/趋势不回退
数据可信(当前波次) 1 簇 · 在途 3 卡 🔴台架/外部:已知电压注入(卡 0,一块万用表就能开)· 端子变比确认(0b,🟡)· 标准源两点标定(12,🟡)。卡 17 批 1 销项、卡 811 批 2 销项(2026-10-25,遥测快照/104 读快照/运行参数段/频率绑定全链 + 大窗与验收窗台架钉证;详表 数据可信.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 结构性判断(排序依据)

  1. 功能主线优先(用户决定 2026-10-12):把"采集→相量→保护→上送"链路收口到"台架闭环 + 功能面完整 + 可送检"。前两项已达成,「采集保护收尾」只剩 M3 送检(采集保护收尾.md)。RS-485 对下采集(B2)暂缓(暂缓-RS485.md),主线不等它。
  2. 内存预算红线已机械化: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)——门禁与台账继续常开,它们正是"何时该重开"的传感器。
  3. 验证债仅剩窗口性事项(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 改为只发不收 → net 层跨上下文收口(含重建窗回执排队问题的根治)→ 注册校验白名单清理 → 性能语义簇 / 空 TU(日志管线与 S8 合并评估、写回 flush 已于 2026-10-25 销项;详表 排期详述.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(执行流程)——不在本文件夹合并范围。