diff --git a/.planning/phases/09-minimum-browser-runnable/09-51-PLAN.md b/.planning/phases/09-minimum-browser-runnable/09-51-PLAN.md
new file mode 100644
index 0000000..a83f21c
--- /dev/null
+++ b/.planning/phases/09-minimum-browser-runnable/09-51-PLAN.md
@@ -0,0 +1,353 @@
+---
+phase: 09-minimum-browser-runnable
+plan: 51
+type: execute
+# 31:09-27..09-50 的计划与摘要均已提交并占用编号,本计划使用下一个空闲编号 09-51 / 波次 31。
+# depends_on 为空:本计划触碰的 6 个代码 / 测试文件没有未执行计划会并行写入,
+# 排期在后只表示排在既有计划之后,不是依赖前序计划。
+wave: 31
+depends_on: []
+files_modified:
+ - packages-user/client-base/src/map/types.ts
+ - packages-user/client-base/src/map/status.ts
+ - packages-user/client-base/src/map/moving.ts
+ - packages-user/client-base/src/map/vertex.ts
+ - packages-user/client-base/src/map/renderer.ts
+ - packages-user/client-base/src/map/__test__/rendererGate.test.ts
+ - .planning/phases/09-minimum-browser-runnable/09-51-SUMMARY.md
+autonomous: false
+requirements: []
+estimate:
+ # 未校准估算(confidence: low),SUMMARY 须声明。
+ # 成本主要在 5 个互相耦合的源码文件同时改写、重写闸门测试、一次全仓 vue-tsc(实测约 1 分钟)。
+ tokens: 80000
+ raw_tokens: 80000
+ tasks: 3
+ confidence: low
+must_haves:
+ truths:
+ - "**第一个 block 点是 Task 0 的 `blocking-human` 汇报关卡(D-03 / AGENTS.md)**:汇报逐文件逐符号改动、类与接口的精确形态、提升与不降级语义、`toStatic` 语义、明确不改的部分、待批准命名(含备选)、范围外错误、旧注释保持不变清单、无浏览器 UAT / 无 WebGL E2E、不提交代码,以及 09-27..09-50 已占用、本计划用 09-51 / 波次 31 的说明;然后停下等待用户恰好回复「可以执行」。"
+ - "**覆盖层只剩一个具体类**:`types.ts` 的 `IOverlayBlock` 新增 `readonly index: number` 与 `toStatic(layer, x, y): void` 并显式重声明 `setAlpha`(覆盖层设为 1 不降级);删除 `IOverlayStaticBlock`;`IRenderBlockMover` 原样保留且无人实现;`status.ts` 只剩 `StaticBlockStatus` 与唯一的 `OverlayBlock implements IOverlayBlock`;`DynamicBlockStatus` / `StaticOverlayBlock` 被删除。"
+ - "**静态层 alpha 严格小于 1 自动提升**:`setStaticAlpha` 在目标格未提升时 `alpha < 1` 走 `promoteStaticBlock`(申请覆盖层索引、创建 `OverlayBlock`、把静态实例 16 个浮点整体拷入覆盖层槽位、覆盖 alpha、把静态实例前四个矩形浮点清零、登记提升表、置三个脏标记并请求更新);`alpha >= 1` 只写静态实例 alpha。目标格已提升时无论 alpha 是否为 1 都只写覆盖层槽位——没有自动降级。"
+ - "**`toStatic` 把覆盖层数据写回静态格并释放槽位**:`OverlayBlock.toStatic` 委托 `renderer.vertex.toStatic(this, layer, x, y)`;后者定位目标静态实例、整体写入 16 个浮点、按 `(x - block.x)` / `(y - block.y)` 平移前四个矩形浮点、按静态公式重算第 9 个浮点(z)、标脏目标分块,再调用 `renderer.deleteOverlayBlock(block)` 释放索引与槽位并移除提升登记;目标格不存在时直接返回、不删除覆盖块。"
+ - "**`moving.ts` 退化为注释参考**:删除 `IMovingRenderer` / `MovingBlock` 的全部可执行声明(文件里不再有 `import` / `export` / 类声明参与编译),`lineTo` / `moveAs` / `moveRelative` / `endMoving` / `stepMoving` 及其依赖字段以逐行 `//` 注释保留;`map/index.ts` 的 `export * from './moving'` 不动且仍合法。"
+ - "**`renderer.ts` 用覆盖层集合 / 索引映射 / 索引池取代移动图块机制**:五个公开方法 `addOverlayBlock` / `getOverlayBlocks` / `getOverlayBlockByIndex` / `deleteOverlayBlock` / `deleteOverlayBlockByIndex`,新增内部工厂 `createOverlayBlock`;删除 `addMovingBlock` / `deleteMoving` / `hasMoving`、`IMovingRenderer` 与 `MovingBlock` 引入;`tick` 保留背景帧 / 地图帧 / tickers / 池缩减,不再步进任何图块;两遍式绘制、深度掩码、`blendFuncSeparate`、FBO / 深度附件 / ping-pong、postEffect、`map.frag` 不动。"
+ - "**`vertex.ts` 只服务静态层 + 覆盖层两张表**:`overlayOrdered: IOverlayBlock[]`,排序键依次为 `getLayerIndex(layer)` → `y` → `x` → `priority`,成员直接来自 `renderer.getOverlayBlocks()`;组装只按 `block.index` 从 `dynamicInstancedArray` 拷贝 16 个浮点;`updateOverlay` / `updateOverlayList` / `deleteOverlay` 全部按 `block.index` 工作;删除 `alphaMap` / `pendingAlpha` / `flushPendingAlpha` / `overlayStatic` 与 `StaticOverlayBlock` / `MovingBlock` 的静态-动态分支;内部提升表用于 `setStaticAlpha` / `getStaticAlpha` / 帧数方法;静态格数据更新时按更新掩码把变化同步到提升槽位(不动 alpha),源格变空时删除提升块;"
+ - "**行为与范围受控**:不改变渲染管线、分块张量布局、动态起始索引、覆盖层缓冲上传与绘制、`viewport.ts` 的动态尾部合并、`chunk.ts` 的分块实现;不改 `extension/*`(`hero.ts` / `door.ts` 仍引用已删除的 `addMovingBlock` / `IMovingBlock`,按用户要求保留为范围外错误、不修)、`element.ts`、`index.ts`、`constant.ts`、`shader/map.frag`;除 `IBlockStatus.setAlpha` / `IOverlayBlock.setAlpha` / `IOverlayBlock.toStatic` 三处 jsDoc 外不改任何既有注释(只新增);测试文件的 `it` 说明注释随范围同步改写。"
+ - "**闸门测试真实通过**:`rendererGate.test.ts` 全部改写为断言单类覆盖层、提升 / 不降级 / `toStatic`、覆盖层集合与索引池、`tick` 无步进、`moving.ts` 无可执行导出,并保留渲染管线、后处理、深度附件、混合、分块布局、动态尾部合并、`map.frag` 阈值的既有守护;每个 `it` 前一行 `//` 注释;不引用已删除符号。"
+ - "**验证形态(无浏览器 UAT)**:vitest、eslint(6 文件)、`vue-tsc --noEmit`(完成性守卫 + 只判 5 个计划文件 + 精确豁免 `renderer.ts` 的 `IMapRendererTicker` 与 `getLayerByAlias` 两条既有诊断并打印原文,其它任何诊断失败,`extension/*` / `element.ts` 由过滤排除)、范围闸门(与 Task 1 采集的 `git status` 集合逐条相等,不用 `.trim()`)、哈希闸门(9 个范围外文件逐字未变);不宣称 WebGL E2E;代码一律不提交。"
+ artifacts:
+ - path: packages-user/client-base/src/map/types.ts
+ provides: "`IOverlayBlock` 新增 `readonly index` / `toStatic` / 重声明 `setAlpha`;删除 `IOverlayStaticBlock`;`IRenderBlockMover` 保留;`IMapRenderer` 新增 `createOverlayBlock` 并保留五个覆盖层方法;`IMapVertexGenerator` 新增低层 `toStatic`;三处 jsDoc 更新(`IMapDataGetter.hasMoving` 位于 `vertex.ts`,在 Task 1 第 5 步删除)"
+ - path: packages-user/client-base/src/map/status.ts
+ provides: "唯一 `OverlayBlock implements IOverlayBlock`(layer / priority / index / renderer / texture / tile / x / y;setPos / setTexture / setAlpha / getAlpha / useGlobalFrame / useSpecifiedFrame / getFrame / useDefaultFrame / destroy / toStatic);`StaticBlockStatus` 原样保留;`DynamicBlockStatus` / `StaticOverlayBlock` 删除"
+ - path: packages-user/client-base/src/map/moving.ts
+ provides: "无可执行导出;五个移动方法与相关字段以 `//` 注释保留;文件头说明未来 mover 的实现位置"
+ - path: packages-user/client-base/src/map/renderer.ts
+ provides: "覆盖层集合 / 索引映射 / 索引池;五个公开方法 + `createOverlayBlock`;`tick` 不再步进;删除移动图块公开面与 `IMovingRenderer` 实现"
+ - path: packages-user/client-base/src/map/vertex.ts
+ provides: "单表排序与组装;提升表、提升 / 写静态 alpha / 帧数转发 / 隐藏判定;低层 `toStatic`;`updateOverlay` / `updateOverlayList` / `deleteOverlay` 按 `block.index`;无 `alphaMap` / `flushPendingAlpha` / `overlayStatic` / 静态-动态分支"
+ - path: packages-user/client-base/src/map/__test__/rendererGate.test.ts
+ provides: "覆盖层单类、提升 / 不降级、`toStatic`、索引池、`tick` 无步进、`moving.ts` 无可执行导出的断言,以及既有渲染管线守护;每个 `it` 前一行注释"
+ - path: .planning/phases/09-minimum-browser-runnable/09-51-SUMMARY.md
+ provides: "逐文件前后形态、删除符号、未改动清单、五类门禁真实结果与豁免原文、范围外类型错误保留声明、无浏览器 UAT / 无 WebGL E2E、估算未校准、0 次提交、编号说明、旧注释保持不动的 OI 清单"
+ key_links:
+ - "`IOverlayBlock.index` ↔ `dynamicInstancedArray[index * INSTANCED_COUNT]` ↔ `assembleOverlay()` 的 16 浮点拷贝 —— 索引必须由渲染器索引池分配且唯一,否则两个覆盖块互相覆盖槽位"
+ - "`createOverlayBlock(layer, 0, tile, num)`(提升)↔ `renderer.overlayIndexMap` ↔ `sortOverlay()` 的 `getOverlayBlocks()` —— 提升块必须是集合成员,否则排序与组装都看不到它,而静态实例已被清零,图块凭空消失"
+ - "`setStaticAlpha` 的 `alpha < 1` 分支 ↔ `promoteStaticBlock` ↔ 静态实例前四个矩形浮点清零 —— 只拷贝不清零会让不透明遍与覆盖层各画一遍(半透明图块双重混合)"
+ - "`setStaticAlpha` 已提升分支 ↔ `promoted.setAlpha(alpha)`(没有删除调用)—— 覆盖层 alpha 恰好为 1 时不得降级,否则回到静态层的错误混合路径"
+ - "`toStatic` ↔ 覆盖层槽位 16 浮点写入静态实例 ↔ `deleteOverlayBlock` 释放索引 —— 写入必须发生在释放之前,否则读到已被 `EMPTY_VETREX` 清空的槽位"
+ - "`IMapDataGetter` 去掉 `hasMoving` ↔ `MapRenderer implements IMapRenderer, IMapDataGetter` —— 移除方法却保留接口成员会重新出现 `TS2420`"
+ - "`tick` 保留背景 / 帧 / tickers 但删除 `stepMoving` 与 `updateOverlayList` —— 移动驱动不在本阶段范围,保留会让已删除符号重新出现在渲染器里"
+ - "`moving.ts` 无可执行导出 ↔ `map/index.ts` 的 `export * from './moving'` —— 空模块仍可被星号导出,不得为「让导出看起来合理」而改 `index.ts`"
+ - "闸门测试的 `?raw` 源码字符串 ↔ 真实源码符号 —— 断言必须基于迁移后的符号;对 `moving.ts` 必须先过滤 `//` 行再判断「无导出」"
+ assumptions:
+ - "**工作树基线(规划日实测)**:`git status --porcelain -uall -- packages-user/client-base/src/map` 为 12 条:` D block.ts` / ` M extension/text.ts` / ` M index.ts` / ` M moving.ts` / ` M renderer.ts` / ` M shader/map.frag` / ` M status.ts` / ` M types.ts` / ` M vertex.ts` / ` M viewport.ts` / `?? __test__/rendererGate.test.ts` / `?? chunk.ts`。本计划只写 7 个路径,执行后该集合必须逐条不变。"
+ - "**类型基线(规划日 `vue-tsc --noEmit` 实测)**:`types.ts` 0 条;`status.ts` 8 条;`moving.ts` 3 条;`vertex.ts` 1 条;`renderer.ts` 9 条(`IMapRendererTicker` 缺失、`IMovingBlock` 缺失、`MapRenderer` 未正确实现接口、两处 `this` 不可赋给接口、`IGameMap.getLayerByAlias` 缺失、`MovingBlock` 不可赋给 `IOverlayBlock`)。迁移后 `types.ts` / `status.ts` / `moving.ts` / `vertex.ts` 必须 0 条;`renderer.ts` 只允许保留 `IMapRendererTicker` 与 `getLayerByAlias` 两类既有且范围外的诊断。"
+ - "**范围外仍会报错(不修)**:`extension/hero.ts` 引用 `IMapRendererTicker` / `IMovingBlock` / `addMovingBlock` / `requestTicker` / `@user/data-state.state`;`extension/door.ts` 引用 `addMovingBlock`;`element.ts` 引用 `IMapRenderer.tick`。类型闸门按文件过滤,不参与判定。"
+ - "**工具链(规划日实测)**:`node` v24.21.0;`node_modules/vitest/vitest.mjs`、`node_modules/eslint/bin/eslint.js`、`node_modules/vue-tsc/bin/vue-tsc.js`、`node_modules/prettier/bin/prettier.cjs` 均存在;`pnpm` 在本树不可用;`vue-tsc --noEmit` 实测约 1 分钟,退出码 2 且有 `error TS` 输出属正常基线。"
+ - "**格式约束**:`.prettierrc` 为 `printWidth: 80` / `tabWidth: 4` / `singleQuote: true` / `arrowParens: avoid` / `trailingComma: none` / `endOfLine: crlf`,eslint 启用 prettier 插件。代码文件必须 CRLF;只允许对 6 个代码 / 测试文件运行 prettier(仅排版)。禁止 `import type`。"
+ - "**测试源码读取**:用 Vite 的 `*?raw` 导入读取源码文本,不用 `node:fs`;测试在仓库根运行,vitest 默认收集 `**/*.test.ts`。"
+ - "**既有注释保持不动(AGENTS.md)**:除上述三处 jsDoc 外不得改任何既有注释。迁移后 `vertex.ts` 的 `sortOverlay` jsDoc 仍写 `kind`、`assembleOverlay` jsDoc 仍描述静态条目与矩形覆盖、`expandOverlay` / `reduceOverlay` 的 jsDoc 仍写「移动图块数组」,`status.ts` 分区标题仍写「覆盖层图块」——这些逐字保留并列入 OI-3。测试文件的 `it` 说明注释例外,随范围同步改写。"
+ - "**无 RESEARCH / 无 VALIDATION**:本 run 无 `09-51-RESEARCH.md` / `09-51-VALIDATION.md`;本阶段无 requirement ID,Nyquist 不适用。spec-less probe fallback skipped: phase has no requirement IDs to probe (visible skip)。"
+ prohibitions:
+ - "不得在用户恰好回复「可以执行」之前执行任何任务或派发执行子代理(D-03 / AGENTS.md)。"
+ - "不得运行任何 git 写命令(`add` / `commit` / `stash` / `checkout` / `restore` / `worktree` / `reset`);本计划全程 0 次代码提交,改动留在工作树供审查。"
+ - "不得恢复或新建 `DynamicBlockStatus` / `StaticOverlayBlock` / `IOverlayStaticBlock` / `IMovingBlock` / `IMovingRenderer` / `MovingBlock`;不得用 `abstract class` / `interface` 替代 `OverlayBlock` 具体类;不得给 `OverlayBlock` 增加子类。"
+ - "不得增加自动降级:覆盖层 alpha 恰好为 1 时必须留在覆盖层;`setStaticAlpha` 的已提升分支不得调用任何删除 / 恢复静态矩形的方法。"
+ - "不得改变渲染管线、排序键顺序、分块张量布局、`dynamicStart` / `dynamicCount` 语义、覆盖层缓冲上传与绘制、`viewport.ts`、`chunk.ts`、`shader/map.frag`、`map/index.ts`、`constant.ts`、`element.ts`。"
+ - "不得触碰 `extension/*`、`element.ts`、`index.ts`、`viewport.ts`、`chunk.ts`、`constant.ts`、`shader/*`、其它包、依赖与配置、其它计划与摘要、`09-CONTEXT.md`;范围外类型错误保留、不修。"
+ - "不得修改除三处 jsDoc 之外的任何既有注释或 jsDoc;不得为「让闸门变绿」删除用例、放宽断言、忽略整个文件或整类诊断;不得擅自处理 OI 之外的疑似问题(包括 `reduceOverlay` 未同步池大小、`getDynamicAlpha` / `getDynamicFrame` 的边界判断等既有形态)。"
+ open_items:
+ - "**OI-1(命名待批准,未获批前不得落码;含备选):** ① `IMapRenderer.createOverlayBlock(layer, priority, texture, tile)`(备选 `registerOverlayBlock` / `addOverlayBlockInstance`;若坚持只保留 4 参 `addOverlayBlock`,则提升块与 API 覆盖块同为 priority 1,需要接受同格同坐标的先后由插入顺序决定);② `IMapVertexGenerator.toStatic(block, layer, x, y)`(备选 `writeStatic` / `applyStatic`);③ `OverlayBlock` 构造器 `(layer, priority, index, texture, tile, renderer)`(备选把 `renderer` 放首位或 `texture` / `tile` 换序);④ 渲染器私有重命名 `overlayBlocks` / `overlayIndexMap` / `overlayIndexPool` / `overlayCount` / `expandOverlay` / `reduceOverlay` / `requireOverlayIndex` / `returnOverlayIndex`(仅标识符改名,逻辑逐字保留);⑤ 新增私有方法 `promoteStaticBlock` / `writeStaticAlpha` / `getPromotedBlock` / `setPromotedBlock` / `deletePromotedBlock` / `deletePromotedBlockByValue`。`tile` 只作为 `OverlayBlock` 类成员(不加入 `IOverlayBlock`),`vertex.updateOverlay` 传 `num: -1`。**不重命名任何公开方法参数与既有 `@param` jsDoc。**"
+ - "**OI-2(语义边界,只记录):** `toStatic` 忠实拷贝 16 个浮点(含 alpha);若写回的 alpha 仍小于 1,静态格会以半透明进入不透明遍,调用方需自行再次 `setStaticAlpha` 或先置 1;`toStatic` 不修改地图数据(external owns map data)。`checkRebuild` / `setBlockSize` 只清空提升表,渲染器中的覆盖块集合保持不变(与旧版清空静态记录同阶);重建后这些块的数据被 `mallocVertexArray` 复位,属既有边界。"
+ - "**OI-3(注释与实现不一致,只记录、待批准):** `sortOverlay` 的 `kind` 措辞、`assembleOverlay` 的静态矩形描述、`expandOverlay` / `reduceOverlay` 的「移动图块」措辞、`status.ts` 的分区标题均保留原文;是否改写由用户决定。"
+ - "**OI-4(范围外类型错误,只记录):** `extension/hero.ts` / `extension/door.ts` / `element.ts` 仍引用已删除的移动图块 API 与缺失接口,`vue-tsc` 会继续报错;本计划不修。"
+ - "**OI-5(待批准的注释处置):** `OverlayBlock.setPos` 里既有 `// TODO: 通知更新` 已与新的 `updateOverlay(this, false)` 调用不符;按 AGENTS.md「不得修改既有注释」原样保留,是否删除由用户决定。"
+---
+
+
+Phase 9 · 第 51 个计划(新增的独立增量,**不是** 09-01..09-50 的 UI / 文档任务)—— **把地图渲染的「静态层 + 覆盖层」两层模型收敛成两个真正的概念:静态图块数据,以及唯一的覆盖层图块类 `OverlayBlock`**,并删除静态 / 动态 / 移动三套历史抽象。
+
+**要解决的问题:** 当前工作树停在半迁移状态:`types.ts` 已删除 `IMovingBlock` 却仍保留 `IOverlayStaticBlock` 与 `IRenderBlockMover`;`status.ts` 里 `DynamicBlockStatus extends OverlayBlock` 与 `StaticOverlayBlock` 同时存在,`OverlayBlock` 还缺 `index` / `tile`;`moving.ts` 仍声明 `MovingBlock` / `IMovingRenderer` 并引用已不存在的 `IMovingBlock`;`renderer.ts` 仍是移动图块集合与 `addMovingBlock`;`vertex.ts` 仍用 `alphaMap` 延迟 flush 与 `overlayStatic` 静态记录,并在排序 / 组装里做静态-动态分支。用户裁定:**只有两层**——静态层(图块 / 分块)与覆盖层(`OverlayBlock` 集合);`IOverlayBlock` 增加 `readonly index` 与 `toStatic(layer, x, y)`;静态 alpha 严格小于 1 自动提升为覆盖层;覆盖层 alpha 恰好为 1 不降级、没有自动降级;`MovingBlock` 的移动算法只作为未来 mover 的注释参考。
+
+**做法(锁定设计):**
+- `types.ts`:`IOverlayBlock` 增 `readonly index: number` 与 `toStatic(layer, x, y): void`,并显式重声明 `setAlpha` 说明覆盖层不降级;删除 `IOverlayStaticBlock`;`IRenderBlockMover` 原样保留且不实现;`IMapRenderer` 新增 `createOverlayBlock` 内部工厂并保留五个覆盖层方法;`IMapVertexGenerator` 新增低层 `toStatic(block, layer, x, y)`;`vertex.ts` 的 `IMapDataGetter` 删除 `hasMoving`。
+- `status.ts`:只保留 `StaticBlockStatus` 与唯一的 `OverlayBlock implements IOverlayBlock`(`layer` / `priority` / `index` / `renderer` / `texture` / `tile` / `x` / `y`;`setPos` / `setTexture` / `setAlpha` / `getAlpha` / `useGlobalFrame` / `useSpecifiedFrame` / `getFrame` / `useDefaultFrame` / `destroy` / `toStatic`);删除 `DynamicBlockStatus` / `StaticOverlayBlock`。
+- `moving.ts`:无可执行导出,五个移动方法以 `//` 注释保留。
+- `renderer.ts`:覆盖层集合 / 索引映射 / 索引池;五个公开方法 + `createOverlayBlock`;删除移动图块公开面;`tick` 不再步进。
+- `vertex.ts`:`overlayOrdered: IOverlayBlock[]`、单表排序与组装、提升表与提升 / 写静态 alpha / 帧数转发、低层 `toStatic`;删除 `alphaMap` / `flushPendingAlpha` / `overlayStatic` 与静态-动态分支。
+- 同步重写闸门测试;验证只做自动化门禁与类型闸门,**不做浏览器 UAT、不宣称 WebGL E2E、不提交任何代码**。
+
+**约束:** 只动 `files_modified` 的 7 个路径;不改 `extension/*` / `viewport.ts` / `chunk.ts` / `element.ts` / `index.ts` / `shader/*`;除三处指定 jsDoc 外不改既有注释;不新增依赖;不改配置;所有新增命名待批准(OI-1)。
+
+**修改方式声明(AGENTS.md):** 本计划的全部文件写入(改 5 个源码、改 1 个测试、写 1 个 SUMMARY)由**派发子代理(`gsd-executor`)执行**,非内联执行;除 `files_modified` 外无任何写入;代码一律不提交。
+
+**可见跳过:** spec-less probe fallback skipped: phase has no requirement IDs to probe (visible skip)。本阶段无 requirement ID,不创建 RESEARCH.md / VALIDATION.md,Nyquist 验证不适用。
+
+
+## 本计划产出物(Artifacts this plan produces)
+
+| 类型 | 名称 / 路径 | 说明 |
+|------|-------------|------|
+| 修改(导出接口) | `IOverlayBlock`(新增 `index` / `toStatic` / 重声明 `setAlpha`) | `types.ts`;唯一覆盖层契约 |
+| 删除(导出接口) | `IOverlayStaticBlock` | `types.ts`;静态覆盖块概念消失 |
+| 保留(导出接口) | `IRenderBlockMover` | `types.ts`;未来 mover 的契约,本计划不实现 |
+| 新增(导出方法) | `IMapRenderer.createOverlayBlock`、`IMapVertexGenerator.toStatic` | `types.ts`;命名待批准(OI-1) |
+| 修改(导出类) | `OverlayBlock implements IOverlayBlock` | `status.ts`;唯一具体覆盖层类 |
+| 删除(导出类) | `DynamicBlockStatus`、`StaticOverlayBlock` | `status.ts` |
+| 保留(导出类) | `StaticBlockStatus` | `status.ts`;逐字不动 |
+| 修改 | `moving.ts` | 退化为注释参考,无可执行导出 |
+| 修改 | `renderer.ts` | 覆盖层集合 / 映射 / 池 + 五个公开方法 + `createOverlayBlock` + `tick` 去步进 |
+| 修改 | `vertex.ts` | 单表排序 / 组装 + 提升 + `toStatic` |
+| 修改 | `map/__test__/rendererGate.test.ts` | 全量改写为新模型断言 |
+| 交付 | `.planning/phases/09-minimum-browser-runnable/09-51-SUMMARY.md` | 执行摘要、门禁结果、范围外错误、UAT 跳过声明 |
+
+## 覆盖审计(Multi-Source Coverage Audit)
+
+| 源 | 条目 | 覆盖位置 |
+|----|------|----------|
+| GOAL(ROADMAP §Phase 9) | 「可在浏览器中运行并验证的最小版本」伞目标 | 本增量只收敛渲染层的覆盖块模型,不新增浏览器可运行性;SUMMARY 如实记录 |
+| REQ | 本阶段无 requirement ID(`requirements: []`) | Nyquist 不适用 |
+| RESEARCH | 本 run 无 RESEARCH.md | 不适用 |
+| CONTEXT D-01 | 增量派发,一个任务一个计划 | 本计划即该派发的唯一计划,不拆分 |
+| CONTEXT D-02 | 计划可累积追加 | plan 51,排在 09-01..09-50 之后(编号说明见 frontmatter) |
+| CONTEXT D-03 | 执行前必须先汇报并等待「可以执行」 | Task 0(`blocking-human`),`autonomous: false` |
+| CONTEXT D-04 | 新命名必须先反馈获批 | Task 0 逐条报备 OI-1 |
+| CONTEXT D-05 | 默认不逐阶段验证 | 本计划仍做自动化门禁,但明确不做浏览器 UAT |
+| CONTEXT D-06 | 范围由用户界定,不擅自扩大 | `files_modified` 7 项 + 范围闸门 + 哈希闸门 |
+| 用户设计 | 只有静态层 + 覆盖层;单一 `OverlayBlock`;`IOverlayBlock` 增 `index` / `toStatic`;删除 `IOverlayStaticBlock` | Task 1(`types.ts` / `status.ts`)+ Task 2 |
+| 用户设计 | 静态 alpha < 1 自动提升;覆盖层 alpha 1 不降级;无自动降级 | Task 1(`vertex.ts`)+ Task 2 |
+| 用户设计 | `toStatic` 写回静态格、重算 z / 位置、释放槽位;external owns map data | Task 1(`vertex.ts` + `OverlayBlock.toStatic`)+ Task 2 |
+| 用户设计 | `MovingBlock` 五个方法只保留为注释;mover 创建 / 驱动不在范围 | Task 1(`moving.ts`)+ Task 2 |
+| 用户设计 | 渲染器覆盖层集合 / 映射 / 池;删除移动公开面;`tick` 不步进 | Task 1(`renderer.ts`)+ Task 2 |
+| 用户设计 | 只改三处 jsDoc;其余既有注释不动 | Task 1 / Task 2 + Task 0 报备 + OI-3 |
+| 用户设计 | 范围外错误(hero / door / element)不修;类型闸门只管计划文件 | Task 2 类型闸门 + SUMMARY(OI-4) |
+| 用户设计 | 不做 UAT / WebGL E2E;不提交代码 | Task 0 报备 + Task 2 SUMMARY |
+
+
+@C:/Users/13194/.config/opencode/gsd-core/workflows/execute-plan.md
+@C:/Users/13194/.config/opencode/gsd-core/templates/summary.md
+
+
+
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/09-minimum-browser-runnable/09-CONTEXT.md
+@AGENTS.md
+@dev.md
+@packages-user/client-base/src/map/types.ts
+@packages-user/client-base/src/map/status.ts
+@packages-user/client-base/src/map/moving.ts
+@packages-user/client-base/src/map/vertex.ts
+@packages-user/client-base/src/map/renderer.ts
+@packages-user/client-base/src/map/chunk.ts
+@packages-user/client-base/src/map/viewport.ts
+@packages-user/client-base/src/map/__test__/rendererGate.test.ts
+
+
+
+
+
+ Task 0: 预执行汇报关卡 —— 汇报单类覆盖层、提升 / 不降级、toStatic、逐文件符号、不改清单、待批准命名与范围外错误,等待「可以执行」
+ 工作树处于 assumptions 描述的半迁移状态(`types.ts` 无 `IMovingBlock` 但有 `IOverlayStaticBlock`;`status.ts` 同时有 `DynamicBlockStatus` 与 `StaticOverlayBlock`;`moving.ts` 仍声明 `MovingBlock` / `IMovingRenderer`;`renderer.ts` 仍是移动图块集合;`vertex.ts` 仍是 `alphaMap` + `overlayStatic`;`rendererGate.test.ts` 仍断言旧符号)。`git status --porcelain -uall -- packages-user/client-base/src/map` 为 assumptions 记录的 12 条;`node_modules` 内 vitest / eslint / vue-tsc / prettier 均存在,`node` v24.21.0。
+ 无(本任务只读,不写任何文件;汇报后停下等待「可以执行」)
+
+ - .planning/phases/09-minimum-browser-runnable/09-CONTEXT.md(D-01 增量派发、D-03 汇报关卡、D-04 命名批准、D-06 范围界定)
+ - packages-user/client-base/src/map/types.ts(`IBlockStatus` / `IOverlayBlock` / `IOverlayStaticBlock` / `IRenderBlockMover` / `IMapRenderer` / `IMapVertexGenerator` / `IMapDataGetter`)
+ - packages-user/client-base/src/map/status.ts(`StaticBlockStatus` / `DynamicBlockStatus` / `OverlayBlock` / `StaticOverlayBlock` 的现状与缺失成员)
+ - packages-user/client-base/src/map/moving.ts(`MovingBlock` 的五个方法与依赖字段)
+ - packages-user/client-base/src/map/renderer.ts(移动集合 / 索引池 / `addMovingBlock` / `tick` / 覆盖层绘制)
+ - packages-user/client-base/src/map/vertex.ts(`alphaMap` / `flushPendingAlpha` / `overlayStatic` / `sortOverlay` / `assembleOverlay` / `getIndexInBlock`)
+ - packages-user/client-base/src/map/chunk.ts 与 viewport.ts(只读:确认 `elX` / `elY` 与动态尾部合并保持不变)
+ - packages-user/client-base/src/map/__test__/rendererGate.test.ts(现状断言与辅助函数)
+ - AGENTS.md(执行前须获批、命名先反馈、既有注释不得修改、疑似问题须先确认)、dev.md(类先接口后 `implements`、`!` / `isNil`、不用 `?.`、不把函数赋给临时变量、`//` 注释规范、CRLF)
+
+
+ 一份待批准的执行计划(`09-51-PLAN.md`):把地图渲染收敛到「静态层 + 唯一的 `OverlayBlock` 覆盖层」,静态 alpha < 1 自动提升、覆盖层 alpha 1 不降级、`toStatic` 写回静态格,并删除静态 / 动态 / 移动三套历史抽象;不改变渲染管线。
+
+
+ **停下并向用户汇报,等待其恰好回复「可以执行」后才继续;本任务不写任何文件、不改任何源码 / 测试 / 计划,不派发执行子代理。**
+
+ ① **要做什么 / 为什么:** 当前工作树是半迁移状态(见 precondition)。用户裁定地图渲染**只有两层**:静态层(图块 / 分块)与覆盖层(唯一的 `OverlayBlock` 集合)。`DynamicBlockStatus` / `StaticOverlayBlock` / `IOverlayStaticBlock` / `IMovingBlock` / `IMovingRenderer` / `MovingBlock` 都属于要删除的历史抽象;静态层半透明图块改为**自动提升**到覆盖层绘制,覆盖层图块 alpha 回到 1 **不自动降级**;移动算法只作为未来 `IRenderBlockMover` 的注释参考,本阶段不创建、不驱动 mover。
+
+ ② **精确形态(逐符号,具体类、非接口、非抽象):**
+ - `types.ts`:`IOverlayBlock` 保留 `layer` / `priority` / `x` / `y` / `texture` / `renderer` / `setPos` / `setTexture` / `useDefaultFrame` / `destroy`,**新增** `readonly index: number`(覆盖层实例数组索引)与 `toStatic(layer: IMapLayer, x: number, y: number): void`,并**显式重声明** `setAlpha(alpha: number): void`(说明覆盖层设为 1 不降级);删除 `IOverlayStaticBlock`;`IRenderBlockMover` 原样保留、无人实现;`IMapRenderer` 保留五个覆盖层方法,新增 `createOverlayBlock(layer, priority, texture, tile): IOverlayBlock`(只分配索引、实例化并登记,不写实例数据);`IMapVertexGenerator` 新增 `toStatic(block, layer, x, y): void`(低层写回助手)。(`IMapDataGetter` 声明在 `vertex.ts`,其 `hasMoving` 在 `vertex.ts` 中删除,不在本文件。)
+ - `status.ts`:只保留 `StaticBlockStatus`(逐字不动)与唯一的 `export class OverlayBlock implements IOverlayBlock`:成员 `readonly layer` / `readonly priority` / `readonly index` / `readonly renderer` / `texture` / `readonly tile` / `x = 0` / `y = 0`;方法 `setPos` / `setTexture` / `setAlpha` / `getAlpha` / `useGlobalFrame` / `useSpecifiedFrame` / `getFrame` / `useDefaultFrame` / `destroy` / `toStatic`;alpha 与帧数一律走 `renderer.vertex` 的 `setDynamicAlpha` / `setDynamicFrame` / `getDynamicAlpha` / `getDynamicFrame`;`destroy` 调 `renderer.deleteOverlayBlock(this)`,`toStatic` 调 `renderer.vertex.toStatic(this, layer, x, y)`;`useDefaultFrame` 用 `manager.getTile(this.tile)` + `getDefaultFrame`。**删除** `DynamicBlockStatus` 与 `StaticOverlayBlock`。
+ - `moving.ts`:删除 `import` / `IMovingRenderer` / `MovingBlock` 的可执行声明,整个原文件逐行加 `// ` 变成注释(保留五个移动方法与 `startTime` / `line` / `relative` / `targetX` / `targetY` / `dx` / `dy` / `time` / `timing` / `curve` / `startX` / `startY` / `end` / `posUpdated` / `promiseFunc`);文件头加数行 `//` 说明「mover 创建 / 驱动不在本阶段范围,移动算法在此保留供未来 `IRenderBlockMover` 实现参考」。
+ - `renderer.ts`:私有面改为 `overlayBlocks: Set` / `overlayIndexMap` / `overlayIndexPool` / `overlayCount`;`expandMoving` / `reduceMoving` / `requireMovingIndex` / `returnMovingIndex` 改名为 `expandOverlay` / `reduceOverlay` / `requireOverlayIndex` / `returnOverlayIndex`,**逻辑逐字保留**(只改标识符);公开面为五个覆盖层方法(`addOverlayBlock` 的 priority 为 1)与 `createOverlayBlock`;删除 `addMovingBlock` / `deleteMoving` / `hasMoving`、`IMovingRenderer` 与 `MovingBlock` 引入,`implements` 只保留 `IMapRenderer, IMapDataGetter`;`tick` 保留背景帧 / 地图帧 / tickers / 池缩减,**删除 `stepMoving` 与 `updateOverlayList` 调用**。
+ - `vertex.ts`:`overlayOrdered: IOverlayBlock[]`;`sortOverlay()` 直接取 `this.renderer.getOverlayBlocks()` 并排序 `getLayerIndex(a.layer) - getLayerIndex(b.layer) || a.y - b.y || a.x - b.x || a.priority - b.priority`;`assembleOverlay()` 对每个块按 `block.index * INSTANCED_COUNT` 从 `dynamicInstancedArray` 拷贝 16 个浮点;新增提升表 `promotedBlocks: Map>` 与 `getPromotedBlock` / `setPromotedBlock` / `deletePromotedBlock` / `deletePromotedBlockByValue`;新增 `promoteStaticBlock` / `writeStaticAlpha` 与公开 `toStatic`;`setStaticAlpha` 按 ③ 实现;`getStaticAlpha` / `setStaticFrame` / `getStaticFrame` 优先读提升表;`updateOverlay` / `updateOverlayList` / `deleteOverlay` 按 `block.index`;删除 `alphaMap` / `flushPendingAlpha` / `overlayStatic` / `IOverlayStaticRecord` / `StaticOverlayBlock` / `MovingBlock` 与全部静态-动态 `instanceof` 分支。
+ ③ **提升与不降级语义(逐条):** 未提升格:`alpha < 1` → `promoteStaticBlock`(`createOverlayBlock(layer, 0, tile, num)`,`block.setPos(x, y)`,把静态实例 16 浮点整体拷入 `dynamicInstancedArray` 的 `block.index * INSTANCED_COUNT`,覆盖第 10 个浮点为 alpha,把静态实例前 4 个矩形浮点清零,标脏分块,登记提升表,置 `dynamicRenderDirty` / `overlayOrderDirty` / `overlayValueDirty`,`requestUpdate`);`alpha >= 1` → `writeStaticAlpha` 只写静态实例第 10 个浮点并标脏。已提升格:无论 alpha 是否等于 1,都只调用 `promoted.setAlpha(alpha)` 写覆盖层槽位——**不删除覆盖块、不恢复静态矩形、没有自动降级**。空格(`manager.getTile(num)` 为 `null`)不提升。静态格之后被 `updateBlock` / `updateArea` / 自动元件邻居更新改动时,按更新掩码把变化的浮点同步到提升槽位(矩形与 z / 纹理 / 帧数各自同步,**不动 alpha**),覆盖层显示新图块、不残留旧数据;静态格被改成空图块时删除提升块并释放槽位。
+ ④ **`toStatic` 语义(逐条):** `OverlayBlock.toStatic` → `renderer.vertex.toStatic(this, layer, x, y)`;后者用 `getIndexInBlock(layer, x, y)` 定位目标静态实例,越界返回;把覆盖层槽位 16 浮点整体写入目标静态实例;前 4 个矩形浮点按 `dx = (x - block.x) * cellWidth / renderWidth * 2`、`dy = (y - block.y) * cellHeight / renderHeight * 2` 平移(横坐标加 dx、纵坐标减 dy);第 9 个浮点(z)按静态公式 `-layerStart - blockZ` 重算(`layerStart = (layerIndex / layerCount) * 1.8 - 0.9`、`perBlockZ = 1 / mapHeight / layerCount`、`blockZ = y * perBlockZ`);标脏目标分块;最后 `renderer.deleteOverlayBlock(block)` 释放索引、清空槽位并移除提升登记。**external owns map data**:不修改图块数字、不调用 `updateBlock`。
+ ⑤ **逐文件符号清单:** `types.ts`(IOverlayBlock 增 index / toStatic / setAlpha;删 IOverlayStaticBlock;IMapRenderer 增 createOverlayBlock;IMapVertexGenerator 增 toStatic;三处 jsDoc);`status.ts`(唯一 OverlayBlock;删 DynamicBlockStatus / StaticOverlayBlock;StaticBlockStatus 不动);`moving.ts`(全注释);`renderer.ts`(覆盖层集合 / 映射 / 池 + 五个公开方法 + createOverlayBlock;删移动面;tick 去步进);`vertex.ts`(`IMapDataGetter` 删 hasMoving;单表排序 / 组装 + 提升表 / 提升 / 写静态 alpha / 帧数转发 / 低层 toStatic;删 alphaMap / flush / overlayStatic / 分支);`rendererGate.test.ts`(全量改写,见⑨)。
+ ⑥ **明确不改动的部分:** `StaticBlockStatus` 整段(含 `setAlpha` 参数顺序);`updateTileVertex` 的纹理 / 帧数 / 自动元件计算;`getTilePosition`;`updateAutotile`;`updateArea` / `updateBlock` / `updateBlockList` / `updateBlockCache` 的懒更新;分块张量 `[chunk][layer][tile]` 与 `mallocVertexArray`;`expandOverlay` / `reduceOverlay` 的既有逻辑(仅改标识符);`renderer.render()` 的两遍式、`depthMask`、`blendFuncSeparate`、FBO / 深度附件 / ping-pong / postEffect、覆盖层缓冲上传与绘制;`viewport.ts` 的动态尾部合并;`chunk.ts`;`shader/map.frag` 的 `0.004`;`element.ts`;`index.ts`;`constant.ts`;`extension/*`;其它包与配置。
+ ⑦ **无浏览器验证主张:** 本计划只保证源码形状、编译与静态闸门通过;**不做浏览器 UAT、不宣称任何 WebGL E2E**(游戏当前不可运行),提升 / 不降级 / `toStatic` 的视觉效果未验证。
+ ⑧ **范围外类型错误(必须报备,不修):** `extension/hero.ts` 引用 `IMapRendererTicker` / `IMovingBlock` / `addMovingBlock` / `requestTicker` / `@user/data-state.state`;`extension/door.ts` 引用 `addMovingBlock`;`element.ts` 引用 `IMapRenderer.tick`。类型闸门只判 `types.ts` / `status.ts` / `moving.ts` / `vertex.ts` / `renderer.ts`,并只豁免 `renderer.ts` 的 `IMapRendererTicker` 与 `getLayerByAlias` 两条既有诊断(打印原文),其余任何诊断失败。
+ ⑨ **测试改动清单:** 删除全部旧符号断言(`IMovingBlock` 继承、`MovingBlock`、`DynamicBlockStatus`、`StaticOverlayBlock`、`OverlayBlockKind`、`pendingAlpha` / `alphaMap` / `flushPendingAlpha` / `overlayStatic`);新增:`IOverlayBlock` 含 `readonly index` / `toStatic` / 无 `IOverlayStaticBlock` / `IRenderBlockMover` 保留;`IMapRenderer` 含五个覆盖层方法与 `createOverlayBlock`;`status.ts` 只有唯一 `OverlayBlock implements IOverlayBlock`、`StaticBlockStatus` 保留、无旧类、alpha 走 `setDynamicAlpha`、`toStatic` 与 `destroy` 的委托目标;`moving.ts` 去掉 `//` 行后为空且仍含五个方法名;`renderer.ts` 含集合 / 映射 / 池与五个公开方法 + `createOverlayBlock`、无移动公开面、`tick` 无 `stepMoving` / `updateOverlayList`;`vertex.ts` 排序键、组装按索引、提升 `alpha < 1`、已提升分支无删除、`toStatic` 的 z / 位置重算与释放、无 `alphaMap` / `flushPendingAlpha` / `overlayStatic` / `instanceof`;保留渲染管线 / 后处理 / 深度附件 / 配对 / 裁剪 / 分块布局 / 动态尾部合并 / `map.frag` 阈值等既有守护,并把 `x - block.dataX` 修正为 `x - block.elX`(`chunk.ts` 已使用 `elX` / `elY`)。每个 `it` 前一行 `//` 注释。
+ ⑩ **范围:** 只写 7 个路径——`types.ts` / `status.ts` / `moving.ts` / `vertex.ts` / `renderer.ts` / `__test__/rendererGate.test.ts` / `09-51-SUMMARY.md`。其余文件零改动,哈希闸门覆盖 `chunk.ts` / `viewport.ts` / `shader/map.frag` / `extension/hero.ts` / `extension/door.ts` / `extension/text.ts` / `index.ts` / `element.ts` / `constant.ts`。
+ ⑪ **编号说明(必须报备):** 派发方给出的编号是 09-51 / 波次 31;仓库中 `09-01`..`09-50` 的计划与摘要均已提交并占用编号(`09-16` 无摘要属既有缺失,与本次无关)。本计划使用 09-51 / 波次 31,不删除、不覆盖任何既有记录。
+ ⑫ **两条铁律 + 类型基线 + 注释现状:** **不做浏览器 UAT、不宣称任何 WebGL E2E**;**不提交任何代码**(禁止 `git add` / `commit` / `stash` / `checkout` / `restore` / `worktree` / `reset`)。类型闸门只判 5 个计划文件,精确豁免 `renderer.ts` 的 `IMapRendererTicker`(`types.ts` 从未导出)与 `IMapRenderer` / `IGameMap` 的 `getLayerByAlias` 两条既有诊断并打印原文;`extension/*` / `element.ts` 报错按用户要求保留。**除 `IBlockStatus.setAlpha`、`IOverlayBlock.setAlpha`、`IOverlayBlock.toStatic` 三处 jsDoc 外,不改任何既有注释**:`sortOverlay` 的 `kind` 措辞、`assembleOverlay` 的静态矩形描述、`expandOverlay` / `reduceOverlay` 的「移动图块」措辞、`status.ts` 的分区标题均保留(OI-3);**测试文件例外**:`it` 说明注释随范围同步改写。
+ ⑬ **已知限制:** 提升表与覆盖层集合是两套结构,`deleteOverlay` 用一次线性扫描清理提升登记;`toStatic` 忠实拷贝 alpha(若仍 < 1,调用方需自行再提升或先置 1);重建 / 分块尺寸变化只清空提升表,渲染器中的覆盖块集合保持不变(既有边界);`reduceOverlay` 与 `getDynamicAlpha` / `getDynamicFrame` 的既有边界形态**原样保留、不修**;估算未校准(`confidence: low`)。
+
+ 用户恰好回复「可以执行」四个字;在此之前不执行 Task 1 / Task 2 的任何一步,也不派发执行子代理。
+ 已完整汇报 ①–⑬(含逐文件符号、精确类形态、提升 / 不降级语义、`toStatic` 语义、明确不改清单、待批准命名、范围外错误、测试改动清单、编号说明、两条铁律、注释现状、已知限制),并停下等待用户回复「可以执行」。
+
+ 逐条核对 ①–⑬ 是否与你的意图一致,特别是:② 的接口新增与两个新增公开名;③ 的提升与「alpha 1 不降级」;④ 的 `toStatic` 写回与释放顺序;⑤ 的逐文件符号;⑥ 的「明确不改」清单;⑨ 的测试改动;⑫ 的类型豁免与注释现状;⑪ 的编号说明。
+
+ 仅当完全同意时回复恰好四个字「可以执行」;任何修改意见(尤其是 ② 的新增公开名、③ 的提升优先级与不降级、④ 的 alpha 忠实拷贝、⑫ 的类型豁免口径、⑪ 的编号)请直接说明,本计划会据此改写后再来一次汇报。
+
+
+
+ Task 1: 收敛为静态层 + 唯一 OverlayBlock 覆盖层(types.ts / status.ts / moving.ts / vertex.ts / renderer.ts)
+ packages-user/client-base/src/map/types.ts, packages-user/client-base/src/map/status.ts, packages-user/client-base/src/map/moving.ts, packages-user/client-base/src/map/vertex.ts, packages-user/client-base/src/map/renderer.ts
+
+ 仅在收到用户恰好回复「可以执行」之后执行。开始改代码前先采集两份基线(PowerShell 5.1 可直接执行,输出 UTF-8 无 BOM):① 范围基线 `node -e "const{execSync}=require('child_process'),fs=require('fs');const raw=execSync('git status --porcelain -uall -- packages-user/client-base/src/map',{encoding:'utf8'});const lines=raw.split(/\r?\n/).filter(l=>l.length>0).sort();const p=(process.env.TEMP||'.')+'/gsd-09-51-status.txt';fs.writeFileSync(p,lines.join('\n')+'\n','utf8');console.log(p);console.log(lines.join('\n'))"`;② 哈希基线 `node -e "const{execSync}=require('child_process'),fs=require('fs');const dir='packages-user/client-base/src/map';const files=['chunk.ts','viewport.ts','shader/map.frag','extension/hero.ts','extension/door.ts','extension/text.ts','index.ts','element.ts','constant.ts'];const lines=files.map(f=>f+' '+execSync('git hash-object '+dir+'/'+f,{encoding:'utf8'}).trim());const p=(process.env.TEMP||'.')+'/gsd-09-51-hashes.txt';fs.writeFileSync(p,lines.join('\n')+'\n','utf8');console.log(p);console.log(lines.join('\n'))"`。任一命令非 0 退出或文件缺失必须停下上报;不得跳过任一闸门。
+
+ 1. `types.ts`:给 `IBlockStatus.setAlpha` 的既有 jsDoc 增补一句:静态图块设置小于 1 的不透明度会自动提升为覆盖层图块;覆盖层图块设置为 1 不会降级回静态层(只改这一处 jsDoc)。`IOverlayBlock` 保留全部既有成员,新增成员 `readonly index: number`(成员 jsDoc 说明是覆盖层实例数组索引)与 `toStatic(layer: IMapLayer, x: number, y: number): void`(换行风格 jsDoc:把覆盖层实例数据写回目标静态图块、重算静态纵坐标与位置、删除当前覆盖层图块并释放索引,图块数据由调用方维护),并显式重声明 `setAlpha(alpha: number): void`(换行风格 jsDoc:覆盖层图块设置为 1 时仍留在覆盖层,不会自动降级)。删除整个 `export interface IOverlayStaticBlock extends IOverlayBlock { ... }`。`IRenderBlockMover` 及其 `bind` / `lineTo` / `moveAs` / `moveRelative` / `endMoving` 逐字保留。`IMapRenderer` 保留五个覆盖层方法与既有 jsDoc,新增 `createOverlayBlock(layer: IMapLayer, priority: number, texture: IMaterialFramedData, tile: number): IOverlayBlock`(jsDoc:分配覆盖层索引、创建并登记覆盖层图块,不写实例数据;`tile` 为 -1 表示不是由图块数字创建)。`IMapVertexGenerator` 保留 `updateOverlay` / `updateOverlayList` / `deleteOverlay` 的既有形参名(`moving` / `moving`)与既有 `@param` jsDoc,**不得改名、不得改这些 jsDoc**(内部实现里的参数名不属于公开契约,保持现状),并新增 `toStatic(block: IOverlayBlock, layer: IMapLayer, x: number, y: number): void`(jsDoc:低层写回助手,把覆盖层槽位写入目标静态实例、重算 z 与位置并释放覆盖块)。`IMapDataGetter` 声明在 `vertex.ts` 而非本文件,故本文件不处理 `hasMoving`。其余声明与注释逐字不动。
+
+ 2. `status.ts`:`./types` 的引入改为 `IBlockStatus` / `IMapRenderer` / `IMapVertexStatus` / `IOverlayBlock`(不再引入 `IOverlayStaticBlock`,普通引入,禁止 `import type`)。`StaticBlockStatus` 整段逐字不动。删除 `DynamicBlockStatus` 与 `StaticOverlayBlock` 两个类的全部代码;最终文件只保留 `//#region 图块状态` 下的 `StaticBlockStatus`、`//#endregion`、`//#region 覆盖层图块` 下的 `OverlayBlock`、`//#endregion`(分区标题是既有注释,逐字保留)。`OverlayBlock` 写成 `export class OverlayBlock implements IOverlayBlock`,成员按序声明并显式标注类型:`readonly layer: IMapLayer;`、`readonly priority: number;`、`readonly index: number;`、`readonly renderer: IMapRenderer;`、`texture: IMaterialFramedData;`、`readonly tile: number;`、`x: number = 0;`、`y: number = 0;`;构造器 `(layer: IMapLayer, priority: number, index: number, texture: IMaterialFramedData, tile: number, renderer: IMapRenderer)` 逐项赋值,不写构造器注释。方法实现:`setPos(x, y)` 写 `this.x` / `this.y` 后调用 `this.renderer.vertex.updateOverlay(this, false)`(既有 `// TODO: 通知更新` 单行注释**原样保留**,按 AGENTS.md 不得删改,记入 OI-5);`setTexture(texture)` 相同引用直接 return,否则赋值并 `updateOverlay(this, true)`;`setAlpha(alpha)` 调 `this.renderer.vertex.setDynamicAlpha(this.index, alpha)`;`getAlpha()` 调 `getDynamicAlpha(this.index)`;`useDefaultFrame()` 在 `manager.getTile(this.tile)` 为空时 return,否则取 `getDefaultFrame(this.tile)` 并 `useSpecifiedFrame`;`useGlobalFrame()` 调 `setDynamicFrame(this.index, -1)`;`useSpecifiedFrame(frame)` 调 `setDynamicFrame(this.index, frame)`;`getFrame()` 调 `getDynamicFrame(this.index)`;`destroy()` 调 `this.renderer.deleteOverlayBlock(this)`;`toStatic(layer, x, y)` 调 `this.renderer.vertex.toStatic(this, layer, x, y)`。
+
+ 3. `moving.ts`:把原文件内容逐行改为 `// ` 前缀的单行注释(保留原有缩进与代码文本,`//` 后留一个空格),不得使用 `/* */` 多行注释;文件顶部另加数行 `//` 说明「本阶段只保留静态层与覆盖层,mover 的创建与驱动不在范围内,以下移动算法原样保留,供未来 `IRenderBlockMover` 实现参考」。最终文件没有任何可执行的 `import` / `export` / 类声明;`lineTo` / `moveAs` / `moveRelative` / `endMoving` / `stepMoving` 与 `startTime` / `line` / `relative` / `targetX` / `targetY` / `dx` / `dy` / `time` / `timing` / `curve` / `startX` / `startY` / `end` / `posUpdated` / `promiseFunc` 均以注释形式保留。
+
+ 4. `renderer.ts`:删除 `IMovingBlock` 引入与 `import { IMovingRenderer, MovingBlock } from './moving';`;在 `./types` 的引入列表中**补上 `IOverlayBlock`**(新字段 `overlayBlocks: Set` 与 `overlayIndexMap` 都要用它,现有引入没有它);`implements` 改为 `IMapRenderer, IMapDataGetter`。把 `movingBlock: Set` 改为 `overlayBlocks: Set`,`movingIndexMap` 改为 `overlayIndexMap: Map`,`movingIndexPool` 改为 `overlayIndexPool: number[]`,`movingCount` 改为 `overlayCount: number`;构造器里 `overlayIndexPool.push(...)` 的初始化逐字保留(仅改标识符)。把 `expandMoving` / `reduceMoving` / `requireMovingIndex` / `returnMovingIndex` 改名为 `expandOverlay` / `reduceOverlay` / `requireOverlayIndex` / `returnOverlayIndex`,**函数体逻辑与遍历对象逐字保留**(`reduceOverlay` 仍检查成员 `index >= half` 后 return,不新增池大小同步)。删除 `addMovingBlock` / `deleteMoving` / `hasMoving`。新增 `createOverlayBlock(layer, priority, texture, tile)`:`const index = this.requireOverlayIndex(); const block = new OverlayBlock(layer, priority, index, texture, tile, this); this.overlayBlocks.add(block); this.overlayIndexMap.set(index, block); return block;`。改写 `addOverlayBlock(layer, block, x, y)`:数字分支 `texture = this.manager.getTile(block)!; tile = block;`,素材分支保留既有 `assetContainsTexture` / `getOffsetIndex` 两条 `logger.error` 检查并 `texture = block; tile = -1;`,随后 `const overlay = this.createOverlayBlock(layer, 1, texture, tile); overlay.setPos(x, y); this.vertex.updateOverlay(overlay, true); this.requestUpdate(); return overlay;`。`getOverlayBlocks()` 返回 `this.overlayBlocks`;`getOverlayBlockByIndex(index)` 返回 `this.overlayIndexMap.get(index) ?? null`;`deleteOverlayBlock(block)` 在集合不含该块时 return,否则 `returnOverlayIndex(block.index)`、从集合与映射删除、`this.vertex.deleteOverlay(block)`、`this.requestUpdate()`;`deleteOverlayBlockByIndex(index)` 先取块、不存在则 return、存在则转调 `deleteOverlayBlock`。`tick(timestamp)` 保留时间戳、池缩减、背景帧、地图帧、`tickers.forEach`,**删除整段移动步进代码**(不得调用 `stepMoving` / `updateOverlayList`)。`./status` 的 `OverlayBlock` 引入保留;`MovingBlock` 不再出现。
+
+ 5. `vertex.ts`:删除 `IMovingBlock` 引入、`import { MovingBlock } from './moving';`、`import { StaticOverlayBlock } from './status';`;`IOverlayBlock` 引入保留。`IMapDataGetter` 删除 `hasMoving`。删除私有 `interface IOverlayStaticRecord { ... }`、模块级常量 `OVERLAY_ALPHA_THRESHOLD`、模块级函数 `isOverlayAlpha`、`alphaMap`、`overlayStatic`、`getOverlayStaticRecord` / `deleteOverlayStaticRecord` / `flushPendingAlpha` 全部代码(`alpha < 1` 直接写在 `setStaticAlpha` 里,不再保留阈值常量)。新增 `private readonly promotedBlocks: Map> = new Map();` 与四个私有方法(均带换行风格 jsDoc):`getPromotedBlock(layer, mapIndex)`、`setPromotedBlock(layer, mapIndex, block)`(用 `getOrInsertComputed`)、`deletePromotedBlock(layer, mapIndex)`(内层清空后删除外层)、`deletePromotedBlockByValue(block)`(遍历两层映射,按引用相等找到并删除、返回)。`setBlockSize` 与 `checkRebuild` 中把 `this.overlayStatic.clear();` / `this.alphaMap.clear();` 换成 `this.promotedBlocks.clear();`(其余清空与脏标记语句保留)。`setStaticAlpha` 改写为:算 `mapIndex`;取 `getPromotedBlock`,存在则 `promoted.setAlpha(alpha)` 并 return;否则 `alpha < 1` 走 `this.promoteStaticBlock(layer, x, y, mapIndex, alpha)`、`alpha >= 1` 走 `this.writeStaticAlpha(layer, x, y, alpha)`。新增 `private writeStaticAlpha(layer, x, y, alpha)`:`getIndexInBlock` 为空 return,写 `index.array[index.index * INSTANCED_COUNT + 9] = alpha`,`index.block.data.markRenderDirty()`。新增 `private promoteStaticBlock(layer, x, y, mapIndex, alpha)`:`getIndexInBlock` 为空 return;`const num = layer.getMapRef().array[mapIndex]; const tile = this.renderer.manager.getTile(num);` 为空 return;`const block = this.renderer.createOverlayBlock(layer, 0, tile, num); block.setPos(x, y);`;把静态实例 16 浮点 `this.dynamicInstancedArray.set(index.array.subarray(source, source + INSTANCED_COUNT), target)`(`source` / `target` 分别为静态实例索引与 `block.index` 乘 `INSTANCED_COUNT`);覆盖 `this.dynamicInstancedArray[target + 9] = alpha`;把 `index.array[source]` 到 `source + 3` 四个矩形浮点清零;`index.block.data.markRenderDirty()`;`this.setPromotedBlock(layer, mapIndex, block)`;置 `this.dynamicRenderDirty = true; this.overlayOrderDirty = true; this.overlayValueDirty = true;`;`this.renderer.requestUpdate()`。`getStaticAlpha` 先查提升表(存在则返回 `this.getDynamicAlpha(promoted.index)`),再读静态实例第 10 个浮点。`setStaticFrame` / `getStaticFrame` 同样先查提升表(存在则转调 `setDynamicFrame` / `getDynamicFrame`),否则读写静态实例第 13 个浮点并 `markRenderDirty`。`sortOverlay` 改为 `const ordered = [...this.renderer.getOverlayBlocks()];`,比较器为 `getLayerIndex(a.layer) - getLayerIndex(b.layer) || a.y - b.y || a.x - b.x || a.priority - b.priority`,结尾三句保留;不得出现 `StaticOverlayBlock` / `MovingBlock` / `instanceof`。`assembleOverlay` 改为对每个块只做一次 16 浮点拷贝(`block.index * INSTANCED_COUNT` → `offset`),删除静态分支、`record` 与矩形覆盖;`overlayCount` / 两个脏标记复位保留。`updateOverlay(block, updateTexture)` 的成员检查改为 `if (!this.renderer.getOverlayBlocks().has(block)) return;`,其余(`block.layer` / `block.texture` / `block.x` / `block.y` / `block.index`、自动元件分支、`updateTileVertex` 的 `dynamic = true`)保留;传给 `updateTileVertex` 的 `num` 参数写 `-1`(覆盖层路径不会读默认帧)。`updateTileVertex` 的静态分支先按 `update` 掩码正常写入静态实例(删除 `getOverlayStaticRecord` 的提前隐藏分支),在三个掩码块**全部写完之后**统一处理提升:`if (!dynamic)` 时用 `getPromotedBlock(index.layer, index.mapY * this.mapWidth + index.mapX)` 查提升块,命中则按**同一掩码**把变化同步到 `promoted.index * INSTANCED_COUNT` 的覆盖层槽位——`VertexUpdate.Position` 时同步索引 0–3(矩形)与索引 8(z),随后把 `instancedArray[startIndex]` 到 `startIndex + 3` 清零隐藏;`VertexUpdate.Texture` 时同步索引 4–7 与 13–15;`VertexUpdate.Frame` 时同步索引 12;**不得整块拷贝 16 个浮点,也不得覆盖索引 9(alpha)**,否则纹理 / 帧更新会把已清零的矩形或覆盖层 alpha 写坏;每次命中都 `index.block.data.markRenderDirty()` 并置 `overlayValueDirty = true` / `dynamicRenderDirty = true`。`updateVertexArray` 的空图块分支只保留矩形清零,并在 `!dynamic` 时用 `getPromotedBlock(index.layer, index.mapIndex)` 查提升块,命中则调用 `this.renderer.deleteOverlayBlock(promoted)`(清空槽位、移除提升登记、释放索引),避免源图块变空后覆盖层继续显示旧图块。`deleteOverlay(block)` 保留两个脏标记与 `dynamicInstancedArray.set(MapVertexGenerator.EMPTY_VETREX, block.index * INSTANCED_COUNT)`,新增 `this.deletePromotedBlockByValue(block)`,并置 `this.dynamicRenderDirty = true`。`getVertexArray` 删除 `flushPendingAlpha()` 调用(保留 `checkRebuild()` 与返回结构);`isOverlayDirty` 改为 `return this.overlayOrderDirty || this.overlayValueDirty;`;`getOverlayArray` 改为先 `if (this.overlayOrderDirty) this.sortOverlay();` 再 `if (this.overlayValueDirty || this.overlayOrderDirty) this.assembleOverlay();` 后返回。新增公开 `toStatic(block, layer, x, y)`:`getIndexInBlock` 为空 return;按④的公式拷贝 16 浮点、平移前 4 个矩形浮点、重算第 9 个浮点(z)、`index.block.data.markRenderDirty()`、`this.renderer.deleteOverlayBlock(block)`。其余方法(`setBlockSize` / `resizeMap` / `expandOverlay` / `reduceOverlay` / `updateLayerArray` / `getIndexInBlock` / `getTilePosition` / `updateAutotile` / `checkAutotileConnectionAround` / `updateVertexArray` / `updateBlockVertex` / `updateArea` / `updateBlock` / `updateBlockList` / `updateBlockCache` / `renderDynamic`)保持逻辑与既有注释不变。
+
+ 6. **不得改动** `StaticBlockStatus`、`chunk.ts`、`viewport.ts`、`renderer.render()` 的绘制与后处理、`shader/map.frag`、`element.ts`、`index.ts`、`constant.ts`、`extension/*`;除三处 jsDoc 外不得改任何既有注释;不得新增 `import type`;不得新增依赖;代码文件保持 CRLF,必要时可对 5 个源码文件运行 `node node_modules/prettier/bin/prettier.cjs --write`(仅排版)。
+
+
+ node -e "const fs=require('fs');const r=f=>fs.readFileSync('packages-user/client-base/src/map/'+f,'utf8');const t=r('types.ts'),s=r('status.ts'),m=r('moving.ts'),v=r('vertex.ts'),rd=r('renderer.ts');const live=x=>x.split(/\r?\n/).filter(l=>l.trim().length>0&&!l.trim().startsWith('//')).join('\n');const body=(x,sig)=>{const i=x.indexOf(sig);if(i<0)return '';const j=x.indexOf('\n }',i);return j<0?x.slice(i):x.slice(i,j);};const vSort=body(v,'private sortOverlay('),vAsm=body(v,'private assembleOverlay('),vSet=body(v,'setStaticAlpha('),vPro=body(v,'private promoteStaticBlock('),vTo=body(v,'toStatic('),vGet=body(v,'getStaticAlpha('),vWrite=body(v,'private writeStaticAlpha('),vTile=body(v,'private updateTileVertex('),vEmpty=body(v,'private updateVertexArray('),vDel=body(v,'deleteOverlay('),rTick=body(rd,'\n tick(timestamp');const checks=[[/readonly index: number;/.test(t)&&/toStatic\(/.test(t),'IOverlayBlock index/toStatic'],[!/IOverlayStaticBlock/.test(t),'no IOverlayStaticBlock'],[/export interface IRenderBlockMover/.test(t),'mover kept'],[/createOverlayBlock\(/.test(t)&&/addOverlayBlock\(/.test(t),'renderer overlay factory'],[/export class OverlayBlock implements IOverlayBlock/.test(s),'single OverlayBlock'],[/readonly index: number;/.test(s)&&/readonly tile: number;/.test(s),'overlay fields'],[/(setDynamicAlpha\(|setDynamicFrame\()/.test(s),'overlay slots'],[!/DynamicBlockStatus/.test(s)&&!/StaticOverlayBlock/.test(s),'no legacy classes'],[/export class StaticBlockStatus/.test(s),'StaticBlockStatus kept'],[live(m).trim()===''&&/lineTo\(/.test(m)&&/moveAs\(/.test(m)&&/moveRelative\(/.test(m)&&/endMoving\(/.test(m)&&/stepMoving\(/.test(m),'moving comments only'],[/overlayOrdered: IOverlayBlock\[\]/.test(v),'overlayOrdered interface array'],[vSort.indexOf('getOverlayBlocks()')>-1&&vSort.indexOf('a.priority - b.priority')>-1&&vSort.indexOf('a.y - b.y')>-1&&vSort.indexOf('a.x - b.x')>-1,'sort keys'],[/block.index \* INSTANCED_COUNT/.test(vAsm)&&!/instanceof/.test(vAsm),'assemble by slot'],[/alpha < 1/.test(vSet)&&/alpha >= 1/.test(vSet)&&/promoteStaticBlock\(/.test(vSet)&&/getPromotedBlock\(/.test(vSet)&&/writeStaticAlpha\(/.test(vSet),'promotion branch'],[/createOverlayBlock\(/.test(vPro)&&/setPromotedBlock\(/.test(vPro),'promote body'],[/layerStart/.test(vTo)&&/perBlockZ/.test(vTo)&&/cellWidth/.test(vTo)&&/renderWidth/.test(vTo)&&/deleteOverlayBlock\(/.test(vTo),'toStatic body'],[!/pendingAlpha|flushPendingAlpha|alphaMap|overlayStatic/.test(v),'lazy alpha removed'],[/getPromotedBlock\(/.test(vGet)&&/getDynamicAlpha\(/.test(vGet),'getStaticAlpha reads promotion'],[/INSTANCED_COUNT/.test(vWrite)&&/markRenderDirty\(/.test(vWrite),'static alpha write'],[/getPromotedBlock\(/.test(vTile)&&/dynamicInstancedArray\[/.test(vTile)&&/instancedArray\[startIndex\] = 0/.test(vTile)&&/VertexUpdate.Texture/.test(vTile),'promoted cell refresh'],[/getPromotedBlock\(/.test(vEmpty)&&/deleteOverlayBlock\(/.test(vEmpty),'empty tile drops promotion'],[/overlayOrderDirty = true/.test(vDel)&&/overlayValueDirty = true/.test(vDel),'deleteOverlay dirty flags'],[/overlayBlocks: Set/.test(rd)&&/overlayIndexMap/.test(rd)&&/overlayIndexPool/.test(rd),'overlay pool'],[/(addOverlayBlock\(|getOverlayBlocks\(|getOverlayBlockByIndex\(|deleteOverlayBlock\(|deleteOverlayBlockByIndex\()/.test(rd)&&/createOverlayBlock\(/.test(rd),'overlay api'],[/IMovingRenderer|MovingBlock|IMovingBlock|addMovingBlock|deleteMoving|hasMoving/.test(rd)===false,'no moving surface'],[/stepMoving|updateOverlayList/.test(rTick)===false,'tick no moving step']];let bad=0;checks.forEach(c=>{if(!c[0]){bad++;console.log('FAIL:',c[1]);}});console.log('checks',checks.length,'failed',bad);process.exit(bad===0?0:1)"
+ 任一形状检查为假(例如 `IOverlayStaticBlock` 残留、`OverlayBlock` 非唯一实现、`moving.ts` 仍有可执行导出、排序仍用 `kind`、组装仍有 `instanceof`、`setStaticAlpha` 缺 `alpha < 1` 提升分支、已提升分支被误写成有删除、`toStatic` 缺 z 重算、`renderer.ts` 仍含移动公开面、`tick` 仍调用 `stepMoving`),退出码非 0。
+ node -e "const fs=require('fs');const files=['types.ts','status.ts','moving.ts','vertex.ts','renderer.ts'];let ok=true;for(const f of files){const s=fs.readFileSync('packages-user/client-base/src/map/'+f,'utf8');const lf=(s.match(/\n/g)||[]).length;const crlf=(s.match(/\r\n/g)||[]).length;if(lf!==crlf){ok=false;console.log('LF-only lines in',f,lf,crlf);}}process.exit(ok?0:1)"
+ 任一源码文件不是全 CRLF(存在仅 LF 的换行),退出码非 0。
+
+ 5 个源码文件迁移完成:`types.ts` 只有单覆盖层契约(`index` / `toStatic` / 重声明 `setAlpha` / 无 `IOverlayStaticBlock` / 保留 `IRenderBlockMover` / `createOverlayBlock` 与低层 `toStatic`);`status.ts` 只有 `StaticBlockStatus` 与唯一 `OverlayBlock`;`moving.ts` 无可执行导出且五个方法以注释保留;`renderer.ts` 用覆盖层集合 / 映射 / 池与六个覆盖层方法,无移动公开面,`tick` 无步进;`vertex.ts` 删除 `IMapDataGetter.hasMoving`、单表排序 / 组装、提升 / 不降级 / `toStatic`,静态格更新时刷新提升槽位、空格时删除提升块,无 `alphaMap` / `flushPendingAlpha` / `overlayStatic` / 静态-动态分支;范围与哈希基线已写入 `%TEMP%` 的两个文件;其余文件零改动;5 个源码文件全 CRLF。
+
+
+
+ Task 2: 重写闸门测试、跑五类门禁并写 SUMMARY
+ packages-user/client-base/src/map/__test__/rendererGate.test.ts, .planning/phases/09-minimum-browser-runnable/09-51-SUMMARY.md
+
+ 1. `rendererGate.test.ts`:**必须删除或改写**下列既有用例,因为它们断言的是已删除符号或旧实现:`stores overlay keys as numeric nested maps`(`alphaMap` / `overlayStatic` 的嵌套 Map 类型)、`clears overlay members when the arrays are rebuilt`(`overlayStatic.clear()` / `alphaMap.clear()`)、`takes moving members live and dirties both flags on deletion`(`getMovingBlock()` / `deleteMoving`)、`keeps the moving block index identity`(`movingIndexMap` / `IMovingBlock`)、`removes the private draw entry and uses the overlay block interface`(`IOverlayDrawEntry` / `OverlayBlockKind` 与 `./moving` / `./status` 引入断言);同时删除全部旧符号断言(`IMovingBlock` 继承、`MovingBlock`、`DynamicBlockStatus`、`StaticOverlayBlock`、`OverlayBlockKind`、`pendingAlpha` / `alphaMap` / `flushPendingAlpha` / `overlayStatic`)。保留 `getMethodBody` 与 `getColorAttachments` 两个辅助,新增 `getUncommented(source)`(按行过滤 `//` 开头与空行,返回剩余内容,用于 `moving.ts`)。保留既有 `?raw` 引入并保持连续、不插注释与空行。**保留**全部渲染管线守护用例(两遍式深度掩码、`blendFuncSeparate`、深度附件与销毁、帧缓冲与颜色纹理配对、最后一个后处理上屏、第一个效果读 ping、覆盖层独立缓冲、动态尾部裁剪、覆盖层绘制注释数量、分块布局不被排序、动态尾部合并、`map.frag` 的 `0.004`、拒绝 OIT / 半精度深度),把 `locates instances with data coordinates inside a chunk` 的断言由 `x - block.dataX` / `y - block.dataY` 改为 `x - block.elX` / `y - block.elY`(`chunk.ts` 已使用 `elX` / `elY`),删除 `getMovingBlock()` / `getMovingBlockByIndex(` 一类的旧断言。**新增或改写**下列用例(每个 `it` 前一行中文 `//` 注释):
+ - `declares a single overlay block contract`:`typesSource` 的 `IOverlayBlock` 片段含 `readonly layer: IMapLayer;` / `readonly priority: number;` / `x: number;` / `y: number;` / `readonly index: number;` / `toStatic(` / `setAlpha(` / `readonly texture: IMaterialFramedData;` / `readonly renderer: IMapRenderer;`;整份 `typesSource` 不含 `IOverlayStaticBlock` / `OverlayBlockKind` / `kind`。
+ - `keeps the mover interface without an implementation`:`typesSource` 含 `export interface IRenderBlockMover`;`getUncommented(movingSource).trim()` 为空。
+ - `declares the renderer overlay api`:`typesSource` 分别含 `addOverlayBlock(` / `getOverlayBlocks(` / `getOverlayBlockByIndex(` / `deleteOverlayBlock(` / `deleteOverlayBlockByIndex(` / `createOverlayBlock(`;不含 `addMovingBlock` / `deleteMoving` / `hasMoving`。
+ - `declares one concrete overlay block`:`statusSource` 分别含 `export class OverlayBlock` / `implements IOverlayBlock` / `readonly index: number;` / `readonly tile: number;` / `readonly renderer: IMapRenderer;` / `readonly priority: number;` / `x: number = 0;` / `y: number = 0;`;整份 `statusSource` 不含 `DynamicBlockStatus` / `StaticOverlayBlock` / `IOverlayStaticBlock`。
+ - `routes overlay state through the dynamic slot api`:`OverlayBlock` 片段含 `setDynamicAlpha(` / `setDynamicFrame(` / `getDynamicAlpha(` / `getDynamicFrame(`,不含 `setStaticAlpha(` / `setStaticFrame(`。
+ - `delegates destroy and toStatic to the renderer`:`OverlayBlock` 片段含 `deleteOverlayBlock(this)` 与 `vertex.toStatic(this`。
+ - `keeps the static block status`:`statusSource` 含 `export class StaticBlockStatus` 与 `implements IBlockStatus`。
+ - `keeps the moving algorithm as comments only`:`getUncommented(movingSource).trim()` 为空;`movingSource` 分别含 `lineTo(` / `moveAs(` / `moveRelative(` / `endMoving(` / `stepMoving(`。
+ - `manages overlays through a set map and pool`:`rendererSource` 含 `overlayBlocks: Set` / `overlayIndexMap` / `overlayIndexPool` / `requireOverlayIndex(` / `returnOverlayIndex(`。
+ - `creates overlay blocks through one factory`:`rendererSource` 含 `createOverlayBlock(`;`addOverlayBlock` 方法体含 `createOverlayBlock(` 与 `updateOverlay(overlay, true)`。
+ - `removes the moving renderer surface`:`rendererSource` 不含 `IMovingRenderer` / `MovingBlock` / `IMovingBlock` / `addMovingBlock` / `deleteMoving` / `hasMoving`。
+ - `keeps the tick free of moving steps`:`tick(` 方法体含 `tickers.forEach` 与 `backgroundFrame`,不含 `stepMoving` / `updateOverlayList` / `movingBlock`。
+ - `sorts overlays by layer y x and priority`:`private sortOverlay(` 方法体含 `getOverlayBlocks()` / `getLayerIndex(a.layer)` / `getLayerIndex(b.layer)` / `a.y - b.y` / `a.x - b.x` / `a.priority - b.priority` / `overlayValueDirty = true`;不含 `StaticOverlayBlock` / `instanceof`。
+ - `assembles every overlay from its slot`:`private assembleOverlay(` 方法体含 `block.index * INSTANCED_COUNT` / `dynamicInstancedArray` / `overlayCount`;不含 `instanceof` / `rectX`。
+ - `promotes static blocks below full alpha`:`setStaticAlpha(` 方法体含 `alpha < 1` / `promoteStaticBlock(` / `getPromotedBlock(` / `writeStaticAlpha(`;`private promoteStaticBlock(` 方法体含 `createOverlayBlock(` / `subarray(` / `INSTANCED_COUNT` / `setPromotedBlock(` / `markRenderDirty(`;整份 `vertexSource` 不含 `alphaMap` / `flushPendingAlpha` / `pendingAlpha` / `overlayStatic`。
+ - `reads promoted alpha from the overlay slot`:`getStaticAlpha(` 方法体含 `getPromotedBlock(` / `getDynamicAlpha(`;`setStaticAlpha(` 方法体含 `alpha >= 1` 与 `writeStaticAlpha(`;`private writeStaticAlpha(` 方法体含 `INSTANCED_COUNT` / `markRenderDirty(`。
+ - `refreshes promoted slots and drops empty cells`:`private updateTileVertex(` 方法体含 `getPromotedBlock(` / `dynamicInstancedArray[` / `instancedArray[startIndex] = 0` / `VertexUpdate.Texture` / `VertexUpdate.Frame`;`private updateVertexArray(` 方法体含 `getPromotedBlock(` / `deleteOverlayBlock(`。
+ - `never demotes promoted overlays`:`setStaticAlpha(` 方法体含 `getPromotedBlock(` 与 `.setAlpha(`,不含 `deletePromotedBlock` / `deleteOverlayBlock` / `promotedBlocks.clear`。
+ - `writes overlay data back to a static cell`:`toStatic(` 方法体含 `getIndexInBlock(` / `INSTANCED_COUNT` / `layerStart` / `perBlockZ` / `cellWidth` / `renderWidth` / `markRenderDirty(` / `deleteOverlayBlock(`。
+ - `keeps both dirty flags when deleting an overlay`:`deleteOverlay(` 方法体含 `overlayOrderDirty = true` 与 `overlayValueDirty = true`。
+ - `forwards frames through the promotion table`:`setStaticFrame(` 与 `getStaticFrame(` 方法体都含 `getPromotedBlock(` 与 `DynamicFrame(`。
+ - `documents every new private overlay method`:`getPromotedBlock` / `setPromotedBlock` / `deletePromotedBlock` / `deletePromotedBlockByValue` / `promoteStaticBlock` / `writeStaticAlpha` / `sortOverlay` / `assembleOverlay` 的签名前 400 字符内含 `/**`。
+ - `takes the overlay array in sort then assemble order`:`getOverlayArray(` 方法体先 `sortOverlay(` 后 `assembleOverlay(`,且不含 `flushPendingAlpha`。
+ - `covers order and value in the overlay dirty flag`:`isOverlayDirty(` 方法体含 `overlayOrderDirty` 与 `overlayValueDirty`,不含 `alphaMap`。
+ - `references no removed overlay symbols`:`typesSource` / `statusSource` / `vertexSource` / `rendererSource` 均不含 `DynamicBlockStatus` / `StaticOverlayBlock` / `IOverlayStaticBlock` / `IMovingBlock` / `IMovingRenderer` / `MovingBlock` / `pendingAlpha` / `flushPendingAlpha` / `alphaMap` / `overlayStatic`。
+ **所有源码形状断言使用拆分 `toContain` 或空白容忍正则,禁止整串单行比对**(`export class OverlayBlock implements IOverlayBlock {` 短于 80 列可整串,但 `createOverlayBlock(...)` 等长签名一律用方法名片段)。断言只基于 `?raw` 字符串,不导入运行期模块。测试文件注释按 dev.md 随范围同步改写。
+ 2. 依次运行五类门禁并记录真实输出(命令见 ``):vitest 全部用例通过(条数以实际运行为准,如实写入 SUMMARY,不得删用例凑数);eslint 6 个文件 0 error / 0 warning(若只报 prettier 格式,可对 6 个文件运行 `node node_modules/prettier/bin/prettier.cjs --write` 后重跑,仅排版);类型闸门按 5 个计划文件判定(先确认 `vue-tsc` 真正完成,否则按 `INCOMPLETE` 失败,不允许空 `scoped` 空过),`types.ts` / `status.ts` / `moving.ts` / `vertex.ts` 必须 0 条,`renderer.ts` 只允许 `IMapRendererTicker` 与 `getLayerByAlias` 两类既有诊断并打印原文,其它任何诊断失败;范围闸门与 Task 1 采集的 `git status` 集合逐条相等(**命令中不得出现 `.trim()`**);哈希闸门读取 `%TEMP%/gsd-09-51-hashes.txt`(恰好 9 行,UTF-8 无 BOM,每行「相对 `map/` 的路径 + 空格 + 哈希」),按首个空格切分后用同一相对路径重算并逐字相等。任何一项失败:停下并如实报告,不得放宽断言、不得扩大豁免、不得改配置、不得删用例。
+ 3. 写 `09-51-SUMMARY.md`:逐文件说明前后形态与新增 / 删除符号(含 `DynamicBlockStatus` / `StaticOverlayBlock` / `IOverlayStaticBlock` / `IMovingBlock` / `IMovingRenderer` / `MovingBlock` 被整体移除);写明提升 / 不降级 / `toStatic` 的最终语义,以及「静态格更新时刷新提升槽位、静态格变空时删除提升块」的生命周期;列出「未改动清单」(渲染管线、后处理、分块张量、`viewport.ts`、`chunk.ts`、`shader/map.frag`、`element.ts`、`index.ts`、`constant.ts`、`extension/*`);记录五类门禁的真实数字与豁免原文;记录实际用例条数;声明**不做浏览器 UAT、无 WebGL E2E**、估算未校准(`confidence: low`)、**0 次代码提交**、未更新 `STATE.md` / `ROADMAP.md`;记录计划编号 09-51 / 波次 31 的原因(09-27..09-50 已占用);记录 OI-1 的最终命名、OI-2 的语义边界、OI-3 的旧注释未改、OI-4 的范围外错误保留、OI-5 的 `setPos` TODO 注释保留;记录类型闸门含完成性守卫(`r.error` / `r.signal` / `status===null` / 非 0 退出且无输出均判失败)。SUMMARY 使用 LF,CRLF 要求只针对代码文件。
+
+
+ node node_modules/vitest/vitest.mjs run packages-user/client-base/src/map/__test__/rendererGate.test.ts
+ 任一用例失败(例如单类断言为假、旧符号断言残留、提升分支缺失、`toStatic` 断言缺失、`tick` 仍含步进),退出码非 0。
+ node node_modules/eslint/bin/eslint.js packages-user/client-base/src/map/types.ts packages-user/client-base/src/map/status.ts packages-user/client-base/src/map/moving.ts packages-user/client-base/src/map/vertex.ts packages-user/client-base/src/map/renderer.ts packages-user/client-base/src/map/__test__/rendererGate.test.ts
+ 任一 error / warning(含 prettier 格式),退出码非 0。
+ node -e "const{spawnSync}=require('child_process');const r=spawnSync(process.execPath,['node_modules/vue-tsc/bin/vue-tsc.js','--noEmit'],{encoding:'utf8',maxBuffer:1024*1024*512});const out=(r.stdout||'')+(r.stderr||'');const done=!r.error&&r.status!==null&&!r.signal&&(r.status===0||(out.trim().length>0&&out.includes('error TS')));if(!done){console.log('INCOMPLETE',String(r.error),r.status,r.signal,out.length);process.exit(1);}const scope=/(packages-user[\\/]client-base[\\/]src[\\/]map[\\/](types|status|moving|vertex|renderer)\.ts)\((\d+),(\d+)\): error (TS\d+): (.*)/;const rows=[];out.split(/\r?\n/).forEach(line=>{const m=scope.exec(line);if(m)rows.push({file:m[1].replace(/\\/g,'/'),code:m[5],msg:m[6]});});const allowed=row=>{if(row.file.endsWith('/renderer.ts')&&/IMapRendererTicker/.test(row.msg))return true;if(row.file.endsWith('/renderer.ts')&&row.code==='TS2339'&&/getLayerByAlias/.test(row.msg))return true;return false;};const forbidden=/(IMovingBlock|MovingBlock|IMovingRenderer|IOverlayStaticBlock|StaticOverlayBlock|DynamicBlockStatus|hasMoving|addMovingBlock|deleteMoving|pendingAlpha|alphaMap|overlayStatic)/;const bad=rows.filter(row=>!allowed(row));const forbiddenRows=rows.filter(row=>forbidden.test(row.msg));console.log('status',r.status,'scoped',rows.length,'allowed',rows.length-bad.length,'unexpected',bad.length,'forbidden',forbiddenRows.length);rows.forEach(row=>console.log((allowed(row)?'ALLOWED':'UNEXPECTED')+': '+row.file+' '+row.code+' '+row.msg));process.exit(bad.length===0&&forbiddenRows.length===0?0:1)"
+ `vue-tsc` 未能真正完成——`r.error` 非空、`r.signal` 非空、`r.status===null`,或非 0 退出但输出为空 / 不含任何 `error TS` 诊断行——打印 `INCOMPLETE` 并失败,绝不允许 `scoped=[]` 空过;`types.ts` / `status.ts` / `moving.ts` / `vertex.ts` 出现任何诊断,或 `renderer.ts` 出现 `IMapRendererTicker` / `getLayerByAlias` 之外的诊断(含已被删除的旧符号),退出码非 0;`extension/*` / `element.ts` 由过滤排除,不参与判定。
+ node -e "const{execSync}=require('child_process'),fs=require('fs');const p=(process.env.TEMP||'.')+'/gsd-09-51-status.txt';const want=fs.readFileSync(p,'utf8').split(/\r?\n/).filter(l=>l.length>0).sort();const raw=execSync('git status --porcelain -uall -- packages-user/client-base/src/map',{encoding:'utf8'});const got=raw.split(/\r?\n/).filter(l=>l.length>0).sort();const ok=want.length===got.length&&want.every((w,i)=>w===got[i]);console.log('want',want.length,'got',got.length);if(!ok)console.log('GOT:\n'+got.join('\n'));process.exit(ok?0:1)"
+ `map/` 下出现基线之外的变更(新增 / 删除 / 改名文件),或某条既有状态消失,退出码非 0。该命令**刻意不对输出做 `.trim()`**(`git status --porcelain` 的 ` M` 行以一个空格开头),不得改回。
+ node -e "const{execSync}=require('child_process'),fs=require('fs');const p=(process.env.TEMP||'.')+'/gsd-09-51-hashes.txt';const lines=fs.readFileSync(p,'utf8').split(/\r?\n/).filter(l=>l.length>0);let ok=lines.length===9;const out=lines.map(l=>{const i=l.indexOf(' ');if(i<1){ok=false;return l;}const f=l.slice(0,i);const v=f+' '+execSync('git hash-object packages-user/client-base/src/map/'+f,{encoding:'utf8'}).trim();if(v!==l)ok=false;return v;});console.log(out.join('\n'));process.exit(ok?0:1)"
+ 采集文件不是恰好 9 行、某行首个空格前为空、相对路径不在 `map/` 下,或 9 个范围外文件的哈希与 Task 1 采集值不一致(说明被本计划越界改动),退出码非 0。
+ node -e "const fs=require('fs');const files=['types.ts','status.ts','moving.ts','vertex.ts','renderer.ts','__test__/rendererGate.test.ts'];let ok=true;for(const f of files){const s=fs.readFileSync('packages-user/client-base/src/map/'+f,'utf8');const lf=(s.match(/\n/g)||[]).length;const crlf=(s.match(/\r\n/g)||[]).length;if(lf!==crlf){ok=false;console.log('LF-only lines in',f,lf,crlf);}}process.exit(ok?0:1)"
+ 任一代码 / 测试文件不是全 CRLF,退出码非 0。
+
+ 闸门测试全部用例通过;eslint 6 个文件 0 报错;类型闸门 `types.ts` / `status.ts` / `moving.ts` / `vertex.ts` 0 条、`renderer.ts` 仅 `IMapRendererTicker` 与 `getLayerByAlias` 两条豁免且打印原文(完成性守卫生效);范围闸门与 Task 1 基线逐条相等;哈希闸门 9 个范围外文件逐字相等;6 个代码 / 测试文件全 CRLF;`09-51-SUMMARY.md` 写完并包含逐文件前后形态、删除符号、未改动清单、门禁真实结果与豁免原文、实际用例数、无 UAT / 无 WebGL E2E、估算未校准、0 次提交、编号说明与四条 OI。
+
+
+
+
+
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| 静态实例数组 ↔ 覆盖层槽位 | 提升把静态实例的 16 个浮点拷入覆盖层槽位并清零静态矩形;拷贝 / 清零顺序错会让图块消失或双重混合 |
+| 提升表 ↔ 渲染器覆盖层集合 | 提升块必须同时登记在 `promotedBlocks` 与渲染器集合 / 索引映射中;只登记一处会让排序、组装或 alpha 读取失效 |
+| `IOverlayBlock.index` ↔ 索引池 | 索引由渲染器池分配并回收;重复或越界索引会覆盖其它覆盖块的槽位 |
+| `toStatic` ↔ 释放顺序 | 必须先写入静态实例再调用 `deleteOverlayBlock`;反序会把 `EMPTY_VETREX` 写进静态格 |
+| 覆盖层 alpha ↔ 不降级 | `alpha === 1` 时留在覆盖层;任何自动降级都会让图块进入静态层的错误混合路径 |
+| 类型契约 ↔ 实现 | `IOverlayBlock` / `IMapRenderer` / `IMapVertexGenerator` 是契约;类改接口或漏实现会让 `vue-tsc` 失败并让运行期 `instanceof` / 方法查找失效 |
+| 范围外文件 ↔ 工作树 | `extension/*` / `element.ts` / `chunk.ts` / `viewport.ts` / `shader/*` 不得被本计划改动,哈希闸门证明 |
+| 依赖安装 | 本计划不新增依赖、不执行安装命令(`pnpm` 在本树不可用) |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
+|-----------|----------|-----------|----------|-------------|-----------------|
+| T-09-51-01 | Tampering | `promoteStaticBlock` 的拷贝 / 清零顺序 | high | mitigate | Task 1 形状闸门断言 `subarray(` / `INSTANCED_COUNT` / 静态矩形清零;Task 2 断言提升分支与 `alpha < 1`,且 `updateTileVertex` 的隐藏判定改用 `getPromotedBlock` |
+| T-09-51-02 | Tampering | 覆盖块索引冲突或未登记 | high | mitigate | 统一走 `requireOverlayIndex` / `createOverlayBlock` / `overlayIndexMap`;删除走 `returnOverlayIndex` + 双结构删除;Task 2 断言集合 / 映射 / 池与五个公开方法 |
+| T-09-51-03 | Tampering | 覆盖层 alpha 1 被误降级 | high | mitigate | `setStaticAlpha` 已提升分支只调 `promoted.setAlpha`;Task 2 断言该分支不含 `deletePromotedBlock` / `deleteOverlayBlock` / `promotedBlocks.clear` |
+| T-09-51-04 | Tampering | `toStatic` 在释放后写入 / 缺 z 重算 | high | mitigate | Task 2 断言 `toStatic(` 含 `getIndexInBlock(` / `layerStart` / `perBlockZ` / `markRenderDirty(` / `deleteOverlayBlock(`;Task 1 闸门同查 |
+| T-09-51-05 | Tampering | `moving.ts` 仍参与编译或 `renderer.ts` 仍保留移动公开面 | high | mitigate | Task 1 过滤 `//` 后断言 `moving.ts` 无可执行内容;Task 2 断言 `renderer.ts` 不含 `IMovingRenderer` / `MovingBlock` / `IMovingBlock` / `addMovingBlock` / `deleteMoving` / `hasMoving` |
+| T-09-51-06 | Tampering | 借「迁移」之名改动渲染管线 / 分块 / 视口 / 着色器 | high | mitigate | 逐条禁止清单 + 9 文件哈希闸门 + 范围闸门(与 Task 1 基线逐条相等) |
+| T-09-51-07 | Repudiation | 闸门恒红却写成「已通过」 | high | mitigate | vitest 全绿、eslint 0、类型闸门完成性守卫、范围 / 哈希 / CRLF 闸门均给真实输出;SUMMARY 记录实际用例数与豁免原文 |
+| T-09-51-08 | Elevation of Privilege | 为让类型检查变绿而改 `tsconfig` / 依赖 / 加 `@ts-expect-error` / 扩大豁免 | high | mitigate | 禁止改配置与依赖;类型闸门只允许 `renderer.ts` 两条既有诊断并打印原文,`types.ts` / `status.ts` / `moving.ts` / `vertex.ts` 必须 0;遇到新诊断必须停下上报 |
+| T-09-51-09 | Repudiation | 声称「渲染已验证」但未做浏览器 UAT | medium | mitigate | Task 0 报备 + SUMMARY 明确「不做浏览器 UAT、无 WebGL E2E、源码闸门通过不等于渲染结果已验证」 |
+| T-09-51-10 | Tampering | `moving.ts` 注释化后仍残留旧符号字符串,被误判为可执行 | medium | mitigate | 测试用 `getUncommented()` 过滤 `//` 行;Task 1 闸门同样用 `live()` 投影后再判断 |
+| T-09-51-SC | Tampering | npm / pnpm 安装 | high | mitigate | 本计划不新增任何依赖、不执行安装命令、不改 workspace / `package.json`;门禁只用 `node_modules` 里既有的直连二进制;若执行期出现安装需求必须停下上报 |
+
+
+
+- 源码形状闸门(vitest `?raw`):全部用例通过,含单类覆盖层、`index` / `toStatic` / 重声明 `setAlpha`、提升与不降级、`toStatic` 写回、覆盖层集合 / 映射 / 池、`tick` 无步进、`moving.ts` 无可执行导出,以及两遍式 / 混合 / 深度附件 / 配对 / 效果链路 / 裁剪 / 分块布局 / 动态尾部合并 / `map.frag` 阈值等保留性断言。
+- `eslint`:6 个文件 0 error / 0 warning。
+- 类型闸门:仅 `types.ts` / `status.ts` / `moving.ts` / `vertex.ts` / `renderer.ts`;先验证 `vue-tsc` 真正跑完,再判定 `types.ts` / `status.ts` / `moving.ts` / `vertex.ts` 0 条、`renderer.ts` 仅 `IMapRendererTicker` 与 `getLayerByAlias` 两条既有豁免并打印原文。
+- 范围闸门:`map/` 变更集与 Task 1 基线逐条相等(命令不含 `.trim()`)。
+- 哈希闸门:9 个范围外文件与 Task 1 采集值逐字相等。
+- CRLF 闸门:6 个代码 / 测试文件全 CRLF。
+- 明确不覆盖:任何浏览器 / WebGL 运行期行为(无 E2E、无 UAT)。
+
+
+
+- `OverlayBlock` 是 `status.ts` 中唯一的覆盖层具体类(`implements IOverlayBlock`),`DynamicBlockStatus` / `StaticOverlayBlock` 已删除,`StaticBlockStatus` 原样保留。
+- `types.ts` 的 `IOverlayBlock` 含 `readonly index` / `toStatic` / 重声明 `setAlpha`;`IOverlayStaticBlock` 已删除;`IRenderBlockMover` 保留未实现;`IMapRenderer` / `IMapVertexGenerator` 有两个新增方法。`vertex.ts` 的 `IMapDataGetter.hasMoving` 删除。
+- `moving.ts` 无可执行导出且五个移动方法以注释保留;`renderer.ts` 用覆盖层集合 / 映射 / 池与六个覆盖层方法,`tick` 不步进,无移动公开面。
+- `vertex.ts` 单表排序 / 组装、提升 / 不降级 / `toStatic`,静态格更新时刷新提升槽位、变空时删除提升块,无 `alphaMap` / `flushPendingAlpha` / `overlayStatic` / 静态-动态分支。
+- 渲染管线、分块张量、`viewport.ts`、`chunk.ts`、`shader/map.frag`、`element.ts`、`index.ts`、`constant.ts`、`extension/*` 零改动。
+- 五类门禁全部通过;SUMMARY 如实记录结果、实际用例数、豁免原文与未验证项;0 次代码提交。
+
+
+
\ No newline at end of file