wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions Packages Projects 2 Releases Wiki Activity

docs(任务规划): 删除两份遗留的 20261028 分工说明

Browse Source 
- 分工说明-20261028-RS485解锁与门禁口径对账.md
- 分工说明-20261028-采集链与上送链联调.md

两份均为 2026-10-28 的一次性分工简报，任务线已收口、文件遗留未清，
用户确认为没用文件后删除。删除前核对引用面：docs/ 全量 *.md 完整扫描、
根 README/AGENTS/.gitea 均零引用；仅 ci-artifacts/（已忽略的一次性脚本
与日志）内有历史命中，不构成悬空链接。
This commit is contained in:
Wanderingss
2026-10-30 00:50:21 +08:00
parent ecf9d3ad3d
commit e02f46ed6a
2 changed files with 0 additions and 88 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/任务规划/分工说明-20261028-RS485解锁与门禁口径对账.md
-44
View File
@@ -1,44 +0,0 @@
# 分工说明：RS-485 解锁与门禁口径对账（2026-10-28）
**目标**：**A 线**补齐 `Drivers/BSP/RS485/` 两条未修契约缺陷，为 `rs485_task` 解除 **RS-485 接线门禁** 的技术前提；**B 线**把 `AGENTS.md` 与 `docs/门禁说明/README.md` 的 **钩子口径** 对账到实跑。
**口径**：本文件只分工、**不改行为**；两条线 **不交叉编辑** 对方文件，跨线接口 **先在本文件登记** 再动手。
## A 线 · RS-485 驱动契约（负责人 A）
- **涉及文件**：`Drivers/BSP/RS485/rs485.c`、`Drivers/BSP/RS485/rs485.h`、`App/task/rs485_task.c`（**新建**）、`test/host/rs485/`（**新建**）
- **交付物**：
1. 修 **单缓冲包撕裂**：RX 改 **双缓冲 + 帧序号**，消费者一次取整帧，对齐 `tpafe5160_snapshot()` 的 **临界区原子快照** 语义（旧的两步取数在两步之间被抢占会混帧）；
2. 修 **TX 超时拉 DE**：超时路径 **先等 TC 再拉 DE**，避免尾字节被截；错误码走 `Drivers/BSP/bsp_err.h` 通道，返回值 **不得裸丢弃**（`bsp-err` 的 consume-result）；
3. `[计划] test/host/rs485/run_unit_test.py` 覆盖 **撕裂**、**TX 超时**、**DE 时序** 三例；新增 `.c` 须 **双端注册**（`MDK-ARM/STM32F407-Demo.uvprojx` + `simulator/CMakeLists.txt`，见 `new-source-file` skill）；
4. 结论回填 `[计划] docs/问题记录/RS485_Trap_Records.md`，并在 `docs/任务规划/暂缓-RS485.md` 写清 **解锁条件是否满足**（接线节奏仍受门禁约束，**不由本线决定**）。
- **禁止**：`malloc/calloc/realloc/strdup/free`（`coding-standard` CODE-RULE-20）；`osKernelStart` 之前调任何创建类 API；注释里写 **星号形态的路径**（`nested-comment` 9-D）。
- **预算**：建任务 **前后各跑一次** `scripts/stack_report.py` 与 `scripts/ram_report.py`；**建任务/抬栈属 Ask first**。
## B 线 · 门禁与文档口径（负责人 B）
- **涉及文件**：`AGENTS.md`、`docs/门禁说明/README.md`、`docs/代码规范/pre-commit使用说明.md` §2；`.pre-commit-config.yaml` **只读核对、不改**。
- **交付物**：
1. **口径 = YAML 解析后的 hook 条目数**：用 `& ".venv\Scripts\python.exe"` 解析 `.pre-commit-config.yaml` 取实数，与 `AGENTS.md` 的 **51** 做 **声明 / 文档 / 实跑** 三数同源核对（**注释掉的候选钩子不计**，直接 grep 声明行会多算 1）；
2. `docs/门禁说明/README.md` 的 **篇数 ↔ 钩子数** 差集清单，核对 **27 篇 + 1 指针** 是否仍成立；
3. 有差异 **只改文档、不加钩子**（Lead 裁定：`test/host/` 41 套里只有 22 根专属钩子，**没有专属钩子 ≠ 没被跑**，余量由 `test-coverage` 总闸兜）；新条目标识用 **语义短语**，**不再发字母+数字编号** → `docs/编号规范.md` §1。
- **禁止**：手工全局替换改名/挪目录（走 `scripts/rename_ref.py`，先 dry-run）；章节引用写成非紧邻形态（`doc-links` 带 `--sections-strict` 拦提交）；在配置注释里复述那个 grep 字面量（文本计数再虚高 1）。
## 共用约束（A/B 都要守）
- 改代码/改文档 **只用 Edit 精确替换**；**绝不**用 `Get-Content`/`Set-Content`/`cmd` 重写含中文的文件（`U+FFFD` 不可逆）；带 BOM 的 `Drivers/BSP/UI/`、`App/cfg/cfg_file.c`、`Lib/lv_conf.h` 改完核对 `EF BB BF`（`bom-guard`）。
- **字符串字面量纯 ASCII**，中文只进注释；行尾 **LF**（`.gitattributes` 已写死 `* text=auto eol=lf`）；怀疑乱码先数 `EF BF BD` 字节，**不要 `git checkout`**。
- 门禁 **只在提交时** 统一跑：`@build` + `& ".venv\Scripts\python.exe" scripts/ci_local.py` + `scripts/check_doc_links.py --all`，**不要中途反复跑**。
- `git commit` / `git push` / 烧录 / CubeMX 重生成 / 登记簿删行销项 / 开 `ENABLE_DESTRUCTIVE_TESTS` —— **Ask first**。
## 验收（合并前）
| 线 | 判据 | 证据 |
|---|---|---|
| A | RS485 两条 ❌ 清零，`rs485_task` 的技术门禁解除（**是否接线仍由用户裁定**） | `test/host/rs485` 全绿 + `MDK-ARM/build_log.txt` **0 错误 0 警告** |
| B | 声明 / 文档 / 实跑 **三数一致** | 解析计数输出 + `docs/门禁说明/README.md` 差集为空 |
| A+B | `registration-check`、`bsp-err`、`nested-comment`、`id-check` 基线 **只减不增** | `scripts/ci_local.py` 输出 + `scripts/archive/id_gate/id_known_backlog.json` 台账 |
## 交接
- 两条线各自 **只回报**：**改了哪些文件、跑了哪些自检、剩余风险**；跨线接口（`rs485_frame_take()` 签名）变更 **先在本文件登记**。
- `docs/任务规划/README.md` 的 **完成即销项** 由协调者在用户确认后统一做，**A/B 都不得自行删行**。
docs/任务规划/分工说明-20261028-采集链与上送链联调.md
-44
View File
@@ -1,44 +0,0 @@
# 分工说明：采集链与上送链台架联调（2026-10-28）
**目标**：把 **语义取数与有效性→全周傅氏相量→测频与遥测快照** 取数链与 **测频与遥测快照→104/UI** 上送链在同一次台架烧录里对齐，提交门禁 **0 错误 0 警告**。
**口径**：本文件只分工，不改行为；任何一条线单独验收通过后合并，**不交叉编辑**对方文件。
## A 线 · 采集链（负责人 A）
- **涉及文件**：`App/algo/adc_input.c`、`App/algo/adc_health.c`、`App/algo/sample_ring.c`、`App/algo/phasor.c`、`Src/freertos.c`（**只写 `USER CODE` 区**）
- **交付物**：
1. `App/algo/README.md` 补 **「快照时序」** 一节：`tpafe5160_snapshot()` 临界区原子性、`adc_tick_irq_notify()` 的「消费者就绪」门（TIM3 比调度器早 ≈100 ms）；
2. `test/host/adc_input/run_unit_test.py` 增加 **帧序号回绕** 与 **双缓冲半帧** 两个用例；
3. `docs/子系统设计/ADC采样节拍设计说明.md` §5 表格与代码实际节拍（**TIM3 PSC 83 / ARR 999 → 1 kHz + TRGO_UPDATE**）核对后回填差异。
- **禁止**：`malloc/calloc/realloc/strdup/free`（门禁 CODE-RULE-20）；跨转换器做 **相位/功率/功率因数** 运算（V0.1 硬件缺陷）；`Drivers/BSP/` 里 include `App/` 的头（`layer-deps`）。
- **取数只用** `adc_input_poll()` / `adc_input_raw()` **按语义**取值，**不写死下标**（`buf[2]=IA`、`buf[5]=UN`、`buf[6]=UA` 见 `docs/硬件平台/ADC通道映射说明.md`）。
## B 线 · 上送链（负责人 B）
- **涉及文件**：`App/algo/meas.c`、`App/task/iec104_task.c`、`Drivers/BSP/UI/ui_data.c`（**带 UTF-8 BOM：改完核对 `EF BB BF`**）、`test/host/meas/run_unit_test.py`
- **交付物**：
1. `App/algo/meas.c` 的 **200 ms 双区快照** 写一个 **单写者/多读者** 一致性说明，落到 `docs/架构设计/项目架构总览.md` 的跨层依赖表；
2. `Drivers/BSP/UI/ui_data.c` 与 104 上送 **共用同一份上游**：补 `test/host/ui_data/run_unit_test.py` 的 **陈旧代次（generation）** 用例；
3. 若新增 `.c`：`MDK-ARM/STM32F4-Base.uvprojx` + `simulator/CMakeLists.txt` **双端注册**（`new-source-file`）。
- **禁止**：直接编辑 `Drivers/BSP/UI/` 之外的 `Src/`、`Inc/` 标记区外内容；把 `*.uvprojx` 的 UV4 抖动改动入库；改 `Lib/lv_conf.h` 不同步 `simulator/` 那份（`lv-conf-sync`）。
- **UI 侧铁律**：字符串字面量 **纯 ASCII**，中文只进注释；注释里写路径 **不要出现星号形态**（`nested-comment` 9-D），写目录或用尖括号。
## 共用约束（A/B 都要守）
- 改代码/改文档 **只用 Edit 精确替换**；**绝不**用 `Get-Content`/`Set-Content`/`cmd` 重写含中文的文件（`U+FFFD` 不可逆）。
- 行尾 **LF**（`.gitattributes` 已写死 `* text=auto eol=lf`）；怀疑乱码先数 `EF BF BD` 字节，**不要 `git checkout`**。
- 门禁只在 **提交时** 统一跑：`@build` + `& '.venv\Scripts\python.exe' scripts/ci_local.py` + `check_doc_links.py --all`；**不要中途反复跑**。
- 文档引用章节 **紧邻写法**：`docs/算法/采集与算法层设计说明.md` §10.1；改名/挪目录走 `scripts/rename_ref.py`（先 dry-run）。
- `git commit` / `git push` / 烧录 / `CubeMX` 重生成 / 抬栈 —— **须用户明确指示**（抬栈前后各跑 `scripts/stack_report.py`）。
## 验收（合并前）
| 线 | 判据 | 证据 |
|---|---|---|
| A | 语义取数与有效性→全周傅氏相量与 1 kHz 节拍一致，无半帧 | `test/host/adc_input` 全绿 + `docs/子系统设计/ADC采样节拍设计说明.md` |
| B | `meas` 双区 **104 与 UI 同源**，无撕裂 | `test/host/meas`、`test/host/ui_data` 全绿 + `docs/编号规范.md` 无新撞号 |
| A+B | 台架一次烧录 **`-Rst -Run` + 回读校验**（`No difference found`），串口日志无 `[ERR]` | `@test` 报告 + `MDK-ARM/build_log.txt` |
## 交接
- 两条线各自 **只回报：改了哪些文件、跑了哪些自检、剩余风险**；跨线接口（`meas` 快照字段）变更 **先在本文件登记**再动手。