# 《我要当市长》0.1 至 1.0 版本迭代计划 v2：3D 与有限扩岛

> 原规划：2026-10-06；独立新版：2026-10-09。原文件完整保留。
> 定位：全新项目，微信小游戏首发，简约 3D 浮空岛；当前采用 DSH 的 Three.js＋TypeScript 路线，NAS 构建、Windows 虚拟机官方调试。真实手机兼容尚未完成验收，不恢复旧 Godot/Cocos 路线。
> 本文只制定玩法、开发顺序和验收目标，不开始创建工程或制作游戏。
> 0.1～0.9 是逐步完成正式版的开发版本；1.0 是正式发布版。
> 依据：新版《游戏企划书 v0.3》保留原 49 条成长线，另加一条有限岛屿扩建线，共 50 条。扩建不是其他升级的替代方式。企划“首版”仍对应 1.0。

---


## 新版修改与当前起点

### 已确认与建议参数

已确认：扩岛属于升级的一部分、其他升级保持不变、岛屿有半径上限、可选方向、按规律随机生成、采用 DSH 3D 结果、微信小游戏目标。

建议参数：边长 2／半径 18／初始 7 块／最多 85 块，费用 100×1.08^N×距离项、配套产速与 2／2／1 配额。具体值不是用户已经选定的最终数值；先用内部试验验证，再在实施任务锁定。

### 当前里程碑（2026-10-09）

| 状态 | 进度 |
| --- | --- |
| 已验收 | 原画面规则文档、NAS 环境、历史 2D 画面、DSH 浏览器 3D 原型与公网预览 |
| 已验收 | 官方微信开发者工具安装启动、游客模式原生小游戏阶段 A |
| 最新报告新增，待全面复核 | 阶段 B 立方体与 C 小岛在模拟器渲染、旋转和射线有证据；不再写成尚未开始 |
| 已实现但交互未验证 | 阶段 D 更多建筑／缩放／高亮，输入注入通道失效 |
| 未验证 | 手机微信真机、合法小游戏 AppID、完整前后台与长稳 |
| 尚未完成 | 正式 0.1 基础经营循环 |
| 新规划，未实现 | 有限半径扩岛和配额种子生成 |

最新迁移报告有旧摘要和新正文冲突，以及软件渲染启动参数改动，先复核记录后再作为阶段正式证据。报告的模拟器 55～59 fps 不能当成手机性能。

**本文件是计划，不是自动开工指令。** 当前仍优先完成微信兼容与基础经营；新增扩岛安排在 0.2。独立扩岛规则／渲染试验只有获得具体开发任务授权后才能提前做。

### 0.1 八步：沿用原节奏，更新 3D 画面

| 步骤 | 内容 | 当前关系与成功标准 |
| --- | --- | --- |
| 1 | 画面和数值规格 | 原 v1.1 数值保留；本企划更新 3D 与方向，不重做已确认公式 |
| 2 | 正式静态手机画面 | 3D 初始岛、市政厅、居民、资源栏、升级抽屉；可旋转／缩放；不接经营账务 |
| 3 | 时间收益 | 市政厅 10／分钟，时间单位明确，小数不丢，前后台不重复 |
| 4 | 连续寻访 | 点市政厅／居民每次 +3 金币、+1 两本声望；拖动不寻访 |
| 5 | 手动升级 | 市政厅 Lv1→2 花 20，产速 12；下一次 25；先结算再判断 |
| 6 | 本地存档 | 保存资产、等级、结算位置、地图版本；此时只保存初始岛 |
| 7 | 无上限离线 | 返回瞬间入账一次，面板只读关闭，任何时长按实际有效时间 |
| 8 | 完整试玩 | 前七步串联，浏览器、模拟器、真机分别记录；复算原断言 |

技术原型 A/B/C/D 是工具与渲染试验，不自动等同于八步完成。合法 AppID 未就绪时可以继续内部开发，但不能把真机验收勾上。

### 0.2 的扩岛分段

| 子阶段 | 工作 | 验收 |
| --- | --- | --- |
| 2-A | 纯坐标、半径、候选、费用、配额规则 | 85／7／78、距离报价、可复现、失败不吃队列 |
| 2-B | 无资产的 3D 有限地图试验 | 土地顶面、岛底、外露边、道路、配套；旋转点击、满图预算 |
| 2-C | 接金币和本地土地存档 | 先结算旧速、手动确认、单次扣费、生成结果随存档保存 |
| 2-D | 与原第一城区四楼和三条建筑升级整合 | 核心资格不随机、不增加扩岛前置门槛，各产速只计一次 |

可以在一个已授权任务内连续执行这些子阶段，不需要每几行代码就问一次；仍要让每一阶段保留独立证据与可回退状态。

---
# 第一部分：通俗版

## 1. 我建议最初版怎么做

**0.1 只做一小块能反复玩的城市：一个区、一栋市政厅、一名居民，呈现在可旋转的 3D 小岛上。**

市政厅会赚钱；你点建筑或居民寻访，可以获得金币和声望；有钱后亲手升级市政厅；退出后再回来，能领取全部离线收入。

```text
城市赚钱 → 连续点击寻访 → 手动升级 → 每分钟赚得更多
→ 退出游戏 → 回来领取离线收益 → 再升级
```

第一版就要让升级有反馈：显示当前收入、升级价格、升级后的收入，点击后有轻量奖励表现。建筑使用临时但可辨认的美术，界面可正常在手机上操作。

这个版本的目的，是让我们亲手判断“升级和点击有没有意思”，并把收入、费用和存档算正确。它是内部试玩包。

## 2. 0.1 到 1.0 一眼看懂

| 版本 | 重点 | 玩家新增体验 | 使用范围 |
| --- | --- | --- | --- |
| 0.1 | 3D 基础循环 | 城市赚钱、手动升级、连续寻访、本地保存、无限时长离线基础收益 | 内部试玩 |
| 0.2 | 城区、建筑第二层、有限扩岛 | 原第一区四栋楼和各条升级，另加定向买地、种子配套、半径上限 | 内部试玩 |
| 0.3 | 助手与主动奖励 | 第二区、助手人数和能力升级、金色光、基础居民反馈 | 内部试玩 |
| 0.4 | 可信长期存档 | 微信身份登录、云存档、服务端时间与收益结算 | 受控联调 |
| 0.5 | 完整经营玩法 | 第三区、全部技能、声望兑换、宜居度，三区全部成长线齐备 | 受控玩法测试 |
| 0.6 | 广告与钻石 | 两种激励广告奖励、免费钻石替代广告、基础成长奖励 | 受控商业能力测试 |
| 0.7 | 基础竞争 | 好友、区、市、全国榜；声望榜、收益榜；新市长参赛规则 | 有资格条件的受控测试 |
| 0.8 | 月赛季与永久榜 | 月度结算、不清城市存档、地区总收益、官网历史榜 | 完整系统测试 |
| 0.9 | 发布候选 | 数值、正式表现、真机体验、反馈处理与发布流程收尾 | 条件具备后小范围公开测试 |
| 1.0 | 正式发布 | 稳定运行的完整轻量经营游戏，开始正式月赛季运营 | 正式玩家 |

每个版本保留前一版功能，修复问题后再增加下一组内容。版本号表示完成程度，不表示“每周发一个”。

## 3. 1.0 最终包含什么

- 三区，每区四栋核心建筑，共十二栋；它们按原规则开放，不随机替换。
- 一座可旋转的 3D 浮空岛，新增手动定向扩建，有固定水平半径上限。
- 外围配套按种子与配额生成，自动衔接道路；玩家不摆楼、不修路。
- 城区升级；每栋建筑的经营、配套设施、寻访宣传三条升级线。
- 全城财政、手动寻访金币、手动寻访声望、金光频率、金光奖励、公共服务六项技能。
- 助手数量、寻访频率、单次金币、单次声望四条成长线。
- 连续寻访、居民反馈和在线金色光。
- 无时长上限的离线建筑金币，以及助手离线金币和声望。
- 累计声望解锁新区，可用声望兑换奖励，宜居度展示。
- 自愿观看的激励广告，免费钻石代替指定广告。
- 微信身份、云存档、基础收益与奖励校验。
- 好友、区、市、全国榜，月赛季、新市长榜、地区总收益统计。
- 城市不因换赛季清档，结束赛季的榜单永久保存在官网。

按三区十二栋核心楼展开，保留 **49 条原有成长线**：3 条城区＋36 条建筑＋6 条全城技能＋4 条助手。新增岛屿扩建 1 条，共 **50 条**。新区解锁、建筑开业和声望兑换另外计算；随机配套不是几十条额外建筑升级线。

寻访选择事件、外商投资、城建投标、专家分析、全球参观、装扮、美化度和省长竞选，继续安排在 1.0 之后。

---

# 第二部分：详细版，供开发 Agent 使用

## 4. 全版本规则

### 4.1 已确认的玩法约束

1. 基础离线收益不设置时长上限；从 0.1 开始按完整有效离线时间计算。
2. 所有升级、开业、解锁、购买助手均由玩家手动触发。助手只寻访。
3. 普通寻访可连续点击，无普通冷却、日次数限制或收益衰减。
4. 每次普通寻访同时给金币和声望。
5. 助手在线和离线按相同规则产生金币和声望。
6. 金色光仅在线生成，玩家点击领取，离线不补发未点击金光。
7. 累计声望决定解锁；兑换只扣可用声望。
8. 升级费用递增；具体系数属于可调数值，公式与等级口径必须明确。
9. 赛季不清除城市、升级、助手和货币存档。
10. 玩法、反馈与后续事件由脚本和配置驱动，不调用大语言模型。
11. 岛屿扩建一次只买一块相邻土地，有固定半径上限，达到边界不关闭其他升级。
12. 随机生成配套不替代固定核心建筑，不自动升级、开业、解锁新区或买助手。
13. 土地、种子、已生成结果随城市跨赛季保存；不因刷新、换设备或换季重抽。

沿用现有企划：升级按钮一次购买一级，首版不提供 x10、MAX 或自动升级。这里只是在安排它们何时实现。

### 4.2 原型与正式服务的区别

- 0.1～0.3 的本地数据用于内部试玩，不能作为可信全国榜成绩或正式资产。
- 0.4 引入服务器和受控账号；正式系统使用可信时间和服务端结算。
- 内部本地存档如需导入，必须明确标为测试数据，禁止直接把客户端余额导入正式榜。
- 公开测试是否保留进度，要在开放前说明。建议 0.9 用可延续至 1.0 的存档规则，并在发布前验证迁移。
- 一旦向公开玩家承诺保留进度，后续升级就按该承诺处理，不能用换版本为由随意清档。

### 4.3 每版都应该能被完整试玩

每版交付包括可试玩包、该版数值配置、已有存档的迁移说明和验收记录。

新增模块需要融入现有循环。金币不足、广告失败、网络中断、满级和重复操作等状态，随对应模块一起完成。

验收清单是未来实施时的要求；本轮没有执行这些开发和测试工作。

---

## 5. 0.1：基础循环版

### 目标

在微信开发者工具和手机测试环境中，完整玩通“赚钱、寻访、手动升级、保存、返回”。

### 功能范围

- 简约 3D 初始浮空岛，单指拖动旋转、受控缩放，点击与拖动区分；资源栏与面板使用微信可运行的绘制方式。
- 原型可以有装饰，但本版经济只有市政厅；不把技术原型的第二栋楼算作已经营。
- 一个市政中心区，一栋已开业市政厅，一名归属市政厅的居民。
- 建筑随时间产生金币，显示每分钟金币。
- 城市画面点击建筑或人物即寻访；升级通过独立入口打开，避免弹窗阻断连续点击。
- 市政厅经营等级升级，显示等级、费用、当前与下一级产出。
- 金币、累计声望、可用声望三项状态。
- 基础奖励飘字或短反馈，不能阻塞后续点击。
- 本地存档，保存等级、资产、收益结算位置和存档格式版本。
- 退出／返回后的基础离线金币结算，无时长上限。
- 主城市画面、建筑升级面板和离线结算展示。

### 初始计算草案

```text
市政厅从 Lv1 开始，金币余额从 0 开始。

每分钟金币 R = 10 × [1 + 0.20 × (L - 1)]
当前 LvL 升至 LvL+1 的费用 C = ceil(20 × 1.22^(L - 1))
每次普通寻访金币 = 3
每次普通寻访声望 = 1
时间收益金币 = R × 有效经过秒数 / 60

获得声望 x：累计声望、可用声望同时加 x。
升级前先结算旧产速收益，再扣费、加一级、更新产速。
```

金币不足时不能扣费或升级；零余额仍能靠挂机和寻访取得第一次升级的钱。收入保留小数余量，不能每次刷新丢弃未满一枚的金币。

本阶段用本地时间验证循环，处理前后台切换和重复结算；修改设备时间的防护在 0.4 改用可信时间落实。本地金额从一开始选择能支持后续大数的表示方案。

### 进入下一版的条件

- 玩家无需讲解即可完成第一次寻访和第一次升级。
- 初始 Lv1 产速 10／分钟；升至 Lv2 后为 12／分钟，下次费用为 25。
- 连续寻访不丢正常输入，不被反馈弹窗打断。
- 固定等级下，在线与离线同样时长得到相同基础收益。
- 前后台切换和重开不会重复领取，也不会丢档。
- 真机画面可操作，旋转／缩放不触发寻访；UI 不把触摸传给场景，文字和按钮没有遮挡。
- Three.js WebGL2 在目标手机实际运行；无合法小游戏 AppID 时只能记录内部模拟器结果，不宣称真机版完成。
- 本版不接真实扩建扣费，防止基础循环与地图改造一起扩大范围。

---

## 6. 0.2：城区、建筑第二层与有限扩岛版

### 目标

验证多条升级线是否有用，玩家能理解“先升城区、楼、配套、宣传还是扩岛”。原升级内容和价格不变，扩岛作为独立选择。

### 新增功能

- 市政中心区四栋建筑：市政厅、居民楼、社区商店、公园。
- 城区行政等级，按 Lv2／Lv4／Lv6 开放后三栋建筑。
- 玩家手动支付开业费用，未开业建筑不产生收入。
- 每栋建筑完整提供经营、配套、宣传三条升级线。
- 建筑列表、城区升级面板、建筑详情和开放条件。
- 居民绑定不同建筑，寻访声望使用所属建筑宣传等级。
- 每个升级按钮显示实际效果增量，避免只有名称和价格。
- 初始 7 块六边形土地；候选地块只在相邻边出现，玩家确认购买。
- 有限半径、距离加价、扩建次数加价、三类配套队列（住宅／商业／绿化）、自动道路连接。
- 每块配套街区收入、本地保存种子、生成版本、坐标、最终结果与购买顺序。
- 满边界提示、整岛满级状态、旧本地测试存档迁移。
- 核心四栋楼仍按城区 Lv2／4／6 解锁，扩建不作为额外门槛。

### 核心公式

```text
城区升级费 = ceil(B区 × 1.45^(D - 1))
建筑升级费 = ceil(B建筑 × 1.22^(L - 1))
配套升级费 = ceil(5 × B建筑 × 1.50^F)
宣传升级费 = ceil(4 × B建筑 × 1.50^A)

单栋每分钟金币
= b建筑 × [1 + 0.20 × (L - 1)]
         × (1 + 0.15 × F)
         × [1 + 0.10 × (D - 1)]

单次寻访声望 = 1 × (1 + 0.20 × A)

扩建费 = ceil(100 × 1.08^N × [1 + 0.20 × (q² + q×r + r²)])
配套每块基础产速 = 2 × [1 + 0.20 × (rho - 1)]
本版总建筑／街区产速 = 核心建筑之和 + 已购配套产速之和
```

扩建参数详见 v0.3 企划第 13 节：六边形边长 2、半径上限 18、初始 7 块、最多 85 块、最多 78 次付费扩建。属于建议草案，实施任务锁定后按同一配置核对。所有顶点都在半径内；种子加版本加购买历史可复现。

`D` 为城区等级，`L` 为建筑经营等级，均从 1 开始；`F`、`A` 分别为配套和宣传等级，从 0 开始。基础费用与基础收入沿用企划表，后续通过试玩调整。

### 进入下一版的条件

- 四栋建筑按条件逐步开放，开业和升级都需要玩家操作。
- 建筑、配套、城区加成分别生效，不重复计算。
- 宣传只增强本建筑手动寻访声望，不偷偷增强助手。
- 小数声望保留，显示取整不会改变实际资产。
- 玩家能看出各条线的收益差别，能找到下一次想买的升级。
- 非相邻、已购、越界地块拒绝扣费；买到边界后其他合法候选仍可买。
- 同购买次数下更远更贵；同一坐标的价格随总购买次数增长。
- 完整五次生成组包含住宅 2、商业 2、绿化 1，跨组同类不超过连续两次。
- 配套类型与原核心建筑分开计数；同圈公园与住宅基础产速相同。
- 重开不重抽，失败不吃队列，重复操作不扣两次；扩建前结算旧产速。
- 满岛仍可升级楼与其他能力；无限时长离线规则不变。
- 85 块地图有浏览器与模拟器证据，真机性能状态独立记录。

---

## 7. 0.3：助手与寻访奖励版

### 目标

形成“手动积极玩”和“买助手后离线成长”的完整互补关系。

### 新增功能

- 民生区及住宅街、学校、医院、公交站，共两区八栋建筑。
- 累计声望达到门槛后，玩家手动解锁民生区。
- 助手团队：购买人数、寻访频率、单次金币、单次声望四条成长线。
- 首名助手购买后才开放团队能力升级，能力等级由全队共享。
- 助手在线和离线收益，离线结算页分别列出建筑金币、助手金币、助手声望。
- 基础金色光：在当前可见建筑或人物上出现，点击获得较多声望。
- 按建筑与人物分类的基础居民反馈，不做选择事件。
- 助手面板与第二区管理切换；三区位于同一座有限岛屿，不新增无限面积。
- 随机配套寻访对象可与新增核心建筑关联，已生成地块不重新随机。
- 扩建产速纳入建筑／街区金币，助手数量和频率不因地块数增加。

### 核心公式

```text
购买第 N+1 名助手费用 = ceil(300 × 3^N)
单人访问间隔 I = 60 / (1 + 0.15 × 频率等级) 秒
助手每分钟金币 = N × (60 / I) × (5 + 2 × 单次金币等级)
助手每分钟声望 = N × (60 / I) × (1 + 0.5 × 单次声望等级)

离线金币 = (建筑每分钟金币 + 助手每分钟金币) × 离线分钟数
离线声望 = 助手每分钟声望 × 离线分钟数
```

助手基础升级费和倍率沿用企划。助手不继承手动寻访、建筑宣传或金光加成。展示的访问动画不能决定实际结算次数，低帧率和切后台不能导致少发收益。

基础金光每分钟出现强度为 0.10，初始奖励 20 声望；场上最多一个，持续 15 秒，未点击自然消失。频率和奖励技能留到 0.5。

### 进入下一版的条件

- 第 1／2／3 名助手费用分别为 300／900／2,700。
- 每项助手升级对在线和离线都生效，升级前后收益分段正确。
- 助手不代替玩家购买升级。
- 离线 10 小时与 100 小时按完整时长结算，没有封顶。
- 金光只领取一次，点中的奖励明显高于普通寻访。
- 第二区可以通过正常挂机和寻访到达，反馈不打断连点。

---

## 8. 0.4：微信身份与可信存档版

### 目标

让长期经营具备可持续保存、校验和恢复的基础，为广告和排行榜提供可信数据。

### 新增功能

- 微信登录凭证由服务端验证，映射为游戏自己的玩家标识；不另做手机号注册。
- 云存档，本地作为缓存，资产和成绩以服务端确认结果为准。
- 服务端可信时间、产速快照和结算记录。
- 升级、开业、新区解锁、助手购买、寻访入账和土地购买的服务端规则校验。
- 服务端控制城市种子、允许集合、半径、报价、配额、购买序号和土地事务；资产扣费与生成结果原子提交。
- 多设备并发购买同一地块或不同地块时，只接受按最新状态验证的请求；过期报价返回新价格，不默默多扣金币。
- 重复请求识别、操作顺序和多设备存档冲突处理。
- 网络中断状态：可查看缓存城市，待确认结果明确展示；避免承诺无法确认的升级已经成功。
- 基础配置版本与存档格式版本管理。
- 诊断记录与受控测试账号，便于定位资产问题。

### 实现边界

1. 无需服务器每秒模拟所有建筑；使用时间差和已确认产速结算。
2. 高频寻访允许流畅本地表现和批量确认，不能每次点击都等待网络返回。
3. 待确认奖励与已入账资产分开处理；恢复网络后不重复发放。
4. 修改手机时间不能直接增加正式收益。
5. 无上限离线指全部有效时长都计算，不能为了防重复领取而截断正常离线时长。
6. 离线收益按已确认规则与离开时产速计算；配置调整不能改写已结算收入，具体生效边界必须记录。

### 进入下一版的条件

- 换手机或重新打开后可恢复同一城市。
- 升级前正确结算旧产速，之后使用新产速。
- 重复登录、重复请求、超时重试和多设备操作不造成重复资产。
- 正常连续点击仍然顺畅，校验机制没有引入普通寻访冷却或日上限。
- 资产异常能够从记录中定位原因。
- 换设备土地形状和配套一致；存档规则更新不消失、不缩水。
- 土地购买、生成队列、产速快照同时提交；网络重试不重复扣费。
- 内部本地测试资产与后续正式成绩隔离。

---

## 9. 0.5：完整经营玩法版

### 目标

补齐正式版全部经营与升级内容，让玩家能持续玩完整三区。

### 新增功能

- 产业区及商业街、物流中心、工厂、会展中心，完成三区十二栋建筑。
- 全城六项技能全部开放：财政、手动金币、手动声望、金光频率、金光奖励、公共服务。
- 累计声望／可用声望的声望兑换功能。
- 宜居度指标和对应居民反馈分档。
- 完整升级效果预览、未开放条件、满级状态。
- 调整新区门槛和价格，让多条升级线都有明确用途。
- 产业区解锁后，从下个生成组启用工业配套（20 次：住宅 6、商业 6、绿化 5、工业 3）；已生成结果不变。
- 工业配套不替代核心工厂；不加入污染、供电或物流仿真。
- 完整土地扩建与所有原升级并存，核心地块站位和三城区标识完善。

### 公式与初始参数

```text
核心建筑金币增加财政倍率：(1 + 0.05 × 财政等级)
配套产速 = Σ 配套地块基础产速 × (1 + 0.05 × 财政等级)
R_city = 核心建筑产速之和 + 配套产速，二者不重复计入
手动寻访金币 = 3 + 2 × 手动金币等级
手动寻访声望 = (1 + 手动声望等级) × (1 + 0.20 × 本建筑宣传等级)

金光每分钟出现强度 λ = 0.10 + 0.40 × (1 - 0.85^金光频率等级)
单次金光声望 = 20 × (1 + 0.50 × 金光奖励等级)

宜居度 H = min(100, 40 + 2 × 公共服务等级)
公共服务最高 Lv30。

声望兑换草案：50 可用声望 → 兑换时建筑每分钟金币 × 10。
每日最多兑换 3 次；这是兑换限制，不是普通寻访限制。
```

现有民生区门槛 100、产业区门槛 1,200 累计声望属于起始草案，不能未经试玩直接认定最终平衡。兑换消耗不减少累计声望和当月已获得声望；兑出的金币是否计入某项收益榜要在 0.7 的统计口径中明确。

### 进入下一版的条件

- 原 49 条成长线与新增扩建线（共 50 条）全部可用，受条件限制或满级的项目显示原因。
- 每条升级都能看到实际效果，价格与公式一致。
- 兑换后解锁资格和已获得声望保持不变。
- 公共服务满级后不能继续扣费。
- 主动寻访、建筑收入、助手和新区成长均有用途。
- 初步记录首个助手、第二区、第三区的到达时间，依据实际体验调整数值。

---

## 10. 0.6：激励广告与免费钻石版

### 目标

验证自愿广告加速是否顺畅，奖励能准确到账，游戏在不看广告时也能正常推进。

### 新增功能

- 微信激励广告接入，分别展示加载、可观看、无广告、关闭、完成和奖励确认状态。
- 离线额外金币与即时金币两种奖励入口。
- 免费钻石余额、消耗和指定广告的替代方式。
- 少量一次性成长奖励，例如首次购买助手、首次解锁新区，用于提供免费钻石。
- 广告与钻石二选一的奖励资格，服务端防重复入账。
- 统计广告请求、展示、完成、奖励确认和失败原因。

### 奖励草案

```text
R_total = 建筑每分钟金币 + 助手每分钟金币
T = 本次结算的离线分钟数

基础离线金币 = R_total × T，正常全额结算。
广告额外金币 = R_total × min(T, 120)，同一结算批次最多额外领取一次。
即时金币 = 奖励资格建立时 R_total × 30。

离线额外奖励的钻石替代价草案：10。
即时金币的钻石替代价草案：5。
```

产速及奖励金额在建立奖励资格时确定，不能看完广告后按新升级产速重复改价。120 分钟只限定广告额外奖励，基础离线收入始终无时长上限。

首版广告不直接发声望；广告所得金币可能间接加快成长，这一点在数值与榜单中需要考虑。即时金币的次数规则和免费钻石发放量在本版一起确定并展示。

**0.6 不开现金购买钻石或高级装扮。** 后续支付准入、版号和主体要求另行处理。任务奖励不能重复领取，也不引入强制签到、体力或阻塞升级的额外货币。

### 平台条件

实际广告开通依赖微信当时的流量主资格。资格尚未具备时，先完成可区分成功／失败的内部联调；不得把测试广告当作真实收入。可向 0.7 推进其他功能，但 1.0 发布前必须完成真实能力验证。

### 进入下一版的条件

- 关闭未完成的广告、广告无填充、重复回调和网络重试均按规则处理。
- 完成广告后奖励仅入账一次；钻石替代仅扣款和发奖一次。
- 取消或失败不会损失基础离线收益。
- 广告播放期间经过的时间正确结算，不依赖被暂停的画面定时器。
- 成长奖励只领取一次，正常升级不需要钻石。
- 有能力时完成真机广告链路验证，未完成部分记录为发布前条件。

---

## 11. 0.7：榜单与参赛规则版

### 目标

让玩家可以比较成绩，并先明确比较对象与统计范围。

### 新增功能

- 微信好友榜，仅显示按平台开放范围取得的同玩游戏好友。
- 游戏服务端管理的区榜、城市榜、全国榜。
- 当月新增声望、当月金币产出两项指标。
- 新市长参赛名单：本月首次创建市长档案的玩家。
- 沿用现有企划的常规月榜建议，供老玩家继续参与；新市长榜独立筛选。
- 排名、自己的成绩、周边名次和空榜状态。
- 基础榜单异常处理：重复奖励、非法资产和明显错误成绩可调查。

### 在本版固定的规则

| 规则 | 建议口径 |
| --- | --- |
| 地区归属 | 玩家选择用于榜单归属的地区；赛季内固定，不采集精确定位 |
| “区”的含义 | 本计划建议榜单按现实地区／城市／区县范围筛选，与玩法中的三个城区区分；在正式实现前确认具体层级 |
| 新市长资格 | 服务端首次创建档案时间落在本赛季内，不能靠重登或换城市名字重新参赛 |
| 金币统计 | 分来源记录建筑、寻访、助手、广告和兑换；榜单明确选取哪些来源，不能把当前余额当产出 |
| 声望统计 | 记录本月获得量，兑换不回扣成绩 |
| 并列名次 | 确定稳定排序；若沿用先达到者优先，必须记录实际达成时间，不能简单使用上线补领时间 |
| 地区总收益 | 按本月地区固定参赛成员的指定收益来源聚合，注明是新人还是全部玩家范围 |
| 昵称／城市名 | 只展示允许公开的信息，不展示微信身份标识等内部数据 |

推荐把“经营产出”作为主要金币比较口径，将广告和兑换另记奖励来源，避免兑换放大金币产出榜。这个口径与现有企划中较宽泛的“金币总产出”需要在本阶段确认，不能由实现者自行混加。

微信好友分数上报和全国榜服务端数据是两套路径；好友榜受平台开放数据能力约束。需要标明成绩更新时间，不能承诺平台好友榜与自有榜每秒完全同步。

### 进入下一版的条件

- 同一个账号在各范围榜上的原始成绩一致，排序差异只来自筛选范围。
- 消费金币不减少产出成绩；兑换不减少声望成绩。
- 新玩家与老玩家按正确资格筛选，地区归属稳定。
- 好友榜不越界读取完整微信好友名单。
- 排名来源可追查，异常修正有记录。
- 空榜、无同玩好友、未选地区和网络失败均有可用状态。

---

## 12. 0.8：月赛季与官网永久榜版

### 目标

完成换月后继续经营和旧赛季永久封榜的完整流程。

### 新增功能

- 按北京时间每个自然月一个赛季，统一使用服务端边界时间。
- 城市、土地形状、种子结果、升级、助手和货币跨赛季保留，仅新赛季计数重新开始。
- 本月首次创建档案的新市长名单按既定资格固定。
- 地区总收益统计与参赛范围说明。
- 跨月离线收益按实际产生时间分配，不能全部算入回来当天。
- 赛季结束流程、固定最终榜单与对应展示奖励。
- 官网赛季档案：按月份、范围和指标查看最终榜。
- 历史数据备份和公开展示快照，官网不直接开放完整存档。

### 封榜顺序

```text
确定赛季结束时间
→ 对全部符合参赛规则的账号结算到该时间
→ 汇总成绩并处理已确认的数据异常
→ 生成排名、地区聚合及奖励资格
→ 固定最终榜单并归档
→ 官网展示
```

**不能只结算月末登录的玩家。** 助手离线也会产生声望，未登录账号同样要结算到赛季边界，最终榜才能保持固定。

封榜结算后要保存已结算位置。该玩家以后回来，只补领尚未结算部分，不能再次把同一段收益计入资产或旧月成绩。金币可能在离线结算时已计入资产、回城时仅做展示，具体界面与账务要使用同一口径。

历史快照包括赛季、榜单范围、指标、公开玩家标识、最终成绩、名次、生成时间与规则版本。正式封榜后不因为平衡配置更新而重新计算；若发生作弊、隐私或错误数据问题，按有记录的申诉／修正流程处理，保留归档依据。

### 进入下一版的条件

- 用内部测试日历跨过至少两个赛季，确认全过程。
- 长期未登录玩家的收入按实际月份分段计算。
- 月末升级、重复结算、奖励领取和月初登录不重复发奖。
- 老玩家保留全部城市进度，新市长榜不混入老玩家。
- 最终榜生成后正常补领不能改变其成绩。
- 官网可访问旧赛季，数据和游戏中的历史榜一致。
- 内部模拟赛季与正式档案分开，官网不把测试榜伪装成正式历史。

---

## 13. 0.9：发布候选与小范围测试版

### 目标

让完整游戏在真实手机、真实网络和真实玩家使用中达到可发布状态。

### 本版工作

- 主要城市、建筑、人物、金光和升级表现替换为统一简约 3D 正式美术。
- 如需升级改变建筑外观，采用少量里程碑阶段，不要求每一级制作独立造型。
- 调整数值节奏：首次升级、首个助手、新区开放与中后期价格。
- 修复存档、广告、排行榜、跨月和高频点击问题。
- 手机适配、弱网状态、首次加载、资源包和长时间运行处理。
- 满半径地图性能：85 块土地、核心十二栋和配套同时显示；核对真实手机帧率、显存、绘制调用、前后台恢复。
- 少量升级外观里程碑，地块建筑自动摆放与脚印校验，消除裂缝、共面闪烁和可见穿模。
- 设置页：音效／音乐开关、隐私入口、反馈入口和必要账号状态。
- 简短、可跳过的首次引导，不阻断玩家操作。
- 回访、成长与广告链路统计，真实收入与模拟数据分开。
- 完成当时适用的资料、备案、版本审核、广告准入和防沉迷能力要求。
- 备份、故障恢复、配置发布和问题处理流程。

### 测试与数据

内部验证与受控测试可以持续进行；小范围公开测试同样依赖适用的平台条件，不把“测试”当作免审核公开发行。

条件具备后，观察真实玩家至少覆盖连续七个自然日的回访窗口；人数、渠道和结果一并记录。小样本只能用于发现问题，不据此承诺市场表现。

真实月赛季尚未结束时，用内部时间验证封榜流程；正式运营的历史档案只能由正式赛季生成。不会为了凑版本号伪造历史榜。

### 进入 1.0 的条件

- 没有已知的资产丢失、重复奖励、错误扣款或封榜错误等发布阻塞问题。
- 确认 0.9 到 1.0 的存档迁移和公开玩家进度承诺。
- 真机登录、云存档、无限离线收益、广告和好友榜可用。
- 玩家可正常到达完整三区，升级目标清楚，不因未看广告卡住基础成长。
- 发布所需资料和能力实际满足当时平台要求。
- 有可执行的故障恢复方案和玩家反馈处理渠道。

0.9 的重点是修复和发布准备；不在这个阶段加入大型新玩法。

---

## 14. 1.0：正式发布版

### 发布内容

正式版包含本文第三节列出的全部功能，完成三区经营、连续寻访、助手、金色光、声望兑换、广告替代、云存档和月赛季竞争。

官方公开版本使用正式账号、正式配置、正式广告位和正式赛季。测试账号、调试入口和内部模拟数据与玩家环境隔离。

### 正式版最低成功标准

| 范围 | 成功标准 |
| --- | --- |
| 进入游戏 | 手机可正常进入，初次与再次进入都能读取正确状态 |
| 经营 | 原三区十二栋核心建筑和 49 条成长线有效；新增扩建线，共 50 条，升级由玩家手动触发 |
| 3D 与土地 | 可旋转／缩放观察浮空岛，扩建有半径上限，种子配套有规律，满地图性能经真机验证 |
| 寻访 | 连续点击同时给金币和声望，反馈不阻断 |
| 助手 | 数量与能力升级生效，在线离线收益规则一致 |
| 金色光 | 在线出现、点中获奖、不可重复领取 |
| 离线 | 完整有效时长结算，长时间离线不封顶、不重复计入 |
| 声望 | 解锁、兑换和赛季增量使用不同且一致的账务口径 |
| 广告 | 自愿观看；完成按规则发奖；失败不损失基础收益 |
| 钻石 | 免费发放、消耗及替代奖励准确；未开放现金购买 |
| 存档 | 升级、换设备和跨赛季均保留城市进度 |
| 榜单 | 范围、资格、来源与并列规则明确，可查自己的成绩 |
| 赛季 | 全体参赛账号按边界结算，结束快照固定，官网可查 |
| 运营 | 实际满足平台发布条件，具备监控、反馈、备份与恢复能力 |

正式发布后可以使用 1.0.1、1.0.2 等版本修复问题，不必为每次修复新增玩法。

---

## 15. 功能首次出现时间

| 功能 | 首次版本 | 完整或正式状态 |
| --- | --- | --- |
| 手机城市画面、手动升级、寻访 | 0.1 | 0.5 补齐玩法，0.9 完善表现 |
| 本地存档、无上限离线金币 | 0.1 | 0.4 改为可信云端结算 |
| 城区升级、建筑第二层 | 0.2 | 0.5 三个区全部开放 |
| 定向扩岛、固定半径、种子配套 | 0.2 | 0.4 土地事务可信，0.5 工业配套，0.9 满图真机性能 |
| 助手数量与三项能力 | 0.3 | 0.4 服务端确认，0.9 调平衡 |
| 助手离线声望、基础金光、反馈 | 0.3 | 0.5 加技能和宜居度分档 |
| 微信身份、云存档、可信资产 | 0.4 | 0.9 完成恢复与迁移验证 |
| 全城技能、声望兑换、宜居度 | 0.5 | 0.9 调节参数 |
| 激励广告、免费钻石替代、成长奖励 | 0.6 | 1.0 前具备实际开通与可用链路 |
| 好友、区、市、全国榜 | 0.7 | 0.8 与赛季结算结合 |
| 新市长资格与月度统计 | 0.7 | 0.8 完整换季和封榜 |
| 地区总收益、官网历史赛季榜 | 0.8 | 1.0 正式赛季生成正式档案 |
| 正式美术、设置、反馈、发布准备 | 0.9 | 1.0 正式运营 |
| 寻访事件、外商投资、投标、专家分析 | 1.0 后 | 单独规划事件版本 |
| 全球参观、装扮、美化度 | 1.0 后 | 单独规划展示版本 |
| 现金购买钻石／高级装扮 | 1.0 后 | 取得相应资质与支付能力后安排 |
| 省长竞选、多城管理 | 更后期 | 先验证市长阶段长期经营 |

---

## 16. 与功能制作并行的准备事项

| 阶段 | 可提前准备的事项 |
| --- | --- |
| 正式开工前 | 确认主体、首发、项目名称、引擎版本和公开测试进度政策 |
| 0.1～0.3 | 整理权属、游戏玩法介绍、适龄与必要资料；形成可用内容截图后再完善提审材料 |
| 0.4～0.5 | 核对登录、隐私、服务端环境、备案流程与存档责任 |
| 0.6 | 根据真实主体和后台确认广告准入，准备真实测试玩家或游戏圈路径 |
| 0.7～0.8 | 确认榜单范围、地区规则、官网公开信息和历史数据备份 |
| 0.9 | 按平台要求完成公开测试／发布材料与实际审核 |
| 1.0 | 用真实玩家数据调整玩法和收益，处理反馈与故障 |

这些事项可以与开发交错推进；它们不是每个版本完成后才开始的额外阶段。备案和平台审批时效由实际流程决定，本文不承诺固定开发天数。

---

## 17. 给开发 Agent 的执行约束

1. 本文是计划，具体版本在用户授权后实施；不自动连续执行到 1.0。
2. 使用新项目思路，DSH 3D 路线继续；旧 Godot 和 2D 页面不构成正式前端约束，MIMO 目录隔离。
3. 每版先明确目标和影响范围，交付可试玩结果，再按该版条件验收。
4. 数值采用明确公式和配置；参数调整有版本记录，禁止只凭显示字符串推算账务。
5. 与该版一起完成必要异常状态、存档处理和迁移，不把资产问题留到发布前。
6. 原型数据、受控测试和正式数据区分；公开保留进度的承诺必须兑现。
7. 连续寻访的校验不改变已确认的无限普通点击玩法。
8. 不能用广告门槛、后台暂停或服务器优化变相设置离线基础收益上限。
9. 微信好友关系链按开放数据域实现；自有榜单和官网快照按自己的数据规则管理。
10. 本文注明的推荐统计口径和地区层级，在对应阶段先定稿，避免实现者自行作出产品决定。

## 18. 参考资料

- 本项目《我要当市长-游戏企划书.md》：升级项目、数值公式、离线收益与既有首版范围。
- 本项目《我要当市长-开发路线调研-2026-10-06.md》：微信首发与引擎建议、主体、广告和发布条件。
- [微信小游戏接入指南](https://developers.weixin.qq.com/minigame/introduction/guide)：发布流程与并行环节。
- [微信广告开通条件](https://developers.weixin.qq.com/minigame/introduction/commercialization/ad)：广告资格与开通路径。
- [微信好友排行榜开发指南](https://developers.weixin.qq.com/minigame/dev/guide/open-ability/ranklist)：好友分数与开放数据域。

政策以实施时的官方规则及实际后台为准；本文的开发顺序不代表已获得平台准入或已开始工程验证。
