# 《叫我大岛主》0.2.3-pre 交付说明（给不懂技术的同学）

> 这份说明只讲**怎么把包打开、怎么装到手机上**，不涉及验收结论。
> 版本：**0.2.3-pre**。四个包的 appid 都是 `touristappid`。
> 凡是本文写「未验证」的地方，就是**我们还没在这条路径上实测过**，请以你本机实测为准，不要当成已经可用。

---

## 一、四个包分别是什么、你该装哪个

| 包 | 文件名 | 用来干什么 | 装在哪 |
| --- | --- | --- | --- |
| **微信正式包** | `叫我大岛主-0.2.3-pre-微信-正式包.zip` | 给**玩家**体验的版本：没有调试面板、没有加金币入口、没有真机报告 | 手机微信里玩 |
| **微信内部包** | `叫我大岛主-0.2.3-pre-微信-内部包.zip` | 做**重负载**测试（+1 亿 / +10 亿金币、三类满级）和出**真机报告** | 手机微信里玩 |
| **网页正式包** | `叫我大岛主-0.2.3-pre-网页-正式包.zip` | 在**笔记本**浏览器上看手感，和正式包同逻辑 | 电脑浏览器 |
| **网页内部包** | `叫我大岛主-0.2.3-pre-网页-内部包.zip` | 在**笔记本**上做重负载（调试按钮同内部包） | 电脑浏览器 |

**该装哪个，一句话说清：**

- **要测玩家真实体验** → 微信**正式包**。
- **要测满岛满级、要看真机报告** → 微信**内部包**。
- **只想在笔记本上先摸一下手感** → 网页**正式包**（或网页内部包）。
- 工程名：微信正式包是 `wyszz-island-0.2.3-pre`，微信内部包是 `wyszz-island-0.2.3-pre-internal`。

> 四个包**不要同时装进同一个微信**做验收：0.2.1 / 0.2.2 / 0.2.3-pre **共用同一个存档命名空间**，同时装会**互相覆盖存档**。要对照，请一次只装一个。

---

## 二、微信包怎么导入微信开发者工具

### 第 1 步：解压

把 zip **解压**出来。解压后的目录里**直接就是**这几个文件：

```
game.js
game.json
project.config.json
（以及其它资源文件）
```

**注意：没有外面多套一层目录。** 所以导入时选的就是**解压出来的那个目录本身**，不要再往里点一层。

### 第 2 步：导入

1. 打开**微信开发者工具** → 「小程序 / 小游戏」→ **导入项目**。
2. 目录选**解压出来的那个目录**（里面能直接看到 `game.js` / `game.json` / `project.config.json`）。
3. AppID 先按默认走（见下一条），点确定。

### 第 3 步：【重要】换成你自己的 AppID，才能生成手机能打开的预览码

**四个包的 appid 都是 `touristappid`（游客 appid）。** 用游客 appid **没法生成能在手机上打开的预览码**。

要生成手机能扫的预览码，**必须在开发者工具里把 AppID 换成你自己的小游戏 AppID**：

- 方法一：导入项目时 / 项目设置里，把 **AppID 填成你自己的小游戏 AppID**；
- 方法二：直接用文本编辑器打开 `project.config.json`，把里面的 **`appid` 字段**改成你自己的小游戏 AppID。

**改完之后，MANIFEST 不再匹配属正常现象**，**不影响运行**，不用管它、也不用去修。

### 第 4 步：上手机

改好 AppID 后，用开发者工具的 **「预览」** 生成二维码 → 用**手机微信扫码**打开。

---

## 三、在无 3D 加速的虚拟机里用开发者工具（此路径未验证）

如果你的电脑是**虚拟机**（比如 Windows Server），显卡只有 **「基本显示适配器」**（没有 3D 加速）：

- 开发者工具里的**模拟器可能无法显示 3D 画面**（可能黑屏 / 白屏 / 画面出不来）。这是显卡能力问题，不一定是包的问题。
- 可以尝试：**跳过模拟器，直接用「预览」生成二维码，用手机扫码打开**，在真机上看画面。

> ⚠️ **此路径我们未验证。** 上面这条「直接用预览、手机扫码」的做法，我们没有在无 3D 加速的虚拟机里实测过，**请以你本机实测为准**。如果模拟器黑屏，先按这个方向试；不行就换一台有 3D 加速的电脑。

---

## 四、笔记本上怎么打开网页包

### 【重要】不要双击 `index.html`

**直接双击 `index.html` 打开是打不开的**（浏览器会拦本地文件的一些功能），**必须起一个本机静态服务器**。

### 我们实测过的那一条命令

1. 把网页包的 zip **解压**出来，打开终端（命令行），**进入解压出来的那个目录**。
2. 执行：

   ```bash
   python3 -m http.server 8137
   ```

3. 然后打开浏览器，访问：

   ```
   http://127.0.0.1:8137/
   ```

> ✅ **这条命令（含 8137 端口）已由 G-09 实测验证通过**：解压出的网页正式包里，`index.html` 与 `assets/main-16edd7c59f.js` 都返回 HTTP 200，且拿到的 sha256 与包内 MANIFEST 记录的**逐字节一致**。
> 停止服务器：在终端里按 `Ctrl + C`。
> **端口可以随便换**：把命令和网址里的 `8137` 同时改成别的数字即可（例如 `8080`、`8081`）。⚠️ 我们这台机器上 **8080 已被另一个服务占用**（访问会返回 401），所以实测用的是 8137；你本机哪个端口空着就用哪个，**换端口这一动作我们未单独实测**。

**其它没写在这里的打开方式（比如双击 HTML、用别的服务器软件、别的命令），我们未验证**，请以你本机实测为准。

---

## 五、四个包的 sha256

> **下表由 G-09 在打包定稿后实测填入**（2026-10-18）。

| 包 | 文件名 | sha256 |
| --- | --- | --- |
| 微信正式包 | `叫我大岛主-0.2.3-pre-微信-正式包.zip` | `601a6bbc1858db83dbd10dd32b289fa74113494bde6c855d601de18e1744be1b` |
| 微信内部包 | `叫我大岛主-0.2.3-pre-微信-内部包.zip` | `b9dca500a95b68b33c4e3b4a69bfc34418f54d38cf00e2ccc466ad4c6ebbacf4` |
| 网页正式包 | `叫我大岛主-0.2.3-pre-网页-正式包.zip` | `6c45ffe71818a09b76909a414afe6a0acdba38cc84ccddb7922e7172d1e97db4` |
| 网页内部包 | `叫我大岛主-0.2.3-pre-网页-内部包.zip` | `b260d93449cde3beb53da3661716349ba2ceff825d8aa540e806e312ef2f8c67` |

（大小：微信正式包 194,465 字节 / 微信内部包 205,140 字节 / 网页正式包 192,713 字节 / 网页内部包 203,860 字节。）

**怎么用**：拿到 zip 后可以自己算一遍 sha256 对比（Windows 用 `certutil -hashfile 文件名 SHA256`，macOS / Linux 用 `shasum -a 256 文件名`），**对不上就不要装**。

---

## 六、0.2.3-pre 与 0.2.2 的区别（就这 6 条）

1. **街区升级失败时会显示深色底板浮字**（例如「还没有住宅街区」）。
2. **内部包调试面板新增「真机报告」按钮与刷新 / 复制路径**（面板上共 12 个调试按钮，其中「读档重载」用来重新读档刷新）。
3. **内部包新增「真机报告」按钮**。
4. **调试托盘给报告让位**（报告打开时不再压住报告）。
5. **报告面板间距调整**（不再贴边、不挤在一起）。
6. **失败浮字加了深色底板**（提高对比度，字更看得清）。

> 除了上面这 6 条，0.2.3-pre 与 0.2.2 **没有别的区别**。
> 另外两点请记住：
> - **存档格式没变**：0.2.1 / 0.2.2 / 0.2.3-pre **共用同一个存档命名空间**，**同时装会互相覆盖存档**，验收时只装一个版本。
> - **内部包的调试按钮里有 +1 亿 / +10 亿 金币**，用来快速到达重负载；**不要按 +10000**（太小，到不了重负载）。

---

## 附：常见问题

**Q：导入后提示 MANIFEST 不匹配 / 校验不过？**
A：因为你在第 3 步改了 AppID，**这是正常的，不影响运行**，忽略即可。

**Q：模拟器里 3D 画面出不来？**
A：见第三节。先确认是不是无 3D 加速的虚拟机；可以试「预览 → 手机扫码」，但**这条路径未验证**。

**Q：网页包双击 `index.html` 打不开？**
A：见第四节，**不要双击**，用 `python3 -m http.server 8137` 起服务器（端口可换成你本机空着的）。

**Q：正式包启动失败？**
A：正式包的程序文件如果被改坏，会**「拒绝启动」**，正常情况下你看不到。遇到就**截屏发回**，**不要自己修**。
