# 《大岛主》面向最终产品的新版城市架构推荐方案

日期：2026-10-30，北京时间。状态：设计评审稿；不授权修改正式工程，不派开发、不启动原型。

## 一、推荐结论与本轮修订

**推荐以B+C为主方案进入独立架构验证：重新设计土地与空间系统，建立确定性的城市规划/生成层，复用经济计算语义、业务规则、程序化素材和平台适配。** 不把六边形、固定85块、六邻接或原轴向坐标列为新版产品约束。

docs/76的源码事实仍有效，但其“A+C优先”的路线建议被本稿更新：原建议重视旧玩法空间兼容；本轮机主明确以最终效果和总开发成本为先，因此评价目标已改变。B+C目前是架构推荐，尚非已通过原型证明的技术结论。A+C只保留为对照路线或迁移期临时呈现方式，不作为新版默认运行架构。

无法保证未来永不重构；可以避免把同一类“坐标等于身份、模型等于经济实体、道路依附单格”的问题带入新系统。

## 二、证据与判断分界

**源码事实**沿用docs/76锁定的S31收口快照。本轮补查 `src/core/engine.ts`、`load.ts`、`rates.ts`、`timeflow.ts`、`src/game/session.ts` 和素材公共接口，未修改实现、未新跑游戏套件。

- `core/land.ts`：固定白名单、六邻接、圈数和父关系。
- `core/config.ts`：地价直接用q²+qr+r²；`rates.ts`土地收益直接取ringOf。
- `core/savev3.ts`：按购买顺序重放类型、候选和父关系；当前版本不是可直接任意加字段的开放对象。
- `game/session.ts`：事件包含q/r，单买与批量购买依赖旧候选自然顺序、MAX_LAND和核心动作。
- `core/engine.ts`：事件、存档键及CoreState绑定；在线先结算再动作、离线先持久化再提交等语义有明确实现。
- `render/city-bridge.ts`、`city-traffic-routes.ts`、`landlayer.ts`、`walk.ts`：宿主几何、路网、拾取与行走共享六边形空间。
- `render/city/`：可复用的程序化内容与材质，并已有演示正交规划；演示规划不是新版生产城市生成器。

**后文推荐的数据对象、模块边界、迁移协议和验证门槛均为待验证设计**，并非声称代码已经具备。概念图原文件、目标设备、当前写任务owner、最新真机结果、开发工期与费用均未验证。

## 三、如果从零设计，我会选择什么

选择“**可配置规模的有界岛屿 + 正交主次路网 + 街区/地段层级 + 稳定土地ID + 独立经济实体 + 确定性生成**”。

理由：这是一款自动规划的挂机扩张游戏，玩家不需要道路编辑器，也不需要复杂任意多边形自由规划。以正交规划作为默认几何基底，沿海边缘采用裁剪、绿带和特殊地段处理，能直接服务完整街区、道路连续与多楼组合。避免先建设通用城市编辑器、全交通仿真、无限世界或每次购地全城重规划。

网格用于放置和几何计算，**不承担经济身份**；地图规模来自版本化WorldProfile配置，不写死成85，也不承诺移动端无限扩张。首期可以预生成一个有界世界的纯数据规划，只构建当前解锁部分的高成本几何。未来确有跨岛/大世界需求时，再扩展分区调度；本轮不提前实现分布式世界系统。

### 推荐的概念边界

| 对象 | 负责什么 | 明确不负责什么 |
|---|---|---|
| LandId | 一个可购地段的稳定身份；在worldId内唯一，购地后不随排序或显示位置改变 | 不从当前世界坐标、数组下标或模型名字临时反推 |
| Parcel（土地段） | 规划边界、空间位置、街区归属、临路接口 | 不直接存Three对象或用楼栋数计算收入 |
| CityBlock（街区） | 道路围合的城市组织单元，可包含多个地段与公共绿化 | 不强制等于一次购买或一份收益 |
| RoadGraph | 节点、路段、主次等级、交叉口、宽度、开放状态及相邻地段入口 | 不以每个地段外圈画路代替全城网络 |
| UnlockGraph | 可购买/解锁关系及稳定候选顺序，按规划的可达/发展关系制定 | 不复用随车人密度变化的运行交通图 |
| EconomicEntity | 市政厅等业务实体、土地权益、等级/设施/宣传或类型升级归属 | 不要求与每栋可见建筑一一对应 |
| VisualBuilding | 一个街区中的楼体/庭院/配套，带稳定视觉ID和业务归属或纯装饰标记 | 不因多生成一栋楼就多收一份钱、多发一份收益 |
| WorldManifest | 世界身份、种子、规则版本、土地清单和规划校验信息 | 不把经济进度隐藏在渲染缓存里 |

**购地单位推荐为“街区内地段”，而非整个街区或单栋建筑。** 一次购买有可见边界和明确归属，可以发展多栋楼；相邻地段组成完整街区。单地段尺度和组合数量由视觉原型决定，不预定未经验证的尺寸。核心业务建筑单独锚定；装饰、公共绿化和街区配套可以跨地段组织，但不得越过未开放区域造成假可用地。

建议接口语义改为“按LandId报价/购买”，报价携带状态修订号、配置版本等防过期信息。批量购买使用明确且确定的候选优先策略，而非数组或轴向坐标的偶然顺序。视图只返回身份，不能把屏幕位置直接当核心命令参数。

## 四、城市生成与自然扩张

### 规划流程

```text
WorldProfile + worldSeed + 规划版本
    → 岛屿可建设范围、岸线约束
    → 正交主路骨架、次路与交叉口
    → 街区围合、地段划分、稳定ID和入口
    → 可购买/开放图、公共道路开放计划
    → 世界规划快照/校验信息

世界规划 + 已购地段/权益 + 核心等级/类型升级
    → 确定的街区建筑组合、绿化和视觉档位
    → 几何批次、车人可达图、拾取代理、取景边界
```

道路图为几何和运行连接的权威来源，路面、人行道、斑马线、车人路径及沿街入口从它派生；不能继续各画各的、各走各的。不同交通参与者可以采用不同可行边和净空规则。业务居民保持可寻访的独立身份和遮挡拾取，不能用装饰人群替代其玩法。

### 扩张规则

- 首次生成全局主路与街区骨架，已购土地边界、已建道路节点和核心锚点固定；升级和买地不能让全城重排。
- 购买行为激活地段，以及规划允许的相邻公共道路/接口。道路属于自动建设的公共基础设施，不临时引入道路收费与交通经营。
- 购买候选必须符合开放计划并能与现有可用区域连通；跨未开放地段通路要有明确预留走廊，不能让车直接穿过未买地或悬空海面。道路走廊不应被任何可购地段占用。
- 主路可以预先存在施工中的延伸端或保留带；表现方式由机主看原型裁量。未解锁规划可以有预览，不能伪装成已可行走/可经营。
- 岛屿实体与购地权益分离：推荐先形成完整岛屿基础轮廓，随购地解锁可经营范围，并以雾、植被或低细节地形表现未开发区。这与原“买地长出岛体”体验不同，必须交机主确认；若机主要求岛体也生长，则由稳定开放区域与公共走廊派生连续岛面，不恢复逐地段孤立底座。

### 种子、稳定性与版本

- 种子分别派生地形/道路/地段/建筑/装饰等确定性随机源，不共享一个全局随机游标；新增一棵树不能改变未来购地类型或整城道路。
- 以稳定对象ID派生子随机，建立稳定遍历和并列决策规则。仅“使用seed”不足以证明跨版本确定性；规划几何宜采用整数或量化坐标，浮点网格输出使用明确容差验证。
- worldId、生成规则版本、内容版本、经济规则版本和存档schema分别管理；不把它们混成一个generatorVersion，也不因更新窗户样式重新洗牌土地。
- 推荐保存紧凑规划数据和已解锁/已购权威状态，不保存Three网格；种子用于生成和校验，不能成为升级后丢失世界形状的唯一恢复依据。已有世界缺少匹配生成版本时，应继续读其规划快照或明确迁移，不能静默重生成。
- 未来种子可改变岸线、主路间距/街区组合和建筑布局；允许变化不等于任意随机。应限定可达、可建、比例合理的参数域，失败要有确定的合法方案，不能靠反复随机直到偶然好看。
- 生成器可以给出用途倾向，但不得覆盖已经购买的经济用途。若保留现有“购买序列决定住宅/商业/绿化”规则，建筑填充在成交后使用实际类型，不能预先把地段固定成另一种经济用途。

## 五、哪些迁移，哪些替换

| 现有成果 | 推荐处理 | 源码依据与理由 |
|---|---|---|
| 整数货币、商余结算、任意精度费用工具、时间护栏 | 迁移，保留回归样例 | 不需要六边形坐标；真机曾规避原生BigInt支持问题，不应丢弃这些兼容经验 |
| 核心升级、开业、寻访、离线语义 | 保留产品规则与纯计算，适配新状态/接口 | 经济公式大部分可分离，但整文件常引用CoreState；不是直接复制所有文件即可 |
| Engine/Session的事件、动作提交和持久化边界 | 保留已验证的时序语义，改装配和状态契约 | 目前绑定BUY_TILE(q,r)、v3键、候选/批量顺序；原封不动保留会把旧空间带回去 |
| S-40楼体、材质、几何工具及车人外观 | 复用并按街区组合重新审尺度/退界/轮廓 | 素材可参数化，不能为了守旧统一脚印继续压缩新街区 |
| Web/微信适配、触摸和生命周期、HUD绘制基础 | 复用，定点适配新拾取/业务身份 | 渲染技术无需更换；地图高亮、聚焦和地块列表需要接新接口 |
| 固定85白名单、轴向坐标、六邻接、旧父关系 | 从新版运行空间系统移除 | 它们限制正交街区组织，继续适配会造成双重邻接与重复判断 |
| 坐标地价、ringOf收益输入 | 改为明确、版本化的经济参数 | 经济层使用经济区位等级/权重等显式参数，不能导入空间坐标函数；参数生成后固定，移动画面不改钱 |
| 旧hex道路、候选反算、旧WalkGrid空间构建、逐格桥接 | 替换其空间实现 | 全部依赖原布局；只复用净空、遮挡、批处理等可分离算法与测试意图 |
| 旧v3解析器/旧空间规则 | 留在有限迁移适配器及审计工具 | 用来正确解释旧档；不成为新版每帧/每笔新购地必须运行的第二套世界 |

土地经济参数可以是区位等级、类别系数、购买阶段等，但具体公式与配置尚未定稿。不能把q/r改名成经济参数后仍在核心暗算六边形距离。是否调整新版新玩家平衡属于独立产品决策，不因重构自动获准。

旧代码复用以“语义、算法和验证证据”为单位，不以整目录保留率衡量成果。旧夹具中与金币、时间、费用有关的断言应迁移；与六边形世界位置有关的断言应按新契约替代，并保留历史，不能篡改成看起来全绿。

## 六、旧档迁移、兼容与回退建议

### 迁移前提

当前v3无法直接承载上述新世界。建议采用新schema与独立存储命名空间，具体编号/键名在实现任务前冻结。本稿不指定未经核查冲突的编号。须区分“读取旧档”“允许旧客户端继续写”“新运行时回退旧显示”这三件不同的事。

### 权益迁移

1. 只读取得原始旧档并校验，保留原字节及哈希；失败须拒绝迁移并保留，不静默新开档。
2. 建立确定的旧记录→新LandId映射表，重复迁移得到同一身份；原坐标/父关系只保留在迁移审计数据。已购数量、类型、顺序、核心等级/设施/宣传、声望、货币、余数及离线状态均有逐项对照。
3. 旧圈数转换为显式土地收益参数，保持原整数/有理数计算及整体取整顺序。不能只让迁移那一刻总产速相等；还需检验后续核心升级、类型升级的产速和费用轨迹，避免“迁移日不亏、下一次升级就变了”。
4. 已购权益在新区形成可访问的连片区域；视觉重排允许但必须明示，不能保证同时保持旧六邻接位置关系。若必须保持原来每个候选和父关系，则与替换空间系统存在冲突，需要机主明确取舍，不能偷偷让新系统继续走六邻接。
5. 建议为旧玩家迁移生成固定的经济兼容配置：旧购地队列剩余部分、旧配置及待售地段的价格/收益参数可离线展开成数据，运行时不再计算旧hex。新购地以新连通图选择；因此未来候选集合可能改变，具体未购权益/报价对应表须机主批准。不能宣称未购土地的所有未来选择都已经无损等价。
6. 旧进度需要更多或更少新地段空间时，优先调整迁移世界规划容量并保留逐笔权益，不默认折成金币、不减少记录。若容量无法容纳，迁移验证失败，不发新版让玩家自行承担损失。

### 提交与恢复

- 本地存储不能假设跨key事务。先写完整迁移候选与校验信息并读回，校验通过再写切换记录；启动时能识别“仅候选写成”“切换写成”“写失败”等状态，协议需在两平台故障注入验证。
- 迁移候选不发离线奖励；由激活后的权威状态按原业务协议结算，避免预演/重试/切换重复领取。保留原离线锚点和挂起状态，不能用本轮迁移时间抹掉累计权益。
- 迁移与激活需幂等；保留原档和新档，切换后只写新权威状态，不双写两个会分叉的存档。备份空间不足或写回校验失败，不标成功、不删原档腾空间硬迁。
- **推荐回退方式**：先在同一新运行时回退显示/关闭新生成特性，继续读取最新经济状态；显示回退本身也需验证，不能等同于已经具备原样旧城显示能力。
- **二进制降级**：只有新状态仍能被准确反向投影为v3、且回放证明无损时，才支持带最新进度的旧版本回退。出现超出旧容量或新权益后，应阻止自动降级，保留/导出新档并修复新版。恢复迁移前备份会丢迁移后进度，必须明确提示并由机主决策，不能叫“无损回退”。
- 已发布的离线旧客户端不会因为新key存在就自动拒绝运行；仅写版本标记不能保证它不继续写旧v3。发布切换、兼容客户端/提示策略和分叉恢复必须另行验证；本地单机存储无法凭空保证跨旧新客户端唯一权威，不能冒充服务器同步能力。

## 七、A+C与B+C的总成本评价

| 维度 | A+C继续保护旧运行空间 | B+C以新版空间为主 |
|---|---|---|
| 对概念图的适配 | 受旧候选、拥有区、六向连接约束，越追求方正越需要解释层 | 正交道路与围合街区为原生规划单位，更直接 |
| 初次实施成本 | 可能较低；若连购地呈现也重排则优势缩小 | 较高，需新领域模型、迁移和系统整合 |
| 隐性维护成本 | 双邻接、双坐标、隐藏道路、反向拾取和档案例外容易持续扩张 | 把旧例外限制在导入边界，正常运行规则统一 |
| 返工风险 | 视觉目标不降级时，可能最后仍要改空间、重复做集成 | 原型若不充分，也会因地价/种子/扩张设计错误返工 |
| 验证重点 | 是否能真正摆脱逐格感，而非只在满岛截图遮住旧结构 | 是否同时证明新世界、真实业务、权益迁移和移动端预算 |

在本轮要求下，**B+C更可能一次达到目标，值得承担有边界的大改**。这是相对判断，没有人日、金额或成功概率的可靠估计。真实总成本应包含规划/迁移/集成、兼容例外、测试、长期维护及潜在二次重构；需在原型收敛后由实施方估算，不能用改动行数代替成本。

## 八、正式重构前的独立验证方案（建议，未派单）

验证应是同一目标架构的一条代表性竖向切片，不能先做无购地无存档的漂亮展示页，再逐模块发现核心矛盾；也不需要先把整款游戏重写完才评审。

| 关口 | 应交证据 | 允许进入下一阶段的条件 |
|---|---|---|
| 架构契约评审 | 对象/模块依赖、身份与归属、购地/报价/批量/升级时序、种子与版本、迁移/提交/回退状态表 | 没有经济导入空间函数、双权威或未解释的权益变化；机主确认购买单位与扩张表现 |
| 纯数据世界验证 | 多种子、不同规模/岸线/疏密及旧档映射；确定性、连通、合法退界、无重复ID与空间冲突 | 扩张不搬旧地段，候选与道路可达一致；失败可复现，不靠镜头隐藏错误 |
| 代表性城市原型 | 同一生成链的早期、分叉扩张、近满/满城、沿岸与高层遮挡；真实点击→报价→购地→建城→升级→保存重启 | 机主认可连续道路、完整街区、多楼比例及扩张；楼与业务归属明确，不用固定摆景冒充生成 |
| 迁移与故障验证 | 合法旧档样本、类型/核心不同进度、离线挂起；写失败/中断/重复启动/未知版本/容量不足/回退 | 权益和升级轨迹可对照，重试不重复发奖，不清档、不静默降级 |
| 双端与性能验证 | 同场景Web/微信、整帧主绘制+阴影、冷构建/购地重建、持续操作帧时间/调用计数、资源生命周期 | 原有与新增预算口径明确；实际目标手机由机主测，软渲染不能代签 |

正式派原型前，需要冻结参考概念图、目标设备与预算、支持的世界规模和迁移兼容范围；当前没有这些新阈值，不编造具体FPS/人日/地图容量。视觉与交互原型仍须玩家视角自检和独立U1；意见先报机主再裁决，不因本轮允许重构而取消规则。对性能和手势须有持续操作与边界手感证据。

优先排除会推翻路线的风险：拥有/购地连通与正交路网是否一致；旧经济权益能否完整导入；移动端实际能否承受完整街区场景。全部关口形成可复核结论后，再集中实施正式替换；不要让双架构无限期并存。

## 九、评审结论及待机主确认

本轮建议确认：**B+C作为主论证方向；土地ID、规划几何、解锁关系、经济权益、渲染模型分别管理；旧hex退出新版运行空间，仅在迁移适配器留存。**

需要成组确认的产品取舍：购地为街区内地段；岛屿“完整岸线解锁”还是“连续岛体生长”；是否允许旧档视觉重排与候选集合变化；旧玩家后续经济兼容范围；概念图/设备/规模/预算。它们是原型开工条件，不要求本轮立刻开发，也不把顾问倾向当作机主已签全部细节。

本稿是可评审方案，不是正式任务书。未更改正式源码、未改变存档、未生成原型、未安排任何开发智能体。docs/76的事实核查继续作为依据，路线推荐以本稿为新版本。
