# 叫我大岛主 0.2.1 · 交付说明（给不懂技术的人看）

> 这份说明只讲一件事：**四个压缩包分别是干什么的、你该用哪个、怎么打开**。
> 所有带「本机实测」字样的内容，都是在这台电脑上真跑过命令、真看到结果才写的；
> 没跑过的一律写「未验证」，不猜、不编。

---

## 一、四个包分别是什么、给谁用

四个包都是同一款游戏《叫我大岛主 0.2.1》，区别只有两点：**跑在哪儿**（微信小游戏 / 浏览器网页）和**是不是测试版**。

| 压缩包文件名 | 里面是什么 | 给谁用 |
| --- | --- | --- |
| 叫我大岛主-0.2.1-**微信-正式包**.zip | 微信小游戏的**正式版**工程文件 | 给玩家、给真机试玩；要体验"真实手感"就用它 |
| 叫我大岛主-0.2.1-**微信-内部包**.zip | 微信小游戏的**内部测试版**工程文件，多一个调试面板 | 给自己人测试：要买满岛、跳时间、测数据用它 |
| 叫我大岛主-0.2.1-**网页-正式包**.zip | 浏览器里玩的**正式版** | 在电脑（笔记本）浏览器里直接体验，不用装微信开发者工具 |
| 叫我大岛主-0.2.1-**网页-内部包**.zip | 浏览器里玩的**内部测试版**，多一个调试面板 | 在浏览器里快速测数据、试买岛 |

一句话记法：**带「内部」两个字的 = 测试用，带「正式」两个字的 = 体验用；「微信」= 小游戏工程，「网页」= 浏览器。**

解压后里面到底有什么（本机实测，`unzip -l` 与解压后目录一致）：

- 微信两个包，解压后根目录 4 个文件：`game.js`、`game.json`、`project.config.json`、`MANIFEST.json`
- 网页两个包，解压后根目录：`index.html`、`assets/`（里面是 `main-xxxxxxxxxx.js`）、`MANIFEST.json`

压缩包里**没有**多余的外层文件夹，解压出来就是这些文件本身（这一点很重要，导入微信开发者工具时要用到）。

---

## 二、我该装哪个？

- **只想体验真实手感（看看画面、点点看顺不顺）** → 装 / 打开**正式包**。
  正式包跟线上要发的那版程序一致，数字和节奏都是真的。
- **想买满岛、想测数据（把金币拉满、把岛全买下、快进时间）** → 用**内部包**。
  内部包比正式包多一个调试面板（左上角「调试 ▼」按钮，点开是一排按钮）：
  `+100 金币`、`+10000 金币`、`+1 亿金币`、`+10 亿金币`、`快进 10 分`、`快进 1 小时`、`重置新游戏`、`读档重载`。
  **要一口气把岛买满，请按「+1 亿金币」或「+10 亿金币」这两个按钮，不要按「+10000 金币」**——后者只加一万，对买满岛来说是杯水车薪，按到手酸也不够。
- **两个包的存档不要混用。**
  正式包和内部包用的是各自的存档，互相之间不通用。别把内部包玩出来的"满岛存档"当成正式包的进度，也别拿内部包的存档去判断正式版的数值平衡。

---

## 三、微信包怎么导入（微信开发者工具）

> ⚠️ **先说结论**：这一节的操作步骤是**按标准流程写的**，但**本机是 Linux 服务器、没有安装微信开发者工具**，
> 所以「导入之后能不能编译成功、能不能预览」这一条**未验证（本机无微信开发者工具）**。
> 我在本机能做的校验只有：**解压后的工程结构、工程名、AppID 字段是否写对**（见下面「已校验」）。

操作步骤：

1. 把 `叫我大岛主-0.2.1-微信-正式包.zip`（或内部包）**解压**到一个文件夹，例如 `D:\wyszz-0.2.1\`。
   解压后这个文件夹里应该直接看到 `game.js`、`game.json`、`project.config.json`、`MANIFEST.json`。
2. 打开**微信开发者工具** → 点「**导入项目**」（有的版本叫「+ 导入」）。
3. **目录选刚才解压出来的那个文件夹，不是 zip 压缩包本身**。
   这是最常见的踩坑点：选 zip 文件会提示找不到工程。
4. 导入后，工具里显示的**工程名**应该是：
   - 正式包：`wyszz-island-0.2.1`
   - 内部包：`wyszz-island-0.2.1-internal`
5. **AppID** 选「**游客模式**」，或直接填 `touristappid`（配置里写的就是这个）。游客模式只能在本机模拟器里跑，不能上传发布，这正合我们的用途。
6. 点「**编译**」，再点「**预览**」看效果。

**已校验（本机实测，看的是包里的配置文件）**：

- 两个微信包解压后根目录都是 4 个文件（`game.js` / `game.json` / `project.config.json` / `MANIFEST.json`）。
- `project.config.json` 里的实际取值：
  - 正式包：`"projectname": "wyszz-island-0.2.1"`、`"appid": "touristappid"`、`"compileType": "game"`
  - 内部包：`"projectname": "wyszz-island-0.2.1-internal"`、`"appid": "touristappid"`、`"compileType": "game"`
- `game.json` 内容为竖屏（`deviceOrientation: portrait`），符合手机小游戏的形态。

**未验证**：微信开发者工具里的导入、编译、模拟器运行、预览二维码、真机表现 —— 本机没有这个工具，也没有微信手机端，全部没跑过。

---

## 四、笔记本上怎么打开网页包（**本机已实测**）

### 4.1 直接复制这段命令（Linux / macOS 通用）

```bash
# 第 1 步：把网页-正式包解压到一个全新目录
mkdir -p /tmp/g07-web
unzip -q "/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/G-07/叫我大岛主-0.2.1-网页-正式包.zip" -d /tmp/g07-web

# 第 2 步：进到解压目录，起一个"本机小服务器"（这个窗口别关）
cd /tmp/g07-web
python3 -m http.server 8123 --bind 127.0.0.1

# 第 3 步：浏览器里打开下面这个网址
#   http://127.0.0.1:8123/
```

第 2 步不想用 python 的话，用 Node 的 serve 也可以（**本机也已实测**）：

```bash
cd /tmp/g07-web
npx --yes serve -l 8125
# 然后浏览器打开 http://127.0.0.1:8125/
```

> 换成 Windows 的电脑：把路径换成你解压出来的文件夹（例如 `cd D:\wyszz-web`），命令照抄即可；没装 python 就用上面的 `npx serve` 那条。
> 网页-内部包同理，只要把 zip 文件名换成 `叫我大岛主-0.2.1-网页-内部包.zip` 即可。

### 4.2 本机实测记录（原样摘录）

**(a) 用 python 起服务器，确认首页返回 200：**

```
$ python3 -m http.server 8123 --bind 127.0.0.1
$ curl -sI http://127.0.0.1:8123/
HTTP/1.0 200 OK
Server: SimpleHTTP/0.6 Python/3.11.2
Content-type: text/html
Content-Length: 721
```

**(b) 确认返回的确实是游戏页面（不是目录列表）：**

```
$ curl -s http://127.0.0.1:8123/ | head
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no,viewport-fit=cover">
<meta name="theme-color" content="#bfe3f2">
<title>我要当岛主 0.2.1</title>
```

**(c) 用本机 headless Chromium（Chromium 154）真正打开 `http://127.0.0.1:8123/`，结果：**

- 页面标题：`我要当岛主 0.2.1`
- 游戏画布 canvas 存在，尺寸 `800x600`，WebGL 可用（`webgl: true`）
- **控制台报错 0 条**，游戏自身启动日志（`[fingerprint]`/`[fingerprint02]`）13 行，末行 `[fingerprint02] all OK`
- 截图确认：岛屿、市政厅、金币数、底部「升级市政厅」按钮全部正常渲染

**(d) 直接双击 `index.html`（也就是 `file://` 方式），结果：游戏起不来。**
实测报错原文：

```
Access to script at 'file:///tmp/g07-doc/web/assets/main-0ff6c33332.js' from origin 'null'
has been blocked by CORS policy: Cross origin requests are only supported for protocol
schemes:（浏览器只放行 http、https、data 等少数几种协议，file 不在其中）
file:///tmp/g07-doc/web/assets/main-0ff6c33332.js :: net::ERR_FAILED
```

（上面第二行括号里那句是我对原文协议清单的转述；报错原文只多列了几个浏览器内部协议名，与游戏无关。）

- 游戏启动日志 **0 行**，canvas 停在浏览器默认的 `300x150`（说明游戏根本没跑起来）。

### 4.3 两种打开方式对比（本机实测结论）

| 打开方式 | 能不能玩 | 本机实测结果 |
| --- | --- | --- |
| 起本机小服务器，用 `http://127.0.0.1:8123/` 打开 | ✅ 能玩 | 返回 200；控制台 0 报错；游戏正常渲染 |
| 直接双击 `index.html`（`file://`） | ❌ 打不开 | 被浏览器安全策略拦下：脚本加载报 CORS 错，游戏 0 启动日志 |

**所以：网页包一定要用第 4.1 节的方式（起服务器 + 用 `http://127.0.0.1:端口/` 打开），不要双击 `index.html`。**

### 4.4 顺手验证了内部包确实"更好用"（本机实测）

用同样的方式打开**网页-内部包**，实测：

- 右上角有红色条「**内部测试包 0.2.1**」，正式包**没有**这条红条。
- 左上角有「调试 ▼」按钮，点开后按钮文案与包内实现一致：
  `+100 金币`、`+10000 金币`、`+1 亿金币`、`+10 亿金币`、`快进 10 分`、`快进 1 小时`、`重置新游戏`、`读档重载`。
- 点了一下「+1 亿金币」：金币从 `61.5` 变成 `100,000,061.5`，按钮按预期生效，全程 0 报错。

---

## 五、四个包的大小与指纹（sha256，**本机实测**）

`sha256` 你可以理解成文件的"指纹"：文件只要被改动一个字节，这串字符就会完全不同。
收文件后想确认没被改坏、没下错，就对一下这串字符。

| 压缩包 | 大小（人类可读） | 大小（字节） | sha256（本机实测） |
| --- | --- | --- | --- |
| 叫我大岛主-0.2.1-微信-正式包.zip | 约 179.6 KiB（180K） | 183896 | `5bbb1c163469548cee9dbb3e9a14ea551f6120b04434cc371a52669c8dc71a2b` |
| 叫我大岛主-0.2.1-微信-内部包.zip | 约 183.5 KiB（184K） | 187819 | `fed04b180b895df1a0f5dda305c513db28911a6e26b432405aa182184044fdd5` |
| 叫我大岛主-0.2.1-网页-正式包.zip | 约 178.3 KiB（179K） | 182492 | `0ff5902f2e71ea04acd67722612c062cda61a728974284dbc2658f1b62ae676b` |
| 叫我大岛主-0.2.1-网页-内部包.zip | 约 182.3 KiB（183K） | 186612 | `1acccb45e2607b88a1d0488e2b92036919cd4d174692ba2228385f12e93e8b1b` |

自己复核的命令（把目录换成你放 zip 的地方）：

```bash
cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/G-07
sha256sum *.zip
stat -c '%n %s' *.zip
```

实测输出（与本表逐字一致）：

```
fed04b180b895df1a0f5dda305c513db28911a6e26b432405aa182184044fdd5  叫我大岛主-0.2.1-微信-内部包.zip
5bbb1c163469548cee9dbb3e9a14ea551f6120b04434cc371a52669c8dc71a2b  叫我大岛主-0.2.1-微信-正式包.zip
1acccb45e2607b88a1d0488e2b92036919cd4d174692ba2228385f12e93e8b1b  叫我大岛主-0.2.1-网页-内部包.zip
0ff5902f2e71ea04acd67722612c062cda61a728974284dbc2658f1b62ae676b  叫我大岛主-0.2.1-网页-正式包.zip
```

（这 4 个 zip 也都通过了打包时的解压复校：解压后与源目录逐字节一致，4/4 PASS，详见 `verify/G-07.2-清单.txt`。）

---

## 六、一句提醒

**内部包**里有「调试 ▼」调试面板，右上角还有一条红色的「**内部测试包 0.2.1**」——看到这条红条就说明你开的是测试版，别拿它当正式版发给别人。
**正式包**在启动时会校验自己的程序文件；万一文件被改坏、被替换，它会显示「**程序文件校验失败**」并**拒绝启动**（正常安装的情况下你不会看到这句话；看到就说明包坏了，重新解压一份即可）。

---

## 七、未验证清单（没实测过的东西，全部列在这里）

| 项目 | 状态 | 说明 |
| --- | --- | --- |
| 微信开发者工具「导入项目」能否成功 | **未验证（本机无微信开发者工具）** | 本机是 Linux 服务器，没装该工具，也没法装 |
| 微信包导入后能否编译通过 | **未验证（本机无微信开发者工具）** | 同上；只校验了工程结构与 `project.config.json` 字段 |
| 微信开发者工具模拟器里的实际运行效果 | **未验证（本机无微信开发者工具）** | 同上 |
| 「预览」二维码 / 手机真机试玩 | **未验证（无微信手机端）** | 真机手感、触屏操作、性能都需你在手机上实测 |
| 微信开发者工具里「游客模式」按钮的确切文案与点击路径 | **未验证** | 不同版本界面略有差异，本文按标准流程描述 |
| 网页包在**其它浏览器**（Windows/Mac 上的 Chrome、Edge、Safari、Firefox）里的表现 | **未验证** | 本机只用 headless Chromium 154 实测过；其它浏览器未测 |
| 网页包在**真实手机浏览器**上的表现与触屏手感 | **未验证** | 只测了桌面端 headless 渲染 |
| `file://` 在其它浏览器里是否同样打不开 | **未验证** | 只在 Chromium 154 实测到 CORS 拦截；其它浏览器未测（但建议一律用 `http://`） |
| 两个包之间存档能否迁移 / 混用 | **未验证** | 未做迁移测试；按设计不建议混用 |
| 微信包与网页包的**玩法数值是否完全一致** | **未验证** | 只确认了两者来自同一版本号 0.2.1，未逐项比对数值 |
| 内部包调试面板**每一个**按钮的效果 | 部分验证 | 已验证面板可打开、按钮文案齐全、「+1 亿金币」点击后金币由 61.5 变为 100,000,061.5；其余按钮（+100 / +10000 / +10 亿 / 快进 / 重置 / 读档重载）未逐个点击验证 |
| 微信包的调试面板长什么样 | **未验证** | 仅在网页-内部包上实测；微信内部包的同一面板未在开发者工具里打开过 |

---

*本文档中「本机实测」的项目，均可用上文给出的命令在本机复现。*
