mirror of
https://github.com/motajs/template.git
synced 2026-09-25 03:20:18 +08:00
fix(04-render-adaptation): revise 04-01 plan per checker feedback (re-measure estimate, CRLF + tracked-anchor gates)
This commit is contained in:
parent
b0592d8ffe
commit
6d8075166a
@ -11,13 +11,13 @@ requirements:
|
||||
- REND-01
|
||||
- REND-02
|
||||
estimate:
|
||||
tokens: 120000
|
||||
raw_tokens: 120000
|
||||
tokens: 62000
|
||||
raw_tokens: 62000
|
||||
tasks: 3
|
||||
confidence: low
|
||||
must_haves:
|
||||
truths:
|
||||
- "`.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md` 存在，且含 `07-LOADSTATE-AUDIT.md` 式骨架：「背景 / 方法 / 发现 / 触发序列（举例） / 判定为「匹配」的同类边界 / 未能从阅读确定（未猜测） / 处置」七段，加上独立成节的「② 数据端缺失接口」，共 8 个二级标题"
|
||||
- "`.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md` 存在，且含 `07-LOADSTATE-AUDIT.md` 式骨架：「背景 / 方法 / 发现 / 触发序列（举例） / 判定为「匹配」的同类边界 / 未能从阅读确定（未猜测） / 处置」七段，加上独立成节的「② 数据端缺失接口」，共 8 个二级标题；全文为 CRLF 换行（dev.md「其他要求」）"
|
||||
- "发现表每条记录精确到「接口名 + 所属文件:行 + 分类 + 问题描述 + 影响 + 置信 + 依据」（D-07）；分类只取 ① 错配（`#04-01-M-N`）或 ③ 多余旧路径（`#04-01-L-N`），② 数据端缺失另走独立节（D-08）"
|
||||
- "「② 数据端缺失接口」为独立节，每条以 `### #04-01-G-N：标题（严重度）` 登记并含「现状 / 期望」两段；节末有固定结论行（确认 N 项，或明示本步未确认缺失接口）"
|
||||
- "每条 `#04-01-M-*` / `#04-01-L-*` 记录的「所属文件:行」锚点指向 `packages-user/client-base` 或 `packages-user/client-modules` 的 tracked 源码行；每条 `#04-01-M-*` 在「依据」列引用至少一个数据端基准文件（`data-common` / `data-base` / `data-system` / `data-state` 的 `src/*.ts`），支持 D-05「以接口签名为准」"
|
||||
@ -28,7 +28,7 @@ must_haves:
|
||||
- path: .planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md
|
||||
provides: "渲染端 ↔ 数据端接口对账账本：8 段骨架 + 三分类记录表 + 独立的数据端缺失接口节 + 匹配边界 + 未确定段 + 处置结论；供用户决定后续适配与双布局如何拆分"
|
||||
key_links:
|
||||
- "发现表「所属文件:行」列 ↔ `packages-user/client-{base,modules}/src/**` 的 tracked 源码行（经 `git ls-files` 验证，不得指向 gitignored 镜像路径）"
|
||||
- "发现表「所属文件:行」列 ↔ `packages-user/client-{base,modules}/src/**` 的 tracked 源码行（不得指向 gitignored 镜像路径；由 Task 3 `<verify>` 的「锚点可追溯门禁」实际执行 `git ls-files packages-user/client-base packages-user/client-modules` 校验审计文档引用的全部 client 路径）"
|
||||
- "每条 `#04-01-M-*` 的「依据」列 ↔ 数据端 `types.ts` / `core.ts` / `ins.ts` 的现行接口签名（D-04/D-05）；接口名必须能在基准文件中逐字命中"
|
||||
- "「判定为『匹配』的同类边界」段 ↔ 04-PATTERNS.md §4 的 A3 组判据（`core.*` 读取先判「数据端状态」还是「渲染侧素材」），防止把素材读成数据端错配"
|
||||
- "「未能从阅读确定（未猜测）」段 ↔ 07-LOADSTATE-AUDIT.md:48-53 的证据纪律（静态阅读不能定论的链路只登记、不判定）"
|
||||
@ -89,6 +89,27 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
| CONTEXT | D-08 | 单文档分节；缺失接口独立成节 | 04-01 | COVERED | `## ② 数据端缺失接口` 独立节 + 固定结论行 |
|
||||
| CONTEXT | D-09 | 允许只读子代理 | 04-01 | COVERED | Task 2/3 允许派只读子代理分派 A1..A7 扫描组，仅回传文本，不得写文件 |
|
||||
| RESEARCH | — | （本阶段无 RESEARCH.md） | — | N/A | Phase 4 未产出 RESEARCH.md，无研究项需覆盖 |
|
||||
|
||||
## Estimate Basis（估算依据 — revision 2026-09-18）
|
||||
|
||||
`estimate-check` 初报 `tokens: 120000` 超出 `smart_zone_tokens` 100000 预算（ratio 1.20，`confidence: low`，`sample_count: 0`）。本计划按「执行者实际触及量」重测（chars/4；`estimate-calibration` factor 1.0，项目无历史样本，故 `confidence` 仍为 low），并在本次修订中把重型整文件读取改为**强制委派**，使单计划落在预算内：
|
||||
|
||||
| 部分 | 口径 | chars | ≈tokens |
|
||||
|------|------|-------|---------|
|
||||
| Task 1 读 + 写 | 结构参考文件 + 基准 `types.ts` + 骨架与两条实测记录 | ~53k | ~13k |
|
||||
| Task 2 读 + 写 | 契约桥 / 组合根 / 类型直连基准 + 子代理事实表 | ~49k | ~12k |
|
||||
| Task 3 读 + 写 | legacy 锚点切片 + 素材匹配判据 + ②节与处置定稿 | ~61k | ~15k |
|
||||
| 三项任务固定开销 | 计划上下文 / 校验命令 / 编辑 | — | ~9k |
|
||||
| **合计** | | | **~49k–62k** |
|
||||
|
||||
**为何 120000 不可直接采信（不可操作的原因）：** 初报值来自「全量整文件读」的朴素加总（被查文件全量约 450k chars ≈ 126k tokens），它假设执行者亲自读完整文件；但本计划按 D-09 把重型整文件组**强制**交由只读子代理（详见 Task 2 action (6) 与 Task 3 action (1)）：
|
||||
|
||||
- Task 2 委派组：`render/map/{renderer,vertex,types,moving,element,status}.ts`、`render/elements/props.ts`、`render/map/extension/hero.ts`；
|
||||
- Task 3 委派组：`render/ui/{main,statistics,viewmap,settings,save,toolbar,statusBar}.tsx`、`render/components/{choices,misc}.tsx`、`render/utils/saves.ts`、`fallback/load.ts`、`render/elements/{cache,misc}.ts`、`client-base/src/load/loader.ts`。
|
||||
|
||||
子代理只回传「接口名 + 所属 `file:line` + 数据端基准签名」或「legacy 调用 + 所属 `file:line` + 建议替代接口」事实表（不贴大段源码、不写文件），执行者据事实表定性并登记，因此执行者上下文是上表而非全量读之和。审计覆盖面（A1..A7）不变，仅读法改变。
|
||||
|
||||
**为何不拆分为多计划：** D-01/D-02 锁定本次第一步为**单一**只读对账计划（04-01，交付物 `04-RENDER-INTERFACE-AUDIT.md`）；拆分会违背用户决策。故对 `scope_sanity` 的非阻塞建议走「重测 + 强制委派（D-09）」路线而非 re-slice：`budget` 这一属性由**执行者上下文**满足，本计划的封面估算已按该口径给出。
|
||||
</objective>
|
||||
|
||||
<execution_context>
|
||||
@ -132,7 +153,7 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
- dev.md（「双端分离」：`@user/client-base` 为系统层、`@user/client-modules` 为实现层）
|
||||
</read_first>
|
||||
<action>
|
||||
(1) 新建 `04-RENDER-INTERFACE-AUDIT.md`，先写标题与 4 行元信息块（`**日期:** 2026-09-18`；`**范围:**` 被查 `packages-user/client-base` + `packages-user/client-modules`、`data-*` 为接口基准；`**性质:** 只读清点，未修改任何代码`；`**接口基准:**` 各包 `types.ts` / `core.ts` / `ins.ts` 的现行签名，D-04/D-05）。
|
||||
(1) 新建 `04-RENDER-INTERFACE-AUDIT.md`，先写标题与 4 行元信息块（`**日期:** 2026-09-18`；`**范围:**` 被查 `packages-user/client-base` + `packages-user/client-modules`、`data-*` 为接口基准；`**性质:** 只读清点，未修改任何代码`；`**接口基准:**` 各包 `types.ts` / `core.ts` / `ins.ts` 的现行签名，D-04/D-05）。**全文使用 CRLF 换行**（dev.md「其他要求」：换行使用 `CRLF` 格式）；Task 2/3 追加内容同样保持 CRLF，不得出现孤立 `LF`。
|
||||
(2) 写 `## 背景`：REND-01 / REND-02、D-01 增量规划、本次只清点不实施、以及「对账以接口为准、不受实现变动影响」的理由。
|
||||
(3) 写 `## 方法`：枚举面 = 04-PATTERNS.md 的 A1..A7 七组；判定口径 = 每条 `core.*` 读取先判「读的是数据端状态」还是「渲染侧素材/全局」；证据纪律 = 每条含 `file:line`、静态阅读不能定论者进「未能从阅读确定」；只读约束；并**实际执行** `git status --porcelain -- packages-user/client-base packages-user/client-modules`，把输出（预期为空）记入本节作为「扫描前基线」；写明允许只读子代理（D-09：仅回传文本、不得写文件）。
|
||||
(4) 写 `## 发现` 表头（列序固定：ID / 接口名 / 所属文件:行 / 分类 / 问题描述 / 影响 / 置信 / 依据），并**实测**填入每类各一条（不得直接照抄 04-PATTERNS.md 的锚点定性，必须打开基准文件核对）：
|
||||
@ -147,6 +168,8 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
<verify>
|
||||
<automated>node -e "const fs=require('fs');const p='.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md';const t=fs.readFileSync(p,'utf8');const need=['## \u80cc\u666f','## \u65b9\u6cd5','## \u53d1\u73b0','## \u2461 \u6570\u636e\u7aef\u7f3a\u5931\u63a5\u53e3','## \u89e6\u53d1\u5e8f\u5217\uff08\u4e3e\u4f8b\uff09','## \u5224\u5b9a\u4e3a\u300c\u5339\u914d\u300d\u7684\u540c\u7c7b\u8fb9\u754c','## \u672a\u80fd\u4ece\u9605\u8bfb\u786e\u5b9a\uff08\u672a\u731c\u6d4b\uff09','## \u5904\u7f6e'];const miss=need.filter(h=>t.indexOf(h)<0);if(miss.length>0){console.error('MISSING HEADINGS '+miss.length);process.exit(1)}const rows=t.split(/\r?\n/).filter(l=>/^\|\s*#04-01-[ML]-\d+\s*\|/.test(l));const bad=rows.filter(l=>!/:\d+/.test(l));if(rows.length<2||bad.length>0){console.error('BAD FINDING ROWS '+rows.length+'/'+bad.length);process.exit(1)}if(t.indexOf('#04-01-M-')<0||t.indexOf('#04-01-L-')<0){console.error('MISSING CATEGORY PREFIX');process.exit(1)}if(t.indexOf('\u2461\u8282\u7ed3\u8bba')<0){console.error('GAP SECTION WITHOUT CONCLUSION');process.exit(1)}console.log('OK headings 8 findingRows '+rows.length)"</automated>
|
||||
<fails_when>non-zero exit, 或 stderr 含 "MISSING HEADINGS" / "BAD FINDING ROWS" / "MISSING CATEGORY PREFIX" / "GAP SECTION WITHOUT CONCLUSION"</fails_when>
|
||||
<automated>node -e "const fs=require('fs');const p='.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md';const s=fs.readFileSync(p,'utf8');const lf=(s.match(/\n/g)||[]).length;const crlf=(s.match(/\r\n/g)||[]).length;if(lf!==crlf){console.error('NON-CRLF LINE ENDINGS '+(lf-crlf));process.exit(1)}console.log('OK CRLF lines '+crlf)"</automated>
|
||||
<fails_when>non-zero exit, 或 stderr 含 "NON-CRLF LINE ENDINGS"（审计文档出现非 CRLF 换行，违反 dev.md「换行使用 CRLF 格式」）</fails_when>
|
||||
</verify>
|
||||
<acceptance_criteria>
|
||||
- 审计文档存在于约定路径，且 8 个二级标题逐字存在（`## 背景` / `## 方法` / `## 发现` / `## ② 数据端缺失接口` / `## 触发序列（举例）` / `## 判定为「匹配」的同类边界` / `## 未能从阅读确定（未猜测）` / `## 处置`）
|
||||
@ -154,6 +177,7 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
- `#04-01-M-01` 的「依据」列引用 `packages-user/data-state/src/types.ts`（或该包基准）的具体行，且其定性来自实际阅读而非锚点照抄
|
||||
- 「② 数据端缺失接口」节存在且含固定结论行（`②节结论`）
|
||||
- `## 方法` 记录了 `git status --porcelain -- packages-user/client-base packages-user/client-modules` 的扫描前基线输出
|
||||
- 审计文档全文为 CRLF 换行（dev.md「其他要求」），Task 1 的 CRLF 门禁转绿
|
||||
- 被查两个渲染端包零改动
|
||||
</acceptance_criteria>
|
||||
<done>审计文档骨架与三分类各一条实测记录端到端贯通，结构/ID 门禁转绿；后续 Task 2/3 只需在同一模板上横向补齐，无需再改结构</done>
|
||||
@ -164,7 +188,7 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
<files>.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md</files>
|
||||
<read_first>
|
||||
- .planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md（Task 1 产出的现有内容，在同一模板上追加）
|
||||
- .planning/phases/04-render-adaptation/04-PATTERNS.md（§2 A1 契约桥、§3 A2 组合根/单例、§5 A4 新接口对照面、§6 A5 类型直连；「既有重构标记的处置口径」）
|
||||
- .planning/phases/04-render-adaptation/04-PATTERNS.md（§2 A1 契约桥、§3 A2 组合根/单例、§5 A4 新接口对照面、§6 A5 类型直连；「既有重构标记的处置口径」；只读所列章节，不读全文件）
|
||||
- packages-user/data-common/src/types.ts（L0 `IDataCommon` 基准）
|
||||
- packages-user/data-base/src/types.ts（L1 `IStateBase` 与 `IGameMap` / `IMapLayer` / `IGameMapHooks` 基准）
|
||||
- packages-user/data-system/src/types.ts（L2 `IStateSystem` 基准）
|
||||
@ -172,7 +196,7 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
- packages-user/data-common/src/replay/types.ts 与 packages-user/data-common/src/store/types.ts（录像/图块 raw-data 契约基准）
|
||||
- packages-user/client-base/src/types.ts（`IClientBase extends ICoreState`）与 packages-user/client-modules/src/types.ts（实现层契约 extends 系统层契约）
|
||||
- packages-user/client-modules/src/client.ts:46（`export class ClientCore extends CoreState implements IClientCore`）与 packages-user/client-modules/src/core.ts:1-6（单例 + 既有重构 TODO）
|
||||
- packages-user/client-modules/src/render/map/{renderer,moving,element,status,vertex,types}.ts、packages-user/client-modules/src/render/elements/props.ts、packages-user/client-modules/src/render/map/extension/hero.ts（数据端类型/契约直连与 `@ts-expect-error 需要重构` 标记）
|
||||
- packages-user/client-modules/src/render/map/{renderer,moving,element,status,vertex,types}.ts、packages-user/client-modules/src/render/elements/props.ts、packages-user/client-modules/src/render/map/extension/hero.ts（数据端类型/契约直连与 `@ts-expect-error 需要重构` 标记；整文件扫描按 action (6) 委派给只读子代理，执行者只在存疑处按 `file:line` 切片复核）
|
||||
</read_first>
|
||||
<action>
|
||||
(1) 枚举被查两包内所有 `@user/data-common|data-base|data-system|data-state` 的 import（含 `import type`），逐处打开基准文件比对**接口名、成员、参数/返回签名**是否仍成立：A1 契约桥（`IClientBase extends ICoreState` 后 `ICoreState` 新增/改名/删成员会使桥断裂）、A2 组合根（`ClientCore extends CoreState` 的 override 签名、`loading.once('coreInit')` 生命周期、`core.firstData.name` 读取点）、A5 类型直连（`IGameMap` / `IMapLayer` / `IGameMapHooks` / `ISaveableContent` / `IHeroMoveController` 等）。
|
||||
@ -180,7 +204,7 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
(3) 带 `// @ts-expect-error 需要重构` 的 import（`action/move.ts:3`、`render/map/extension/hero.ts:5,7,9`、`render/ui/main.tsx:28`）是强线索但**不是结论**：必须与基准文件实签核对后才定性；核对后仍成立的保持「匹配」并写入边界段，核对后发现签名已变的登记为 `#04-01-M-*`。
|
||||
(4) 把最高置信的 1–3 条错配的「调用 → 按旧形状解读 → 结果偏离」链路写进 `## 触发序列（举例）`（格式对照 07-LOADSTATE-AUDIT.md:29-35）。
|
||||
(5) 若某 import 的定性无法从静态阅读确定（例如依赖运行时形状、或基准文件正在被用户并行改动），写入 `## 未能从阅读确定（未猜测）`，**不得**登记为错配。
|
||||
(6) 允许派只读子代理分派 A1/A2/A4/A5 扫描组（D-09），子代理只回传文本，**不得写文件**；主执行者负责汇总与定性一致性。
|
||||
(6) **必须**按 D-09 派只读子代理完成重型整文件扫描（对应 Estimate Basis 的重测口径）：委派 `render/map/renderer.ts`、`render/map/vertex.ts`、`render/map/types.ts`、`render/map/moving.ts`、`render/map/element.ts`、`render/map/status.ts`、`render/elements/props.ts`、`render/map/extension/hero.ts`。子代理只回传事实表（每行：接口名 + 所属 `file:line` + 数据端基准签名或现行 import 原文），**不得写文件、不贴大段源码**；主执行者据事实表定性、登记并保证一致性，**不整文件读取上述八个文件**，只在事实表存疑时按 `file:line` 附近切片复核。
|
||||
(7) 只修改审计文档；不得改动任何生产源码，不得新增计划文件。
|
||||
</action>
|
||||
<verify>
|
||||
@ -203,18 +227,19 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
<files>.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md</files>
|
||||
<read_first>
|
||||
- .planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md（Task 1/2 产出，做定稿而非重写）
|
||||
- .planning/phases/04-render-adaptation/04-PATTERNS.md（§4 A3 legacy `core.*` 读取锚点表与判定口径、§7 A6 双布局既有资产、Shared Patterns「分类口径」「证据纪律」「只读约束」）
|
||||
- .planning/phases/04-render-adaptation/04-PATTERNS.md（§4 A3 legacy `core.*` 读取锚点表与判定口径、§7 A6 双布局既有资产、Shared Patterns「分类口径」「证据纪律」「只读约束」；只读所列章节，不读全文件）
|
||||
- .planning/phases/07-data-fixes/07-LOADSTATE-AUDIT.md:37-46（「判定为安全/匹配的同类边界」写法）与 :48-53（「未能从阅读确定（未猜测）」写法）
|
||||
- packages-user/data-base/src/game.ts:155,166,266-267（`hook`、`GameListener`、`@deprecated gameListener`）
|
||||
- packages-user/data-state/src/core.ts（顶层装配与 legacy bridge 落点）、packages-user/data-state/src/ins.ts（`state` 单例）
|
||||
- packages-user/entry-data/src/mota.ts:125-136（`r()` / `rf()` 渲染调用门控）
|
||||
- packages-user/data-system/src/path/types.ts 与 packages-user/data-state/src/types.ts（判定 legacy 读取的替代接口目标）
|
||||
- packages-user/client-modules/src/action/move.ts:66-67,97,123,156、packages-user/client-modules/src/render/ui/{main,statistics,viewmap,settings,save,toolbar,statusBar}.tsx、packages-user/client-modules/src/render/components/choices.tsx、packages-user/client-modules/src/fallback/load.ts、packages-user/client-modules/src/render/utils/saves.ts（A3 锚点面）
|
||||
- packages-user/client-base/src/load/loader.ts:103,129,151,167,188,284,418 与 packages-user/client-modules/src/render/elements/{cache,misc}.ts、packages-user/client-modules/src/render/components/misc.tsx（渲染侧素材族，用于「匹配」判据）
|
||||
- packages-user/client-modules/src/action/move.ts:66-67,97,123,156、packages-user/client-modules/src/render/ui/{main,statistics,viewmap,settings,save,toolbar,statusBar}.tsx、packages-user/client-modules/src/render/components/choices.tsx、packages-user/client-modules/src/fallback/load.ts、packages-user/client-modules/src/render/utils/saves.ts（A3 锚点面；整文件扫描按 action (1) 委派给只读子代理，执行者只按需切片）
|
||||
- packages-user/client-base/src/load/loader.ts:103,129,151,167,188,284,418 与 packages-user/client-modules/src/render/elements/{cache,misc}.ts、packages-user/client-modules/src/render/components/misc.tsx（渲染侧素材族，用于「匹配」判据；整文件扫描按 action (1) 委派给只读子代理，执行者只按需切片）
|
||||
- packages-user/client-modules/src/render/use.ts:22-52 与 packages-user/client-modules/src/shared.ts:33-97（双布局既有资产）
|
||||
</read_first>
|
||||
<action>
|
||||
(1) 按 04-PATTERNS.md §4 的 A3 锚点表逐处核对 legacy `core.*` 读取，对每处先判定「读的是数据端状态」还是「渲染侧素材/全局」：
|
||||
(1) 先按 D-09 派只读子代理完成 Task 3 的重型整文件扫描（对应 Estimate Basis 的重测口径）：委派 `render/ui/{main,statistics,viewmap,settings,save,toolbar,statusBar}.tsx`、`render/components/{choices,misc}.tsx`、`render/utils/saves.ts`、`fallback/load.ts`、`render/elements/{cache,misc}.ts`、`client-base/src/load/loader.ts`。子代理只回传事实表（每行：legacy 调用 + 所属 `file:line` + 建议替代接口/基准位置），**不得写文件、不贴大段源码**；执行者**不整文件读取上述文件**，只在事实表存疑时按 `file:line` 附近切片复核。
|
||||
然后按 04-PATTERNS.md §4 的 A3 锚点表逐处核对 legacy `core.*` 读取，对每处先判定「读的是数据端状态」还是「渲染侧素材/全局」：
|
||||
- 数据端状态类（如 `core.isReplaying()` / `core.isPlaying()` / `core.status.*` / `core.getNextLvUpNeed()` / `core.itemCount()` / `core.getLvName()` / `core.maps.*` / `core.flags.*` / `core.firstData.*` / `core.startGame()` / `core.status.replay.*`）→ 登记为 `#04-01-L-N`（N 从 2 递增，`L-01` 已在 Task 1 占用），分类=`③ 多余旧路径`，并在「依据」列写出应取代它的新接口/基准 `file:line`；
|
||||
- 纯渲染侧素材/全局（`core.material.images.*`、`core.materials`、`core.icons.icons` 等）→ **不登记为缺陷**，写入 `## 判定为「匹配」的同类边界` 并给出判据（对照 04-PATTERNS.md 「不得因出现 `core.` 就一律登记」）。
|
||||
每条记录含 接口名 / 所属文件:行 / 分类 / 问题描述 / 影响 / 置信 / 依据。
|
||||
@ -222,11 +247,15 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
(3) `## ② 数据端缺失接口` 定稿：逐条确认/补全 `### #04-01-G-N` 的「现状 / 期望」；最终结论行取固定两式之一。凡不能确认的候选一律不登记为缺失项，转入「未能从阅读确定（未猜测）」。
|
||||
(4) 定稿 `## 判定为「匹配」的同类边界`（至少覆盖 `core.material.*` 素材族、`hook`/`loading` 订阅新接口用法），定稿 `## 未能从阅读确定（未猜测）`（逐条说明为何静态阅读不能定论），定稿 `## 处置`（本步只读、零生产改动；后续适配与双布局未在本 run 规划、由用户决定拆分；`render/use.ts` 的 `Orientation`/`onOrientationChange` 与 `shared.ts` 布局常量登记为后续双布局起点，不展开实施）。
|
||||
(5) 全表 ID 唯一性自检：`#04-01-M-*` / `#04-01-L-*` / `#04-01-G-*` 各自序号连续且不重复；每条分类列与 ID 前缀一致（M=① 错配、L=③ 多余旧路径、G=② 数据端缺失）。
|
||||
(6) 门禁与提交：运行只读门禁与范围门禁（见 `<verify>`）；随后以 `docs(04-01): 渲染端 ↔ 数据端接口对账（只读清点，D-01 第一步）` 提交**仅**审计文档，不得提交任何被查源码改动，不得新增后续步骤的计划文件。
|
||||
(6) 门禁与提交：运行只读门禁、**锚点可追溯门禁**（`git ls-files packages-user/client-base packages-user/client-modules`，确认审计文档引用的每个 `packages-user/client-{base,modules}/**` 路径都是 tracked 源码、未指向 gitignored 镜像路径）、CRLF 门禁与范围门禁（见 `<verify>`）；追加内容保持 CRLF。随后以 `docs(04-01): 渲染端 ↔ 数据端接口对账（只读清点，D-01 第一步）` 提交**仅**审计文档，不得提交任何被查源码改动，不得新增后续步骤的计划文件。
|
||||
</action>
|
||||
<verify>
|
||||
<automated>node -e "const fs=require('fs');const t=fs.readFileSync('.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md','utf8');const rows=t.split(/\r?\n/).filter(l=>/^\|\s*#04-01-L-\d+\s*\|/.test(l));if(rows.length===0){console.error('NO LEGACY ROWS');process.exit(1)}const bad=rows.filter(l=>!/:\d+/.test(l));if(bad.length>0){console.error('LEGACY ROW WITHOUT ANCHOR '+bad.length);process.exit(1)}const lines=t.split(/\r?\n/);const gh=lines.map((l,i)=>({l:l.trim(),i:i})).filter(o=>/^### #04-01-G-\d+/.test(o.l));for(const g of gh){const body=lines.slice(g.i+1,g.i+7).join('\n');if(body.indexOf('\u73b0\u72b6')<0||body.indexOf('\u671f\u671b')<0){console.error('GAP ENTRY MISSING FIELDS');process.exit(1)}}if(t.indexOf('\u2461\u8282\u7ed3\u8bba')<0){console.error('GAP SECTION WITHOUT CONCLUSION');process.exit(1)}console.log('OK legacy rows '+rows.length+' gaps '+gh.length)"</automated>
|
||||
<fails_when>non-zero exit, 或 stderr 含 "NO LEGACY ROWS" / "LEGACY ROW WITHOUT ANCHOR" / "GAP ENTRY MISSING FIELDS" / "GAP SECTION WITHOUT CONCLUSION"</fails_when>
|
||||
<automated>node -e "const fs=require('fs'),cp=require('child_process');const t=fs.readFileSync('.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md','utf8');const paths=[...new Set(t.match(/packages-user\/(?:client-base|client-modules)\/[A-Za-z0-9._\/-]+\.tsx?/g)||[])];if(paths.length===0){console.error('NO CLIENT ANCHOR PATHS');process.exit(1)}const tracked=new Set(cp.execSync('git ls-files packages-user/client-base packages-user/client-modules',{encoding:'utf8'}).split(/\r?\n/).filter(Boolean).map(s=>s.replace(/\\/g,'/')));const missing=paths.filter(p=>!tracked.has(p));if(missing.length>0){console.error('UNTRACKED ANCHOR PATHS '+missing.length+' '+missing.join(','));process.exit(1)}console.log('OK tracked anchor paths '+paths.length)"</automated>
|
||||
<fails_when>non-zero exit, 或 stderr 含 "NO CLIENT ANCHOR PATHS" / "UNTRACKED ANCHOR PATHS"（审计文档引用了 `git ls-files` 不认识的路径，即 gitignored 镜像或被臆造的路径）</fails_when>
|
||||
<automated>node -e "const fs=require('fs');const s=fs.readFileSync('.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md','utf8');const lf=(s.match(/\n/g)||[]).length;const crlf=(s.match(/\r\n/g)||[]).length;if(lf!==crlf){console.error('NON-CRLF LINE ENDINGS '+(lf-crlf));process.exit(1)}console.log('OK CRLF lines '+crlf)"</automated>
|
||||
<fails_when>non-zero exit, 或 stderr 含 "NON-CRLF LINE ENDINGS"（审计文档出现非 CRLF 换行，违反 dev.md「换行使用 CRLF 格式」）</fails_when>
|
||||
<automated>git status --porcelain -- packages-user/client-base packages-user/client-modules</automated>
|
||||
<fails_when>stdout 非空（任一被查渲染端包出现改动/新增行）—— 违反只读约束</fails_when>
|
||||
<automated>node -e "const cp=require('child_process');const out=cp.execSync('git status --porcelain -- .planning/phases/04-render-adaptation',{encoding:'utf8'});const extra=out.split(/\r?\n/).filter(l=>/\d{2}-\d{2}-PLAN\.md/.test(l)&&l.indexOf('04-01-PLAN.md')<0);if(extra.length>0){console.error('UNEXPECTED PLAN FILES '+extra.length);process.exit(1)}console.log('OK plan scope')"</automated>
|
||||
@ -238,6 +267,7 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
- 「② 数据端缺失接口」节定稿：条目（如有）均含「现状 / 期望」，且节末结论行取固定两式之一；未确认候选在「未能从阅读确定（未猜测）」中逐条列出
|
||||
- `## 判定为「匹配」的同类边界` / `## 未能从阅读确定（未猜测）` / `## 处置` 三段均非空且符合 07-LOADSTATE-AUDIT 的写法；`## 处置` 含双布局资产登记与「后续步骤未在本 run 规划」的明确表述
|
||||
- ID 唯一且前缀与分类列一一对应（M=① 错配、L=③ 多余旧路径、G=② 数据端缺失）
|
||||
- 审计文档引用的每个 `packages-user/client-{base,modules}/**` 路径都能在 `git ls-files` 输出中命中（无 gitignored 镜像或被臆造路径）；全文为 CRLF 换行
|
||||
- `git status --porcelain -- packages-user/client-base packages-user/client-modules` 为空；`.planning/phases/04-render-adaptation` 下无 04-01 以外的计划文件
|
||||
- 审计文档已以 `docs(04-01)` 提交，提交内容仅含该文档
|
||||
</acceptance_criteria>
|
||||
@ -274,9 +304,11 @@ Output: `04-RENDER-INTERFACE-AUDIT.md`（本 run 唯一新增产物；零生产
|
||||
2. 错配门禁（Task 2）：每条 `#04-01-M-*` 含 `file:line` 且「依据」列引用 `data-common|data-base|data-system|data-state` 的 `src/*.ts`。
|
||||
3. 旧路径与缺失节门禁（Task 3）：每条 `#04-01-L-*` 含 `file:line`；每个 `### #04-01-G-*` 之后紧跟的 6 行内含「现状」「期望」；② 节结论行存在。
|
||||
4. 只读门禁（Task 3）：`git status --porcelain -- packages-user/client-base packages-user/client-modules` 输出为空。
|
||||
5. 范围门禁（Task 3）：`.planning/phases/04-render-adaptation` 下除 `04-01-PLAN.md` 外无其它 `*-PLAN.md`（后续步骤未被规划）。
|
||||
6. 人工核对：`## 判定为「匹配」的同类边界` 的素材族判据、`## 未能从阅读确定（未猜测）` 的逐条理由、`## 处置` 的双布局资产登记与「后续步骤未在本 run 规划」表述均齐备。
|
||||
7. 提交：`docs(04-01)` 仅含审计文档。
|
||||
5. 锚点可追溯门禁（Task 3）：审计文档引用的每个 `packages-user/client-{base,modules}/**` 路径都能在 `git ls-files packages-user/client-base packages-user/client-modules` 输出中命中（落实 `must_haves.key_links[0]`）。
|
||||
6. CRLF 门禁（Task 1 与 Task 3）：审计文档无孤立 `LF`，全文为 CRLF（dev.md「换行使用 CRLF 格式」）。
|
||||
7. 范围门禁（Task 3）：`.planning/phases/04-render-adaptation` 下除 `04-01-PLAN.md` 外无其它 `*-PLAN.md`（后续步骤未被规划）。
|
||||
8. 人工核对：`## 判定为「匹配」的同类边界` 的素材族判据、`## 未能从阅读确定（未猜测）` 的逐条理由、`## 处置` 的双布局资产登记与「后续步骤未在本 run 规划」表述均齐备。
|
||||
9. 提交：`docs(04-01)` 仅含审计文档。
|
||||
</verification>
|
||||
|
||||
<success_criteria>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user