@ -0,0 +1,468 @@
---
phase: 04-render-adaptation
plan: 5
type: execute
wave: 5
depends_on:
- 04-01
files_modified:
- packages-user/client-modules/src/render/ui/main.tsx
- packages-user/client-modules/src/render/map/renderer.ts
autonomous: false
requirements:
- REND-01
- REND-02
estimate:
tokens: 51000
raw_tokens: 51000
tasks: 4
confidence: low
must_haves:
truths:
- "**本计划的第一个 block 点**是 Task 0 的 `blocking-human` 汇报关卡： （ `#04-01-M-06` 与 `#04-01-M-09` ） （ `main.tsx` 的 9 处 `getHeroStatusOn(...)` 改为经 `client` 读新数据端属性接口 `client.hero.attribute.getFinalAttribute(...)` ； `RendererLayerHook` ，把 `onUpdateArea` / `onUpdateBlock` 转发到 `renderer.updateLayerArea(layer, ...)` / `renderer.updateLayerBlock(layer, ...)` ）、**拟新增 / 删除的成员命名清单**（唯一已获批准的新增名是 `RendererLayerHook` ；其余拟名 `renderer` / `layer` / `layerHooks` / `syncLayerHooks` 须当场获批或改由用户指定）、**必须移除 `main.tsx:28` 的 `// @ts-expect-error 需要重构` 编译器指令**这一项单独列出（移除未使用的 `@ts-expect-error` 指令本身会产生新诊断 TS2578， ； ， ） ， ） ， （ ）
- "**M-06 落地（`#04-01-M-06`） ： `packages-user/client-modules/src/render/ui/main.tsx` 中 `getHeroStatusOn` 以词边界判定计数为 **0** （ `client.hero.attribute.getFinalAttribute('<key>')` 且该调用形态出现 **9** 次，键依次为 `atk` / `hp` / `hpmax` / `mana` / `manamax` / `def` / `mdef` / `money` / `exp` （与 `IHeroAttr` 的九个数值键一一对应，`data-common/src/types.ts:23-44`） ； **保留** （ `state.maps` 属 M-08， ）
- "**M-06 的编译器指令处置：** `main.tsx:28` 的 `// @ts-expect-error 需要重构` 已移除——该指令唯一作用是压制 `getHeroStatusOn` 未导出的 TS2305； ， （ ： @ts -expect-error` 下一行 import 可解析时报 `error TS2578: Unused '@ts-expect-error' directive.` ），从而在改动文件上新增诊断、违反「改动文件类型诊断不增加」门禁。移除该行后，`@user/data-state` import 上方不再有 `@ts-expect-error` ，且 `import` 之间不再夹注释（顺带符合 `dev.md:55` ） ； `state.maps` 的 `@ts-expect-error 需要重构` **逐字保留** （本计划不动 M-08） ， `@ts-expect-error` 计数由 **2 变为 1** ， `@ts-expect-error` 」"
- "**M-06 范围外零改动：** `main.tsx` 除 import 的 `getHeroStatusOn` 与该 9 处调用外，`core.*` 读取（`:99`、`:103`、`:113`-`:125`、`:127`-`:134`、`:139`、`:155`、`:165`、`:198`、`:207`、`:216`）一律保持原样（`core.*` 属第五阶段， ） ； `state.maps` → `layerState` （ ） `statistics.tsx` （ ） ；
- "**M-09 落地（`#04-01-M-09`） ： `packages-user/client-modules/src/render/map/renderer.ts` 新增模块内（不导出）类 ** `RendererLayerHook implements Partial<IMapLayerHooks>` **（用户已批准该类名），实现 `onUpdateArea(x, y, width, height)` 与 `onUpdateBlock(block, x, y)` ，分别转发 `this.renderer.updateLayerArea(this.layer, x, y, width, height)` 与 `this.renderer.updateLayerBlock(this.layer, block, x, y)` （对应数据端现行逐图层契约 `data-base/src/map/types.ts:222` / `:230` ）
- "**M-09 的旧错误注册清零：** `renderer.ts` 中 `onUpdateLayerArea` / `onUpdateLayerBlock` 计数为 **0** （ **保留其 map 级职责** `onChangeBackground` / `onResizeLayer` / `onUpdateLayer` （对应 `IGameMapHooks` 现行成员，`data-base/src/map/types.ts:588-608`），类名不改"
- "**M-09 的注册路径：** 逐图层钩子经 `layer.addHook(new RendererLayerHook(...))` 注册并 `.load()` （与既有 `door.ts:22-23` 的 `MapDoorRenderer` / `MapDoorHook` 范式一致），注册/注销发生在**图层状态变更路径**——`MapRenderer.setLayerState`（ `MapRenderer.updateLayerList` （ `RendererLayerStateHook.onUpdateLayer` 在 `GameMap.addLayer` / `removeLayer` 后触发）；换地图或图层被移除时对旧控制器 `.unload()` 并移出登记，**不泄漏钩子**"
- "**契约面零变更：** 不新增 / 删除任何公共接口成员——`IMapRenderer`（ `IGameMapHooks` 等数据端契约不变、`RendererLayerHook` 为模块内私有类不导出；不改任何数据端文件与 `packages/**` ；不新增依赖、不改 `package.json` / `pnpm-lock.yaml` "
- "**D-23 的显式例外已记录：** 本计划在 M-06 中使用 `client` （ `client` / `state` 全局单例，若有必须调用之处停下告知用户」相冲突，**但用户已就本增量明确裁定**：原话「先用 client 读，这部分还未完成重构，后续我再进行处理」。故本计划按用户裁定使用 `client` ，不因 D-23 停摆；`main.tsx` 的存量 `core.*` 与 `client.*` 混用**不在本计划清理范围**"
- "**验证可运行且不臆造通过：** 改动前先记录 `pnpm exec vue-tsc --noEmit` 的 `client-modules` 基线错误集（当日实际值，逐行原样入 SUMMARY； **0** 条），改动后该错误集必须与基线**完全一致**，且 `main.tsx` / `renderer.ts` 命中 0 条；`pnpm exec eslint` 对两个被改文件 0 错误； （ ： `getFinalAttribute` =9 / 九键齐 / `state` import 在 / `@user/data-state` import 上方 `@ts-expect-error` 清零且全文件计数为 1（ `main.tsx:247` 的 M-08 指令） ； ： `this.layer` 、`onUpdateLayerArea` / `onUpdateLayerBlock` =0、`RendererLayerStateHook` 三个 map 级成员在、`addHook` 注册在） `client.ts:151-155` 的 `addHero` 接线仍为注释、`MapExtensionManager.addHero` 无调用点，故运行时渲染无法观察：本计划的实质验证为「编译 + 契约 + 静态」三类机器门禁，另附人工代码复核；**不得**以任何无法运行的门禁冒充通过"
- "用户并发的未提交改动（以 Task 1 起始 `git status --porcelain` 当日实测为准，排除 `packages-user/client-modules/src/render/ui/main.tsx` 、`packages-user/client-modules/src/render/map/renderer.ts` 两个在范围文件与 `.planning/phases/04-render-adaptation/` 前缀）在 Task 1 起始记录基线（ ） ， `packages-user/data-state/src/types.ts` 、`src/content/core.jsonc`、`src/content/client.jsonc`，执行时以当日实测为准）"
- "REND-01 / REND-02 在本 run 后仍保持 Pending： `#04-01-M-09` ），未实施其余渲染适配与移动端 / 桌面端双布局（见 assumptions 的两条 FLAGGED ASSUMPTION）
artifacts:
- path: packages-user/client-modules/src/render/ui/main.tsx
provides: "状态栏 `updateStatus()` 的 9 个数值属性改为经 `client.hero.attribute.getFinalAttribute(...)` 读取（ ） ； `:28` 上方的 `@ts-expect-error` 指令移除（`:247` 服务于 M-08 `state.maps` 的同名指令逐字保留）；`state` import 保留；其余 `core.*` 读取原样"
- path: packages-user/client-modules/src/render/map/renderer.ts
provides: "新增模块内类 `RendererLayerHook` （ < IMapLayerHooks > `）把 `onUpdateArea` / `onUpdateBlock` 转发到 `MapRenderer.updateLayerArea` / `updateLayerBlock` ；逐图层注册/注销落在 `setLayerState` / `updateLayerList` ； `onUpdateLayerArea` / `onUpdateLayerBlock` 并保留 map 级职责"
key_links:
- "`client`（ ， `ClientCore extends CoreState` （ `CoreState.hero: IHeroState<IHeroAttr>` （ ， `IHeroState.attribute: IReadonlyHeroAttribute<IHeroAttr>` （ `getFinalAttribute<K extends keyof IHeroAttr>(name: K): IHeroAttr[K]` （ ）
- "`IHeroAttr` 的九个数值键 `atk` / `hp` / `hpmax` / `mana` / `manamax` / `def` / `mdef` / `money` / `exp` （ `ILeftHeroStatus` 对应字段类型均为 `number` （ ）
- "`IMapLayerHooks.onUpdateArea(x, y, width, height)`（ `MapLayer.putMapData` 经 `forEachHook` 触发（`mapLayer.ts:299-301`） ； （ `MapLayer.setBlock` 触发（`mapLayer.ts:242-244`）
- "`IMapLayer.addHook(hook): IMapLayerHookController` + `.load()` / `.unload()` 范式：既有同类实现 `MapDoorRenderer` （ `RendererLayerHook` 注册"
- "`MapRenderer.updateLayerArea(layer, x, y, w, h)`（ `vertex.updateArea(...)` ； （ `vertex.updateBlock(...)` （此前永不被触发，见 `#04-01-M-09` ）
- "`MapRenderer.setLayerState(map: IGameMap)`（ `render/map/element.ts:20,103` 经 `layerState` 变更驱动）/ `MapRenderer.updateLayerList()` （ `RendererLayerStateHook.onUpdateLayer` （ `GameMap.addLayer` / `removeLayer` （ ，
- "数据端现行 `IGameMapHooks` 只有 `onChangeBackground?` / `onUpdateLayer?` / `onResizeLayer?` （ `RendererLayerStateHook` 上 `onUpdateLayerArea` / `onUpdateLayerBlock` 既非契约成员、也永不被调用的根因"
- "`pnpm exec vue-tsc --noEmit` 的 `client-modules` 错误集基线（ ；
assumptions:
- "**FLAGGED ASSUMPTION（ ） ： （ ） ； `#04-01-M-06` 与 `#04-01-M-09` 两条 ① 错配的修复。用户须在推进其余渲染适配前补齐 REND-01 的边界判据。"
- "**FLAGGED ASSUMPTION（ ） ： （ ） ； ，
- "**D-23 的用户例外（须原样汇报）：** D-23 禁止新增 / 后续代码使用 `client` / `state` 全局单例，并要求「若有必须调用它们的地方，停止执行并告知用户」。本计划 M-06 恰恰要用 `client` ，与 D-23 表面冲突；**但用户已就本增量明确裁定**原话：「先用 client 读， ， （ `client` per user decision） ，
- "**执行前必须复核（未确定项，不猜）：** Task 1 步骤 (0a) 必须在动手前打开当日 HEAD 的基准文件逐条确认：① `IHeroAttr` 的九个数值键仍在且类型为 `number` （ `IHeroState.attribute: IReadonlyHeroAttribute<THero>` 与 `getFinalAttribute<K extends keyof THero>(name: K): THero[K]` 签名未变（`data-base/src/hero/types.ts:106` / `:896` ）；③ `CoreState.hero` 仍为公开只读成员且在构造期赋值（`data-state/src/core.ts:86` / `:144` ）；④ `getHeroStatusOn` 在 `@user/data-state` barrel 与全仓库仍无导出定义（`data-state/src/index.ts:1-9`）；⑤ `IHeroAttr` 的键名与 `ILeftHeroStatus` 的字段名逐一对得上（`render/ui/statusBar.tsx:17-39`）；⑥ `IMapLayerHooks.onUpdateArea` / `onUpdateBlock` 签名仍为 `(x, y, width, height)` / `(block, x, y)` （ `:230` ），且 `IGameMapHooks` 仍**不含** `onUpdateLayerArea` / `onUpdateLayerBlock` （ `MapLayer.putMapData` / `setBlock` 仍经 `forEachHook` 触发上述两个钩子（`mapLayer.ts:299-301` / `:242-244` ）；⑧ `IMapLayer.addHook` 返回 `IMapLayerHookController` （ `GameMap.addLayer` / `removeLayer` 会在图层列表变化时触发 map 级 `onUpdateLayer` （ `:80-82` ）。**任一条不同即停下汇报并修订本计划，不得按记忆或文档示例改代码。**"
- "**`@ts-expect-error` 移除的依据（已实测）：** 在仓库外临时目录用本仓 `node_modules/.bin/tsc` 复现——`// @ts -expect-error` 的下一行 import 可正常解析时报 `error TS2578: Unused '@ts-expect-error' directive.` 。故 `main.tsx` 删除 `getHeroStatusOn` 后必须同时删除 `:28` 的指令，否则新增诊断。该行是既有注释，按 AGENTS.md 须用户批准（
- "**成员命名需用户同意（ ） ： `RendererLayerHook` 。其余拟名——`RendererLayerHook` 的两个构造器只读字段 `renderer` / `layer` （照 `MapDoorHook` / `MapDoorRenderer` 既有写法）、`MapRenderer` 的新增私有字段 `layerHooks: Map<IMapLayer, IMapLayerHookController>` 、新增私有方法 `syncLayerHooks(): void` ——**均待 Task 0 用户批准或改名**；未获批准前执行者不得落地这些名字（可停下改由用户指定）。**不删除任何既有命名**（ `MapRenderer` 成员一律保留）。"
- "**运行时 UAT 不可得（诚实降级）：** 渲染端无测试设施（`client-modules` 无 `*.test.*` ），且 `client.ts:151-155` 的 `addHero` 接线仍为注释、`MapExtensionManager.addHero` 无调用点，故运行时渲染（状态栏数值、地图区域/图块更新后的顶点刷新）无法在渲染环境观察。本计划的验收为 `pnpm exec vue-tsc --noEmit` 的 scoped 类型门禁 + 静态 / 契约门禁 + `pnpm exec eslint` + CRLF + 基线感知范围 / 并发基线门禁 + 人工代码复核；运行时 UAT 顺延到启用接线的增量，**不伪造绿**。"
- "**数据端实现可能被用户并发修改（ ） ：
prohibitions:
- "不得在用户明确回复「可以执行」四个字之前执行本计划的任何任务、或派发任何执行子代理（ `yolo` / `auto_advance` 模式而放宽）。"
- "不得把范围扩大到 `#04-01-M-06` / `#04-01-M-09` 之外的任何对账项：`#04-01-M-01`（ ， （ `ItemState` ）、`#04-01-M-08`（ `state.maps` ，用户原话「其他几个都涉及到接口的调整，这部分我自己来」）、`#04-01-M-02..M-05`（勇士本体，已由 04-03 / 04-04 处置）与全部 ③ 多余旧路径（`core.*`，
- "不得改动 `main.tsx` 中除 import 的 `getHeroStatusOn` 、`:28` 的 `@ts-expect-error` 指令与该 9 处调用以外的任何内容：其余 `core.*` （含 `core.status.*` / `core.getNextLvUpNeed()` / `core.getLvName()` / `core.itemCount()` / `core.isReplaying()` / `core.doRegisteredAction()` / `core.status.stepPostfix` / `core.status.lockControl` ）与 `:248` 的 `state.maps` 保持原样；`client.flags.*` 用法保持原样。"
- "不得改动 `renderer.ts` 的 `RendererLayerStateHook` 类名与其 map 级成员（`onChangeBackground` / `onResizeLayer` / `onUpdateLayer` ）；不得改动 `MapRenderer` 的既有公共方法签名（`setLayerState` / `updateLayerList` / `updateLayerArea` / `updateLayerBlock` 等一律不变）。"
- "不得修改任何数据端文件（`packages-user/data-common` / `data-base` / `data-system` / `data-state` ）、`packages-user/client-base`、`packages/**`、`src/**`；不得新增 / 修改任何数据端公共接口（ ： `IMapLayerHooks` ，不新增数据端接口）。"
- "不得改动 `packages-user/client-modules/src/action/move.ts` 与任何移动控制 API（ ， ）
- "不得处理贴图 / 不透明度（ ） （ ） （ ） `addHero` 接线（本计划不接线）。"
- "不得新增 / 删除任何公共接口成员（含导出的类、方法、字段）；`RendererLayerHook` 必须是模块内不导出的内部类。"
- "不得修改任何既有 jsDoc 注释的内容；新增注释必须遵循 `dev.md` 的注释规范（中文、`//` 后一个空格、不写无价值注释、不对构造器加注释）。`main.tsx:28` 指令行的**移除**属本计划经用户批准的例外，不得借此顺手改写其它注释。"
- "不得引入任何未被用户批准的新命名；不得改动 `files_modified` 之外的源码；不得回滚 / 暂存 / 提交用户并发的未提交改动。"
- "不得新增依赖、不得修改 `package.json` / `pnpm-lock.yaml` ；出现安装需求即暂停并要求用户确认包合法性。"
- "不得新增测试文件之外的测试设施改动；本计划**不新增任何测试**（渲染端无测试设施），且必须在 SUMMARY 中如实说明该降级。"
- "不得以「无测试设施」为由弱化验证：每条 `<automated>` 必须有 `<fails_when>` ；确实无法运行的门禁必须显式声明为不可得并降级为静态 + 人工，不得伪造绿。"
---
< objective >
Phase 4 增量（第五个计划）—— **收口 04-01 只读对账中仅剩的两条 ① 错配** ： （ `#04-01-M-09` （ `.onUpdateLayerBlock` ）。**本计划是代码改动计划**，改动面严格限定为两个文件；其余对账项（`#04-01-M-01` / `M-07` / `M-08` 与全部 ③ 多余旧路径）**不在本计划范围**。
**要解决的问题（两条，全部来自 `04-RENDER-INTERFACE-AUDIT.md` ） ：
1. ** `#04-01-M-06` （ ） ： `@user/data-state` import `getHeroStatusOn` （ `// @ts-expect-error 需要重构` ），并在 `:104` -`:112` 用它读 9 个属性；但 `@user/data-state` barrel（ ） `data-state` 侧属性读取断链。属性侧新等价接口为 `IHeroState.attribute.getFinalAttribute(...)` （ `client` 读**（原话「先用 client 读，这部分还未完成重构，后续我再进行处理」）——`client`（ `ClientCore` 单例）在 `main.tsx:34` 已 import 并在该文件大量使用；`ClientCore extends CoreState`， `IHeroState<IHeroAttr>` （
2. ** `#04-01-M-09` （图层更新钩子挂错契约）**： `RendererLayerStateHook` （ `onUpdateLayerArea` / `onUpdateLayerBlock` （ `:1755` ）注册为 `Partial<IGameMapHooks>` ，但现行 `IGameMapHooks` 只有 `onChangeBackground?` / `onUpdateLayer?` / `onResizeLayer?` （ `IMapLayerHooks.onUpdateArea(x, y, width, height)` / `onUpdateBlock(block, x, y)` （ `:230` ），由 `MapLayer.putMapData` / `setBlock` 经 `forEachHook` 触发（`mapLayer.ts:299-301` / `:242-244` ）。结果：`MapRenderer.updateLayerArea` / `updateLayerBlock` （ `:1545` ） `RendererLayerHook` **（须实现 `Partial<IMapLayerHooks>` ，负责把 `onUpdateArea` / `onUpdateBlock` 转发给 `renderer.updateLayerArea(layer, ...)` / `renderer.updateLayerBlock(layer, ...)` ；
**大致解决方案：**
- **M-06（ ） ：删除 `:28` 的 `// @ts-expect-error 需要重构` （已实测：符号删除后该指令变为「未使用」并报 TS2578， ； ， `:29` 的 `import { getHeroStatusOn, state } from '@user/data-state';` 改为 `import { state } from '@user/data-state';` （ `:104` -`:112` 的 9 处 `getHeroStatusOn('<key>')` 逐条改为 `client.hero.attribute.getFinalAttribute('<key>')` 。**不动**其余 `core.*` （第五阶段）与 `:248` 的 `state.maps` （ ）
- **M-09（ ） ：新增模块内类 `RendererLayerHook implements Partial<IMapLayerHooks>` （构造器持有 `renderer` 与该图层，实现 `onUpdateArea` / `onUpdateBlock` 两条转发）；在**图层状态变更路径**（ `updateLayerList` ）为 `map.layerList` 的每个图层 `layer.addHook(new RendererLayerHook(...))` 并 `.load()` ，保存控制器；换地图或图层被移除时 `.unload()` 并移出登记；从 `RendererLayerStateHook` 删除 `onUpdateLayerArea` / `onUpdateLayerBlock` ，保留其 map 级三个成员。**契约面零变更**（
**执行前置关卡（ ， **拟新增·删除的成员命名清单** （唯一已批准名 `RendererLayerHook` ，其余拟名待批） / **必须移除 `main.tsx:28` 的 `@ts-expect-error` 指令** （含实测依据） / **M-06 使用 `client` 与 D-23 的例外** / 范围边界与禁令 / 验证方式的诚实降级」，然后**停下等待**用户明确回复「可以执行」四个字。收到该回复前，任何任务都不得执行，也不得派发执行子代理；无论触发方式或配置模式如何均不得自动放行。故本计划 `autonomous: false` 。
**显式延后（本计划不涉及、不实施）：** 其余 ① 错配（`#04-01-M-01` / `M-07` / `M-08` ）、全部 ③ 多余旧路径（`core.*`， ） （ ） （ ） `addHero` 接线启用与运行时渲染、双布局 REND-02。
Purpose: 04-01 对账列出的 9 条 ① 错配里，勇士本体相关（`M-02`..`M-05`）已由 04-03 / 04-04 处置，`M-01` / `M-07` / `M-08` 经用户裁定由其自行处理；`M-06` 与 `M-09` 是**用户明确交办给 AI 的两条**。其中 `M-06` 让状态栏属性值回到新数据层接口（渲染适配 REND-01 的最小可见切片），`M-09` 修掉一条「注册了但永不触发」的静默失效——它不会报编译错，却让地图顶点数组在区域 / 图块变更后长期不刷新。
Output: `render/ui/main.tsx` / `render/map/renderer.ts` 的修正改动（两个按关注点拆分的原子提交）+ 会话内可复跑的 scoped 类型门禁、M-06 静态门禁、M-09 静态门禁、`pnpm exec eslint`、CRLF 门禁、基线感知范围门禁与并发改动基线门禁结果 + `.planning/phases/04-render-adaptation/04-05-SUMMARY.md` 。Task 0 为只读汇报关卡，不写任何文件。
## Source Audit（ ）
| SOURCE | ID | Feature/Requirement | Plan | Status | Notes |
|--------|----|---------------------|------|--------|-------|
| GOAL | — | Phase 4： ， （ `#04-01-M-06` 与 `#04-01-M-09` ； （ ）
| REQ | REND-01 | 渲染端适配新数据层接口 | 04-05 | COVERED（ ； ） `getHeroStatusOn` 改为新数据层 `getFinalAttribute` ； `IGameMapHooks` 改到现行逐图层契约 `IMapLayerHooks` 。验收边界未提供 → 见 assumptions 的 FLAGGED ASSUMPTION |
| REQ | REND-02 | 渲染端同时支持移动端与桌面端布局 | 04-05 | N/A（ ， ） ；
| RESEARCH | — | （本阶段无 RESEARCH.md） ； `04-PATTERNS.md` |
| CONTEXT | D-01 / D-02 | 阶段 4 增量规划；第一步只读对账 | 04-01 | COVERED（ ）
| CONTEXT | D-03 / D-04 | 被查对象限渲染端两包；数据端仅作接口基准 | 04-05 | COVERED | 本计划只改 `client-modules` 两个文件，不新增数据端接口 |
| CONTEXT | D-05 | 以接口为准，不受数据端实现变动影响 | 04-05 | COVERED | Task 1 步骤 (0a) 复核；签名若变则停下汇报 |
| CONTEXT | D-06 / D-07 | 三类分类与逐条记录口径 | 04-01 | COVERED（ ） `#04-01-M-06` / `#04-01-M-09` 的 ① 错配条目收口 |
| CONTEXT | D-11 | `getHeroStatusOn` 类裸函数多为待删除 | 04-05 | COVERED | M-06 移除其唯一渲染端 import 与 9 处调用（不新增该裸函数） |
| CONTEXT | D-12 | `core.*` 属旧引擎适配，归第五阶段 | 04-05 | COVERED（ `main.tsx` 其余 `core.*` 原样保留；
| CONTEXT | D-18 | `HeroRendering` （贴图 / 不透明度）暂不处理 | 04-05 | COVERED（ ） `main.tsx` / `renderer.ts` 均不涉及 |
| CONTEXT | D-19 | 移动控制由用户手动修改 | 04-05 | COVERED（ ） `action/move.ts` 不在 `files_modified` |
| CONTEXT | D-20 | 勇士渲染完全被动 | 04-05 | COVERED（ ）
| CONTEXT | D-21 | 走现有数据端钩子，不新增数据端公共接口 | 04-05 | COVERED | M-09 只接现行 `IMapLayerHooks.onUpdateArea` / `onUpdateBlock` ，不改数据端 |
| CONTEXT | D-22 | 跟随者暂缓 | 04-05 | COVERED（ ）
| CONTEXT | D-23 | 不使用 `client` / `state` 全局单例（仅约束新增 / 后续） | 04-05 | COVERED（ ） `client` （原话「先用 client 读…后续我再进行处理」） ，
| CONTEXT | D-24..D-29 | 勇士渲染修正（ （ ）
## Estimate Basis（ ）
`estimate-calibration` 返回 `factor: 1` 、`applied: false`、`sample_count: 0`、`confidence: low`（项目无历史样本），故 `tokens == raw_tokens` ，并如实标注 `confidence: low` 。按「执行者实际触及量」估算（`estimate.tasks: 4` = Task 0 汇报关卡 + 三个工作任务） ： ， ） ； `main.tsx` 改动（ ） ； `renderer.ts` 新增钩子类与注册路径（ ） ； ） ； ；
< / objective >
< execution_context >
@C:/Users/13194/ .config/opencode/gsd-core/workflows/execute-plan.md
@C:/Users/13194/ .config/opencode/gsd-core/templates/summary.md
< / execution_context >
< context >
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/STATE.md
@.planning/REQUIREMENTS.md
@.planning/phases/04-render-adaptation/04-CONTEXT.md
@.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md
@.planning/phases/04-render-adaptation/04-PATTERNS.md
@.planning/phases/04-render-adaptation/04-04-PLAN.md
@.planning/phases/04-render-adaptation/04-04-SUMMARY.md
@AGENTS .md
@dev .md
< / context >
< tasks >
< task type = "checkpoint:decision" gate = "blocking-human" >
< name > Task 0: 预执行汇报关卡 —— 汇报 `#04-01-M-06` / `#04-01-M-09` 的解决方案、成员命名清单（拟名待批）、`main.tsx:28` `@ts-expect-error` 指令的移除、M-06 使用 `client` 对 D-23 的例外，等待用户回复「可以执行」</ name >
< precondition > `.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md` 内存在 `#04-01-M-06` 与 `#04-01-M-09` 两条 ① 错配记录（以文件内实际存在为准）</ precondition >
< files > （只读汇报，不修改任何文件）< / files >
< read_first >
- AGENTS.md（ ，
- `.planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md` （ `#04-01-M-09` 两条的锚点、依据、影响与触发序列）
- `.planning/phases/04-render-adaptation/04-CONTEXT.md` （ ； `core.*` 归第五阶段； ；
- `.planning/phases/04-render-adaptation/04-04-SUMMARY.md` （「运行时 UAT 不可得」的诚实降级先例与门禁风格）
- `packages-user/client-modules/src/render/ui/main.tsx:28-34,98-135,245-249` （现状 import、9 处调用、`state.maps`、`client` 走向）
- `packages-user/client-modules/src/render/map/renderer.ts:83,414-433,1527-1548,1730-1763` （ `updateLayerList` 、`updateLayerArea` / `updateLayerBlock` 、`RendererLayerStateHook`）
- `packages-user/data-base/src/map/types.ts:207-264,588-608` （ `onUpdateBlock` ；
- `packages-user/client-modules/src/render/map/extension/door.ts:11-24,63-73` （ `IMapLayerHookController` 的既有范式）
< / read_first >
< action >
**停下并向用户汇报，等待明确回复后才继续；汇报本身只读，不写任何文件、不改任何生产代码、不派发子代理。**
① **要解决的问题（两条，来自 `04-RENDER-INTERFACE-AUDIT.md` ，本计划只做这两条）：**
- `#04-01-M-06` ： `@user/data-state` import `getHeroStatusOn` （ `// @ts-expect-error 需要重构` ） ， `data-state` barrel 无此导出、全仓库无定义，属性读取断链（新等价接口 `getFinalAttribute` ，
- `#04-01-M-09` ： `IGameMapHooks.onUpdateLayerArea` / `.onUpdateLayerBlock` （ `:1755` ，注册于 `:426` ），但 `IGameMapHooks` 已无这两成员（只有 `onChangeBackground?` / `onUpdateLayer?` / `onResizeLayer?` ）；它们已下移到**逐图层**契约 `IMapLayerHooks.onUpdateArea` / `.onUpdateBlock` （ `:230` ），由 `MapLayer.putMapData` / `setBlock` 经 `forEachHook` 触发。结果 `MapRenderer.updateLayerArea` / `updateLayerBlock` （ `:1545` ）
② **大致解决方案（两个文件）：**
- `main.tsx` （ ） ： `:104` -`:112` 的 9 处 `getHeroStatusOn('<key>')` 逐条改为 ** `client.hero.attribute.getFinalAttribute('<key>')` **，键依次为 `atk` / `hp` / `hpmax` / `mana` / `manamax` / `def` / `mdef` / `money` / `exp` ； `import { state } from '@user/data-state';` （ `state.maps` 属 M-08， ） `core.*` （ `:103` / `:113` -`:125` / `:127` -`:134` / `:139` / `:155` / `:165` / `:198` / `:207` / `:216` ，属第五阶段 D-12） ， `client.flags.*` 用法。
- `renderer.ts` （ ） ： （ ** `RendererLayerHook implements Partial<IMapLayerHooks>` **（用户已批准类名），持有 `renderer` 与该图层，实现 `onUpdateArea(x, y, width, height)` → `this.renderer.updateLayerArea(this.layer, x, y, width, height)` 、`onUpdateBlock(block, x, y)` → `this.renderer.updateLayerBlock(this.layer, block, x, y)` ；在**图层状态变更路径** `MapRenderer.setLayerState` （换地图）与 `MapRenderer.updateLayerList` （由 `RendererLayerStateHook.onUpdateLayer` 在 `GameMap.addLayer` / `removeLayer` 后触发）为 `map.layerList` 中每个图层 `layer.addHook(new RendererLayerHook(...))` 并 `.load()` （照 `door.ts:22-23` 范式），换地图 / 移除图层时 `.unload()` 并移出登记；从 `RendererLayerStateHook` **删除** `onUpdateLayerArea` / `onUpdateLayerBlock` ， `onChangeBackground` / `onResizeLayer` / `onUpdateLayer` （类名不改）。
③ **成员命名清单（
- **已批准（用户先前裁定，本计划直接使用）** ：内部类名 ** `RendererLayerHook` **。
- **待批准（新增，均为模块内 / 私有，不进任何公共接口）** ：
- `RendererLayerHook` 的两个构造器只读字段名：拟 ** `renderer` **、**`layer`**（照 `MapDoorHook` / `MapDoorRenderer` 的既有写法）。
- `MapRenderer` 新增**私有字段**名：拟 ** `layerHooks` **（类型 `Map<IMapLayer, IMapLayerHookController>` ，用于保存逐图层钩子控制器以便 `unload` ）。
- `MapRenderer` 新增**私有方法**名：拟 ** `syncLayerHooks()` **（对比 `this.map.layerList` 与已登记控制器，补注册 / 注销）。
- **不删除任何既有命名** ：
- 若用户给出的名字与本计划拟名不同：按用户指定的名字落地，本计划其余部分不变；若用户要求换方案（例如不用 `Map` 登记而用别的机制），执行者退出本计划、修订 `04-05-PLAN.md` 后重新汇报。
④ **必须移除 `main.tsx:28` 的 `// @ts-expect-error 需要重构` （单独列出待批准，属既有注释）：**
- 该指令唯一作用是压制 `getHeroStatusOn` 未导出（ ） ， ， **TS2578 `Unused '@ts-expect-error' directive.`** （本计划已在仓库外临时目录用本仓 `node_modules/.bin/tsc` **实测复现** ），这会在改动文件上**新增诊断**，直接违反「改动文件类型诊断不增加」门禁——故「删符号、留指令」不可行。
- 因此本计划必须删除 `:28` 这一行。按 AGENTS.md「不得擅自修改任何已有注释」， `@user/data-state` import 上方不再有 `@ts-expect-error` （文件内仅剩 `:247` 那一条服务于 M-08 `state.maps` 的指令，**逐字保留，不得顺手删除**），且 `import` 之间不再夹注释（顺带符合 `dev.md:55` ）。除此之外**不改写任何其它注释**。
⑤ **M-06 使用 `client` 与 D-23 的例外（必须原样告知）：**
- D-23 规定「不使用 `client` / `state` 全局单例；若有必须调用它们的地方，**停止执行并告知用户**，不得自行选择绕过方案」（适用新增 / 后续改动）。
- 本计划 M-06 恰恰要使用 `client` 。用户已就本增量**明确裁定**，原话：「**先用 client 读，这部分还未完成重构，后续我再进行处理**」；`client` 在 `main.tsx:34` 已 import 并在该文件大量使用（`:37`、`:100`-`:101`、`:121`-`:123`、`:134`）。
- 请用户在本关卡确认该例外成立（确认后即按 D-23 的「用户已决定解决方案」路径执行，不停摆）；若用户改口，执行者退出本计划并修订。
⑥ **范围边界与禁令（须原样告知）：** 只改 `packages-user/client-modules/src/render/ui/main.tsx` 与 `packages-user/client-modules/src/render/map/renderer.ts` 两个文件；**不碰**其余对账项（`#04-01-M-01` 属 D-19 用户自行处理；`#04-01-M-07`、`#04-01-M-08` 用户原话「其他几个都涉及到接口的调整，这部分我自己来」；`#04-01-M-02..M-05` 已由 04-03 / 04-04 处置；全部 ③ 多余旧路径 `core.*` 属第五阶段 D-12） ； `packages/**` / `src/**` ； （ ） ； （ ） （ ） （ ） `addHero` 接线；不新增依赖；不回滚 / 暂存 / 提交用户并发未提交改动。
⑦ **验证方式与诚实降级（须原样告知）：** 渲染端**无测试设施**（ `*.test.*` ），且 `client.ts:151-155` 的 `addHero` 接线仍为注释、`MapExtensionManager.addHero` 无调用点，故**运行时渲染无法观察**（状态栏数值、地图区域 / 图块更新后的顶点刷新都跑不起来）。本计划的验收 = **scoped 类型门禁** （ ： `renderer.ts` 0 条，且 `client-modules` 错误集与当日记录基线完全一致）+ **M-06 / M-09 静态门禁** + ** `pnpm exec eslint` ** + **CRLF 门禁** + **基线感知范围门禁（放行两个在范围文件）与并发改动基线门禁** + **人工代码复核** ；另附「该移除的 `@ts-expect-error` 已移除（`@user/data-state` import 上方无残留，`main.tsx:247` 的 M-08 指令保留）、`state` import 保留」的显式断言。**不冒充任何无法运行的门禁，不新增测试文件（无设施），不伪造绿。**
⑧ **关卡性质（必须原样告知用户）：** 无论触发方式（`/gsd-execute-phase`、`/gsd-manager`、`/gsd-autonomous`、子代理 / 执行器派发）或配置模式（`.planning/config.json` 的 `yolo` 、`workflow.auto_advance`）如何，**执行者 / 子代理都必须在此停下并等待**用户明确回复「可以执行」四个字；未收到这四个字前不得执行任何任务、不得派发执行子代理，也不得以「自动化模式」为由自动放行。
⑨ **失败语义（等同硬门禁，非自动命令）：** 用户未回复「可以执行」即继续，或回复的是其它任何内容（含修订意见、沉默、`yolo` / `auto_advance` 下的自动推进、或子代理 / 执行器的自行放行），一律视为**未通过本关卡**：立即停止执行，不派发任何执行子代理，保持只读、不写任何文件，直到用户在对话中明确回复「可以执行」四个字后方可继续。
⑩ **若用户给出修订意见** （含不同意命名 / 不同意移除 `:28` 指令 / 不同意 M-06 使用 `client` / 要求更换方案）：退出本计划、修订 `04-05-PLAN.md` 后重新汇报，不得自行改道执行。
< / action >
< decision > 是否按本计划（两文件收口 `#04-01-M-06` 与 `#04-01-M-09` ： `client.hero.attribute.getFinalAttribute` 读取并移除 `getHeroStatusOn` 与 `:28` 的 `@ts-expect-error` 指令；`renderer.ts` 新增内部类 `RendererLayerHook` 并改到逐图层 `addHook` 注册、移除 `onUpdateLayerArea` / `onUpdateLayerBlock` ）开始执行；并确认 ③ 的拟名（`renderer` / `layer` / `layerHooks` / `syncLayerHooks` ）、④ 的指令移除、⑤ 的 D-23 例外</ decision >
< context >
AGENTS.md 要求任何计划的第一个 block 点必须是向用户汇报计划内容并等待用户确认，且任何新增 / 改写的成员命名必须先经用户同意。本计划的三处判断（新命名、移除既有注释、在 D-23 禁单例的前提下使用 `client` ）都属于「接口 / 命名 / 规则设计归用户」的边界；`.planning/config.json` 为 `mode: yolo` ，因此该关卡必须显式声明为 `blocking-human` 并置 `autonomous: false` 。若不在关卡内定下这三点，执行者会在「加什么字段名」「删不删注释」「用不用 `client` 」上自行猜测。
< / context >
< options >
< option id = "execute" >
< name > 可以执行< / name >
< pros > 按本计划落地： `client.hero.attribute.getFinalAttribute` 并移除 `getHeroStatusOn` 与 `:28` 指令； `RendererLayerHook` 并改到逐图层注册；命名按 ③ 拟名（`renderer` / `layer` / `layerHooks` / `syncLayerHooks` ） </ pros >
< cons > `main.tsx` 新引入 `client` 单例读法（ </ cons >
< / option >
< option id = "execute-renamed" >
< name > 可以执行，但改名 / 改细节< / name >
< pros > 按用户指定的字段 / 方法名与细节执行，避免命名返工< / pros >
< cons > 无< / cons >
< / option >
< option id = "revise" >
< name > 修订方案后再执行< / name >
< pros > 避免带着错误命名或错误接线方案落地（ < / pros >
< cons > 退出本计划并修订 PLAN.md 后重新汇报，增加一轮往返< / cons >
< / option >
< / options >
< resume-signal > 回复「可以执行」四个字（如需改名 / 改细节，请在回复中一并给出），或给出修订意见< / resume-signal >
< verify >
< human-check > 用户在对话中明确回复「可以执行」四个字（人工核对用户回复原文；本关卡为人工关卡，无可运行的 `<automated>` 命令，故不携带 `<fails_when>` ；失败语义完整写在 Task 0 的 action ⑨ 与 acceptance_criteria 中）</ human-check >
< / verify >
< acceptance_criteria >
- 用户回复中明确包含「可以执行」四个字
- 汇报内容涵盖：要解决的问题（`#04-01-M-06` / `#04-01-M-09` 的锚点、依据与影响，含 M-09 的「静默失效」性质）、大致解决方案（两个文件的改法）、成员命名清单（已批准 `RendererLayerHook` ；待批 `renderer` / `layer` / `layerHooks` / `syncLayerHooks` ）、**必须移除 `main.tsx:28` 的 `@ts-expect-error` 指令**（含 TS2578 实测依据）、**M-06 使用 `client` 对 D-23 的例外**（含用户原话）、范围边界与禁令、验证方式与「运行时渲染不可观察」的诚实降级
- 汇报中已原样告知关卡性质：执行者 / 子代理必须停下等待，不因触发方式或 yolo / auto 模式自动放行
< / acceptance_criteria >
< done > 用户明确回复「可以执行」（如需改名 / 改细节，已在回复中给出）；在此之前未执行任何任务、未修改任何文件、未派发任何执行子代理< / done >
< / task >
< task type = "tracer" >
< name > Task 1（ ） ： `getHeroStatusOn` 改经 `client.hero.attribute.getFinalAttribute` 读取，并移除失效 import 与 `:28` 的 `@ts-expect-error` 指令</ name >
< files > packages-user/client-modules/src/render/ui/main.tsx, .planning/phases/04-render-adaptation/04-05-SUMMARY.md< / files >
< read_first >
- AGENTS.md（ （ ； ；
- packages-user/client-modules/src/render/ui/main.tsx（ `:28` -`:34` import、`:98`-`:135` `updateStatus()` 、`:245`-`:249` `state.maps` ）
- packages-user/client-modules/src/render/ui/statusBar.tsx:17-39（ `IHeroAttr` 键逐一对应）
- packages-user/client-modules/src/core.ts:1-6（ ）
- packages-user/client-modules/src/client.ts:47,74,100-101,132-133（ ；
- packages-user/data-state/src/core.ts:86,144（ < IHeroAttr > ` 与其赋值，`client.hero` 的来源）
- packages-user/data-base/src/hero/types.ts:95-140,889-905（ `IHeroState.attribute` ）
- packages-user/data-common/src/types.ts:23-44（
- packages-user/data-state/src/index.ts 与 src/ins.ts:11-13（
- *.planning/phases/04-render-adaptation/04-04-PLAN.md:286-330* （前序计划的「执行前核对 / 并发基线 / 类型基线」写法，本任务照此执行）
< / read_first >
< action >
(0) **执行前核对与基线（只读前置，必须先做）：**
(0a) **数据端现行接口复核（消费未确定项，不猜）** ：打开当日 HEAD 的基准文件逐条确认，并把结论（每条一行：结论 + `file:line` ）写入 `04-05-SUMMARY.md` 的「执行前核对」段：① `IHeroAttr` 仍有九键且类型为 `number` （ `IReadonlyHeroAttribute.getFinalAttribute<K extends keyof THero>(name: K): THero[K]` 签名未变（`packages-user/data-base/src/hero/types.ts:106`），且 `IHeroState.attribute: IReadonlyHeroAttribute<THero>` （ `CoreState.hero` 为公开只读成员且在构造期赋值（`packages-user/data-state/src/core.ts:86` / `:144` ）；④ `@user/data-state` barrel 仍无 `getHeroStatusOn` 导出（`packages-user/data-state/src/index.ts:1-9`），且全仓库无该符号定义（只读检索确认）；⑤ `ILeftHeroStatus` 的 `hp` / `hpmax` / `mana` / `manamax` / `atk` / `def` / `mdef` / `money` / `exp` 均为 `number` （ `client` 由 `packages-user/client-modules/src/core.ts:6` 导出且 `ClientCore extends CoreState` （
(0b) **并发改动基线** ：执行下述固定命令（排除即将改动的 `main.tsx` / `renderer.ts` 两个在范围文件与 `.planning/phases/04-render-adaptation/` 前缀），把输出**原样**写入 SUMMARY， ：
```
<!-- CONCURRENT - BASELINE:START -->
< porcelain 条目逐行 >
<!-- CONCURRENT - BASELINE:END -->
基线摘要 sha256=< 64hex >
```
```
node -e "const fs=require('fs'),c=require('crypto'),{execSync}=require('child_process');const keep=l=>!/main\.tsx$/.test(l)&&!/map[ \\/]renderer \.ts$/.test(l)&&!/ \.planning \/phases \/04-render-adaptation \//.test(l); const out=execSync('git status --porcelain',{encoding:'utf8'}).replace(/\s+$/,'');const cur=(out?out.split(/\r?\n/).map(s=>s.replace(/\s+$/,'')):[]).filter(keep);const digest=c.createHash('sha256').update(cur.slice().sort().map(l=>{let h='MISSING';try{h=c.createHash('sha256').update(fs.readFileSync(l.slice(3))).digest('hex')}catch(e){}return l+' '+h}).join('\n')).digest('hex');console.log(cur.join('\n'));console.log('基线摘要 sha256='+digest)"
```
**不得**沿用任何前序 SUMMARY 的旧列表；一律以本次实测为准。**不得回滚 / 暂存 / 提交 / 修改**其中任何条目。
(0c) **类型门禁基线** ：执行 `pnpm exec vue-tsc --noEmit` （整仓会以非 0 退出属预期）并把 `client-modules` 的命中行**归一化**（每行形如 `<相对 client-modules/src 的路径>(line,col): error TSxxxx` ）后原样写入 SUMMARY， ：
```
<!-- TYPE - BASELINE:START -->
< 归一化后的 client-modules 命中行 ， 逐行 >
<!-- TYPE - BASELINE:END -->
```
同时确认两个在范围文件（`render/ui/main.tsx`、`render/map/renderer.ts`） （ `pnpm` 被执行策略拦截，改用 `pnpm.cmd exec vue-tsc --noEmit` （等价）。**基线捕获必须证明类型检查确实跑起来了**：记录命令的退出码（整仓非 0 属预期）并确认捕获非空或退出码为 0； （
(0d) 建立 `04-05-SUMMARY.md` 骨架（含上面三段 + 后续任务要填的空节），保持 CRLF。
(1) ** `main.tsx` 的 M-06 改动（逐条对齐；行号为改动前锚点）：**
(1a) 删除 `:28` 的整行 `// @ts-expect-error 需要重构` （
(1b) 把 `:29` 的 `import { getHeroStatusOn, state } from '@user/data-state';` 改为 `import { state } from '@user/data-state';` （ **必须保留** ——`:248` 的 `state.maps` 属 M-08， ）
(1c) 9 处替换（`:104`-`:112`，每条只替换右值，行内其余不变）：
`:104` `leftStatus.atk = getHeroStatusOn('atk');` → `leftStatus.atk = client.hero.attribute.getFinalAttribute('atk');`
`:105` `hp` → `client.hero.attribute.getFinalAttribute('hp')`
`:106` `hpmax` → `client.hero.attribute.getFinalAttribute('hpmax')`
`:107` `mana` → `client.hero.attribute.getFinalAttribute('mana')`
`:108` `manamax` → `client.hero.attribute.getFinalAttribute('manamax')`
`:109` `def` → `client.hero.attribute.getFinalAttribute('def')`
`:110` `mdef` → `client.hero.attribute.getFinalAttribute('mdef')`
`:111` `money` → `client.hero.attribute.getFinalAttribute('money')`
`:112` `exp` → `client.hero.attribute.getFinalAttribute('exp')`
(1d) **不得改动的事** ： `:103` 的 `core.status.*` 、`:113`-`:120` 的 `core.getNextLvUpNeed()` / `core.itemCount(...)` 、`:124` 的 `core.status.floorId` 、`:125` 的 `core.getLvName(hero.lv)` （与 `:103` 的 `const hero = core.status.hero;` 一并保留，`hero` 仍被 `:125` 使用）、`:127`-`:132` 的 `core.status.replay.*` / `core.isReplaying()` 、`:134` 的 `client.flags` 、`:139` 的 `core.status.lockControl` 、`:155` / `:165` 的 `core.status.stepPostfix` 、`:198` / `:207` / `:216` 的 `core.doRegisteredAction` 、`:248` 的 `state.maps` 与 `:247` 的 `// @ts-expect-error 需要重构` （ ， ） （
(1e) 本文件新增内容不得引入任何新命名（只出现既有成员访问链 `client.hero.attribute.getFinalAttribute` ）。
(2) **本任务提交（验证通过后）** ： `packages-user/client-modules/src/render/ui/main.tsx` ，提交信息 `fix(04-05): read hero status via client attribute API` ；
(3) 全程保持 `main.tsx` CRLF； `pnpm exec eslint --fix` 对该文件，再 `pnpm exec eslint` 必须 0 错误。
< / action >
< reversibility rating = "reversible" > 本任务只把 `main.tsx` 的 9 处属性读取从已失效的 `getHeroStatusOn` 改到 `client.hero.attribute.getFinalAttribute` 并移除一条失效 import 与一条失效的 `@ts-expect-error` 指令；回退只需还原该文件，无契约 / 数据影响，故为 `reversible` 。</ reversibility >
< verify >
< automated > node -e "const fs=require('fs');const p='packages-user/client-modules/src/render/ui/main.tsx';const s=fs.readFileSync(p,'utf8');const cnt=x=>(s.match(x)||[]).length;const g=cnt(/getHeroStatusOn/g);if(g!==0){console.error('M06 getHeroStatusOn REMAINS '+g);process.exit(1)}const calls=(s.match(/getFinalAttribute\([^)]*\)/g)||[]).map(x=>x.replace(/getFinalAttribute/g,'').replace(/[^A-Za-z]/g,''));const want=['atk','def','exp','hp','hpmax','mana','manamax','mdef','money'];const got=calls.slice().sort().join(',');if(got!==want.join(',')){console.error('M06 ATTR SET MISMATCH got=['+got+'] want=['+want.join(',')+']');process.exit(1)}if(!s.includes('@user/data-state')){console.error('M06 data-state IMPORT LOST');process.exit(1)}if(!s.includes('{ state } from')){console.error('M06 state IMPORT NOT RETAINED');process.exit(1)}const idx=s.indexOf('@user/data-state');if(idx< 0 ){ console . error (' M06 data-state IMPORT NOT FOUND '); process . exit ( 1 )} if (/ ts-expect-error /. test ( s . slice ( Math . max ( 0 , idx-400 ), idx ))){ console . error (' M06 DIRECTIVE ABOVE data-state IMPORT REMAINS '); process . exit ( 1 )} const te = (s.match(/ts-expect-error/g)||[]).length;if(te!==1){console.error('M06 ts-expect-error COUNT '+ te +' ( expected exactly 1 = the preserved M-08 directive at main . tsx:247 )'); process . exit ( 1 )} if (!/ ts-expect-error [^ \r\n]* \r? \n\s* layerState = \{state \.maps \}/.test(s)){console.error('M06 M08 DIRECTIVE / state . maps PAIRING LOST '); process . exit ( 1 )} if (! s . includes (' core . status ')||! s . includes (' core . itemCount ')){ console . error (' M06 LEGACY core READS LOST ( out of scope )'); process . exit ( 1 )} console . log (' OK M06: getHeroStatusOn 0 ; getFinalAttribute 9 keys OK ; state import kept ; core .* preserved ')"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "M06 getHeroStatusOn REMAINS"（ `main.tsx` ） （ `getFinalAttribute(...)` 的键集合与 `atk,def,exp,hp,hpmax,mana,manamax,mdef,money` 不一致，或数量不为 9） （ `:248` ） （ `@ts-expect-error` （ ） ： `main.tsx:247` 的 M-08 指令也删了； `:28` 未删）/ "M06 M08 DIRECTIVE/state.maps PAIRING LOST"（ `state.maps` 的配对被破坏，越界改动 M-08） </ fails_when >
< automated > node -e "const fs=require('fs'),{execSync}=require('child_process');let out='',status=null;try{out=execSync('pnpm exec vue-tsc --noEmit',{encoding:'utf8',maxBuffer:1< < 26 , stdio: [' ignore ',' pipe ',' pipe ']}); status = 0}catch(e){out=String(e.stdout||'')+String(e.stderr||'');status=(typeof e . status = =='number')?e.status:null}if(status===null){console.error('TYPE CHECK DID NOT RUN ( vue-tsc spawn failed ) : '+ out . slice ( 0 , 200 )); process . exit ( 1 )} const lines = out.split(/ \r? \n/).filter(l= > /: error TS\d+/.test(l));if(lines.length===0&& status!==0){console.error('TYPE CHECK EXITED '+status+' WITH NO PARSEABLE DIAGNOSTICS');process.exit(1)}const scope=lines.filter(l=>/render[\\/]ui[\\/]main\.tsx\(\d+,\d+\)|render[\\/]map[\\/]renderer\.ts\(\d+,\d+\)/.test(l));if(scope.length){console.error('IN-SCOPE TYPE ERRORS '+scope.length+'\n'+scope.join('\n'));process.exit(1)}const norm=l=>{const m=l.match(/client-modules[\\/]src[\\/](.+)$/);return m?m[1].replace(/\s+$/,''):null};const cur=lines.map(norm).filter(Boolean).sort();const t=fs.readFileSync('.planning/phases/04-render-adaptation/04-05-SUMMARY.md','utf8');const bm=t.match(/<!-- TYPE-BASELINE:START --> ([\s\S]*?)<!-- TYPE-BASELINE:END --> /);if(!bm){console.error('NO TYPE BASELINE');process.exit(1)}const base=bm[1].split(/\r?\n/).map(s=>s.trim()).filter(Boolean).sort();const extra=cur.filter(x=>base.indexOf(x)< 0 ); const missing = base.filter(x= > cur.indexOf(x)< 0 ); if ( extra . length || missing . length ){ console . error (' CLIENT-MODULES ERROR SET CHANGED missing = ['+missing.join(' ; ')+'] extra = ['+extra.join(' ; ')+']'); process . exit ( 1 )} console . log (' OK in-scope type errors 0 ; client-modules baseline '+ cur . length )"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "TYPE CHECK DID NOT RUN"（ ， ， （ `renderer.ts` 仍有类型错误，例如 import 上方 `@ts-expect-error` 未删除而报 TS2578） （ </ fails_when >
< automated > pnpm exec eslint packages-user/client-modules/src/render/ui/main.tsx< / automated >
< fails_when > non-zero exit 或输出含 "error"（ < / fails_when >
< automated > node -e "const fs=require('fs');const s=fs.readFileSync('packages-user/client-modules/src/render/ui/main.tsx','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 main.tsx');process.exit(1)}console.log('OK CRLF')"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "NON-CRLF LINE ENDINGS"（出现孤立 LF， < / fails_when >
< / verify >
< acceptance_criteria >
- `main.tsx` 的 `getHeroStatusOn` 计数为 0（ < key > ')` 恰为 9 次且键集合为 `atk, def, exp, hp, hpmax, mana, manamax, mdef, money`
- `:28` 的 `// @ts-expect-error 需要重构` 已移除（`@user/data-state` import 上方不再有该指令）；`main.tsx:247` 服务于 M-08 `state.maps` 的同名指令逐字保留（全文件 `@ts-expect-error` 计数由 2 → 1）
- `import { state } from '@user/data-state';` 保留；其余 `core.*` （含 `core.status.*` / `core.getNextLvUpNeed()` / `core.getLvName()` / `core.itemCount()` / `core.isReplaying()` / `core.doRegisteredAction()` / `core.status.stepPostfix` / `core.status.lockControl` ）与 `:248` 的 `state.maps` （ ） `@ts-expect-error` 一字未动
- 本任务**未**触碰 `renderer.ts` ；未改动任何既有注释（除经批准的 `:28` 整行移除）；未新增任何命名
- `04-05-SUMMARY.md` 的「执行前核对」含 (0a) 六条结论 + `file:line` ， ，
- 四条 `<automated>` 全部转绿（ ） ； `fix(04-05): read hero status via client attribute API` 原子提交（仅 `main.tsx` ）
< / acceptance_criteria >
< done > 状态栏 9 个属性全部经 `client.hero.attribute.getFinalAttribute` 读取，`getHeroStatusOn` 与其上方 `:28` 的 `@ts-expect-error` 指令消失（`main.tsx:247` 的 M-08 指令保留）、`state` import 与全部 `core.*` 原样保留； </ done >
< / task >
< task type = "auto" >
< name > Task 2： `RendererLayerHook` （ < IMapLayerHooks > `）把 `onUpdateArea` / `onUpdateBlock` 转发到 `updateLayerArea` / `updateLayerBlock` ，并在图层状态变更路径改为 `layer.addHook` 注册</ name >
< files > packages-user/client-modules/src/render/map/renderer.ts< / files >
< read_first >
- packages-user/client-modules/src/render/map/renderer.ts（ `:33` ； `:83` ； `:414-420` ； `:422-433` ； `:1527-1536` ； `:1545-1548` ； `:1730-1763` ）
- packages-user/data-base/src/map/types.ts:207-264（ `onUpdateArea` / `onUpdateBlock` / `onOpenDoor` / `onCloseDoor` 与可选动态块钩子；`IMapLayerHookController`）
- packages-user/data-base/src/map/types.ts:588-608（
- packages-user/data-base/src/map/mapLayer.ts:236-248,290-303（ `putMapData` 经 `forEachHook` 触发 `onUpdateBlock?` / `onUpdateArea?` ）
- packages-user/data-base/src/map/gameMap.ts:59-87（ `removeLayer` 在图层列表变化时触发 map 级 `onUpdateLayer` ）
- packages-user/client-modules/src/render/map/extension/door.ts:11-24,63-73（ `.load()` / `.unload()` 的既有范式，本任务照此写 `RendererLayerHook` 的注册）
- .planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md（
< / read_first >
< action >
(1) **import 扩充（`:33` 同一行）** ：在 `import { IGameMap, IGameMapHooks, IMapLayer } from '@user/data-base';` 中追加 `IMapLayerHookController` 与 `IMapLayerHooks` ； ， （ `@typescript-eslint/no-unused-vars` 为 error）
(2) **新增私有字段（ ， ：在既有 `private mapHook: IHookController<IGameMapHooks> | null = null;` （ `private layerHooks: Map<IMapLayer, IMapLayerHookController> = new Map();` ，并加一行中文说明其用途（新增注释，须符合 dev.md 注释规范；不得改写既有注释）。若 Task 0 改名为指定写法，按用户名字落地。
(3) **新增私有方法（拟名 `syncLayerHooks`， ：语义为「使登记的逐图层钩子集合与 `this.map.layerList` 一致」——先遍历 `this.layerHooks` 的既有登记，凡其图层已不在 `this.map.layerList` （或 `this.map` 已为 `null` ）者调用其控制器的 `.unload()` 并从登记中移除；再遍历 `this.map.layerList` ，凡尚无登记者执行 `layer.addHook(new RendererLayerHook(this, layer))` 、`.load()`、并写入登记。**注意 `this.map` 是 `IGameMap | null` ，其 `layerList` 为 `Set<IMapLayer>` （ `IMapLayer` ，两者一致，不得为此引入 `any` / `as` **（若编译要求类型收窄，按类型定义写，不得掩盖）。
(4) **接到图层状态变更路径（两处，缺一不可）** ：
(4a) `setLayerState` （ `this.map = map;` 之后、`this.sortLayer();` 之前调用 `this.syncLayerHooks();` ——换地图时旧地图的逐图层钩子因不在新 `map.layerList` 而被 `.unload()` 并移出登记，新地图的图层被注册。其余行（`this.mapHook?.unload()` / `map.addHook(new RendererLayerStateHook(this))` / `this.mapHook.load()` / `sortLayer` / `resizeLayer` / `layerCount` / `vertex.updateLayerArray()` / `vertex.resizeMap()` ）
(4b) `updateLayerList()` （ `if (!this.map) return;` 之后调用 `this.syncLayerHooks();` ——覆盖 `GameMap.addLayer` / `removeLayer` 后经 map 级 `onUpdateLayer` 进来的新增 / 移除图层。其余行保持原样。
(5) **新增模块内类 `RendererLayerHook`（用户已批准该类名；不导出）** ：紧邻 `RendererLayerStateHook` （ `class RendererLayerHook implements Partial<IMapLayerHooks>` ；构造器持有 `renderer: MapRenderer` 与 `layer: IMapLayer` 两个只读成员（字段名拟 `renderer` / `layer` ， `onUpdateArea(x: number, y: number, width: number, height: number): void` 转发 `this.renderer.updateLayerArea(this.layer, x, y, width, height)` ，与 `onUpdateBlock(block: number, x: number, y: number): void` 转发 `this.renderer.updateLayerBlock(this.layer, block, x, y)` 。**只实现这两个成员**（其余 `IMapLayerHooks` 成员由 `Partial` 允许缺省；门的开关另有 `MapDoorHook` ，动态块钩子未被渲染端消费）。按 dev.md「不对构造器添加注释」不写构造器注释；
(6) **删除旧错误注册** ：从 `RendererLayerStateHook` 中删除 `onUpdateLayerArea` （ `onUpdateLayerBlock` （ `onChangeBackground` / `onResizeLayer` / `onUpdateLayer` 三个 map 级成员与类名 `RendererLayerStateHook` 不变。删除的是**代码**（非契约成员），不得改写任何既有注释。
(7) **契约面零变更** ：不改 `IMapRenderer` （ `export` 中；不新增 / 删除 / 改名 `MapRenderer` 的既有公共成员。
(8) **本任务提交（验证通过后）** ： `packages-user/client-modules/src/render/map/renderer.ts` ，提交信息 `fix(04-05): forward layer area/block updates via IMapLayerHooks` ；
(9) 全程保持 `renderer.ts` CRLF； `pnpm exec eslint --fix` 对该文件，再 `pnpm exec eslint` 必须 0 错误。
< / action >
< reversibility rating = "reversible" > 本任务只在渲染端内部新增一个不导出的钩子类、一个私有登记字段与一个私有同步方法，并把逐图层更新钩子从无效的 map 级注册改到现行 `IMapLayerHooks` ；公共契约与数据端零改动，回退只需还原该文件，故为 `reversible` 。</ reversibility >
< verify >
< automated > node -e "const fs=require('fs');const s=fs.readFileSync('packages-user/client-modules/src/render/map/renderer.ts','utf8');const hasTok=t=>new RegExp('(?<![A-Za-z0-9_])'+t+'(?![A-Za-z0-9_])').test(s);const fail=m=> {console.error('M09 '+m);process.exit(1)};if(!/class RendererLayerHook implements Partial< IMapLayerHooks > /.test(s))fail('RendererLayerHook DECL MISSING');if(!/\.addHook\(new RendererLayerHook\(/.test(s))fail('LAYER HOOK NOT REGISTERED via layer.addHook');if(!/updateLayerArea\(this\.layer/.test(s))fail('onUpdateArea NOT FORWARDING to updateLayerArea');if(!/updateLayerBlock\(this\.layer/.test(s))fail('onUpdateBlock NOT FORWARDING to updateLayerBlock');const legacy=(s.match(/onUpdateLayerArea|onUpdateLayerBlock/g)||[]).length;if(legacy!==0)fail('LEGACY MAP-LEVEL UPDATE HOOKS REMAIN '+legacy);for(const t of ['onChangeBackground','onResizeLayer','onUpdateLayer'])if(!s.includes(t))fail('RendererLayerStateHook MEMBER LOST '+t);if(!hasTok('syncLayerHooks'))fail('SYNC ENTRY NAME NOT FOUND (if renamed at Task 0, substitute the approved name)');const ss=s.slice(s.indexOf('setLayerState('));if(!ss.slice(0,ss.indexOf('\n }')).includes('syncLayerHooks'))fail('setLayerState DOES NOT SYNC LAYER HOOKS');const ul=s.slice(s.indexOf('updateLayerList()'));if(!ul.slice(0,ul.indexOf('\n }')).includes('syncLayerHooks'))fail('updateLayerList DOES NOT SYNC LAYER HOOKS');if(!/\.unload\(\)/.test(s))fail('NO unload for stale layer hooks');if(/export .*RendererLayerHook|export \{[\s\S]*RendererLayerHook[\s\S]*\}/.test(s))fail('RendererLayerHook MUST NOT BE EXPORTED');if(!s.includes('IMapLayerHooks')||!s.includes('IMapLayerHookController'))fail('REQUIRED TYPE IMPORTS MISSING');console.log('OK M09: RendererLayerHook forwards area/block via per-layer addHook; map-level update hooks removed')"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "M09 RendererLayerHook DECL MISSING"（未按 `class RendererLayerHook implements Partial<IMapLayerHooks>` 声明）/ "M09 LAYER HOOK NOT REGISTERED via layer.addHook"（未在图层上注册）/ "M09 onUpdateArea NOT FORWARDING to updateLayerArea" / "M09 onUpdateBlock NOT FORWARDING to updateLayerBlock"（转发目标或 `this.layer` 传参不对）/ "M09 LEGACY MAP-LEVEL UPDATE HOOKS REMAIN"（ （ </ fails_when >
< automated > node -e "const fs=require('fs'),{execSync}=require('child_process');let out='',status=null;try{out=execSync('pnpm exec vue-tsc --noEmit',{encoding:'utf8',maxBuffer:1< < 26 , stdio: [' ignore ',' pipe ',' pipe ']}); status = 0}catch(e){out=String(e.stdout||'')+String(e.stderr||'');status=(typeof e . status = =='number')?e.status:null}if(status===null){console.error('TYPE CHECK DID NOT RUN ( vue-tsc spawn failed ) : '+ out . slice ( 0 , 200 )); process . exit ( 1 )} const lines = out.split(/ \r? \n/).filter(l= > /: error TS\d+/.test(l));if(lines.length===0&& status!==0){console.error('TYPE CHECK EXITED '+status+' WITH NO PARSEABLE DIAGNOSTICS');process.exit(1)}const scope=lines.filter(l=>/render[\\/]ui[\\/]main\.tsx\(\d+,\d+\)|render[\\/]map[\\/]renderer\.ts\(\d+,\d+\)/.test(l));if(scope.length){console.error('IN-SCOPE TYPE ERRORS '+scope.length+'\n'+scope.join('\n'));process.exit(1)}const norm=l=>{const m=l.match(/client-modules[\\/]src[\\/](.+)$/);return m?m[1].replace(/\s+$/,''):null};const cur=lines.map(norm).filter(Boolean).sort();const t=fs.readFileSync('.planning/phases/04-render-adaptation/04-05-SUMMARY.md','utf8');const bm=t.match(/<!-- TYPE-BASELINE:START --> ([\s\S]*?)<!-- TYPE-BASELINE:END --> /);if(!bm){console.error('NO TYPE BASELINE');process.exit(1)}const base=bm[1].split(/\r?\n/).map(s=>s.trim()).filter(Boolean).sort();const extra=cur.filter(x=>base.indexOf(x)< 0 ); const missing = base.filter(x= > cur.indexOf(x)< 0 ); if ( extra . length || missing . length ){ console . error (' CLIENT-MODULES ERROR SET CHANGED missing = ['+missing.join(' ; ')+'] extra = ['+extra.join(' ; ')+']'); process . exit ( 1 )} console . log (' OK in-scope type errors 0 ; client-modules baseline '+ cur . length )"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "TYPE CHECK DID NOT RUN"（ （ `any` / `as` 掩盖失败的收窄）/ "CLIENT-MODULES ERROR SET CHANGED" / "NO TYPE BASELINE"</ fails_when >
< automated > pnpm exec eslint packages-user/client-modules/src/render/map/renderer.ts< / automated >
< fails_when > non-zero exit 或输出含 "error"（含未使用 import / 未使用变量 / Prettier 违规 / 注释规则）< / fails_when >
< automated > node -e "const fs=require('fs');const s=fs.readFileSync('packages-user/client-modules/src/render/map/renderer.ts','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 renderer.ts lone-lf='+(lf-crlf));process.exit(1)}console.log('OK CRLF')"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "NON-CRLF LINE ENDINGS"（出现孤立 LF） < / fails_when >
< / verify >
< acceptance_criteria >
- `renderer.ts` 存在 `class RendererLayerHook implements Partial<IMapLayerHooks>` （模块内不导出），实现 `onUpdateArea` → `this.renderer.updateLayerArea(this.layer, x, y, width, height)` 与 `onUpdateBlock` → `this.renderer.updateLayerBlock(this.layer, block, x, y)`
- 逐图层注册经 `layer.addHook(new RendererLayerHook(...))` + `.load()` ，且发生在 `setLayerState` 与 `updateLayerList` 两条图层状态变更路径上；旧登记在换地图 / 移除图层时 `.unload()` 并移出（不泄漏）
- `RendererLayerStateHook` 不再有 `onUpdateLayerArea` / `onUpdateLayerBlock` （计数 0） ， `onChangeBackground` / `onResizeLayer` / `onUpdateLayer` 与类名
- `IMapRenderer` （ `export` ；
- `this.map` 为 `IGameMap | null` ，其 `layerList` 为 `Set<IMapLayer>` （ `IMapLayer` ；未使用 `any` / `as` 掩盖类型不匹配
- 四条 `<automated>` 全部转绿（ ） ； `fix(04-05): forward layer area/block updates via IMapLayerHooks` 原子提交（仅 `renderer.ts` ）
< / acceptance_criteria >
< done > 逐图层钩子 `RendererLayerHook` 就位并经 `layer.addHook` 在图层状态变更路径注册，`onUpdateArea` / `onUpdateBlock` 正确转发到 `updateLayerArea` / `updateLayerBlock` ， </ done >
< / task >
< task type = "auto" >
< name > Task 3： （ ） `04-05-SUMMARY.md` 定稿</ name >
< files > .planning/phases/04-render-adaptation/04-05-SUMMARY.md< / files >
< read_first >
- .planning/phases/04-render-adaptation/04-05-SUMMARY.md（
- .planning/phases/04-render-adaptation/04-05-PLAN.md（ ）
- .planning/phases/04-render-adaptation/04-RENDER-INTERFACE-AUDIT.md（ `#04-01-M-09` 的原文，用于 SUMMARY 的处置对照）
- .planning/phases/04-render-adaptation/04-04-SUMMARY.md（
- .planning/phases/04-render-adaptation/04-CONTEXT.md（ `client` 的例外）
< / read_first >
< action >
(1) **范围门禁（基线感知，先跑，防止越界改动）** ：把当前 `git status --porcelain` 的**生产路径**（ `CONCURRENT-BASELINE` 段记录的基线条目做差集；只有**基线之外**、且不属于 `render/ui/main.tsx` / `render/map/renderer.ts` 两个在范围文件的生产改动才算越界。特别断言 `action/move.ts` （ ） （ ） （
(2) **并发改动基线门禁** ：用与 Task 1 步骤 (0b) 完全相同的固定命令重算（排除两个在范围文件与 `.planning/phases/04-render-adaptation/` 前缀），断言 porcelain 条目集合与内容摘要 `sha256` 均与 SUMMARY 的 `CONCURRENT-BASELINE` 段记录一致。
(3) **合并静态门禁** ：把 Task 1 与 Task 2 的静态断言合并复跑一次（ ： `client.hero.attribute.getFinalAttribute` 九键齐 / `state` import 在 / `@user/data-state` import 上方无 `@ts-expect-error` 且全文件计数为 1（ `main.tsx:247` 的 M-08 指令）/ `core.*` 与 `state.maps` 仍在； ： `onUpdateLayerBlock` 计数 0、`RendererLayerStateHook` 三成员在、`syncLayerHooks` 在两条路径、`.unload()` 在）。若 Task 0 对拟名有改动，本门禁须使用用户批准的名字（并在此处与 SUMMARY 中记录改名）。
(4) **复跑类型 / eslint / CRLF** ： `client-modules` 错误集 == `TYPE-BASELINE` ）、`pnpm exec eslint` 对两个文件 0 错误、CRLF 门禁（两个源文件）。
(5) **确认两个原子提交存在** ： `fix(04-05): read hero status via client attribute API` 与 `fix(04-05): forward layer area/block updates via IMapLayerHooks` ；若因执行环境未按任务提交，把两个改动合并为一个 `fix(04-05): close M-06 and M-09 render interface mismatches` 提交（仅两个在范围文件），并在 SUMMARY 记录该偏差。
(6) **人工复核（写进 SUMMARY 的「人工复核」段，逐条给结论）** ：① M-06 的 9 处逐条对位（`atk`/`hp`/`hpmax`/`mana`/`manamax`/`def`/`mdef`/`money`/`exp` → `client.hero.attribute.getFinalAttribute` ），并说明语义：读的是**最终属性**（含 Buff / 装备加成），与旧 `getHeroStatusOn` 的「状态栏显示值」定位一致（`data-base/src/hero/types.ts:102-106`）；② `:28` 指令移除的必要性（ `state` import 保留的理由（`:248` 属 M-08） ； `:248` 的 `state.maps` 逐条确认未动）；④ M-09 的转发链路：`MapLayer.setBlock` → `onUpdateBlock` → `RendererLayerHook.onUpdateBlock` → `updateLayerBlock` → `vertex.updateBlock` ，以及 `MapLayer.putMapData` → `onUpdateArea` → `updateArea` → `vertex.updateArea` ；⑤ M-09 的注册路径：`setLayerState` 与 `updateLayerList` 两处同步，说明 `GameMap.addLayer` / `removeLayer` 经 map 级 `onUpdateLayer` 进来后新图层会被补注册、被移除图层会被 `.unload()` ；⑥ `RendererLayerStateHook` 保留三个 map 级成员、类名不变；⑦ 契约面零变更（`IMapRenderer` / 任何数据端文件未动；`RendererLayerHook` 未导出；公共成员无增删改名）；⑧ 拟名落地情况（`RendererLayerHook` 已批准；`renderer` / `layer` / `layerHooks` / `syncLayerHooks` 是否按 Task 0 批准或改名）；⑨ **运行时 UAT 不可得**的理由已写明（渲染端无测试设施；`client.ts:151-155` 的 `addHero` 接线仍为注释、`MapExtensionManager.addHero` 无调用点，故状态栏数值与地图顶点刷新均无法在运行时观察）。
(7) **SUMMARY 定稿** ：写 `.planning/phases/04-render-adaptation/04-05-SUMMARY.md` ，含：改动两个在范围文件的清单与职责；`#04-01-M-06` / `#04-01-M-09` 的逐条处置对照表（含 M-06 的 9 键映射、`@ts-expect-error` 移除依据、M-09 的钩子契约迁移与注册路径、拟名落地结果）；执行前核对结论（(0a) 六条，带 `file:line` ）；执行前基线（`CONCURRENT-BASELINE` 段 + `基线摘要 sha256` ）与类型门禁基线（`TYPE-BASELINE` 段，逐行原样）；全部机器门禁的实际输出摘要；人工复核九条；**M-06 使用 `client` 对 D-23 的例外说明**（含用户原话）；未实现 / 显式延后项清单（其余 ① 错配 `#04-01-M-01` / `M-07` / `M-08` 、全部 ③ 多余旧路径、`client.ts` 接线、贴图 / 不透明度 D-18、跟随者 D-22、双布局 REND-02） ； **REND-01 / REND-02 仍为 Pending** 与运行时 UAT 不可得的明确声明。全文 CRLF。
(8) **提交 SUMMARY** ： `04-05-SUMMARY.md` 。
(9) **不做的事** ：不接线 `client.ts` 、不改 `action/move.ts` / `statistics.tsx` / `render/map/types.ts` / 任何数据端文件、不新增测试文件（渲染端无测试设施）、不修任何 ③ 多余旧路径或其它 ① 错配。
< / action >
< verify >
< automated > node -e "const fs=require('fs'),{execSync}=require('child_process');let out;try{out=execSync('git status --porcelain',{encoding:'utf8'})}catch(e){console.error('GIT STATUS FAILED '+e.message);process.exit(1)}const allow=['packages-user/client-modules/src/render/ui/main.tsx','packages-user/client-modules/src/render/map/renderer.ts'];const t=fs.readFileSync('.planning/phases/04-render-adaptation/04-05-SUMMARY.md','utf8');const bm=t.match(/<!-- CONCURRENT-BASELINE:START --> ([\s\S]*?)<!-- CONCURRENT-BASELINE:END --> /);if(!bm){console.error('NO CONCURRENT BASELINE');process.exit(1)}const base=bm[1].split(/\r?\n/).map(s=>s.replace(/\s+$/,'')).filter(Boolean).map(s=>s.slice(3).replace(/^\"|\"$/g,''));const lines=out.split(/\r?\n/).filter(l=>l.trim().length>0);const prod=lines.map(l=>l.slice(3).replace(/^\"|\"$/g,'')).filter(p=>/^packages(-user)?\//.test(p));const extra=prod.filter(p=>allow.indexOf(p)< 0 && base . indexOf ( p )< 0 ); if ( extra . length ){ console . error (' OUT-OF-SCOPE FILE MODIFIED '+ extra . join (' ; ')); process . exit ( 1 )} console . log (' OK scope ( baseline-aware ) : out-of-scope extra 0 ')"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "OUT-OF-SCOPE FILE MODIFIED"（出现 `files_modified` 之外、且不在并发基线内的生产文件改动——含 `action/move.ts` 、`statistics.tsx`、`render/map/types.ts`、任何数据端文件、`packages/**`、`src/**`；基线内的用户并发改动不触发）/ "GIT STATUS FAILED" / "NO CONCURRENT BASELINE"</ fails_when >
< automated > node -e "const fs=require('fs'),c=require('crypto'),{execSync}=require('child_process');const keep=l=>!/main\.tsx$/.test(l)&&!/map[ \\/]renderer \.ts$/.test(l)&&!/ \.planning \/phases \/04-render-adaptation \//.test(l); const out=execSync('git status --porcelain',{encoding:'utf8'}).replace(/\s+$/,'');const cur=(out?out.split(/\r?\n/).map(s=>s.replace(/\s+$/,'')):[]).filter(keep);const digest=c.createHash('sha256').update(cur.slice().sort().map(l=>{let h='MISSING';try{h=c.createHash('sha256').update(fs.readFileSync(l.slice(3))).digest('hex')}catch(e){}return l+' '+h}).join('\n')).digest('hex');const t=fs.readFileSync('.planning/phases/04-render-adaptation/04-05-SUMMARY.md','utf8');const bm=t.match(/<!-- CONCURRENT-BASELINE:START --> ([\s\S]*?)<!-- CONCURRENT-BASELINE:END --> /);if(!bm){console.error('NO CONCURRENT BASELINE');process.exit(1)}const rec=bm[1].split(/\r?\n/).map(s=>s.replace(/\s+$/,'')).filter(Boolean).filter(keep);const dm=t.match(/基线摘要[^\r\n]*?sha256=([0-9a-f]{64})/);if(!dm){console.error('NO BASELINE DIGEST');process.exit(1)}const extra=cur.filter(l=>rec.indexOf(l)< 0 ); const gone = rec.filter(l= > cur.indexOf(l)< 0 ); if ( extra . length || gone . length ){ console . error (' BASELINE ENTRY SET CHANGED extra = ['+extra.join(' ; ')+'] missing = ['+gone.join(' ; ')+']'); process . exit ( 1 )} if ( dm [ 1 ]!== digest ){ console . error (' BASELINE DIGEST CHANGED '+ dm [ 1 ]+' vs '+ digest ); process . exit ( 1 )} console . log (' OK user concurrent edits unchanged entries '+ cur . length )"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "NO BASELINE DIGEST" / "BASELINE ENTRY SET CHANGED" / "BASELINE DIGEST CHANGED"（用户并发的未提交改动被本计划回滚 / 暂存 / 提交 / 修改）< / fails_when >
< automated > node -e "const fs=require('fs');const A='packages-user/client-modules/src/render/ui/main.tsx';const B='packages-user/client-modules/src/render/map/renderer.ts';const a=fs.readFileSync(A,'utf8');const b=fs.readFileSync(B,'utf8');const fail=m=>{console.error('FINAL '+m);process.exit(1)};if((a.match(/getHeroStatusOn/g)||[]).length!==0)fail('M06 getHeroStatusOn REMAINS');const calls=(a.match(/getFinalAttribute\([^)]*\)/g)||[]).map(x=>x.replace(/getFinalAttribute/g,'').replace(/[^A-Za-z]/g,''));const want=['atk','def','exp','hp','hpmax','mana','manamax','mdef','money'].join(',');if(calls.slice().sort().join(',')!==want)fail('M06 ATTR SET MISMATCH');if(!a.includes('{ state } from')||!a.includes('@user/data-state'))fail('M06 state IMPORT LOST');const aidx=a.indexOf('@user/data-state');if(aidx< 0 ) fail (' M06 data-state IMPORT NOT FOUND '); if (/ ts-expect-error /. test ( a . slice ( Math . max ( 0 , aidx-400 ), aidx ))) fail (' M06 DIRECTIVE ABOVE data-state IMPORT REMAINS '); const ate = (a.match(/ts-expect-error/g)||[]).length;if(ate!==1)fail('M06 ts-expect-error COUNT '+ ate +' ( expected exactly 1 = the preserved M-08 directive )'); if (!/ ts-expect-error [^ \r\n]* \r? \n\s* layerState = \{state \.maps \}/.test(a))fail('M06 M08 DIRECTIVE / state . maps PAIRING LOST '); if (! a . includes (' core . status ')||! a . includes (' core . itemCount ')||! a . includes (' state . maps ')) fail (' M06 OUT-OF-SCOPE core / state EDITS '); if (!/ class RendererLayerHook implements Partial < IMapLayerHooks > /.test(b))fail('M09 RendererLayerHook DECL MISSING');if(!/\.addHook\(new RendererLayerHook\(/.test(b))fail('M09 LAYER HOOK NOT REGISTERED');if(!/updateLayerArea\(this\.layer/.test(b)||!/updateLayerBlock\(this\.layer/.test(b))fail('M09 FORWARDING WRONG');if((b.match(/onUpdateLayerArea|onUpdateLayerBlock/g)||[]).length!==0)fail('M09 LEGACY MAP-LEVEL HOOKS REMAIN');if(!b.includes('onChangeBackground')||!b.includes('onResizeLayer')||!b.includes('onUpdateLayer'))fail('M09 RendererLayerStateHook MEMBER LOST');if(!b.includes('syncLayerHooks'))fail('M09 SYNC ENTRY MISSING (or renamed - substitute approved name)');if(/export .*RendererLayerHook/.test(b))fail('M09 RendererLayerHook MUST NOT BE EXPORTED');console.log('OK final M06 + M09 static gates')"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "FINAL M06 ..." / "FINAL M09 ..."（任一 M-06 / M-09 静态断言未过；含 `syncLayerHooks` 改名后未同步替换门禁字符串的情况）</ fails_when >
< automated > node -e "const fs=require('fs'),{execSync}=require('child_process');let out='',status=null;try{out=execSync('pnpm exec vue-tsc --noEmit',{encoding:'utf8',maxBuffer:1< < 26 , stdio: [' ignore ',' pipe ',' pipe ']}); status = 0}catch(e){out=String(e.stdout||'')+String(e.stderr||'');status=(typeof e . status = =='number')?e.status:null}if(status===null){console.error('TYPE CHECK DID NOT RUN ( vue-tsc spawn failed ) : '+ out . slice ( 0 , 200 )); process . exit ( 1 )} const lines = out.split(/ \r? \n/).filter(l= > /: error TS\d+/.test(l));if(lines.length===0&& status!==0){console.error('TYPE CHECK EXITED '+status+' WITH NO PARSEABLE DIAGNOSTICS');process.exit(1)}const scope=lines.filter(l=>/render[\\/]ui[\\/]main\.tsx\(\d+,\d+\)|render[\\/]map[\\/]renderer\.ts\(\d+,\d+\)/.test(l));if(scope.length){console.error('IN-SCOPE TYPE ERRORS '+scope.length+'\n'+scope.join('\n'));process.exit(1)}const norm=l=>{const m=l.match(/client-modules[\\/]src[\\/](.+)$/);return m?m[1].replace(/\s+$/,''):null};const cur=lines.map(norm).filter(Boolean).sort();const t=fs.readFileSync('.planning/phases/04-render-adaptation/04-05-SUMMARY.md','utf8');const bm=t.match(/<!-- TYPE-BASELINE:START --> ([\s\S]*?)<!-- TYPE-BASELINE:END --> /);if(!bm){console.error('NO TYPE BASELINE');process.exit(1)}const base=bm[1].split(/\r?\n/).map(s=>s.trim()).filter(Boolean).sort();const extra=cur.filter(x=>base.indexOf(x)< 0 ); const missing = base.filter(x= > cur.indexOf(x)< 0 ); if ( extra . length || missing . length ){ console . error (' CLIENT-MODULES ERROR SET CHANGED missing = ['+missing.join(' ; ')+'] extra = ['+extra.join(' ; ')+']'); process . exit ( 1 )} console . log (' OK final type gate: in-scope 0 ; client-modules baseline '+ cur . length )"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "TYPE CHECK DID NOT RUN"（ < / fails_when >
< automated > pnpm exec eslint packages-user/client-modules/src/render/ui/main.tsx packages-user/client-modules/src/render/map/renderer.ts< / automated >
< fails_when > non-zero exit 或输出含 "error"< / fails_when >
< automated > node -e "const fs=require('fs');const FS=['packages-user/client-modules/src/render/ui/main.tsx','packages-user/client-modules/src/render/map/renderer.ts'];for(const f of FS){const s=fs.readFileSync(f,'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 '+f+' lone-lf='+(lf-crlf));process.exit(1)}}console.log('OK CRLF source files')"</ automated >
< fails_when > non-zero exit, 或 stderr 含 "NON-CRLF LINE ENDINGS"（两个源文件出现孤立 LF， `.prettierrc` 的 `endOfLine: crlf` ； </ fails_when >
< automated > node -e "const fs=require('fs');const t=fs.readFileSync('.planning/phases/04-render-adaptation/04-05-SUMMARY.md','utf8');const need=['执行前核对','CONCURRENT-BASELINE:START','TYPE-BASELINE:START','人工复核','REND-01','REND-02','Pending','getHeroStatusOn','getFinalAttribute','ts-expect-error','client','RendererLayerHook','IMapLayerHooks','syncLayerHooks','updateLayerArea','updateLayerBlock','unload','D-23','M-06','M-09'];const miss=need.filter(x=>!t.includes(x));if(miss.length){console.error('SUMMARY MISSING SECTIONS '+miss.join(','));process.exit(1)}console.log('OK summary completeness')"< / automated >
< fails_when > non-zero exit, 或 stderr 含 "SUMMARY MISSING SECTIONS"（ `client` 与 D-23 例外说明）</ fails_when >
< / verify >
< acceptance_criteria >
- 范围门禁（基线感知）证明基线之外无第三个生产文件改动（尤其 `action/move.ts` 、`statistics.tsx`、`render/map/types.ts`、任何数据端文件、`packages/**`、`src/**` 均未动）
- 并发改动基线门禁证明用户并发的未提交改动条目集合与内容摘要 `sha256` 与 Task 1 基线完全一致（未被回滚 / 暂存 / 提交 / 修改）
- 合并静态门禁、scoped 类型门禁、eslint、CRLF 全部转绿；两个在范围文件类型诊断 0 条且 `client-modules` 错误集 == `TYPE-BASELINE`
- 两个原子提交存在（或按 (5) 的合并提交，并在 SUMMARY 记录偏差）
- `04-05-SUMMARY.md` 含：改动清单与职责、`#04-01-M-06` / `#04-01-M-09` 处置对照、执行前核对六条（带 `file:line` ）、`CONCURRENT-BASELINE` 段 + `基线摘要 sha256` 、`TYPE-BASELINE` 段、门禁输出摘要、人工复核九条、M-06 使用 `client` 对 D-23 的例外说明（含用户原话）、未实现 / 延后项清单、REND-01 / REND-02 仍 Pending 与运行时 UAT 不可得的明确说明；并以 `docs(04-05)` 提交（仅含该 SUMMARY）
- 未新增任何测试文件（渲染端无测试设施），且该降级已在 SUMMARY 中如实说明
< / acceptance_criteria >
< done > 七类机器门禁全绿、用户并发改动零变化、范围无越界、两个原子提交就位、SUMMARY 定稿并按 `docs(04-05)` 提交；用户可据此继续裁决后续渲染适配增量（`#04-01-M-01` / `M-07` / `M-08` 、③ 多余旧路径、接线启用、双布局 REND-02） </ done >
< / task >
< / tasks >
< threat_model >
## Trust Boundaries
| Boundary | Description |
|----------|-------------|
| 数据端属性接口 → 渲染端状态栏 | `IHeroState.attribute.getFinalAttribute` 是数据端只读契约；渲染端把它显示到状态栏。误用可变属性对象（`getModifiableAttribute`） （ ） ， `getFinalAttribute` |
| 数据端图层钩子 → 渲染顶点数组 | `IMapLayerHooks.onUpdateArea` / `onUpdateBlock` 是数据端通知渲染端「图块区域变了」的唯一现行通道；渲染端若继续挂在错误的 map 级契约上，顶点数组永不刷新（静默失效），画面与数据不一致 |
| 渲染端契约面 → 下游调用方 | `IMapRenderer` 是 `client-base` / `client-modules` 其它模块消费的公共契约；本计划**零契约变更**，误改 `render/map/types.ts` 或误导出 `RendererLayerHook` 会扩大破坏面 |
| 数据端接口 → 渲染端绑定 | 渲染端只读 import 数据端类型并读取 `client.hero.attribute` / 注册逐图层钩子； ， ， （ ）
| 执行者/子代理 → 执行前置关卡 | AGENTS.md 要求第一个 block 点先汇报并等待用户回复「可以执行」；`yolo` / `auto_advance` 或子代理派发都不是放行理由（ `blocking-human` 、`autonomous: false`）
| 执行者 → 仓库工作树 | 用户会并发手工重构数据端；本计划只允许改两个渲染端文件，且不得触碰用户的未提交改动 |
| 未接线状态 → 验收结论 | `client.ts` 的 `addHero` 接线仍为注释、渲染端无测试设施，运行时渲染不可观察；若不显式声明，「编译通过」会被误读为「状态栏与地图刷新已可用」 |
| 既有注释 → 修改授权 | `main.tsx:28` 的编译器指令必须移除才能不新增诊断，但 AGENTS.md 禁止擅自修改既有注释；该例外只在 Task 0 获用户批准后方可执行 |
## STRIDE Threat Register
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|-----------|----------|-----------|----------|-------------|-----------------|
| T-04-05-01 | Tampering | `render/map/types.ts` 的 `IMapRenderer` 与数据端 `IMapLayerHooks` / `IGameMapHooks` 契约 | high | mitigate | 契约面零变更：`renderer.ts` 只在模块内新增不导出的 `RendererLayerHook` ；范围门禁（基线感知）只放行 `main.tsx` / `renderer.ts` ，任何对 `render/map/types.ts` 或数据端文件的改动立即判越界； `RendererLayerHook` 未被 `export` ；
| T-04-05-02 | Repudiation | `@ts-expect-error` 指令移除与 9 处属性读写的可追溯性 | medium | mitigate | 指令移除的必要性由 TS2578 实测记录支撑，并在 Task 0 汇报中单列待用户批准； `getFinalAttribute` ）与拟名落地结果写入 SUMMARY 人工复核段；
| T-04-05-03 | Elevation of Privilege | 执行前置关卡（ `checkpoint:decision` + `gate="blocking-human"` 且本计划 `autonomous: false` ；
| T-04-05-04 | Tampering | 用户并发的未提交改动（`packages-user/data-state/src/types.ts`、`src/content/*.jsonc`） `sha256` 摘要（写入 SUMMARY 的 `CONCURRENT-BASELINE` 段） ； ；
| T-04-05-05 | Spoofing | 「编译通过」被当作「运行时可用」 | medium | mitigate | 运行时 UAT 不可得（渲染端无测试设施、`addHero` 未被接线）作为 truths/assumptions 明写； `client` / `Pending` / `getFinalAttribute` 等字样与运行时不可得说明；严禁以不可运行的门禁冒充通过 |
| T-04-05-06 | Elevation of Privilege | 范围蔓延（`#04-01-M-01` / `M-07` / `M-08` 、③ 多余旧路径 `core.*` 、贴图 D-18、跟随者 D-22、`action/move.ts` D-19、`client.ts` 接线） | medium | mitigate | 范围门禁（ ） ； `core.*` 与 `state.maps` 仍在（ ） ；
| T-04-05-07 | Denial of Service | 逐图层钩子登记泄漏（换地图 / 移除图层未 `unload` ，钩子随图层累积） | medium | mitigate | `syncLayerHooks` 语义要求先注销不在 `layerList` 的登记再注册新图层； `.unload()` 存在且同步入口同时出现在 `setLayerState` 与 `updateLayerList` ；人工复核第 ⑤ 条专门核对增删图层路径。**既有边界（非本计划引入）**： （ `mapHook` 也不注销逐图层钩子；因 `MapRenderer` 生命周期与 GL 上下文同寿、单例 `client` 不再重建，该缺口不构成新增泄漏面，本计划**不**顺手改 `destroy()` （保持与既有 `mapHook` 行为对称，改动超出 M-09 范围），仅在此登记 |
| T-04-05-08 | Information Disclosure | 改动引用的接口名、文件行号与类型签名 | low | accept | 改动只含渲染端源码引用，不含凭据 / 密钥 / 用户数据；无需额外缓解 |
| T-04-05-SC | Tampering | npm / pnpm 依赖安装 | high | accept | 本计划零依赖变更、不修改 `package.json` / `pnpm-lock.yaml` （只用既有 `@user/data-base` / `@user/data-state` workspace 依赖） ，
< / threat_model >
< verification >
<!-- plan-criteria-allow: R4 - 本计划判据区内的 `|` 全部是 node -e 脚本里 JS 源码的正则交替 / 对象分隔 / 字符串拼接，不是 shell 管道；脚本内 git 调用由 execSync 的 try/catch 捕获并以非零退出失败，不会把失败读成通过。 -->
<!-- planner - discipline - allow: getHeroStatusOn -->
<!-- planner - discipline - allow: onUpdateLayerArea -->
<!-- planner - discipline - allow: onUpdateLayerBlock -->
<!-- planner - discipline - allow: ts - expect - error -->
0. 执行前置关卡（ ， `#04-01-M-09` ） `RendererLayerHook` ；拟名 `renderer` / `layer` / `layerHooks` / `syncLayerHooks` 待批）/ **必须移除 `main.tsx:28` 的 `@ts-expect-error` 指令** （含 TS2578 实测依据）/ **M-06 使用 `client` 对 D-23 的例外** （含用户原话）/ 范围边界与禁令 / 验证方式的诚实降级」后**停下等待**用户明确回复「可以执行」四个字；未收到前不得执行任何任务、不得派发执行子代理，任何触发方式与 `yolo` / `auto_advance` 模式均不得自动放行（人工核对：用户回复原文）。
1. 执行前核对与基线（ ） ： （ `IHeroAttr` 九键、`getFinalAttribute` 签名、`CoreState.hero` 赋值、`state` barrel 导出、`ILeftHeroStatus` 字段类型、`ClientCore extends CoreState`，带 `file:line` ）写入 SUMMARY； （ `基线摘要 sha256` ）与类型门禁基线（`TYPE-BASELINE` 段，逐行原样）写入 SUMMARY； ；
2. scoped 类型门禁（ ） ： `render/ui/main.tsx` 与 `render/map/renderer.ts` 必须 0 条诊断；`client-modules` 错误集必须与 SUMMARY 的 `TYPE-BASELINE` 完全一致（集合比较，顺序无关）。整仓其余既有诊断不属本计划，不得以「整仓非 0 退出」判定失败，也不得漏判两个在范围文件的新诊断（尤其是删除符号后遗留指令所引发的 TS2578）
3. M-06 静态门禁（ ） ： `getHeroStatusOn` 计数 0； `atk, def, exp, hp, hpmax, mana, manamax, mdef, money` （ `{ state } from` 仍在；`@user/data-state` import 上方无 `ts-expect-error` ，且全文件计数为 1（ `core.itemCount` / `state.maps` 仍在（正向保留断言，防越界迁移）。
4. M-09 静态门禁（ ） ： `class RendererLayerHook implements Partial<IMapLayerHooks>` （未导出）；存在 `.addHook(new RendererLayerHook(` ；存在转发 `updateLayerArea(this.layer` 与 `updateLayerBlock(this.layer` ； `onUpdateLayerBlock` 计数 0； `onResizeLayer` / `onUpdateLayer` 三成员仍在；同步入口出现在 `setLayerState` 与 `updateLayerList` 两个方法体内；存在 `.unload()` ； `IMapLayerHookController` 已 import。
5. 并发改动基线门禁（ ） ： `.planning/phases/04-render-adaptation/` 后， `sha256` 与 SUMMARY 的 `CONCURRENT-BASELINE` 段记录一致（用户改动未被回滚 / 暂存 / 提交 / 修改）。
6. 范围门禁（ ， ） ： `git status --porcelain` 的生产路径（`^packages(-user)?/`）与 `CONCURRENT-BASELINE` 段做差集；只有基线之外、且不属于 `main.tsx` / `renderer.ts` 的生产改动才判越界；`action/move.ts`、`statistics.tsx`、`render/map/types.ts`、数据端各包、`client-base`、`packages`、`src` 均无基线之外的新改动。
7. ESLint / CRLF 门禁（ ） ： `main.tsx` / `renderer.ts` 0 错误；两个源文件无孤立 LF（ `endOfLine: crlf` ）
8. 人工复核（ ） ： `state` import 保留的理由； ； `onUpdateBlock` → `updateLayerBlock` → `vertex.updateBlock` ； `onUpdateArea` → `updateLayerArea` → `vertex.updateArea` ） ； `updateLayerList` 两处同步与 `addLayer` / `removeLayer` 覆盖）；`RendererLayerStateHook` 三成员保留；契约面零变更；拟名落地情况；运行时 UAT 不可得的理由已写明。
9. 提交（ ） ： `main.tsx` ）、`fix(04-05): forward layer area/block updates via IMapLayerHooks`（仅 `renderer.ts` ）、`docs(04-05): record execution state`（仅 SUMMARY） ； ； ，
< / verification >
< success_criteria >
- **执行前置关卡（ ） ： 本计划第一个 block 点是 Task 0 —— 向用户汇报计划内容、两条错配的锚点与影响、成员命名清单（含唯一已批准名与四项待批拟名）、**必须移除 `main.tsx:28` 的 `@ts-expect-error` 指令**、**M-06 使用 `client` 对 D-23 的例外**后停下等待用户明确回复「可以执行」四个字；未收到前不执行任何任务、不派发执行子代理，任何触发方式与 `yolo` / `auto_advance` 模式均不得自动放行。
- ** `#04-01-M-06` ： `main.tsx` 的 `getHeroStatusOn` 彻底消失（ ） ， `client.hero.attribute.getFinalAttribute('<key>')` 读取且键集合为 `atk, hp, hpmax, mana, manamax, def, mdef, money, exp` ； `@ts-expect-error` 指令按用户批准移除；`state` import 保留；其余 `core.*` 与 `:248` 的 `state.maps` 一字未动。
- ** `#04-01-M-09` ： `renderer.ts` 新增模块内不导出类 `RendererLayerHook` （ < IMapLayerHooks > `），把 `onUpdateArea` / `onUpdateBlock` 转发到 `renderer.updateLayerArea(layer, ...)` / `renderer.updateLayerBlock(layer, ...)` ；逐图层注册经 `layer.addHook(...)` 落在 `setLayerState` 与 `updateLayerList` 两条图层状态变更路径，换地图 / 移除图层时 `.unload()` ； `onUpdateLayerArea` / `onUpdateLayerBlock` 清零并保留 map 级三职责；类名不变。
- **契约面与范围：** 不新增 / 删除任何公共接口成员（`IMapRenderer`、数据端接口一律未动）；`RendererLayerHook` 未被导出；不新增依赖；`action/move.ts`、`statistics.tsx`、`render/map/types.ts`、数据端各包、`client-base`、`client.ts` 接线、`packages/**`、`src/**` 均未被触碰；用户并发的未提交改动未被回滚 / 暂存 / 提交 / 修改。
- **验证诚实且可运行：** scoped 类型门禁（两个在范围文件 0 条、`client-modules` 错误集 == 基线）
- REND-01 / REND-02 保持 Pending（ ） ， （ `M-07` / `M-08` 、③ 多余旧路径、接线启用、双布局 REND-02）
## Artifacts this phase produces
| 类型 | 路径 | 内容 |
|------|------|------|
| 生产源码（修改） | `packages-user/client-modules/src/render/ui/main.tsx` | `updateStatus()` 的 9 个数值属性改经 `client.hero.attribute.getFinalAttribute(...)` 读取；`getHeroStatusOn` 与其 `:28` 的 `@ts-expect-error` 指令移除；`import { state } from '@user/data-state';` 保留；其余 `core.*` / `client.flags.*` / `:248` 的 `state.maps` 一字未动 |
| 生产源码（修改） | `packages-user/client-modules/src/render/map/renderer.ts` | 新增模块内不导出类 `RendererLayerHook` （ < IMapLayerHooks > `）转发 `onUpdateArea` / `onUpdateBlock` 到 `updateLayerArea` / `updateLayerBlock` ； `updateLayerList` 两条路径同步逐图层登记（`layer.addHook` + `.load()` / `.unload()` ） ； `onUpdateLayerArea` / `onUpdateLayerBlock` 并保留 `onChangeBackground` / `onResizeLayer` / `onUpdateLayer` |
| 摘要 | `.planning/phases/04-render-adaptation/04-05-SUMMARY.md` | 执行前核对六条（带 `file:line` ）、`CONCURRENT-BASELINE` 段 + `基线摘要 sha256` 、`TYPE-BASELINE` 段、`#04-01-M-06` / `#04-01-M-09` 处置对照、门禁输出摘要、人工复核九条、M-06 使用 `client` 对 D-23 的例外说明、未实现项清单、REND-01 / REND-02 Pending 声明与运行时 UAT 不可得说明 |
< / success_criteria >
< output >
Create `.planning/phases/04-render-adaptation/04-05-SUMMARY.md` when done
< / output >
