docs(04): register 04-05/04-06 and sync progress metadata

This commit is contained in:
unanmed 2026-09-21 23:17:21 +08:00
parent 3fadf34fff
commit 58a8e6806e
4 changed files with 14 additions and 8 deletions

View File

@ -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) | - |

View File

@ -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

View File

@ -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 在对账执行时按实际情况把握,但不得据此扩大范围。

View File

@ -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"
}