From ac69d31cbb798a328f0190f976230827ebac476e Mon Sep 17 00:00:00 2001 From: unanmed <1319491857@qq.com> Date: Tue, 22 Sep 2026 10:29:20 +0800 Subject: [PATCH] docs(04-06): complete material impact study; sync state --- .planning/ROADMAP.md | 4 ++-- .planning/STATE.md | 8 ++++---- .planning/phases/04-render-adaptation/04-CONTEXT.md | 1 + .planning/state.json | 2 +- 4 files changed, 8 insertions(+), 7 deletions(-) diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index 8321138..5683a22 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -181,7 +181,7 @@ Plans: 3. 移动端（窄屏）布局下，同一场景正常显示且可操作 4. 数据端与渲染端保持双端分离——数据端无 DOM，仍可在 Node 环境跑回放验证 -**Plans**: 5 of 6 executed（04-01..04-05）+ 04-06 planned（material 接口影响范围清点·只读，未执行） +**Plans**: 6 of 6 executed（04-01..04-06；04-06 = material 接口影响范围清点·只读，已执行）。material 接口适应第二步（实施）待用户审阅清点结果后另行规划；渲染适配与移动端/桌面端双布局（REND-01/REND-02）整体仍未完成 **Plan register note (2026-09-21):** 第五个增量 `04-05`（收口 `#04-01-M-06` / `#04-01-M-09`：状态栏 9 个数值属性改经 `client.hero.attribute.getFinalAttribute(...)` 读取 + 逐图层钩子类 `RendererLayerHook`，2026-09-20 执行）此前未登记进本路线图，本次一并补登；第六个增量 `04-06` = material 接口适应（D-30/D-31/D-32）**第一步·只读影响清点**，产出 `04-MATERIAL-INTERFACE-IMPACT.md`，第二步（实施）待用户审阅后另行规划。 Plans: @@ -399,7 +399,7 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6 → 7 | 1. 事件系统 | 13/13 | In Progress| | | 2. 寻路系统 | 5/5 | In Progress| | | 3. 数据端完成 | 19/19 | Complete | 2026-09-12 | -| 4. 渲染适配与双布局 | 5/6 | In Progress| | +| 4. 渲染适配与双布局 | 6/6 | In Progress| | | 5. Legacy 移植 | 0/TBD | Not started | - | | 6. 单元测试 | 18/18 | In Progress| | | 7. 数据端缺陷修复 | 15/16 | 暂缓 (Deferred) | - | diff --git a/.planning/STATE.md b/.planning/STATE.md index 34b790b..e919353 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -5,15 +5,15 @@ current_phase: 04 current_phase_name: 渲染适配与双布局 status: executing stopped_at: Completed 04-04-PLAN.md（勇士渲染修正：注入 IFaceManager、拆钩子类、补 AnimDir、换 @motajs/animate，三文件机器门禁全绿；REND-01/REND-02 保持 Pending） -last_updated: "2026-09-21T15:16:11.920Z" +last_updated: "2026-09-22T02:28:19.679Z" last_activity: 2026-09-21 last_activity_desc: Phase 04 execution started -state_head: 3fadf34fff51c15c9f105806a278e6a8478fb6af +state_head: 85f65b8f551e700992664b4f14700cd3cf0f4074 progress: total_phases: 7 completed_phases: 0 total_plans: 77 - completed_plans: 74 + completed_plans: 76 milestone_name: milestone --- @@ -29,7 +29,7 @@ See: .planning/PROJECT.md (updated 2026-09-17) ## Current Position Phase: 04 (渲染适配与双布局) — READY TO EXECUTE -Plan: 5 of 6 +Plan: 6 of 6 Status: Ready to execute Last activity: 2026-09-21 — Completed quick task 260921-lwa: Upgrade toolchain to pnpm 12.5.1 and Node 24 diff --git a/.planning/phases/04-render-adaptation/04-CONTEXT.md b/.planning/phases/04-render-adaptation/04-CONTEXT.md index ad7061e..e65d059 100644 --- a/.planning/phases/04-render-adaptation/04-CONTEXT.md +++ b/.planning/phases/04-render-adaptation/04-CONTEXT.md @@ -69,6 +69,7 @@ - **D-31:** 本次改动的根因：用户**重写了 Texture 的底层管理器，删除 `big-image` 概念**（旧样板概念，新引擎不再需要；旧兼容可**无痛丢弃**）。`4e305e3` 已从接口删除 `IBigImageReturn` / `isBigImage` / `getBigImage` / `getIfBigImage` / `getBigImageByAlias` / `setBigImage` / `bigImageStore`，并把 `IMaterialManager`→`ITextureManager`、`IMaterialGetter`→`ITextureGetter`、`IMaterialAliasGetter`→`ITextureAliasGetter`，新增 `textures` 与 `ICoreStateExtended` 约束。**影响面可能很大。** - **D-32:** 计划分**两步**：**第一步**收集影响范围（只读清点）；**第二步**进行修改。第二步骤第一步结果与用户审阅后再规划。 - **边界确认（2026-09-21）：** 范围限 `packages-user`；`packages` 不纳入（理应不受本改动影响）。**以 `packages-user/client-base/src/types.ts`（及 `material/types.ts`）为基准**。**若发现其余 big-image 残留，必须在清点文档中报告。** `src/` 或 `packages/` 内若命中，仅报告、不修改。第一步产出 `.planning/phases/04-render-adaptation/04-MATERIAL-INTERFACE-IMPACT.md`（只读，允许派只读子代理）；第二步待用户审阅第一步结果后再规划。 +- **D-33:** **范围外一律不改**；**不追求解决全部类型错误**（整仓 199 条中大量为既有/无关），**只修复与本次 material 接口适应相关的项**。第二步实施时严格按此约束。 ### the agent's Discretion - D-07 的「影响」字段具体写法、「多余旧路径」是否需要进一步细分，交由 AI 在对账执行时按实际情况把握，但不得据此扩大范围。 diff --git a/.planning/state.json b/.planning/state.json index 602c80e..f8f3805 100644 --- a/.planning/state.json +++ b/.planning/state.json @@ -44,5 +44,5 @@ "label": "Advance to the next step", "reason": "Phase 04 of 7 · executing" }, - "updated_at": "2026-09-21T15:16:12.042Z" + "updated_at": "2026-09-22T02:28:19.843Z" }