# 《我要当市长》游戏企划书 v0.3：简约 3D、有限扩岛与经营升级

> 修订日期：2026-10-09。  
> 基于原《游戏企划书 v0.2》《0.1 至 1.0 版本迭代计划》和《0.1 第一步规格 v1.1》。  
> 原文件保留；本文件为独立新版，不覆盖旧稿。本次仅更新文档，不授权自动修改代码、部署或平台配置。  
> 玩家已确认的要求与本版建议参数分别标注。具体价格、半径和产出系数是可调草案，不能当作已通过试玩的最终平衡。

## 给你看的简版

城市是一座可以拖动旋转、缩放观察的简约 3D 浮空岛。原来的楼、城区、设施、宣传、技能、助手升级全部保留。增加一个「扩建岛屿」按钮：选一块与岛屿相邻的土地，花金币扩大岛屿，系统生成住宅、商业、绿化，后期再出现工业配套。

离市政厅越远，同一次扩建报价越高；总扩建次数越多，价格也越高。岛屿有固定半径上限，不会无限变大。填满后仍然可以继续升级楼、助手和技能，也能正常离线赚钱。

随机配套与核心楼分开：市政厅、学校、医院、工厂等原有十二栋核心建筑仍固定解锁，不会因为没随机到某种楼而卡关。配套外观不同，但同圈地块给予相同的基础增收，不会因为抽到公园就明显吃亏。

**工程可实现，新增玩法属于中等难度。** 最费工作的是土地边缘拼接、点击与拖动区分、种子结果和存档一致，以及扩满后的手机性能。采用有限六边形地块、自动拼道路、预制配套和分阶段验证，可以控制复杂度。微信真机兼容仍是当前最优先验证事项。

## 本版范围与阅读顺序

| 内容 | 本版处理 |
| --- | --- |
| 原有城区、建筑、技能、助手升级 | 全部保留原公式与开放规则 |
| 新增岛屿扩建 | 单独一条手动升级线，写明半径、坐标、费用、收益与生成 |
| 3D 视觉和触摸 | 作为产品基础要求，不再采用 2D 城市作为正式视觉 |
| 原有离线、声望、广告、榜单、赛季 | 保留，新增土地进度跨赛季保存 |
| 当前项目进度 | 按已验收事实与新发现的报告分别记录 |
| 0.1 至 1.0 阶段安排 | 独立配套文档《版本迭代计划 v2》 |
| 扩建半径、地块规模、费用倍率、随机配额 | 本版建议值；正式实现前按任务锁定版本 |
| 代码开发 | 本轮未执行 |

---
# 第一部分：详细经营规格（保留原有升级体系）

## 1. 产品定位与版本边界

### 1.1 核心定位

轻度挂机城市经营游戏。玩家以市长身份从小城起步，持续获得金币，**亲手升级**城区、建筑和能力；通过点击城市中的建筑或人物寻访，取得金币和声望；积累声望后手动解锁下一个区。玩家只选升级按钮和扩建方向，不手动摆放建筑、规划道路或选择科技路线。城市采用可旋转观察的简约 3D 浮空岛形式。长期方向可扩展到省长竞选。

所有事件、反馈、奖励和规则采用脚本与配置，不调用大语言模型，不消耗 Token。广告是自愿加速和后续专家分析入口；钻石可代替部分广告。

### 1.2 本文所说的“首版”

首版包含：三区、建筑和配套升级、城区升级、全城技能、连续手动寻访、助手在线与离线寻访、金色光奖励、离线金币与助手声望、声望兑换、居民反馈、基础激励广告、月度赛季与基础榜单。原计划中的第一、二阶段合并为这个首版。

**寻访选择事件**、外商投资、城建投标、专家分析、全球视角、城市装扮、美化度、省长竞选是后续版本。宜居度作为首版基础指标存在，首版不依赖复杂事件系统。新增「岛屿扩建」作为独立手动升级线，有固定半径上限，规则见第 13 节。它不替代原有升级体系。

### 1.3 不可改变的规则

1. 离线基础收益按实际离线时长计算，**没有时长上限**。
2. 所有升级、解锁、购买助手都由玩家手动确认；助手只寻访，不购买升级，也不存在自动升级功能。
3. 普通寻访可以连续点击，无每日次数限制、普通冷却或点击收益递减。
4. 每次手动寻访同时给少量金币和声望。助手在线、离线都给金币和声望。
5. 金色光随机出现在在线城市中的建筑或人物上，点击后给较多声望。
6. 声望既用于解锁，也可兑换奖励；兑换不应让已获得的解锁资格倒退。
7. 城市存档跨赛季保留；每月重新统计赛季增量，并永久保存已结束赛季的榜单快照。
8. 原有 49 条成长线全部保留，新增 1 条岛屿扩建线，共 50 条；扩建有半径上限，达到边界后仍可升级其他能力。
9. 随机生成的是扩建地块的配套内容，不随机替换十二栋核心建筑、不自动升级、不自动支付开业费。

### 1.4 玩家循环

```text
回城领取离线收益 → 选择一个明确的升级按钮 → 城市每分钟金币上涨
→ 连续点击建筑或人物寻访 → 金币与声望上涨
→ 偶遇金色光，点击取得大量声望 → 达到声望门槛后手动解锁新区
→ 购买或升级助手 → 下次回来领取更多离线收益
```

首版单次上线建议 1～5 分钟内可以完成领取、1～3 次升级和一次新区进度查看；这只是节奏目标，不设登录时长要求。

## 2. 城市结构与“第二层套娃”

### 2.1 层级

```text
城市
├─ 城区（升级行政管理，解锁区内建筑）
│  └─ 建筑（升级经营等级）
│     ├─ 配套设施（升级该建筑挂机金币）
│     └─ 寻访宣传（升级点击该建筑所得声望）
├─ 全城技能（财政、手动寻访、金色光等）
├─ 助手团队（数量、频率、单次金币、单次声望）
└─ 岛屿扩建（玩家选择相邻地块；半径内手动购买；按种子与规则生成配套）
```

这就是适合城市题材的第二层：玩家在城区内看到具体建筑，进入建筑卡片后看到“经营等级、配套设施、寻访宣传”三个升级按钮。配套名称按建筑皮肤变化，例如居民楼是物业与便民设施，学校是教学设备，商业街是商户服务；底层公式相同。城区决定区内核心建筑开放与整体加成，岛屿扩建决定土地形状与配套街区，建筑决定主要产出，配套和宣传分别增强被动产出与主动寻访。玩家只需要选按钮升一级，不放置设施，也不分配员工。

### 2.2 首版城区与建筑配置

建筑在对应城区达到指定等级时显示“可开业”按钮。每区第一个建筑随区解锁免费开业并从 Lv1 开始；其他建筑手动支付 `2 × 建筑基础升级费` 开业，从 Lv1 开始。开业不是自动升级。

| 城区 | 累计声望门槛 | 城区基础升级费 | 建筑（开放城区等级；基础每分钟金币；基础升级费） |
|---|---:|---:|---|
| 市政中心区 | 0 | 150 | 市政厅（1；10；20）、居民楼（2；16；40）、社区商店（4；25；100）、公园（6；40；250） |
| 民生区 | 100 | 1,500 | 住宅街（1；40；200）、学校（2；64；400）、医院（4；100；1,000）、公交站（6；160；2,500） |
| 产业区 | 1,200 | 15,000 | 商业街（1；150；1,500）、物流中心（2；240；3,000）、工厂（4；375；7,500）、会展中心（6；600；18,750） |

示例数值是让三个区有可见的收入阶梯，并不代表最终平衡值。新区解锁只检查累计声望，达到门槛后玩家点“解锁”；不扣声望。城市阶段称号暂按解锁区数显示，无额外复杂门槛。

**核心建筑与随机配套的区别**：上表十二栋建筑是固定经营节点，仍按原等级与声望条件手动解锁、开业和升级；不会因随机没有生成学校或工厂而卡住。随机配套住宅、公园、商业和工厂外观属于扩建模块，不额外产生三条独立建筑升级线，也不重复计入上表。

### 2.3 居民反馈

每栋建筑预设人物和反馈模板。点击寻访立即结算奖励，反馈以不阻断连续点击的短消息或列表展示。模板可依据建筑、城区等级和宜居度切换；首版不需要模拟每个人的真实生活。事件系统后续再接入同一反馈入口。

## 3. 货币、声望与城市指标

### 3.1 金币

金币来自建筑挂机、手动寻访、助手寻访、广告即时奖励；用于全部常规升级、建筑开业、购买助手与岛屿扩建。首版普通升级只消耗金币，避免多货币卡点。

### 3.2 两本声望账

```text
累计声望 P_total = 历史获得声望总量，只增不减
可用声望 P_wallet = 当前可兑换声望
获得声望 x：两者都增加 x
兑换奖励花费 x：仅 P_wallet 减少 x
```

新区和行政称号检查 `P_total`；兑换检查 `P_wallet`；赛季榜检查本赛季获得的声望增量。声望兑换首版提供固定档位，如 50 声望换 `当前每分钟建筑金币 × 10`，每自然日最多兑换 3 次；按兑换时建筑收益快照计算，防止离线补领后回溯改价。金币奖励系数和次数均是可配置草案。声望不能兑换钻石，避免与付费货币循环套利。

### 3.3 钻石

钻石来自任务、赛季奖励或付费；首版只用于代替指定激励广告，不参与常规升级，不直接兑换声望。每种广告按钮同时列出“看广告”和“花钻石”两种方式及同一个奖励结果。钻石价格为配置值。

### 3.4 宜居度与美化度

首版宜居度 `H = min(100, 40 + 2 × 公共服务等级)`，仅用于居民反馈分档和城市展示。公共服务 Lv30 满级，不能在满级后继续付费。美化度及可购买的装扮留到后续版本，不影响首版经济公式。随机绿化和公园先改变外观并提供配套街区收益，不改变本条公共服务与宜居度公式；避免把扩建随机结果偷偷叠入既有升级效果。

## 4. 统一数值口径

### 4.1 等级、费用与取整

城区和已开业建筑从 Lv1 开始。其他可升级能力从 Lv0 开始。购买助手用当前助手数量 `N` 计价。所有费用是整数金币，统一**先用高精度计算，再向上取整**；界面可以显示缩写，但服务器按精确整数结算。全局不提供“买 x10”“MAX”或自动升级；一次按钮操作只升一级。

```text
城区或建筑当前等级 L ≥ 1，升至 L+1：C(L) = ceil(B × r^(L−1))
其他能力当前等级 L ≥ 0，升至 L+1：C(L) = ceil(B × r^L)
购买第 N+1 名助手：C_assistant(N) = ceil(300 × 3^N)
```

`B` 是该项基础升级费，`r` 是逐级费用倍率。指数费用会随着等级递增，但收益通常按线性增加。这样每次升级有效、价格逐渐昂贵，玩家会自然转向新区和其他升级线。所有金币不足时显示精确差额并禁止扣费。按钮状态定期刷新；收到操作请求时仍先结算时间收益，再检查余额与条件。

### 4.2 从参考截图读取的倍率

后三张截图是同一批升级项在连续等级上的报价，计算 `下一次报价 ÷ 上一次报价`：

| 截图项目 | 连续报价 | 相邻倍率 |
|---|---:|---:|
| 下落速度 | 2.73e4 → 4.10e4 → 6.14e4 | 1.502、1.498 |
| 自动投放间隔 | 6.82e6 → 1.02e7 | 1.496 |
| 同屏数量 | 1.35e3 → 4.05e3 → 1.22e4 | 3.000、3.012 |
| 投放暴击率 | 2.22e5 → 3.34e5 → 5.00e5 | 1.505、1.497 |
| 落槽暴击率 | 1.31e5 → 1.97e5 → 2.96e5 | 1.504、1.503 |
| 稀有球出现率 | 3.20e4 → 6.40e4 → 1.28e5 | 2.000、2.000 |

因此参考游戏的常规专项能力约 `×1.5`，稀有项约 `×2`，容量项约 `×3`。截图金额经科学记数法显示和四舍五入，只能估算倍率，无法断言原游戏的精确底层公式。第一张不同颜色节点的价格不是同一项目的连续等级，不能拿来推算逐级倍率。本企划借鉴升级轴的分层和上述三档成本；城区与建筑主等级另用较缓倍率，以保证城市成长节奏。

## 5. 首版完整升级清单

下表中 `L` 均指当前等级；“效果”列用当前等级计算，升一级后代入新等级。所有项目均需玩家手动购买。未写上限的项目首版不设等级上限，但需要大数存储和后期数值调优。表内 `B` 是首轮草案，尤其需要根据实际留存与收益测试修正。

| 层级与升级项 | 初始状态 | 升一级费用 | 当前等级效果 | 用途 |
|---|---|---|---|---|
| 每区：城区行政等级 | Lv1 | `ceil(B区 × 1.45^(L−1))` | 区内建筑金币倍率 `1 + 0.10×(L−1)`；Lv2/4/6 开放新建筑 | 城区成长与整体增收 |
| 每栋：建筑经营等级 | Lv1 | `ceil(B建筑 × 1.22^(L−1))` | 本建筑基础每分钟金币 `b建筑 × [1+0.20×(L−1)]` | 主收入线 |
| 每栋：配套设施 | Lv0 | `ceil(5×B建筑 × 1.50^L)` | 本建筑金币倍率 `1+0.15×L` | 建筑内第二层被动升级 |
| 每栋：寻访宣传 | Lv0 | `ceil(4×B建筑 × 1.50^L)` | 手点本建筑声望倍率 `1+0.20×L` | 建筑内第二层主动升级 |
| 全城：财政管理 | Lv0 | `ceil(500 × 1.50^L)` | 所有建筑金币倍率 `1+0.05×L` | 全城被动增收 |
| 全城：手动寻访金币 | Lv0 | `ceil(80 × 1.50^L)` | 每次手点基础金币 `3+2×L` | 强化点击金币 |
| 全城：手动寻访声望 | Lv0 | `ceil(120 × 1.50^L)` | 每次手点基础声望 `1+L` | 强化主动扩区 |
| 助手：购买数量 | 0 名 | `ceil(300 × 3^N)` | 总助手数量 `N`，每人独立产生相同访问收益 | 扩大自动寻访容量 |
| 助手：寻访频率 | Lv0 | `ceil(600 × 1.50^L)` | 单人访问间隔 `60/(1+0.15×L)` 秒 | 让助手更勤快 |
| 助手：单次金币 | Lv0 | `ceil(450 × 1.50^L)` | 每名助手每次获得 `5+2×L` 金币 | 增加在线与离线金币 |
| 助手：单次声望 | Lv0 | `ceil(700 × 1.50^L)` | 每名助手每次获得 `1+0.5×L` 声望 | 增加在线与离线声望 |
| 金色光：出现频率 | Lv0 | `ceil(1,000 × 2^L)` | 在线每分钟出现强度 `0.10+0.40×(1−0.85^L)` | 增加稀有点击机会 |
| 金色光：单次声望 | Lv0 | `ceil(1,200 × 2^L)` | 点中一次获得 `20×(1+0.50×L)` 声望 | 提高稀有奖励 |
| 全城：公共服务 | Lv0，最高 Lv30 | `ceil(350 × 1.50^L)` | 宜居度 `min(100,40+2×L)` | 改变反馈与城市展示 |

说明：买到第一名助手后才开放三项助手能力升级。助手升级是全队共享等级，不逐个配点。购买更多助手和提升每名助手品质是两条独立线路。`3^N` 仅用于容量扩张，不用于所有升级，否则前期经济会过陡。金色光频率使用渐近公式，避免无限升级后生成速度无界；其价格 `×2` 是稀有项参考值。

**成长线数量**：3 条城区 + 12×3 条核心建筑 + 6 条全城技能 + 4 条助手 = 原有 49 条。新增岛屿扩建为第 50 条，公式见 13.3。扩建不会取消、合并或重定价上表任何项目。

### 5.1 具体费用与效果例子

```text
市政厅：初始 Lv1，基础每分钟 10 金币，下一次费用 20。
升到 Lv2 后，市政厅基础每分钟 = 10×1.2 = 12；再升 Lv3 费用 ceil(20×1.22)=25。

第 1 名助手花 300，第 2 名花 900，第 3 名花 2,700。
有 2 名助手且频率 Lv0、单次金币 Lv0：每分钟助手金币 = 2×60/60×5 = 10。
若频率升 Lv1：间隔约 52.17 秒，助手每分钟金币 = 2×1.15×5 = 11.5。

手动声望 Lv2、某建筑宣传 Lv3：手点该建筑声望 = (1+2)×(1+0.2×3)=4.8。
内部保存到至少 0.001 声望，界面可以显示一位小数，不在每次寻访时向上取整。
```

## 6. 收益与离线结算公式

### 6.1 建筑挂机金币

对已开业建筑 `b`，所在城区 `d`：

```text
R_b = b0 × [1+0.20×(建筑等级−1)]
          × [1+0.15×配套设施等级]
          × [1+0.10×(城区等级−1)]
          × [1+0.05×财政管理等级]

R_core = Σ R_b   （单位：金币/分钟；未开业核心建筑不计入）
R_city = R_core + R_land
R_land 为第 13.4 节定义的配套街区产速；它只计一次。
```

这些加成只进入各自规定的公式，不再叠加同名“技能倍率”；避免一个升级被计算两次。城区等级、建筑等级、配套和财政分别提供不同层级的增收。

### 6.2 手动寻访

点击已解锁的建筑或人物一次即结算一次；人物归属于一栋核心建筑，使用该建筑的宣传等级。随机配套的可寻访对象保存其所属核心建筑 ID，沿用同一公式；不为每个配套对象另建升级等级。点击可连续进行，不设普通冷却、日次数或衰减。

```text
G_manual = 3 + 2×手动寻访金币等级
P_manual(b) = (1+手动寻访声望等级) × (1+0.20×建筑 b 的寻访宣传等级)
```

金币直接入账；声望同时计入 `P_total` 和 `P_wallet`。若反馈较长，以非阻断展示处理，不拖慢连点。金色光点击是独立奖励，不替代普通寻访奖励；若同一点击触发两者，两份奖励分别列明。

### 6.3 助手在线与离线

助手自动访问已开放的建筑，目标建筑可轮流显示，但收益按全队统一等级结算；不继承手动寻访技能、建筑宣传或金色光奖励，避免隐含叠乘。

```text
I = 60 / (1+0.15×助手寻访频率等级)   （秒/次/名助手）
R_assist_gold = N × (60/I) × (5+2×助手单次金币等级)  （金币/分钟）
R_assist_rep = N × (60/I) × (1+0.5×助手单次声望等级) （声望/分钟）
```

在线和离线使用同一产速；不因玩家关闭游戏而停止。助手不会替玩家购买任何升级。小数内部保留，显示与存储按统一精度处理。

### 6.4 无上限离线结算

离线时没有手动点击和金色光点击。离线期间升级等级保持离开时状态；玩家返回后才可手动升级。设 `T` 为服务器确认的实际离线分钟数：

```text
离线基础金币 = (R_city + R_assist_gold) × T
离线助手声望 = R_assist_rep × T
```

统一时间换算：`Δt_sec=(now_ms-last_settle_ts_ms)/1000`，`T=Δt_sec/60`。返回游戏时结算并入账一次，离线面板只展示，关闭不重复发钱；任何升级、开业或扩建都先结算旧产速。

`T` **不做 8 小时、24 小时或其他时长截断**。例：固定总金币产速 100/分钟，离线 10 小时得 60,000，离线 100 小时得 600,000。按确切秒数计算可写成 `产速 × 离线秒数/60`。服务器记录结算时间与上次状态，防止重复领取；赛季跨月时按时间边界拆分声望和金币增量，存档和总收益不断档。

广告带来的限时额外奖励可有独立作用窗口，但**基础离线收益始终全额结算**。例如观看广告将离线前 120 分钟的基础金币额外奖励一次，额外金币为 `(R_city+R_assist_gold)×min(T,120)`；超出 120 分钟的基础金币仍然完整到账。广告窗口属于额外奖励规则，不是离线收益上限。此窗口数值是商业化草案。

### 6.5 金色光

只在玩家在线且城市画面打开时随机出现，落在当前可见、已开放的建筑或人物上。采用第 5 节给出的每分钟出现强度 `λ`；随机间隔可用指数分布 `等待秒数 = −60×ln(U)/λ`，`U` 是 `(0,1)` 内的随机数。场上同时最多一个金色光，持续 15 秒，未点击自然消失；消失后才排下一次。刷新不会因为玩家高速连点普通建筑而加速，离线不补发未点中的金光。点击成功按公式发声望，服务器只接受同一次金光一次领取。金光表现可以是建筑或人物发光。

## 7. 广告与钻石

首版激励广告建议仅提供两种明确奖励：

1. 离线结算页：额外领取前 120 分钟对应的基础金币，公式见 6.4；每次离线结算最多一次。
2. 即时金币：按点击时 `(R_city+R_assist_gold)×30` 发放，可设每日次数限制并在界面明示。

每个按钮都可配置钻石替代价格，例如离线额外领取 10 钻石、即时金币 5 钻石；广告和钻石只能选一种，不可同一奖励重复领取。首版广告不直接增加赛季声望，避免排行榜过度取决于广告次数。事件的专家分析与更多广告入口在事件版本上线时增加。广告奖励失败时不扣钻石、不发奖励；需要确认广告完成后再结算。

## 8. 赛季、榜单与公开存档

每个自然月一个赛季，按服务器统一时区和月份边界统计。玩家城市、金币、累计声望、助手、升级等级跨赛季保存。每月榜单成绩统计**当月获得量**，不是累计存档值；声望兑换不扣当月获得量。

首版建立好友、地区、城市、全国四种范围，至少有当月新增声望和当月金币总产出两项指标。“新市长榜”只包含本月首次建立市长档案的玩家，整个赛季参赛名单按该条件固定；老玩家继续参与常规月榜。玩家中途入场从其入场时间开始统计，不追溯以前收益。赛季结束后保存排名、玩家 ID、城市名、最终指标、赛季编号和生成时间的不可变快照，并在官网长期展示；新赛季开始时仅月度计数归零。地区、城市与全国归属按赛季入场时的归属锁定，避免月中换区影响比较。好友榜按查看时的好友关系筛选同一赛季成绩。

榜单由服务器结算，客户端显示排名。若两个玩家指标相同，先达到该指标者优先，再按玩家 ID 稳定排序。离线期间跨月的收益要按实际时间切割计入对应月份，不能把旧月离线收益全部记入登录时的新月份。

## 9. 首版数据与交互规格

### 9.1 关键状态

```text
城市：金币、钻石、累计声望、可用声望、宜居度、上次结算时间
土地：city_seed、generator_version、land_config_version、固定半径、已购坐标、生成结果、扩建顺序、生成队列与操作 ID
城区：是否解锁、行政等级
建筑：是否开业、经营等级、配套设施等级、寻访宣传等级
全城技能：财政、手动金币、手动声望、金光频率、金光奖励、公共服务等级
助手：购买数量、频率等级、单次金币等级、单次声望等级
赛季：赛季编号、当月新增声望、当月金币总产出、入场地区和时间
居民：固定档案、所在建筑、反馈模板条件
```

金币、声望和费用建议采用大数整数或定点表示；不可用容易丢精度的普通浮点数直接维护超大金币余额。业务结算由服务器确认，客户端可以预览但不能决定实际入账。升级操作应按“先结算当前时间累计收益 → 校验余额与条件 → 扣费并升一级 → 更新产速”顺序完成，避免玩家因离线和升级交界获得重复收益。

### 9.2 界面层级

主城市画面展示金币、声望、总每分钟金币、当前城区、金色光和可点击的人物或建筑。点城区进入建筑列表；直接点已开放核心建筑或人物执行寻访；通过独立管理入口打开建筑的三个升级按钮，避免每次寻访弹出管理面板。技能页展示全城技能，助手页展示四条助手升级线。每个升级按钮显示当前效果、下一级效果和价格；挂机项显示预计每分钟增量，寻访项显示预计每次增量，金光项显示出现强度或单次奖励。岛屿扩建入口显示当前面积、已购地块数、最大半径、候选地块价格与增收；不与市政厅升级按钮合并。没有下一级效果的满级项目显示“已满级”。所有按钮单次点击只购买一级。

### 9.3 配置化范围

城区、建筑、解锁门槛、初始费用、费用倍率、反馈文本、广告奖励窗口及钻石价格用配置管理。新增后续事件时用固定条件、选项、结果和专家分析文本，不接入动态生成。配置热更新需要版本号；已经结算的奖励和历史榜单不能因新配置被改写。

## 10. 后续版本路线

### 10.1 城市抉择版

在寻访反馈后加入脚本事件：单次选择、连续事件、外商投资、城建投标等。每个事件有固定结果和可解释的较优方案；玩家可以看广告或花钻石看专家分析。事件先由条件触发，不让关键主线完全依赖随机。

### 10.2 城市展示版

加入城市装扮与美化度：基础装扮通过游戏或广告获取，高级装扮可用钻石或付费；美化度影响展示与美化榜，不给明显的金币或声望优势。全球视角允许搜索或随机参观其他城市，缩小到地图、再放大进入城市；只加载公开快照，不公开玩家完整存档。可继续加宜居度榜、装扮榜和访问互动。

### 10.3 行政晋升版

加入竞选省长、省级地图与多城管理。保持“点击升级、看反馈、逐步扩张”的底层体验，不把主玩法改成复杂道路规划。

## 11. 首版完成标准与待调数值

首版交付时应能让玩家明确看到：

- 三区逐步开放，每区四栋建筑，建筑内有经营、配套、宣传三条升级线。
- 全部升级由玩家手动操作；助手只增加在线和离线寻访收益。
- 点击已开放建筑或人物可以连续得到金币与声望，反馈展示不阻断点击。
- 金色光偶尔出现，点中获得明显高于普通寻访的声望。
- 离线 10 小时和 100 小时均按完整时间乘当前产速结算，没有截断。
- 兑换奖励只减少可用声望，不降低新区资格和赛季已得声望。
- 月度成绩跨月正确切分，赛季结束快照固定且官网可读。

首轮重点调整项是各建筑基础收入、`1.22/1.45/1.5/2/3` 费用倍率、金色光出现强度、助手每分钟收益、声望门槛、广告额外奖励窗口。判定目标是“玩家始终有一个可理解的下一次升级”，且第二区和第三区能通过正常挂机加适量点击逐步到达；具体分钟数需要实测再定。首版不包含自动升级、寻访事件或专家分析，因此不把这些后续功能算入首版完成条件。

---

# 第二部分：3D 浮空岛与有限扩建详细规格

## 12. 视觉基础与场景组织

### 12.1 已确认的方向

- 简约 3D 浮空岛，地形、建筑、人物采用低多边形或简化模型。
- 玩家可旋转观察城市；当前原型已有缩放，正式版保留并设置边界。
- DSH 原型为继续开发的基础；MIMO 结果保持隔离，不混入源码、资源与配置。
- 微信小游戏是首发目标；浏览器公网预览服务于开发与外地验收。
- 开发、编译主要在 NAS；官方微信调试在现有 Windows 虚拟机；真机验收使用真实手机。
- 应用运行不调用模型。DSH 等模型只是开发工具，与游戏 Token 消耗无关。

### 12.2 城区、核心建筑、随机配套三者关系

首版采用**一座有限岛屿、三个经营城区**。城区是行政管理和收入分组，不是三个无限扩张的岛。半径上限覆盖全城；解锁新区不增加最大半径。

建议在初始 7 块核心土地预留十二栋核心建筑的固定站位（中心市政厅、外围小型站位），按原规则逐步开放；模型脚印必须缩放到站位范围，采用较小的低多边形模型而不是把原型大楼原尺寸塞进来。用城区标签、配色和管理面板区分三区。核心建筑必须可从建筑列表定位，镜头自动对准它们。

扩建只添加外围土地与配套内容。随机住宅与「居民楼／住宅街」核心楼、公园外观与「公园」核心楼、工业配套与「工厂」核心楼均有不同对象 ID 和用途，名字与管理入口需让玩家分得清。

此安排保证：玩家无需先扩某个方向才能解锁原有核心建筑。道路由系统连接，不要求手动修路、拆楼、挪楼或分配员工。

### 12.3 正式场景与原型的区别

当前原型的市政厅不在世界坐标原点。正式地图的价格中心固定为**市政厅地面锚点**；建议转换到逻辑原点，不直接沿用原型岛中心。旋转相机、模型变高、换外观不改变计价中心。

当前 3D 原型多出的建筑仅用于技术验证，不代表 0.1 已实现开业、经营或新城区。

UI 采用可在小游戏运行的 Canvas／3D 叠加绘制。浏览器 DOM/CSS 原型可参考，但不能作为正式微信 UI 依赖。

## 13. 岛屿扩建规则

### 13.1 一次操作与可购买范围

一次扩建只购买一块相邻土地：

1. 玩家打开扩建模式，查看岛边候选地块。
2. 选择地块，显示价格、距市政厅距离、预计配套和每分钟增收。
3. 玩家确认后，先结算旧产速时间收益，这部分入账不回滚。
4. 校验地块仍可买、余额足够、配置与报价版本有效。
5. 扣金币，记录地块、配套结果、生成队列状态及新产速。
6. 播放扩建动画；动画不决定扣费和产出，也不要求整段动画结束才能存档。

岛边拖动仍旋转相机，不支付金币。只有确认按钮购买；快速双击、网络重试不得重复扣款。

只能买与已拥有土地共享一条边的未购地块。禁止孤立土地、斜角连接、越界购买和离线自动扩岛。可以绕过空洞选择其他相邻地块；空洞不自动填充，也不强制玩家补齐某圈。

### 13.2 半径上限：建议的第一组可执行参数

采用平顶面、尖顶朝向的规则六边形，轴坐标为整数 `(q,r)`，市政厅为 `(0,0)`。以下是**建议参数，不是用户已指定的最终尺寸**：

| 参数 | 草案 |
| --- | --- |
| 六边形边长 `s` | 2 个世界单位 |
| 初始已拥有地块 | 中心及六个相邻地块，共 7 块 |
| 最大水平半径 `R_max` | 18 个世界单位，相对市政厅地面锚点 |
| 初始扩建次数 `N` | 0；初始 7 块不计付费扩建 |
| 可拥有地块总数 | 按下述完整顶点边界计算为 85 块 |
| 可购买扩建次数上限 | 85 − 7 = 78 次 |
| 全图填满状态 | 土地扩建满级；其他升级、寻访与收入继续 |
| 边界是否随城区／声望升级增大 | 首版不增大，不提供扩大上限的升级 |

坐标与边界：

```text
x(q,r) = sqrt(3) × s × (q + r/2)
z(q,r) = 1.5 × s × r
d(q,r) = sqrt(x² + z²)
rho(q,r) = max(abs(q), abs(r), abs(q+r))     // 六边形圈数

第 k 个顶点：
theta_k = 30° + 60° × k，k=0..5
vx_k = x + s × cos(theta_k)
vz_k = z + s × sin(theta_k)

允许地块 ⇔ max_k sqrt(vx_k²+vz_k²) ≤ R_max
```

**用全部顶点检查，不能只检查中心点。** 这样地块不会半截越出半径。土地边缘、岩壁和裙边也不能水平伸出硬边界；树冠与云是装饰，不计作可购买土地面积。

该草案按圈数的可拥有数量为：第 0 圈 1 块、第 1 圈 6 块、第 2 圈 12 块、第 3 圈 18 块、第 4 圈 24 块、第 5 圈 24 块，共 85。不是完整的第 5 圈，最外侧的部分地块被圆形半径裁掉。

`R_max` 是**最大允许半径**，不表示必须把岛扩成圆形，也不表示到达一处边界后其他方向就不能再买。只有所有剩余合法相邻候选都买完才整体满级。

世界单位与现实米不绑定。原型的圆形草坪应在正式扩建试验中单独转换为地块地形，不能直接把圆盘覆盖到六边形上制造重叠面。

### 13.3 价格：距离与购买次数共同递增

用真实水平距离计价，确保同一次报价下更远的地块更贵；距离与镜头无关。

```text
d0 = sqrt(3) × s
Q(q,r) = q² + q×r + r² = d(q,r)² / d0²

C_land(N,q,r)
= ceil(B_land × a^N × [1 + beta × Q(q,r)])

建议：B_land=100，a=1.08，beta=0.20
N = 已成功购买的扩建地块数量，不含初始地块
```

| 已购次数 N | 坐标 | 距离项 Q | 本次费用 |
| --- | --- | --- | --- |
| 0 | (1,1) | 3 | 160 |
| 0 | (2,0) | 4 | 180 |
| 1 | (2,0) | 4 | 195 |
| 10 | (2,0) | 4 | 389 |
| 10 | (3,0) | 9 | 605 |
| 40 | (4,0) | 16 | 9,125 |
| 77 | (2,3) | 19 | 179,834 |

表中报价用于复算；某次是否实际可买仍要检查相邻关系和是否已购买，不能从报价表直接跳买远处。

切换到近处地块时，本次价格可能低于上一次成交价；本公式保证同地块随购买次数涨价，以及同一次报价中更远更贵，不要求不同地块的每笔成交价严格递增。

采用大数／高精度运算，最后统一向上取整。核心建筑 `1.22`、城区 `1.45`、专项 `1.50`、金光 `2`、助手数量 `3` 的原倍率不变。

半径与成本从存档中的配置版本读取；更新数值不能偷偷缩小老玩家土地、重新扣费或让已生成建筑消失。建议首版存档固定半径，未来提高上限另做显式迁移和公告。

### 13.4 配套街区收益：有价值，不改原升级线

为了不让随机类型决定明显的经济输赢，同一圈的已购买地块给予相同基础金币产速：

```text
b_land(rho) = 2 × [1 + 0.20 × (rho−1)]    // 金币/分钟
R_land = Σ(已购买地块 b_land) × [1 + 0.05 × 财政管理等级]
R_city = Σ(已开业核心建筑 R_b) + R_land
R_total = R_city + R_assist_gold
```

- 第 2 圈一块配套地块基础为 2.4／分钟，第 3 圈 2.8，第 4 圈 3.2，第 5 圈 3.6。
- 初始 7 块不重复获得扩建产出，0.1 仍从市政厅 10／分钟开始。
- 随机住宅、商店、公园、工厂外观不再逐栋加一遍收益；一块地只算一份配套街区产出。
- 配套街区是全城层级收入，本版只继承财政加成，不继承城区、某栋建筑经营或设施倍率。核心建筑的全部原公式不变。
- 每块至少一个可寻访目标，保存其归属的已开业核心建筑 ID；单次手动奖励沿用第 6.2 节，不额外复制技能加成。
- 增加寻访目标不提高助手固定产速，不按目标数量自动增加金光频率。
- 扩建收入在线、离线一致；返回一次结算，不设置离线时长上限。
- 绿化配套的金币称作「街区综合收益」，不表示公园直接征税；宜居度仍按原公共服务公式。
- 土地满级后 `R_land` 继续产生，财政升级仍能增强它。所有原有成长线继续正常工作。

示例：市政厅 Lv1、财政 Lv0，购买 (1,1) 的第 2 圈地块。费用 160，产速从 10 变为 12.4／分钟；不改变市政厅等级。之后离线 100 小时，基础金币为 `12.4×6000=74,400`（不含寻访、助手和任何升级变动）。

只有有效购买才扣费和吃生成队列；金币不足或地块失效时仍保留刚结算的时间收益。

这组增收与费用是测试草案。扩建是可选升级，不应变成获得其他原有升级资格的必买税；需要比较它与建筑升级的回报周期，再调系数。

## 14. 有规律的种子生成

### 14.1 先说种子的能力边界

种子控制可复现的随机结果，不等于合理的城市布局。还需要配额、连接和模型尺寸规则。

本版选择「**城市种子 + 生成版本 + 扩建历史**」来复现。相同种子且扩建顺序相同，结果相同；仅种子相同、购买方向和次序不同，不能保证每个坐标最终建筑类型相同。这与完全由坐标决定的地图有所区别，是为了保证玩家实际拿到的内容不过度偏科。

地块装饰细节可以按 `hash(seed, version, q, r, channel)` 稳定选取。主要类型受配额与购买顺序影响。不能同时承诺“任意购买顺序下每个坐标类型固定”和“每五次购买配额完全相同”。

### 14.2 基础配额与防重复

初期三类主要内容：住宅 R、商业 C、绿化 G。绿化包含小公园、绿地和广场变体。

每 5 次成功扩建构成一组：

```text
R × 2，C × 2，G × 1
同一主要类型最多连续出现 2 次，包括跨组边界
```

种子生成的有约束队列确定购买次序的类型；预览不消耗队列，失败购买不消耗队列。每组开始时，根据前组尾部和固定种子生成满足连续约束的完整顺序；推荐有限回溯构造，不能无限抽随机数等待成功。

产业区解锁且版本包含工业配套后，从**下一组开始**采用 20 次配额：

```text
住宅 6，商业 6，绿化 5，工业 3
同类型仍最多连续 2 次
```

当前旧组先完成；已生成地块不改类型、不替换旧建筑。若玩家先买满岛再解锁产业区，外围可能没有随机工业配套，但原有核心「工厂」仍能按原条件开业，不影响产业玩法。

上述配额保证完整组内均衡，不承诺任意滑动五次都恰好包含同样配额。只剩不足一组的容量时使用该组前缀，仍满足连续约束；全图总比例可能与配额有小幅偏差。

### 14.3 次要元素和道路

每块最多：
- 1 个主要配套模型；
- 0～2 个小装饰，例如树、灯、座椅或灌木；
- 至少 1 个可点击寻访目标；可使用主模型，不要求每块都有独立动态居民。

道路从中央路网沿购买地块的相邻边连接，记录一个已购相邻地块为父连接，保证连通。六个邻居按固定坐标序排序；有多个可选父连接时用稳定规则选一个。新增邻居后可添连接，但不重新随机土地内容。

道路、草坪、底部岩壁使用预制边型和尺寸检查，不为每个对象引入寻路或交通仿真。工厂与绿化用小型预制配套，先不加污染、拆迁、供电、物流链等系统。

建筑只能放在地块安全区域，模型脚印和装饰外伸提前校验。位置先按脚印分配，再构建几何；不依靠上线后不断挪模型修穿模。

### 14.4 预览、保存与更新

1. 创建城市时生成一次 `city_seed`，使用固定的、版本化的整数伪随机算法。
2. 预览候选地块展示本次对应类型与收入；预览本身不抽新随机数。
3. 任一扩建成功后，其他候选价格与预览内容可以更新，但确认时必须再次显示有效报价。
4. 记录最终类型、变体、布局、归属建筑、序号、种子版本和队列状态。
5. 重开、换手机、跨赛季、掉线重试不得重抽已购地块。
6. 不增加付费重抽、广告重抽或“买到不喜欢就退款刷种子”。
7. 新生成规则只用于明确升级后的后续地块；已有地块按保存结果加载。
8. 装饰随机与主要类型使用不同随机通道，增加一棵树不会改变后续配额。
9. 同一个扩建请求只提交一次；随机结果和扣费必须与存档一起原子提交。

核心商业、住宅、绿化类是全程可用配套；工业配额只在对应解锁条件满足后启用。预制模型还要检查尺寸、边距和道路出口。

本版采用先确定类型、再选择适配外观的方式。不能先随便生成几十个模型，再靠不断删改“凑成”合理街区。

## 15. 实现结构、数据与性能

### 15.1 功能拆分与工程难度

| 模块 | 难度 | 控制办法 |
| --- | --- | --- |
| 半径、相邻候选、报价 | 低～中 | 整数轴坐标，平方距离计价，有限地块集合 |
| 种子和防重复 | 中 | 小配额队列，固定算法与版本，保存结果 |
| 3D 土地拼接、外侧岩壁 | 中～较高 | 合并共享边，仅外露边生成侧壁，预制连接形状 |
| 点击、拖动、缩放、UI | 中 | 手势状态区分，UI 优先接收输入，真实射线拾取 |
| 存档和服务端重复请求 | 中～较高 | 土地事务、操作 ID、资产与生成结果同时保存 |
| 微信手机兼容与性能 | 当前最大不确定性 | 先真机验证 WebGL2、触摸和资源，再扩充大图 |

无需实现无限区块加载、地形挖掘、编辑器、完整碰撞物理、自由建造或居民 AI。此任务有现实可行的拆分方式，但不能用模拟器帧率替代真机性能结论。

### 15.2 纯规则层和平台层

纯规则层：
- 地块坐标、允许集合、相邻关系；
- 报价与收益；
- 种子队列、内容分配、保存与读取；
- 与 Three.js、DOM、wx 和相机完全分离。

渲染层：
- 已购土地顶面、外露边侧壁、岛底；
- 核心建筑、配套、道路、目标高亮；
- 扩建预览与短动画，不维护真实余额。

平台层：
- 微信画布、触摸、前后台、存档接口；
- 浏览器预览适配；
- 0.4 起由服务端确认种子、报价、扣费与土地事务。

复用已经验证的场景比例、配色、相机和射线思路；不把浏览器 DOM 钩子、部署脚本或实验全局对象搬进正式小游戏。

### 15.3 最小存档字段

| 范围 | 字段 |
| --- | --- |
| 地图规则 | `land_config_version, generator_version, city_seed, hex_side, R_max` |
| 地块 | `q, r, initial/paid, purchase_index, content_type, variant, layout, parent_connection` |
| 经营关联 | `owner_building_id, base_land_rate` |
| 生成状态 | `cycle_profile, cycle_index, remaining_queue, last_two_types` |
| 交易 | `operation_id, quoted_N, rule_version, charged_cost, settled_at_ms` |
| 城市 | 原金币、声望、等级、助手、结算时间及存档格式版本 |

不要在正式云存档中相信客户端自行上报的新种子、半径和生成结果；服务器从已确认状态计算并验证。0.1～0.3 的本地测试数据不进入正式排行榜。

### 15.4 性能预算（目标，尚未实测）

有限半径限制为 85 地块，使场景对象数可预估：
- 地形与道路合并网格；重复树木、路灯等共享几何／材质，适时实例化。
- 不给 85 块地每块跑一个收益计时器，也不为每个助手模拟离线行走。
- 居民动画同时最多展示少量，例如 8 名；助手数量不等于常驻 3D 模型数量。
- 满岛目标：每帧绘制调用不超过 200，三角形不超过 80,000，低端目标设备稳定 30 fps。
- 像素比提供可配置上限；初始 1.5，高性能设备经测试可到 2。
- 一盏主要方向光，阴影分辨率与关闭阴影的质量档位可配；性能不足时可使用假阴影。
- HUD 仅状态变化时重画纹理，不每帧生成文字材质。
- 场景退出正确释放新增资源，反复打开面板不持续增加显存。

这些是设计预算，不代表 Three.js r186 已覆盖所有目标手机。WebGL2 不支持设备的产品策略，需要真机资料后确认，不能擅自换引擎或宣称自动兼容。

## 16. 当前进度与近期推进安排

### 16.1 截至本版的状态

| 项目 | 当前状态 | 证据层级／后续 |
| --- | --- | --- |
| 原企划、0.1 规则文档 | 已有，已修正规则口径 | 本版保留旧文件 |
| NAS Node／TypeScript 开发环境 | 已完成环境探针 | 不要求重新配置 |
| 2D 静态手机画面 | 已完成历史原型 | 作为 UI 参考，不是正式 3D 场景 |
| DSH 浏览器 3D 浮空岛 | 已选用；公网预览已复核 | 继续保留，MIMO 隔离 |
| 草坪闪烁与道路附近交叠 | 已修复，有对比证据 | 不等于所有未来地块几何均已验证 |
| 微信开发者工具安装、阶段 A | 已验收通过 | 游客模式原生点按完整序列 |
| 微信阶段 B 立方体、C 小岛 | **最新本地报告记载模拟器成功** | 本轮读取了报告，尚未另做全面代码／模拟器验收 |
| 微信阶段 D 更多建筑和缩放 | 已构建并渲染的报告记录 | 交互未验证，输入注入链路失效 |
| 合法小游戏 AppID、手机微信真机 | 未完成／未验证 | 与模拟器通过分开 |
| 0.1 时间收益、寻访奖励、经营升级、存档、离线 | 未完成正式循环 | 不能以技术原型代替 0.1 完成 |
| 有限扩岛、种子生成 | **本版新增规划** | 本轮没有实现 |

参考最新报告：
`/vol1/ai/projects/wyszz-new/wechat-spike-ds/docs/微信小游戏迁移连续验证报告.md`。

该报告有旧摘要“C/D 尚未完成”与后文新进度冲突，需在正式验收时统一。报告记载启用软件渲染启动参数，其中包含 `--disable-gpu-sandbox`；这是调试环境改动，不能作为普通默认启动的兼容结论，也不能把它搬到玩家客户端。应补核参数授权和是否能保留 GPU 沙箱运行，不能因本文而自动继续放宽环境限制。

### 16.2 接下来先做什么

1. 复核已经存在的微信 B/C 证据，修正文档状态，不重复下载安装工具。
2. 恢复或定位阶段 D 的输入取证问题；复测旋转、对象选择、缩放。
3. 合法小游戏 AppID 条件具备后，做真实手机 WebGL2、画面、触摸与前后台验证。
4. 按更新后的 0.1 八步完成正式 3D 画面及基础循环。
5. 扩岛纯规则与无资产 3D 试验可在独立目录提前制作，但仅在明确开发任务授权后；默认将真实购买与收益接入 0.2。
6. 0.2 把有限扩岛与第一城区原有升级线一起接入；0.4 增加服务端土地事务；0.5 完善工业配套。

不为了新增扩岛把已完成工具和公网预览全部推倒重来。正式游戏入口与 spike 目录分开，后续迁移由具体任务列出允许读取和修改范围。

## 17. 新模块的验收与执行边界

### 17.1 规则验收

- 原 49 条升级线完整存在，原费用与基础效果未被扩岛取代。
- 新增扩建线单次手动购买一块；助手、离线和广告不替玩家购买。
- 允许集合共 85 块、初始 7 块、可买 78 块，所有顶点在半径内。
- 非相邻、已拥有、越界地块不能购买；失败不扣费、不消耗队列。
- 同 N 的报价随真实距离平方增加，N 增加报价也增加。
- 报价算例与 13.3 一致；显示缩写不决定扣费。
- 达到外缘后其他合法方向仍可买；全部买满后不继续扣费。
- 土地满级不封顶基础离线收益，不冻结其他升级。

### 17.2 生成和账务验收

- 基础每 5 次成功扩建配额为 2／2／1，同类不连续超过 2 次。
- 相同种子、版本、扩建顺序可复现；不同装饰通道不扰动主要类型。
- 重开、跨月、配置更新不改变已保存地块。
- 固定核心建筑不会被随机配套替代或重复算收益。
- 随机公园与同圈住宅的基础街区产速相同。
- 扩建前结算旧速；扩建后立即按新速累计；视觉动画不重复发钱。
- 保存中断与请求重试不产生“扣了钱没有地”或重复地块。
- 离线仍按完整有效时长结算，跨赛季只重置成绩，不删除土地。

### 17.3 3D 与手机验收

- 地块边缘无裂缝、重复共面闪烁和可见交叠；先检查模型脚印再摆放。
- 模型选择是实际射线；拖动和捏合不误购地、不触发普通寻访。
- UI 占用区域不把输入传到场景；关闭离线展示不再次入账。
- 旋转镜头不改价格中心；完整土地画面有可用的复位和缩放边界。
- 满岛在真实目标手机检查性能，记录机型、微信版本、帧率与资源占用。
- 浏览器、模拟器、真机三类结果分别记录，不混写兼容结论。
- 每次前端交付保留可访问的 hynixing 公网预览；域名与部署权限沿用具体任务，不擅自改公共站点。

### 17.4 给 Agent 的约束

本企划是规格与路线，不等于今晚自动执行所有章节。继续采用“明确任务 → 交付证据 → 复核 → 下一任务”的节奏。可以在一份已授权任务内连续推进多个小阶段，但遇到需本人扫码、AppID、权限或底层兼容问题时如实停下对应依赖项。

新增库须说明必要性；避免为了扩岛引入完整物理、导航、地形编辑工具。先写纯规则，再做有限地形原型，再接资产与存档。

MIMO 目录隔离；既有 3D 浏览器原型、微信 spike、旧 Godot 工程各自保留。未来正式迁移应是受控复制和独立入口，不能从本文自行推断已获得覆盖文件或修改系统服务的权限。

---

## 18. 来源与文档版本

- 基础升级与经营数值：原《我要当市长-游戏企划书.md》v0.2。
- 既有路线：原《我要当市长-0.1至1.0版本迭代计划.md》。
- 0.1 时间、入账、八步安排：《我要当市长-0.1-步骤1-画面与规则规格.md》v1.1。
- 3D 方向、DSH 选用、公网预览和半径限制：本会话用户已确认要求。
- 微信 B/C/D 最新状态：本轮只读取得的迁移连续验证报告，按报告证据层级记录。
- 新版阶段安排：《我要当市长-0.1至1.0版本迭代计划-v2-3D有限扩岛-2026-10-09.md》。

原文件内容未删、未覆盖。新版扩建参数和实现建议以本文件为依据；若旧稿的 2D/Cocos 或成长线总数与新版冲突，采用新版明确更新项，其他经营规则保留。
