# 《大岛主》当前架构与城市改版可行性说明

编写日期：2026-10-30（北京时间）。性质：首次技术与设计沟通；不是开发任务书，不授权改代码或迁移存档。

**初步结论：方正、连续、有主次道路的城市方向可行，现阶段优先验证“路线A的玩法保护边界 + 路线C的空间生成层”。路线B保留为必要时的选择。现有实现可以复用素材和经济核心，但不能只替换楼体或改一个坐标换算函数就兑现目标。**

## 证据范围与可信度

- **源码确认**：本次直接阅读 `交付-S31-验收收口-20261029/工程`；逐文件复核冻结清单，305个文件全部匹配，无不一致。冻结清单标记 sourceTreeSHA256 为 `2e6b9c06bd09b2d793c875f690db3164639d8809d88f5594849eb431f7d94d67`，该聚合值本轮仅引用，未重算其聚合算法。下文源码路径均相对此工程。
- **源码确认**：上述工程的 src 与 `交付-S31-真机预览-20261029/184723/构建工程/src` 逐文件比较无差异。因此已核查的城市实现也对应这次预览构建的源码；不表示手机效果已经通过。
- **记录确认**：S-30机主签收见本对话及 docs/66；S-31独立历史复核见 docs/73，后续收口数值见随包 README。区分总监实跑历史数据与交付方报告数据。
- **架构判断**：后文标注的可行性、代价、风险和建议，来自上述源码关系，不是已实现能力。
- **未验证**：2026-10-30其他对话是否继续改动、当前写任务占用、最新真机反馈、全部存量玩家档案分布。不能把这份快照称为全项目唯一最新主干。

## 当前整体架构

源码确认：`package.json` 为 TypeScript、Three.js、esbuild 工程，包内版本仍为0.3.5；不能仅凭S-31任务原规划称其已发布0.4.1。

```text
Web / 微信小游戏平台适配
          ↓
GameApp：装配、输入、HUD、相机与渲染
          ↓
Session / CoreEngine：业务动作、时间结算、读写存档
          ↓ 只读状态投影
World + LandLayer + CityBridge
          ↓
整岛几何、道路、建筑批次、拾取代理、居民/交通动画
```

经济动作和渲染有明确模块边界；但同一套六边形坐标被购地、存档校验、岛体、候选高亮、道路、拾取和行走共同使用，空间语义存在跨层依赖。这里的“耦合”不等于经济代码直接创建Three.js模型。

Web使用浏览器Canvas与Three.WebGLRenderer，主存档落localStorage。微信是**小游戏Canvas/WebGL入口**，不是普通小程序WXML页面：`wx.createCanvas`、触摸/生命周期适配、同步存储API，装配同一GameApp。HUD主要绘制为Canvas纹理，以独立场景叠加；不能照搬网页DOM控件。真实手机兼容与性能仍须机主测试。

## 六边形地图、种子、购地与存档

| 主题 | 源码确认的实际行为 | 对改版的含义 |
|---|---|---|
| 地图位置 | `core/land.ts`是固定85块白名单，初始拥有7块，可再买78块；轴向坐标(q,r)，六邻接 | 当前不是每个种子重新随机地形/地块排列 |
| 世界映射 | `render/hex.ts`：边长s=2，x=√3·s·(q+r/2)，z=1.5·s·r；含世界坐标反算 | 不能只改正向坐标，不改拾取、候选和边界 |
| 购地候选 | 未拥有且至少有一个已拥有六邻居；玩家选候选位置 | 无自由摆楼不等于完全没有空间选择 |
| 已购对象 | 按购买顺序保存 `[q,r,type,parentQ,parentR]` | 稳定身份、顺序和父关系都是兼容边界 |
| 父关系 | 买下时在已拥有邻居中选圈数最小者，并列按方向序 | 父关系影响旧道路，且读档会重放检查 |
| 地价 | `core/config.ts`：ceil(base_price[N]×(5+q²+qr+r²)/5) | 改坐标距离可能直接改变报价，不能当纯美术变化 |
| 收益 | `core/rates.ts`：土地产速关联圈数、类型升级及核心产速 | 保留金币字段不等于已经保留经济语义 |
| 升级 | 四核心有独立开业/升级状态；已购街区按住宅/商业/绿化类型共用升级计数 | 视觉中多栋楼不应自动成为多份可升级、可收益的经济实体 |
| 种子 | `core/queue.ts`以citySeed生成购地类型队列，当前位置为land.length；预览/失败不消耗 | 相同种子给相同队列，但玩家购地顺序/位置不同，地图状态可以不同 |
| 视觉随机 | CityBridge以稳定id与citySeed选变体；模型内部另有确定性变化 | 应承诺“相同完整状态+生成版本”的稳定布局，而非仅相同seed |

当前主存档是 `core/savev3.ts` 的 **schema v3**，主key为 `wyszz-0.2-save`，有v1/v2迁移路径。旧 `contract/game-state.d.ts` 仍描述早期v2，不能只读它就判断当前存档结构。

v3保存citySeed、generatorVersion、landConfigVersion、核心建筑状态、land购买序列、类型升级等；不直接保存整城网格/道路网格。解析器逐笔重放候选合法性、类型队列及父关系，未知字段和不支持生成版本有拒绝/保护路径。直接改变队列、邻接或generatorVersion而不提供兼容分支，可能使旧档不能正常恢复；不能先改再指望旧解析器自动兼容。

视觉风格与车人密度写入既有设置key的cityVisual段，不混入主经济档。未来视觉生成版本放在哪里尚需设计；不能复用generatorVersion随意升号，因为它目前参与核心存档校验。

**地理约束**：`render/island-shape.ts`根据已拥有六边形集合生成连续外轮廓、整岛顶面和侧壁/底面，已有整岛一体化；不是每块独立悬空底座。顶面主要为平面，并非种子高程图。内部洞区可在视觉上填平，但不因此变成已拥有地；沿岸足迹和行走限制仍需遵守。旧 `render/layout.ts` 的固定小岛环路不能代表当前活动地图。

## 建筑与道路的真实实现

**建筑——源码确认：**

- S-40素材库位于 `render/city/`，以 `city-contract.ts::buildCity` 为公共构建入口；住宅、商业、市政厅、公园、工业、地标及道具/车人分模块。
- 主要是无外部贴图的程序化几何、顶点色和共享材质，车人实例化；不是必须回到Blender重做的一批模型文件。
- 库支持独立x/z、占地宽深、档位、变体、种子及朝向输入。库内朝向按直角规则处理；宿主S-31在外部进行实际旋转和等比缩放，适应六边形方位。
- `city-bridge.ts::placementsFromGame` 把四核心和每条实际已购land映射到宿主位置；购地模型按统一占地目标适配，再按材质合批并建立拾取代理。
- 外观会随等级映射到有限档位；核心等级、类型升级与视觉档位并非逐级一一变化。设施/宣传等升级也不能默认每次都会换造型。
- 当前宿主实际接了civic/residential/commercial/park；素材有industry/landmark，不代表游戏经济中已有这两类，也不代表已接入游戏场景。

**重复与比例——源码事实加判断：**当前宿主变体由稳定哈希选取，未直接采用演示规划器整城的邻近避重规则；同类型街区共享升级会同时进入相近档位，又被放入相似占地。因此“有限轮廓+同步档位+相似尺度+逐格朝向”会强化重复感。素材是否本身不好看属于观感裁量；具体哪种比例最影响机主尚未逐项核实，不能只凭源码宣判。

**道路与交通——源码确认：**

- `render/hex.ts` / `landlayer.ts` 的旧道路为初始放射连接及购地块到父块连接，不能概括成“所有道路只沿六边形边缘”。
- S-31额外有 `city-traffic-routes.ts`：节点、边、邻接表、真实拥有集合和障碍校验；跨块连接基于初始连接与land父关系，并有块内绕行。
- `city-bridge.ts`按该路网绘制补充路带/人行道，车辆和装饰行人在边上移动、按确定性规则选择后续连接。因此当前已经有交通图，不是完全没有拓扑。
- 另有 `render/walk.ts` 的WalkGrid与业务居民路径/障碍，业务居民承担寻访收益；不能把它和装饰行人合并后意外删除寻访。
- 在所审核心报价、购地和收益代码中，通车条件不作为收费/收益门槛。当前交通主要服务视觉与行走，不是交通经营模拟，也未证实有路口信号、拥堵或目的地需求模拟。
- S-40 `city/layout.ts` **已经有**正交演示规划、主次道路规则；S-31未把它作为真实游戏路网，而是逐个取模型、沿原六边形坐标装配。演示道路推导不等于通用、完备的运行路口拓扑，更不等于已经解决存档映射。

## 三条路线的初步评价（架构判断，尚未原型验证）

| 路线 | 可行性与收益 | 主要风险 | 相对代价与影响 |
|---|---|---|---|
| A 保留逻辑地图，重做视觉映射 | 可保留经济、购买序列和v3；有利于迭代验证 | 若仍限定每六边形内独立摆一组楼，棋盘感难消；若重排为矩形，逻辑候选与画面邻接可能不一致 | 局部美化较小，真正整城重映射中到高；需改拾取/候选/取景，不能称零侵入 |
| B 重构空间系统，保留经济玩法 | 可统一正交街区、拓扑和购地展示，长期表达清晰 | 六邻接、圈数定价/收益、父关系重放、老档与回退迁移都受影响 | 当前代价和兼容风险最高；未完成空间/经济解耦前不可承诺直接复用所有动作 |
| C 独立程序化城市生成层 | 让玩法数据先形成稳定空间规划，再生成道路/街区/多楼组合，适合复用现有模型 | 新增生成版本、稳定id、增量构建、归属反查、资源释放；如果只包一层旧逐格映射仍无效 | 中到高；可以组合A，也可未来承接B；不是新建一套经济 |

推荐先验证A+C，不预判最终必须保留六边形。已有CityBridge是接入边界，可演化或替换其规划职责，避免在它旁边再造第二套同时生效的城市状态。

建议的数据方向为：`只读经济状态 + 稳定逻辑地块身份 + 视觉生成版本 → CityPlan → RoadGraph / 街区 / 建筑组合 / 拾取归属`。CityPlan是待设计方案，不是现有类型。允许一个视觉街区包含多个逻辑单元，也允许一个逻辑单元显示多栋装饰建筑，但每份产出、每次购地和升级必须仍能明确归属，不能多算或漏算。

**关键限制：六邻接逻辑不能简单一一替换为四邻接矩形格并保持全部邻接关系。** 正交道路可以通过折线连接、街区内部通道或跨单元组织解决出行；但那不自动解决“哪块能买、在哪里买、买后出现在哪里”。任何基于当前已购集合的动态全城重排，还可能导致每买一块就让旧楼搬家，应优先验证稳定槽位/预留规划和局部增量更新。

## 可保留、需改造及保护边界

| 分类 | 模块及条件 |
|---|---|
| 优先保留 | 挂机结算、离线、整数货币、寻访、核心开业/升级、价格配置、v3读写；前提是逻辑坐标/类型/顺序及圈数语义不变 |
| 优先复用 | S-40程序化建筑、材质、几何工具、实例化车人外观；复用不等于冻结其全部占地或规划规则 |
| 必须适配 | CityBridge空间规划、正交道路面与图、车人路径/障碍、LandLayer候选与高亮、点击反查、聚焦锚点、相机/云/阴影取景；迁移岛轮廓时也需改岛体与拥有区判断 |
| 高风险 | 逻辑邻接替换、旧档重放、圈数定价收益、更改购买单位、生成版本、多个经济实体聚合后的选中/升级归属、扩张时布局跳变与不连通 |
| 本轮不扩展 | 不新增道路经营收费、工业经济线、自由摆放、交通仿真或整套UI重做；这些均未获本次方案讨论的实施授权 |

工程状态：S-30已获机主签收，不重开其验收；S-40素材已有技术核验和机主观感接受；S-31源码及预览构建已存在，仍有未裁决事项。收口README明确独立U1/UX未实际试玩，旧浏览器三项红仍保留，不能写整单全绿。

预算不能复用错口径：docs/73历史独立复核记录无阴影世界+HUD为169626三角/32 calls，含阴影172878/35；收口README报告有限260种子城市层最大149368三角、6网格/6材质，优化后独立进程首冷238.9/253.4/238.6ms。前者是历史独立证据，后者本轮仅审报告，均不是手机FPS；城市层150000/70/12与整帧预算不得混为一个通过结论。新增道路/人行道/绿化/路口会继续消耗预算。正式game.js增量上限150000B来自既有S-31任务，需明确新改版是否沿用，不能自行涨预算。

冻结保护：hm035封版树、hm044-city素材树、已交付快照不覆盖；新原型未来应在独立树，开始写任务前确认owner和当前写任务。同一树单写者；总监本轮不写实现、不派开发、不出码、不代手机测试。设计目标被认可并不等于路线B及存档迁移已获批准。

## 对设计设想的反馈与优先问题

方向合理：用道路组织街区、混合建筑组团、统一尺度和移动端微缩风格，能对准当前结构性问题；不必先更换逻辑坐标。需要修正的事实是：目前不是种子随机生成整张地图；已经有路网和车人；岛体已经整岛化；购地仍包含位置选择；素材库的矩形演示规划尚未接入真实玩法。

建议优先解决以下三个问题，均为下一阶段共同评审议题，尚未派开发：

1. **确定购买与空间归属契约。** 玩家购买的是保留身份的逻辑单元、一个可见地段，还是整个街区？用现有不同购地分支的旧档画出“候选→购买→多楼街区→升级”的对应关系，明确视觉不相邻时如何解释，不改价格和收益来掩盖映射问题。
2. **证明扩张中的街区稳定性。** 先比较早期、稀疏/分叉购地和满岛状态，再看多种子；确认主次道路、路口、建筑退界/统一尺度、岸线和业务居民都能成立，买地后不整城洗牌，隐藏洞区不产生假可购/假可走区域。若保留六边形仍无法达标，再有依据选B。
3. **统一视觉验收与真实预算。** 先由机主确认带尺度标尺、道路层级和楼高层次的画面；原型验收同时检查整帧主绘制/阴影、构建与升级重建、连续操作、拾取及微信实机。数值阈值与目标设备待确认，不以桌面模型统计替代真机；机主要求停止追加试玩的安排保持，未授权前本轮不启动原型或评审试玩。

尚需共同确认：参考概念图及机主最终取舍、本次能否改变购地展示/岛岸线、是否要求老档保持原有视觉位置、最新真机结果、活动开发owner、整帧预算口径。本轮未取得的内容统一标记未验证，不以猜测补齐。

## 主要源码与记录定位

工程绝对路径：`/vol1/ai/projects/little-town/交付-S31-验收收口-20261029/工程`。

| 依据 | 核查内容 |
|---|---|
| package.json；src/app/app.ts；src/web/main.ts；src/wechat/main.ts；src/ui/hud.ts | 技术栈、平台适配、实际渲染和存储 |
| src/core/land.ts；queue.ts；actions.ts；config.ts；rates.ts | 白名单、邻接、种子类型、购买、报价与收益 |
| src/core/state.ts；savev3.ts；load.ts | 当前状态、严格校验与迁移保护 |
| src/render/hex.ts；landlayer.ts；island-shape.ts | 六边形世界映射、道路、候选、整岛轮廓 |
| src/render/city-bridge.ts；city-traffic-routes.ts；walk.ts；world.ts | 宿主映射、交通图、业务居民、拾取与取景依赖 |
| src/render/city/city-contract.ts；layout.ts；tier-residential.ts；content.ts | 素材公共入口、正交演示规划与模型参数 |
| src/ui/city-visual-settings.ts | 视觉设置与主存档隔离 |
| 交付根目录/README-收口进展与待确认.md；冻结源码SHA.json | 收口状态、报告数值、源码冻结 |
| frontend-rebuild-hm/docs/66、71、73、75；真机预览184723/出码回执.json | 历史验收、预览调度与候选状态；不推导真机通过 |

本轮验证方式：源码只读审阅、冻结文件哈希比对、预览源码比对。没有修改src/tools/test/dist，没有新跑游戏或性能套件，没有建立开发目标或安排其他智能体。
