diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index 6011a8a..8321138 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -181,7 +181,7 @@ Plans: 3. 移动端(窄屏)布局下,同一场景正常显示且可操作 4. 数据端与渲染端保持双端分离——数据端无 DOM,仍可在 Node 环境跑回放验证 -**Plans**: 5/5 plans executed(04-01..04-05)+ 1 planned(04-06,material 接口影响范围清点·只读,未执行) +**Plans**: 5 of 6 executed(04-01..04-05)+ 04-06 planned(material 接口影响范围清点·只读,未执行) **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. 渲染适配与双布局 | 4/4 | In Progress| | +| 4. 渲染适配与双布局 | 5/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 8f2ad4a..34b790b 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -5,14 +5,14 @@ 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-19T08:59:27.618Z" -last_activity: 2026-09-18 +last_updated: "2026-09-21T15:16:11.920Z" +last_activity: 2026-09-21 last_activity_desc: Phase 04 execution started -state_head: 0ad933368c4b2245bba179acdcda4a7b45e5eb7c +state_head: 3fadf34fff51c15c9f105806a278e6a8478fb6af progress: total_phases: 7 completed_phases: 0 - total_plans: 75 + total_plans: 77 completed_plans: 74 milestone_name: milestone --- @@ -29,7 +29,7 @@ See: .planning/PROJECT.md (updated 2026-09-17) ## Current Position Phase: 04 (渲染适配与双布局) — READY TO EXECUTE -Plan: 4 of 4 +Plan: 5 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 b571e94..ad7061e 100644 --- a/.planning/phases/04-render-adaptation/04-CONTEXT.md +++ b/.planning/phases/04-render-adaptation/04-CONTEXT.md @@ -64,6 +64,12 @@ - **D-28:** **存量 `state` 使用暂不处理**(含 `hero.ts` 的 `state.roleFace.getFaceOf`):这涉及引擎整体的底层架构,由用户后续统一整改。本阶段**不因「不得使用单例」而清除存量**;改动只约束新增/后续代码。 - **D-29:** **`degrade` 与 `next` 均用 `Dir4FaceHandler`**(贴图只有四向;与移动 (Dir8) 失配,需单独处理)。因构造器参数已多,**`MapHeroRenderer` 构造器改为直接传入 `IFaceManager`**(`data-common/src/common/faceManager.ts:13`;`core.ts:117-120` 注册 `FaceGroup.Dir4`/`Dir8`):`degrade` / `next` 经 `faceManager.get(FaceGroup.Dir4)` 取四向处理器;移动相关的 `movement` 仍取勇士自身 `mover.faceHandler`(Dir8)。**注入路径走 B**:`IMapExtensionManager.addHero(state, layer, faceManager)` 新增 `faceManager: IFaceManager` 参数(**改 `types.ts` 接口**),`manager.ts` 转发给构造器;未来接线处再传。后续用户再进一步改进。 +### 下一个目标:material 接口适应(用户裁定,2026-09-21;待规划) +- **D-30:** 下一个任务 = **完成 material 相关的接口适应**。用户已自行修改接口 `packages-user/client-base/src/types.ts`(提交 `4e305e3 refactor(type): material types.`,涉及 `material/types.ts`、`types.ts`、多个消费者的同步改名)并改完受影响的一部分内容;剩余未适应的实现与消费者由本任务处理。 +- **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`(只读,允许派只读子代理);第二步待用户审阅第一步结果后再规划。 + ### the agent's Discretion - D-07 的「影响」字段具体写法、「多余旧路径」是否需要进一步细分,交由 AI 在对账执行时按实际情况把握,但不得据此扩大范围。 diff --git a/.planning/state.json b/.planning/state.json index 45708db..602c80e 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-19T08:58:48.919Z" + "updated_at": "2026-09-21T15:16:12.042Z" }