# 《叫我大岛主》0.2.1 手机验收清单（含总监补充说明）

> 本文件 = 总监补充说明（在前） + S-09.D 原验收手册全文（在后，未删改）。
> 原手册里的「买满岛不现实」「改坏文件只弹红字」两条已被本轮改动覆盖，以本页补充说明为准。

## 补充说明（总监）

1. **内部包调试面板已新增两个按钮：「+1 亿金币」「+10 亿金币」。**
   想买满岛就用这两个，**不要再按 `+10000`**（按两万多次不现实）。
   已实测确认：内部包（`dist/wechat-internal/game.js`、`dist/web-internal/assets/main-fbd6e0350d.js`）里确实存在「+1 亿金币」「+10 亿金币」两个按钮文案。
2. **原清单里写的「买满岛需约 2.32 亿金币、按 +10000 不现实」已过时**，请忽略那一段（原清单第 8 项 ⚠️ 段落与文末待决 D-D1）。现在点两下就能买满岛。
3. **正式包若程序文件被改坏，会「拒绝启动」并显示「程序文件校验失败」**（正常情况看不到这行字）。
   已实测确认：正式包（`dist/wechat/game.js`、`dist/web/assets/main-0ff6c33332.js`）里存在「程序文件校验失败」「拒绝启动」文案。
   这条覆盖了原清单文末待决 **D-D2**（原行为是「只弹红字、照常运行」）。
4. **满岛时镜头左右余量只有约 9~17px，偏紧**。请在手机上记录：岛的最左/最右边缘是否看得全、有没有被裁掉。
5. **请记录：手机型号、微信版本、满岛时的 FPS 和 draw calls**（内部包调试面板上能直接读到）。原清单记录表里的「手机型号+系统」请补上「微信版本」。
6. **内部包只用于测试**（有调试面板，屏幕右上角有「内部测试包 0.2.1」红条）；**正式包用于看真实手感**。**两个包的存档不要混用**。

### 本轮口径提示（不影响你操作）
- 「买满岛」现在走内部包 + 「+10 亿金币」按钮；正式包仍然没有任何加金币入口（这是设计要求）。
- 原清单第 8 项正文里「面板上有 6 个按钮」的描述已过时，现在按钮更多（含上述两个「亿」按钮）。

---

# S-09.D 报告 — 《叫我大岛主》0.2.1 手机验收手册（给不写代码的人）

> **这份手册是什么**：0.2.1 这一版改了什么、你要在手机上亲自试哪些东西、每样东西「应该看到什么」、看到不对时怎么记下来发给我。
> **最重要的一句话**：下面**没有任何一项**已经在真机上验证过。之前所有验收都是在**电脑上**用「软件渲染的浏览器」跑出来的（相当于用 CPU 画图，不是手机的 GPU），所以**手机上的手感、帧率、发热必须由你亲自试**。电脑上的帧率数字只能当参考，不能当手机成绩。
>
> 本轮电脑端验收结论：**没有阻断项**（可以交给你做手机验收）。已知需要注意的两条：①电脑端无法证明手机表现；②把程序改坏 1 个字节时，游戏只是弹红字提醒、**不会停止运行**（详见文末「待决」）。

---

## 一、先分清两个包，别装错

0.2.1 会给你**两个包**，玩法完全一样，区别只在「有没有测试用的开关」：

| | **正式包**（给别人玩、日常用这个） | **内部包**（你自己测试用） |
| --- | --- | --- |
| 网页版目录 | `dist/web/` | `dist/web-internal/` |
| 微信版目录 | `dist/wechat/` | `dist/wechat-internal/` |
| 一眼认出它的方法 | 屏幕上**没有**任何红条、没有「调试」小按钮 | 屏幕**右上角有一条红色横幅「内部测试包 0.2.1」**，左上角有一个「调试 ▼」小按钮 |
| 微信工程名 | `wyszz-island-0.2.1` | `wyszz-island-0.2.1-internal` |
| 有没有加金币/快进 | 没有（我实测过：用网址参数也塞不进去） | 有（第 8 项会用到） |

**结论：**
- **正式验收（第 1–7、9 项）→ 用正式包**（微信版 `dist/wechat`，或网页版 `dist/web`）。
- **第 8 项（调试面板、满岛帧率）→ 只能用内部包**。
- 看到红条 = 内部包；看不到红条 = 正式包。这是最快的判断方法。

---

## 二、怎么把它跑起来（两种方式，选一种）

**方式 A：微信开发者工具（最接近真机，推荐）**
1. 打开「微信开发者工具」→ 新建/导入**小游戏**项目。
2. 目录选到 `dist/wechat`（正式）或 `dist/wechat-internal`（内部）。
3. AppID 用「**游客模式 / touristappid**」（工程里已经写好，不要改成你自己的 AppID）。
4. 点「编译」即可看到画面；点右上角「预览」用手机扫码，就能在**真机**上试。

**方式 B：手机浏览器（最省事）**
1. 在电脑上进入工程目录，运行：`HOST=0.0.0.0 PORT=5320 node tools/serve-preview.mjs`
   （注意：默认只允许本机访问，所以**必须**加 `HOST=0.0.0.0` 手机才连得上）
2. 手机浏览器打开 `http://<电脑的局域网IP>:5320/frontend-rebuild/`
3. 内部包要改成：`WEB_ROOT=dist/web-internal HOST=0.0.0.0 PORT=5320 node tools/serve-preview.mjs`，网址后面加 `?debug=1`。
4. 已知小坑：正式对外网址（公网预览）目前是 404，属于历史遗留，**不影响**你用上面两种方式验收。

---

## 三、逐项检查（每项都是「动作 → 预期 → 不对怎么记」）

### 第 1 项 · 顶部那两行数字还压不压在一起（这一版最关键的修复）

**为什么要试**：你在真机上发过一张截图，**「声望 236」那张卡片压住了金币数字**，金币只露出「1,0…」，每分钟收益也被压住了。
**动作**：用正式包打开游戏，让顶部两行数字都出现（金币、每分钟收益、声望、可用、寻访），**横屏竖屏各试一次**（手机转一下屏）。
**预期**：两张卡片**左右分开、谁也不压谁**；金币数字**完整**（例如「1,022.8」一位不少）；左边卡片里的字不跑到卡片外面；顶部不顶到手机刘海/状态栏。
**不对时怎么记**：截一张**整屏**图（要能看见顶部数字），在图上圈出重叠的地方，并写一句：「哪几个数字压在一起 / 哪个数字看不全 / 手机型号 + 系统版本」。电脑端我实测过同样的数字组合（Lv28、1,022.8、236、可用 236·寻访 236）在 320/360/414 三种宽度下都不重叠，**但手机上字体不同，必须你亲眼确认**。

### 第 2 项 · 右上角胶囊（微信的「···」圆按钮）有没有压住卡片

**动作**：在**微信**里打开（胶囊只存在于微信），看右上角胶囊与顶部卡片、和报价卡的关系。
**预期**：胶囊**不要压住**任何卡片和数字。这一项**只记录、不算错**——因为胶囊的位置和大小每台手机都不一样，我手上没有你手机的准确数据。
**不对时怎么记**：截图 + 写「胶囊压住了什么」。

### 第 3 项 · 新游戏开局：7 块地、空地看着能买、点一下出报价

**动作**：用正式包，**清掉存档**开新游戏（内部包有「重置新游戏」按钮；正式包可先删掉游戏再重进）。数一数：
- 中间那圈**已拥有**的地是不是 **7 块**（中心 1 块 + 周围 6 块）；
- 外圈是不是有一圈**颜色不同的「空地」标记**（候选地）；
- **点一下**其中一块空地。
**预期**：点空地后，屏幕下方（或地块旁边）出现一张**报价卡**，写着「价格 N 金币」和「买后每分钟 +X」，还有一个「购买」按钮。**点下去的那一刻不会直接买**（防误触，见第 6 项）。
**不对时怎么记**：截图 + 写「我数到几块已拥有 / 几块空地」「点空地没反应」或「点一下就买掉了」。

### 第 4 项 · 报价卡上的数字对不对、点别处能不能取消、钱不够是什么样

**动作**：
1. 点一块空地，看报价卡上的「价格」和「买后每分钟 +X」。
2. **点屏幕别的地方**（不是那块地、也不是按钮）。
3. 把钱花到不够（连买几块），再点一块贵的空地。
**预期**：
- 报价卡上**只有价格和「买后每分钟 +X」**，**不会**提前告诉你这块地是什么类型（住宅/商业/绿化），也**不显示「多久回本」**（这是设计决定，不是漏了）；
- 点别处 → 报价卡**消失**，不会买；
- 钱不够 → 报价卡上的价格**变红**、并出现「**金币不足**」字样，点「购买」**买不成**。
**不对时怎么记**：把报价卡截图，写出你看到的**全部文字**（我要逐字核对），以及「点别处还留着卡片」「钱不够居然买成了」。

### 第 5 项 · 买地的手感：再点一次才成交、「砰」一下冒烟、收入立刻变多

**动作**：点一块空地出现报价卡 → **再点同一块地一次**（或点报价卡上的「购买」）。
**预期**：
- 地**买下来**了：空地被替换成有内容的地块（街区/道路/树等）；
- 成交时冒出**一小团烟**（约 0.6 秒后消失，不要一直冒）；
- 顶部的「每分钟」收益**立刻变大**，同时旁边短暂出现一个「+X/分」的提示；
- 金币**精确减少**报价卡上的数字。
**不对时怎么记**：连拍两张截图（买之前 / 买之后）+ 写「金币前后各是多少」「有没有烟」「每分钟有没有变」。

### 第 6 项 · 250 毫秒防误触：手快会不会买错

**为什么要试**：这是防止你**手抖点两下就误买**的机制。
**动作**：点空地出报价卡后，**飞快**再点同一块地一下（要快，尽量在 0.25 秒内）。
**预期**：太快的那一下**不成交**（只当「选中」），你需要**慢一点点**再点一次才会买到。感觉上就是「点两下要有个小停顿」。
**不对时怎么记**：写「我连点两下就买掉了」或「点了几次都不买」。电脑端我实测过：249 毫秒不成交、**正好 250 毫秒才成交**，但**手感是主观的，只有你能判断快慢合不合适**。

### 第 7 项 · 买很多块以后：岛会不会变大、镜头会不会拉远、会不会看不全

**动作**：尽量多买几块（正式包靠正常玩，内部包可以先用第 8 项的加金币），买到十几二十块，转一转视角。
**预期**：岛**越铺越大**，镜头**自动往后退**，整个岛**始终完整在屏幕里**（不会跑到屏幕外看不见），也不会出现地块之间裂开、互相穿模。
**不对时怎么记**：截图 + 写「哪一块跑出屏幕了 / 哪里裂开了 / 哪里穿模了」。

### 第 8 项 · 内部包调试面板：加金币、快进、看帧率（含「买满岛」的实话）

**动作**：
1. 用**内部包**打开（网页版网址要带 `?debug=1`），左上角有一个「**调试 ▼**」小按钮，点它展开。
2. 面板上有 6 个按钮：`+100 金币`、`+10000 金币`、`快进 10 分`、`快进 1 小时`、`重置新游戏`、`读档重载`；下面还有读数：`FPS`、`draw calls · tri`、`已拥有地块`、`选中`、报价、写档状态。
3. 点几下 `+10000 金币`，再点「快进 1 小时」，看读数有没有跟着变。
4. **尽量多买地**，然后记录：面板上的 **FPS**、**draw calls**、**tri**，以及「已拥有地块」的数量。

**⚠️ 关于「买满岛」必须先说实话（我算过账）**：
- 把 85 块地**全部买满，总共要约 2.32 亿金币**（电脑端实测：5,000,000,045 → 4,767,907,412）。
- 调试面板一次只给 `+10000 金币`，要按 **约 23,210 次**才够——**手机上一次一次点是不现实的**。
- 买 **21 块**大约需要 **15.3 万金币**（约点 16 次 `+10000`），这是**现实可做的**。
- **所以**：请把第 8 项做成「**买到十几二十块，记录 FPS/draw calls**」，并明确写清你买到几块。**不要**为了凑满岛去点两万多次。如果你确实需要「一键满岛」，见文末待决清单（建议加一个 `+1 亿金币` 或「直接铺满」按钮）。

**预期**：读数随游戏变化；`FPS` 旁边本来就标着「软件渲染不代表手机」，手机上读数才是真数据。
**不对时怎么记**：截图（要拍到面板和读数）+ 写「按了没反应 / 读数不动 / 数字是多少」。

### 第 9 项 · 杀掉进程重开，进度还在吗；老存档还能不能用

**动作**：
1. 玩一会儿（买几块地、升几级），**完全退出**游戏（微信里：从后台列表划掉；浏览器里：关标签页/清掉页面）。
2. 重新打开。
3. **老存档迁移**：如果你手上有**旧版本（0.1 / 0.2.0）的存档**，用新版打开它。
**预期**：重开后**金币、等级、已买的地、声望都在**（不是从新游戏开始）。旧存档打开后**自动升级并恢复**，会提示「存档已升级并恢复」，进度不丢。
**不对时怎么记**：写「重开后变成了新游戏（金币 60）」「提示存档损坏」「旧存档打开后进度不对」，并说明是哪个版本存下来的。

### 第 10 项 · 再确认一次你装的是哪个包

**动作**：看你装的目录和屏幕。
**预期**：正式验收用**正式包**（无红条、工程名 `wyszz-island-0.2.1`）；只有第 8 项用**内部包**（红条「内部测试包 0.2.1」、工程名带 `-internal`）。
**不对时怎么记**：写「我装的是哪个目录 / 屏幕上有没有红条」。

---

## 四、记录表（照着填，回头发给我）

| 项 | 动作做完了吗 | 结果（正常/不正常） | 我看到的实际样子 | 截图文件名 | 手机型号+系统 |
| --- | --- | --- | --- | --- | --- |
| 1 顶部不叠压 | | | | | |
| 2 胶囊 | | | | | |
| 3 开局 7 块/空地/报价 | | | | | |
| 4 报价卡/取消/钱不够 | | | | | |
| 5 买地/烟/收入 | | | | | |
| 6 250ms 手感 | | | | | |
| 7 买很多块/镜头 | | | | | |
| 8 调试面板（买到几块：___；FPS：___；draw calls：___；tri：___） | | | | | |
| 9 重开存档/老存档迁移 | | | | | |
| 10 包识别 | | | | | |

**记录小要求**（不然我判断不了）：①截图要**整屏**、别裁掉顶部；②写清**数字**（金币前后各多少、买到几块）；③写清**手机型号和系统版本**；④同一问题连拍两张（发生前 / 发生后）。

---

## 五、这份手册的边界（未验证清单）

1. **真机表现全部未验证**：帧率、发热、手感、微信里的真实胶囊位置、阴影/光照观感——**没有任何一项**在本轮电脑验收中被验证。
2. 电脑端的所有画面/帧率结论来自 **headless Chromium + SwiftShader 软件渲染**，且游戏在软件渲染下会自动降级（关阴影精度、像素比 1），**与手机 GPU 完全不是一回事**。
3. 250 毫秒只验证了「249 不成交 / 250 成交」这个数值边界，**手感**必须真人判断。
4. 满岛（85 块）在电脑端跑通过（43 个 draw call、108,132 个三角形，冒烟峰值 55），**但手机上买到满岛的帧率无人验证**，且调试面板按不出那么多金币（见第 8 项）。
5. 微信「预览」扫码后的真机表现、微信开发者工具模拟器，本轮都未运行。
6. 旧存档迁移只验证了电脑端的 0.1 夹具（20 个场景 32 个用例全过）；**真机上你手上的那份旧存档**未验证。

## 待决清单（要你或实现方定）

| 编号 | 待决事项 | 建议 |
| --- | --- | --- |
| D-D1 | 调试面板按不出「买满岛」所需金币（约 2.32 亿，需约 23,210 次 +10000） | 加一个 `+1 亿金币` 或「直接铺满 85 块」按钮；否则第 8 项只能按「买到十几二十块」执行 |
| D-D2 | 把程序改坏 1 个字节时，只弹红字「程序完整性自检未通过」，**游戏照常运行**（不是「拒绝启动」） | 确认是否要改成「直接停住不让玩」 |
| D-D3 | 胶囊与卡片的间距标准（电脑端按「卡片与胶囊外扩 8 像素不相交」判的，这个 8 像素是自定值，官方没有规定） | 真机上量一次胶囊位置，定成正式标准 |
| D-D4 | 满岛时远处那圈「淡轮廓」和岛角被裁的 6 个角，R4 文档里仍标着「待决」 | 定下来画不画 |
