# 84附件A · S31旧模块处置矩阵与重构复用策略

核查日期：2026-10-31，北京时间。只读基线：`/vol1/ai/projects/little-town/交付-S31-验收收口-20261029/工程`。表内路径相对该基线；符号与行号可在冻结文件定位。新接管者是**拟建职责/接口**，不是已实现模块。

[R] REBUILD＝新版重新建立权威；[A] ADAPT＝保留价值但替换接口/空间依赖；[K] KEEP＝优先复用并回归；[X] RETIRE＝退出新版运行权威，保留冻结历史。混合标记按“复用/替换”列执行，不能扩张成整文件强制重写或整目录直接搬迁。

**源码核实后的修正**：

- 当前主业务链是`web/main.ts`/`wechat/main.ts`→`app/app.ts`→`game/session.ts`→`core/engine.ts`→`rates.ts`/`actions.ts`/`timeflow.ts`。`core/index.ts`再导出旧land/queue/savev3，新入口不能整桶照搬。
- `economy.ts`、`offline.ts`、`visit.ts`、`upgrade.ts`是0.1契约实现，经`fingerprints.ts`被应用引用，但不是当前Session的主结算/奖励实现。它们仍在旧校验链中，不能简单说“未使用”；也不能作为当前业务整套KEEP。
- `CoreEngine.commit`先改内存再尽力写档；`Session.view`固定`saveOk:true`。这与新版持久事务要求冲突，必须替换提交协议及UI状态传播，不以“旧版已验收”为理由照搬。
- `island-shape.outlineOf`明确只取最大环并填洞；`earClip`输入单环。旧轮廓/封底不能证明新内洞能力；噪声、法向、资源工具可有条件复用。
- `city/city-contract.buildCity`同时装配默认规划、地面和交通。复用资产门面时必须剥离其默认规划权威；`buildUnitFor`目前为内部函数，接入方应明确公开适配接口，不能假定已有独立公开API。
- `camera.ts`及`ui/drawer.ts`本身未直接导入六角模块，不应因城市重构而整份重写。全局视觉设置也不等于按单栋身份持久化皮肤。

**策略及判定边界**：先建立稳定身份、RoadState、支撑掩膜、版本检查点及业务端口，再把成熟算法接到新接口。需要重做K模块时，先用源码说明适配失败原因，并列出原能力回归，不按修改行数评价。旧业务测试保留有效断言；旧六角/v3断言列为历史参考并给新版替代，不能删失败seed冒充绿。代码改动比例只属未验证量级预测，不是配额或验收项。

| 旧源码路径／函数职责锚点 | 当前核心职责 | 标记 | 旧依赖 | 新版接管者（拟建） | 具体复用内容 | 必须替换内容 | 阶段 | 验收依据 |
|---|---|---|---|---|---|---|---|---|---|
| `src/core/land.ts`<br>ringOf:L24；candidates:L67；tileIndex:L34 | 白名单、圈数、候选、父关系 | [R][X] | q/r、六邻接、85/78上限 | ParcelRegistry / UnlockGraph | 候选输入校验意图 | 所有旧空间权威；不得坐标转换包裹续用 | P0/P1/P2 | 可配规模；分叉/内洞/填洞候选；无旧ring/parent调用 |
| `src/core/queue.ts`<br>mulberry32:L8；typeQueue:L66；typeAt:L70 | 种子流及旧类别队列 | [K][R][X] | 78长度默认、旧购地序列 | SeedStreams / DefaultCategoryPlan | [K]mulberry32；经版本锁定的种子派生 | [X]旧固定队列作为新购地身份/类别权威 | P0/P1 | 同种子可复现；装饰变更不扰规划；不依赖78队列 |
| `src/core/config.ts`<br>priceCoins:L24；LandConfig:L7 | 旧地价和配置类型 | [A][R][X] | qDistance、旧价格基表 | EconomicConfigPort / WorldProfile | 版本化配置、字段校验思路 | 旧六角区位/地价字段；GPT-6新配置缺失显式失败 | P0/P2 | 配置缺失拒绝报价；新报价不读qDistance |
| `src/core/state.ts`<br>CoreState:L5；newGame:L43；isValidNow:L59 | 核心状态、新游戏和时间校验 | [R][A][K][X] | 旧land行及生成版本 | CityState / WorldManifest | [K]合法时间校验；[A]业务计数及初始化 | 旧地块行与v3生成契约；不新增Parcel独立U | P0/P2 | 状态schema校验；三类共享U；旧状态不可误载 |
| `src/core/actions.ts`<br>quoteTile:L57；buyTile:L74；hasCandidates:L243 | 旧土地报价、购买、候选 | [R][A][X] | q/r、MAX_LAND、队列与旧父关系 | LandQuoteService / PurchaseCommand | 余额/预期报价检查及失败原因的业务意图 | 空间身份和新交易协议；批量买地逐笔/整批语义需明示 | P0/P2 | 实际点击买地；过期/重复提交；不越权；旧地不移动 |
| `src/core/actions.ts`<br>upgradeBlock:L157；blockCount:L150 | 类别共享升级 | [A][R][X] | costBlockUpgrade含N、旧land类别列 | SharedUpgradeCommand | 共享升级状态、无同类地块时拒绝 | 旧价格乘N；改用GPT-6整数表及版本配置 | P2 | 费用表逐项对照供表；改N报价不变；零地块拒绝 |
| `src/core/actions.ts`<br>upgradeLine:L101；openBuilding:L134；upgradeDistrict:L123 | 四核心业务开业、等级/设施/宣传、区级业务 | [K][A] | CoreState与旧Config类型 | CoreBusinessCommands | 有效业务门槛、奖励/扣费语义、线别检查 | 新状态接口与统一持久化提交；不复制旧坏提交策略 | P2 | 旧业务迁移逐项回归；锁定/缺钱/满级/确认流程 |
| `src/core/actions.ts`<br>spawnResident:L189；applyTap:L218；maxPromo:L208 | 业务居民生成、寻访和宣传影响 | [K][A] | 核心居民状态、宣传、分数声望 | VisitService / ResidentRegistry | 当前applyTap奖励/饱和/宣传及声望余数规则 | 居民可拾取位置接口；奖励事务去重 | P2/P3 | 寻访/卡片/宣传回归；断路不重发或漏发奖励 |
| `src/core/rates.ts`<br>costLevel:L48；costFacility:L50；costPromo:L52；costDistrict:L54；costOpen:L56 | 当前核心建筑费用 | [K][A] | CoreState/LandConfig类型；文件另有land导入 | CorePricing / EconomicConfigPort | 成熟整数费用算法，业务规则未经批准不变 | 从混合文件隔离非空间函数；不把整个rates原样带入旧依赖闭包 | P0/P2 | 相同合法旧业务输入对照；整数边界；不复做经济平衡 |
| `src/core/rates.ts`<br>costBlockUpgrade:L59；landFraction:L96；landMilli:L110；totalMilli:L115 | 旧类别费用与土地/全城产速接线 | [R][A][X] | 费用乘N、ringOf区位 | SharedUpgradeQuote / RateProvider | 核心产速与土地汇总的接口分层思路 | 旧N乘数、ring区位；新系数只接GPT-6配置 | P2 | 供表/供样例工程验证；道路/皮肤不影响收益 |
| `src/core/rates.ts`<br>settle:L143；coreMilli:L83；buildingMilli:L73 | 当前在线结算与核心业务产速 | [K][A] | CoreState；totalMilli含旧土地依赖 | SettlementService / RateProvider | 整数/余数/时间护栏及成熟核心业务算法 | 替换状态类型和产速供应器；不保留旧空间传递依赖 | P0/P2 | 结算切段一致、回拨/溢出/余数回归；跨事务先结旧收益 |
| `src/core/timeflow.ts`<br>previewOffline:L19；foregroundState:L37；backgroundState:L47 | 当前离线预览及前后台状态转换 | [K][A] | rates及旧CoreState | LifecycleSettlement | 当前时间护栏与离线结算语义 | 新检查点时间锚/单次提交协议 | P0/P2/P4 | 前后台/重启不重复结算；时间回拨与失败恢复 |
| `src/core/ints.ts`<br>ceilDiv:L16；mulDivFloor:L27；isIntIn:L44 | 整数计算及数值校验 | [K] | bigx；无地图依赖 | MoneyMath | 现有精度算法及校验 | 只在真实输入/单位要求变化时适配，不重写 | P0/P2 | 现有有效精度用例回归；金币/毫币单位接口明确 |
| `src/core/bigx.ts`<br>bigPow:L157 | 可移植大整数辅助 | [K] | 无六角身份 | MoneyMath | 现有大整数实现 | bigPow只接受旧整数幂语义，不拿它直接算新版分数指数 | P0/P2 | 整数工具回归；新升级直接使用权威表 |
| `src/core/cards.ts`<br>hash32:L10；residentCard:L36 | 确定性居民角色卡 | [K][A] | citySeed、稳定居民序号 | ResidentRegistry / CardService | 词表、分通道hash及卡片生成 | 稳定业务ID映射；不能用交通实例替代业务居民 | P2 | 相同业务身份卡片稳定；道路/换肤不改变卡片 |
| `src/core/economy.ts`<br>createInitialState:L13 | 0.1结算实现与指纹参考；不是当前主结算 | [X][K] | contract旧GameSession；旧常量 | rates/新SettlementService接管 | 仅经对照确认的通用计算片段 | 不作为当前经济整套迁入，不替代当前rates.settle | P0/P2 | 主业务调用追踪；历史指纹参考单列，不冒充新经济验收 |
| `src/core/offline.ts`<br>enterBackground:L11 | 0.1离线实现与指纹参考 | [X][K] | economy.ts旧状态 | timeflow/新LifecycleSettlement接管 | 时间分段思想可参考 | 不误接为新版当前离线权威 | P0/P2 | 前后台实际入口指向新服务；保留历史证据 |
| `src/core/visit.ts`<br>createVisitState:L8；isResidentTag:L12 | 0.1固定寻访与指纹参考 | [X][K] | 旧固定奖励/声望常量 | actions.applyTap业务适配 | 精确tag校验等可抽取 | 不能覆盖当前maxPromo与声望余数业务 | P0/P2 | 按当前奖励样本回归而非只过旧固定奖励指纹 |
| `src/core/upgrade.ts`<br>upgradeCostCoins:L14 | 0.1市政升级与指纹参考 | [X][K] | 旧economy、旧契约 | 当前核心升级业务适配 | 纯参数/校验思路仅供参考 | 不以旧常量替换当前四核心规则 | P0/P2 | 开业/各升级线对照当前Session入口 |
| `src/core/savev3.ts`<br>parseSave:L92；migrateToV3:L74；encodeSave:L177；futureSignal:L192 | v3解析/迁移/编码及未知版本识别 | [R][X][A] | 旧land索引、候选与队列重放 | CitySaveCodec | 严格字段校验、未知版本保护思路 | v3主格式、旧迁移/坐标序列及旧键；不删除旧档 | P0/P2/P4 | 新命名空间；损坏/未知schema；旧键未改 |
| `src/core/load.ts`<br>StoragePort:L14；safeRead:L43；loadGame:L50 | 存储端口与旧档加载 | [R][K][A][X] | savev3及旧迁移 | CheckpointRepository | [K/A]端口、读异常与无档区分 | [X]旧迁移权威；[R]双槽、确认/未知结果恢复 | P0/P2/P4 | 读失败不当新游戏；双槽损坏/读回失败/未知提交 |
| `src/core/engine.ts`<br>CoreEngine:L56；persist:L83；commit:L107；foreground:L96 | 当前事件调度、结算与保存 | [A][R][X] | CoreState/v3；普通动作内存先变且写失败不回滚 | CommandCoordinator / CheckpointRepository | 事件串行、时间检查、先结算后动作意图 | [X]普通动作尽力写档即继续的成功语义；[R]持久提交权威、opId与恢复状态 | P0/P2/P4 | 故障注入；保存失败/未知无半提交；视觉重试不扣第二次 |
| `src/core/index.ts`<br>BUILTIN_CONFIGS:L39 | 当前核心barrel及旧配置装配 | [A][X] | export*间接带land/queue/savev3 | 新核心组合入口 | 明确公共API的方式 | 旧barrel整体迁入；旧价格JSON当新正式地价 | P0/P2 | 检查再导出/配置/动态导入闭包；无隐藏六角权威 |
| `src/core/uistate.ts`<br>UiState:L15 | 旧选地/报价UI状态 | [A][R] | 旧Tile目标 | SelectionState / InteractionMode | 明确选择/取消状态意图 | 目标改为ParcelId/RoadCellId/VisualBuildingId | P0/P2/P3 | 模式互斥、返回取消与目标失效安全 |
| `src/core/fingerprints.ts`<br>checkFingerprints:L16 | 旧0.1实现指纹检测 | [A][X] | economy/visit/upgrade/offline/save旧链 | 新版本规则校验与回归门槛 | 防错误接线的守卫方式 | 旧固定指纹作为新版启动硬门槛；不是删除所有守卫 | P0/P2/P4 | 新配置有对应权威样例；历史指纹另存，不假改绿 |
| `src/game/session.ts`<br>Session:L233；view:L268；bulkBuyPlan:L424；buyNext:L485 | 当前唯一业务会话、批量/一键购买、业务视图 | [A][R][X] | CoreEngine/barrel、q/r事件；view固定saveOk=true | GameSession / CommandCoordinator | 事件通知、核心业务行/确认与批量功能语义 | 空间目标和旧上限；固定保存成功UI；明确批量部分成功规则 | P0/P2/P3 | 真实界面闭环；一键/批量/存档错误显示；奖励去重 |
| `src/render/city/layout.ts`<br>hash2:L211；planBlocks:L290；roadsFor:L449；fitToIsland:L625 | 素材演示的正交布局与道路描述 | [R][K][A][X] | 演示预设/自动道路、岛形适配 | WorldPlanner / BlockPlanner | hash/尺度经验/描述类型；原演示可只读参考 | 演示规划直接充生产世界权威；海水/海岛假设 | P0/P1 | 多种子/成长阶段同一规划链；真实地段与道路权限 |
| `src/render/city/content.ts`<br>makeUnit:L369 | 建筑内容单元、占地与风格工具 | [K][A] | 素材params/materials/geom | AssetAdapter / SkinCatalog | 程序化素材和统一风格工具 | 适配占地包络/视觉档位/皮肤元数据；不整库重做 | P1/P3 | 同框尺度；合法占地；至少两栋独立皮肤实例 |
| `src/render/city/city-contract.ts`<br>buildUnitFor:L214；buildCity:L503；mergeUnit:L357；collectResources:L880 | 素材门面、合批、演示地面/交通与资源统计 | [K][A][R][X] | layout.planBlocks/roadsFor及工厂 | AssetAdapter / CityRenderer | [K/A]工厂分发、合批/变换/统计/dispose；buildUnitFor目前非公开 | [R]生产接线；[X]buildCity默认规划/地面/交通成为第二道路权威 | P0/P1/P3 | 复用真实S40资产；拓扑唯一；资源释放与拾取ID分离 |
| `src/render/city-bridge.ts`<br>placementsFromGame:L39；stableVariant:L33；mergeGeometries:L81；buildCityBridge:L189 | 六角业务到城市素材的接线/合批/交通 | [R][A][K][X] | 轴向位置、核心R4、旧tile与buildingIndex | CityProjection / BuildingRegistry | 合批/资源回收、稳定变体思路、素材交通原型 | 旧placements空间权威；数组或位置ID；增加实例退役和皮肤记录 | P0/P1/P3 | 独立身份；换肤/升级保持；转换退役；新购地不覆盖编辑 |
| `src/render/hexworld.ts`<br>buildTilesGeometry:L117；buildRoadsGeometry:L188；buildBlocksGeometry:L308 | 六角岛面/候选/旧建筑/道路几何 | [R][A][K][X] | hex、outlineOf、旧BlockSpec | TerrainBuilder / RoadRenderer / AssetAdapter | TriSink/通用几何与材质；道路网格生成可按新段适配 | 六角承托、独立升地板、父道路/旧地块建模权威 | P1/P3 | 连续地面含洞；路口一致；不再按每Parcel围一圈路 |
| `src/render/landlayer.ts`<br>LandLayer:L36；setLand:L124；rebuild:L128；tileAt:L264 | 旧地层、候选、购买烟雾和拾取 | [R][A][K][X] | INITIAL7、旧land行、worldToAxial | ParcelLayer / TerrainLayer / RoadLayer | 资源替换与烟雾池生命周期可适配 | 旧tileAt/旧地段更新与道路生成；不继承角点连接 | P1/P2 | 购地空间投影稳定；地形准备后开放交互；资源无泄漏 |
| `src/render/island-shape.ts`<br>outlineLoops:L150；outlineOf:L203；islandTopTris:L377；islandWallTris:L675；islandCapTris:L703 | 六角整岛外环、顶面、岩壁及封底 | [R][A][K][X] | hex输入；outlineOf只取最大环并填洞 | TerrainBoundary / TerrainMeshBuilder | 噪声/绕序/岩层表现及缓存思路，需新输入验证 | 外环单环权威、填洞、旧地块切面/封盖规则 | P0/P1 | 多环/内壁/底面孔；填洞边界消失；单调承托；窄桥 |
| `src/render/island-shape.ts`<br>earClip:L264；wallRingVertex:L623 | 简单多边形三角化与岩壁顶点 | [K][A] | 单环、tile中心方向、向内收缩 | 新几何工具适配 | 简单多边形算法、法向/绕序经验 | earClip本身不是带洞算法；wallRingVertex需替换hex内缩约束 | P0/P1 | 凹口/内洞互不盖洞；闭合/法向/自交检查，不能只验面数 |
| `src/render/island.ts`<br>buildIslandGeometry:L24 | 固定轮廓老岛体生成器 | [X][K] | render/layout固定outlineR与分层扇面 | 新TerrainBuilder接管 | 岩层颜色、噪声及装饰造型参考 | 固定岛壳/扇面不是当前购地地形方案，不作为新承托 | P1 | 实际运行入口不依赖旧岛体；侧底视角对照 |
| `src/render/hex.ts`<br>axialToWorld:L24；worldToAxial:L29 | 旧轴向坐标几何 | [X] | 六角坐标 | 正交坐标与稳定ID契约 | 仅保留历史参考，不带回生产空间权威 | 坐标当产权/候选/承托/拾取身份 | P0/P1 | 生产权威依赖和运行状态检查；历史测试不误报 |
| `src/render/city-traffic-routes.ts`<br>buildHexTrafficNetwork:L135；trafficObstacles:L54；spawnTrafficAgent:L247；advanceTrafficAgent:L270 | 旧六角交通网络及代理移动 | [R][A][K][X] | hex、R4、旧障碍/地块道路 | RoadGraph / MobilityController | 移动/转向/碰撞工具与代理管理，按新边适配 | 旧六角网络/旧障碍推导；不直接以视觉路段导航 | P1/P3 | 删路重算/绕行/掉头；无跨天空；JumpLink能力过滤 |
| `src/render/walk.ts`<br>WalkGrid:L65；Wanderer:L206；obstaclesOf:L28 | 网格寻路及业务居民游走 | [A][K][X] | hex可行走域、R4/旧建筑模板 | WalkableMask / BusinessResidentController | BFS/可见性简化/运动算法 | 旧可走域和障碍生成；业务居民与装饰分开 | P1/P2/P3 | 实际障碍/道路约束；居民可选可访；断路不消失/重奖 |
| `src/render/world.ts`<br>createWorld:L214；PickResult:L45 | 场景/灯云/地层/居民及拾取总装 | [A][R][K][X] | LandLayer、旧tile/R4与city-bridge | WorldRenderer / SceneProjection | 灯光/天空云/资源生命周期、遮挡拾取经验 | 旧世界接线/坐标焦点；拾取增加三类稳定目标 | P1/P2/P3 | 不穿透误点；核心居民保留；全城不搬移；资源回收 |
| `src/render/camera.ts`<br>OrbitCamera:L419 | 环绕相机、阻尼和取景 | [K][A] | Three；本文件无hex直接导入 | OrbitCamera / BoundsProvider | 手势阻尼/投影/限位算法 | 承托边界、焦点和屏幕适配输入 | P1/P4 | 顶手感；旋转/拖动持续帧时间与每帧边界调用计数 |
| `src/app/input.ts`<br>InputController:L135；decidePinchKind:L127 | 指针/双指/点击判定及手势门控 | [K][A] | OrbitCamera、HUD命中回调 | InteractionController | 成熟阈值、手势归属与取消 | 模式路由；道路编辑/建筑/Parcel目标不能互抢 | P1/P3/P4 | 触控取消/误触/44CSS目标与实际Canvas换算 |
| `src/app/app.ts`<br>GameApp:L115；syncWorld:L332；syncLand:L332；onWorldTap:L194 | 应用循环、会话/HUD/世界联动与确认 | [A][R][K][X] | hex坐标、旧Session事件、各旧指纹 | AppComposition / SelectionController | 帧循环/前后台/确认返回/原成熟UI反馈 | 旧空间映射、旧指纹硬门槛；新场景恢复时交互锁定 | P0/P1/P2/P3/P4 | 真实主入口全流程；非独立demo；旧业务矩阵不漏项 |
| `src/ui/hud.ts`<br>Hud:L352 | Canvas控件、金额/业务/抽屉绘制 | [K][A] | SessionView、旧报价/目标类型 | Hud / ViewModelAdapter | Canvas绘制/金额显示/复用控件 | 新目标与编辑/换肤/改建预览；不全套重画 | P2/P3/P4 | 窄屏数字完整；单入口；遮挡/禁用反馈；U1/UX |
| `src/ui/drawer.ts`<br>createDrawerState:L230；drawerTick:L329；layoutDrawer:L185 | 纯抽屉状态机与布局 | [K][A] | 无导入；控件布局参数 | 原抽屉＋新业务ViewModel | 成熟拖拽/手风琴/阶段/布局 | 仅业务行及取景参数适配，避免重写手感 | P2/P4 | 拖拽/焦点/返回/确认不回归；持续操作计数 |
| `src/ui/city-visual-settings.ts`<br>parseCitySettings:L7；readCitySettings:L19；writeCitySettings:L23 | 全局风格及车人密度偏好 | [K][A][R] | 旧CityViewSettings、settings键 | VisualPreferences / BuildingAppearanceStore | 全局偏好解析、默认值和无关字段保护 | 单栋皮肤另由主检查点按稳定ID保存，不塞全局样式替代 | P1/P3 | 旧合法偏好保留；两栋分别保存；购地不覆盖皮肤 |
| `src/game/format.ts`<br>fmtCoinsMilli:L7；fmtRateMilli2:L28 | 玩家金额文字格式 | [K] | 通用数值输入 | 原格式化工具 | 成熟金额/单位表达 | 仅新输入单位明确后必要适配 | P2/P4 | 小屏极值完整可读，不省略关键金额 |
| `src/ui/confirm.ts`<br>hallConfirmStep:L422；drawHallConfirm:L325 | 市政厅确认状态与绘制 | [K][A] | 市政厅预览及UI状态 | 保留市政厅确认＋新交易预览适配 | 确认与取消交互 | 新用途/工程预览内容、opId确认与锁定 | P2/P3 | 双击不重做；返回取消；金额与影响明确 |
| `src/platform/canvas.ts`<br>makeCanvas:L9；setCanvasFactory:L8 | 平台离屏画布工厂 | [K] | 平台回调 | 共用CanvasPort | 同源渲染适配 | 无必要不改 | P0/P1/P4 | Web/微信首帧探针；离屏画布可创建 |
| `src/platform/clock.ts`<br>GameClock:L3 | 平台时间封装 | [K][A] | 原Clock接口 | ClockPort | 成熟单一时钟来源 | 仅类型/生命周期接口必要适配 | P0/P2/P4 | 回拨与前后台时间同源；不引入第二结算时钟 |
| `src/web/main.ts`<br>GameApp:L64 | 浏览器宿主和事件接入 | [K][A] | DOM/localStorage、GameApp | WebHost + 新AppComposition | 输入/RAF/可见性/读异常透传 | 接入新应用与存储schema，保留旧键 | P0/P1/P4 | 真实入口首帧/触控等价；存储失败可见 |
| `src/wechat/main.ts`<br>GameApp:L170 | 微信宿主/画布/触控/存储/安全区 | [K][A] | wx接口、GameApp、内部诊断 | WeChatHost + 新AppComposition | 无DOM适配、异常透传、生命周期/安全区 | 新应用/存档接线；不把文件头过时注释当实际read行为 | P0/P1/P4 | 微信首帧/存储故障/触控；最终真机由机主 |
| `src/ui/confirm-mute.ts`<br>SETTINGS_KEY:L14 | 升级确认偏好 | [K][A] | 见源码事实中的实际import；不授予空间权威 | 原确认偏好适配 | 原成熟通用实现 | 仅新接口/单位/资源owner所需变更 | P1/P2/P3/P4 | 不同升级确认/取消/不再提示回归 |
| `src/ui/feedback.ts`<br>FB_SHAKE_MS:L28 | 禁用反馈与玩家提示 | [K][A] | 见源码事实中的实际import；不授予空间权威 | 原反馈工具 | 原成熟通用实现 | 仅新接口/单位/资源owner所需变更 | P1/P2/P3/P4 | 余额不足/锁定/恢复反馈不遮关键信息 |
| `src/ui/fx.ts`<br>Fx:L39 | 通用UI动画 | [K][A] | 见源码事实中的实际import；不授予空间权威 | 原动画工具 | 原成熟通用实现 | 仅新接口/单位/资源owner所需变更 | P1/P2/P3/P4 | 动画取消与资源回收；交易权威不靠动画 |
| `src/render/city/geom.ts`<br>PartOpts:L8 | S40通用几何工具 | [K][A] | 见源码事实中的实际import；不授予空间权威 | 原素材工具 | 原成熟通用实现 | 仅新接口/单位/资源owner所需变更 | P1/P2/P3/P4 | 造型与资源计数对照；几何合法性 |
| `src/render/city/materials.ts`<br>CityMaterials:L29 | S40材质/风格 | [K][A] | 见源码事实中的实际import；不授予空间权威 | 原素材工具 | 原成熟通用实现 | 仅新接口/单位/资源owner所需变更 | P1/P2/P3/P4 | 共享材质释放、色彩与双端兼容 |
| `src/render/city/tier-residential.ts`<br>buildResidential:L47 | 住宅分档建筑生成 | [K][A] | content/geom/materials与视觉档位；详见import索引 | AssetAdapter / SkinCatalog | 既有模型、细节、变体及分档造型 | 只适配统一尺度/合法占地/实例输出；地标不增经济类别 | P1/P3 | 实际显示并记录素材来源；退界/碰撞/升级档位；无重复收益 |
| `src/render/city/tier-commercial.ts`<br>buildCommercial:L1110 | 商业分档建筑生成 | [K][A] | content/geom/materials与视觉档位；详见import索引 | AssetAdapter / SkinCatalog | 既有模型、细节、变体及分档造型 | 只适配统一尺度/合法占地/实例输出；地标不增经济类别 | P1/P3 | 实际显示并记录素材来源；退界/碰撞/升级档位；无重复收益 |
| `src/render/city/commercial.ts`<br>buildCommercialStreet:L322；buildCommercialDistrict:L407 | 商业街及组团生成 | [K][A] | content/geom/materials与视觉档位；详见import索引 | AssetAdapter / SkinCatalog | 既有模型、细节、变体及分档造型 | 只适配统一尺度/合法占地/实例输出；地标不增经济类别 | P1/P3 | 实际显示并记录素材来源；退界/碰撞/升级档位；无重复收益 |
| `src/render/city/park.ts`<br>buildPark:L425 | 公园地景生成 | [K][A] | content/geom/materials与视觉档位；详见import索引 | AssetAdapter / SkinCatalog | 既有模型、细节、变体及分档造型 | 只适配统一尺度/合法占地/实例输出；地标不增经济类别 | P1/P3 | 实际显示并记录素材来源；退界/碰撞/升级档位；无重复收益 |
| `src/render/city/hall.ts`<br>buildHall:L52 | 市政厅生成 | [K][A] | content/geom/materials与视觉档位；详见import索引 | AssetAdapter / SkinCatalog | 既有模型、细节、变体及分档造型 | 只适配统一尺度/合法占地/实例输出；地标不增经济类别 | P1/P3 | 实际显示并记录素材来源；退界/碰撞/升级档位；无重复收益 |
| `src/render/city/landmark.ts`<br>buildLandmark:L453 | 地标素材生成 | [K][A] | content/geom/materials与视觉档位；详见import索引 | AssetAdapter / SkinCatalog | 既有模型、细节、变体及分档造型 | 只适配统一尺度/合法占地/实例输出；地标不增经济类别 | P1/P3 | 实际显示并记录素材来源；退界/碰撞/升级档位；无重复收益 |
| `src/render/city/traffic.ts`<br>buildTraffic:L293 | 车辆素材与演示交通组织 | [K][A][X] | 演示BlockPlan路网及density | VehicleAssets / MobilityController | 车体原型、动画/资源生命周期可适配 | 演示交通路线不能作为实际RoadState导航权威 | P1/P3 | 删路后合法移动；素材复用；不穿楼或跨洞 |
| `src/render/city/pedestrians.ts`<br>buildPedestrians:L196 | 装饰行人素材与演示运动 | [K][A][X] | 演示BlockPlan路网及density | PedAssets / MobilityController | 人物造型与动画/资源池 | 演示可达关系；不能替代有奖励的业务居民 | P1/P3 | 装饰与业务身份独立；断路合法返回；无新奖励 |
| `src/render/city/props.ts`<br>buildProps:L238 | 街道景观和装饰 | [K][A] | 演示规划和建筑包围盒 | StreetscapeBuilder | 树/街具造型与资源管理 | 装饰输入改用有效道路/建筑退界，不自动填天洞 | P1/P3 | 道路/天空洞无障碍穿插；装饰随机源不扰规划 |
| `src/render/city/industry.ts`<br>buildIndustry:L435 | 已有工业视觉素材 | [X][K] | 素材类型industry | 保留素材备份，不接新经济类别 | 经批准可作为纯视觉细节参考 | 本轮不新增工业经济权益或默认工业产品入口 | P0/P1 | 配置/玩法不出现未经批准的新经济类别 |
| `src/render/city/style-a.ts`<br>STYLE_A:L14 | 独立风格参数/配色 | [K][A] | 素材风格类型；不承担空间权威 | StyleCatalog | 已有配色与比例配置 | 风格不能替代每栋皮肤保存；只做同框标尺适配 | P1/P3 | 同框尺度和颜色；双端外观；全局风格不丢个体偏好 |
| `src/render/city/style-b.ts`<br>STYLE_B:L13 | 独立风格参数/配色 | [K][A] | 素材风格类型；不承担空间权威 | StyleCatalog | 已有配色与比例配置 | 风格不能替代每栋皮肤保存；只做同框标尺适配 | P1/P3 | 同框尺度和颜色；双端外观；全局风格不丢个体偏好 |
| `src/render/city/style-c.ts`<br>STYLE_C:L14 | 独立风格参数/配色 | [K][A] | 素材风格类型；不承担空间权威 | StyleCatalog | 已有配色与比例配置 | 风格不能替代每栋皮肤保存；只做同框标尺适配 | P1/P3 | 同框尺度和颜色；双端外观；全局风格不丢个体偏好 |
| `src/render/city/style-params.ts`<br>styleParams:L145 | 独立风格参数/配色 | [K][A] | 素材风格类型；不承担空间权威 | StyleCatalog | 已有配色与比例配置 | 风格不能替代每栋皮肤保存；只做同框标尺适配 | P1/P3 | 同框尺度和颜色；双端外观；全局风格不丢个体偏好 |

检查方法与局限：`源码事实与冻结预检.json`保留全src文件哈希、导入/再导出和顶层符号索引；正则索引辅助人工核查，不冒充完整TS语义分析。实施P0仍须以实际新入口执行可解析的依赖闭包/状态契约/运行样本验证。本轮没有运行游戏、性能或经济模拟。
