docs(04-04): sync roadmap/state metadata for D-29 revision

This commit is contained in:
unanmed 2026-09-19 15:09:38 +08:00
parent b59710ac7d
commit 2169af4c67
3 changed files with 5 additions and 4 deletions

View File

@ -181,7 +181,7 @@ Plans:
3. 移动端(窄屏)布局下,同一场景正常显示且可操作
4. 数据端与渲染端保持双端分离——数据端无 DOM,仍可在 Node 环境跑回放验证
**Plans**: 4 plans(第一步·只读对账已完成;第二步·勇士移动接口探索(只读)已完成;第三步·勇士本体适配已执行;第四步·勇士渲染修正(04-03 人工审查反馈 D-24..D-28)已规划,待执行 — 04-CONTEXT D-01/D-02/D-13/D-17/D-18/D-19/D-20/D-21/D-22/D-24..D-28;其余渲染适配与移动端/桌面端双布局待后续增量另行规划)
**Plans**: 4 plans(第一步·只读对账已完成;第二步·勇士移动接口探索(只读)已完成;第三步·勇士本体适配已执行;第四步·勇士渲染修正(04-03 人工审查反馈 D-24..D-28,D-29 修订为注入 `IFaceManager`)已规划,待执行 — 04-CONTEXT D-01/D-02/D-13/D-17/D-18/D-19/D-20/D-21/D-22/D-24..D-29;其余渲染适配与移动端/桌面端双布局待后续增量另行规划)
Plans:
**Wave 1**
@ -198,7 +198,7 @@ Plans:
**Wave 4** *(blocked on Wave 3 completion)*
- [ ] 04-04-PLAN.md — 勇士渲染修正(04-03 人工审查反馈 D-24..D-28):`render/map/extension/{hero,manager}.ts` 注入 `IFaceHandler<FaceDirection>` 并替换三个弃用 helper(D-24)、拆分 `MapHeroLocationHook` / `MapHeroMoverHook` 且 `onSetPos` 无条件(D-25)、补 `AnimDir`(D-26)、改 `@motajs/animate` 的 `ExcitationCurve2D`(D-27)、保留存量 `state` 用法(D-28);不改 `types.ts`、不新增数据端接口,排除 D-18/D-19/D-22
- [ ] 04-04-PLAN.md — 勇士渲染修正(04-03 人工审查反馈 D-24..D-29):`render/map/extension/{hero,types,manager}.ts` 注入 `IFaceManager`(`faceManager`;`degrade`/`next` 走 `Dir4FaceHandler`、`movement` 走勇士 `mover.faceHandler`(Dir8)——D-24/D-29)并替换三个弃用 helper;`IMapExtensionManager.addHero(state, layer, faceManager)` 新增参数(D-29,改 `types.ts` 接口签名);拆分 `MapHeroLocationHook` / `MapHeroMoverHook` 且 `onSetPos` 无条件(D-25)、补 `AnimDir`(D-26)、改 `@motajs/animate` 的 `ExcitationCurve2D`(D-27)、保留存量 `state` 用法(D-28);不新增数据端接口,排除 D-18/D-19/D-22
**UI hint**: yes
@ -393,7 +393,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. 渲染适配与双布局 | 3/3 | In Progress| |
| 4. 渲染适配与双布局 | 3/4 | In Progress| |
| 5. Legacy 移植 | 0/TBD | Not started | - |
| 6. 单元测试 | 18/18 | In Progress| |
| 7. 数据端缺陷修复 | 15/16 | 暂缓 (Deferred) | - |

View File

@ -29,7 +29,7 @@ See: .planning/PROJECT.md (updated 2026-09-17)
## Current Position
Phase: 04 (渲染适配与双布局) — READY TO EXECUTE
Plan: 3 of 3
Plan: 3 of 4
Status: Ready to execute
Last activity: 2026-09-18 — Phase 04 execution started

View File

@ -62,6 +62,7 @@
- **D-26:** 补上 **`AnimDir` 的设置**(`ObjectMoveType.AnimDir` 分支不再跳过)。
- **D-27:** **不使用 `mutate-animate`**,改用功能更全的 `@motajs/animate`(前者能实现的后者都能实现)。**本次范围仅限删除勇士(`render/map/extension/hero.ts`)对 `mutate-animate` 的调用并改用 `@motajs/animate`**;其余存量使用由用户自己逐步处理。
- **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` 转发给构造器;未来接线处再传。后续用户再进一步改进。
### the agent's Discretion
- D-07 的「影响」字段具体写法、「多余旧路径」是否需要进一步细分,交由 AI 在对账执行时按实际情况把握,但不得据此扩大范围。