# S-07.D 用户验收清单草案(给笔记本"微信开发者工具"和真手机)

**声明**:下面每一条都是"请你去验证"的步骤。**没有任何一条已经在真机或微信开发者工具上通过**,我只在电脑里的模拟环境(Node 与软件渲染的 Chromium)验证过逻辑。凡我不确定能不能这样操作的,都标了"未验证"。

## 先看这个:该装哪个包?(第 7 条放前面,因为它决定你装什么)
| | 正式包 | 内部包 |
|---|---|---|
| 目录 | `frontend-rebuild-hm02/dist/wechat`(微信)、`dist/web`(网页) | `dist/wechat-internal`、`dist/web-internal` |
| 是什么 | 给玩家的版本,**没有**任何调试入口 | 给测试用,多了调试入口 |
| 调试入口(我看过代码) | 无 | 网页版地址后加 `?debug=1` 会出现一块"DEBUG ONLY"小面板(按钮:+1h、-1h、后台、前台、清档、损坏、重载)。**微信内部包没有任何可见的调试按钮** |
| 你应该装哪个 | **验收"新手玩家体验"一律装正式包**(第 1、3、4、6 条) | 只有要"快进时间"(第 5 条想省时间)或"清档/造损坏存档"时才用网页内部包;**微信里内部包和正式包几乎没区别** |
注意:两个微信包里的 `project.config.json` 完全一样,工程名都显示 `wyszz-island-0.1`(0.2.0 还没改名,见 report-C C-1),所以**在开发者工具里分不出来**。请自己在文件夹名上做记号(例如导入时分别放到"正式"和"内部"两个文件夹里,别混)。

"不对时怎么记录"的统一做法:**截图 + 写下①做了什么 ②看到什么 ③你以为应该看到什么 ④包是正式还是内部、设备/开发者工具版本**。能的话再附开发者工具"调试器/Console"里的红字。

## 1. 全新安装进入:金币是 60,画面正常
- 步骤:装正式包。第一次打开(确保没有旧存档:开发者工具里点"清缓存→清除数据缓存";手机则卸载重装或删除小游戏再进)。
- 期望:一座浮空岛,左上角等级 Lv1,金币约 **60**(因为从一开始就计时,几秒内会是 60.x,如 61.2,每分钟 +10.0);屏幕下方有"升级市政厅 → Lv.2,花费 20 金币"的大按钮;右下"已保存";底部出现一句提示"新的岛屿!点居民领金币,点市政厅升级"。
- 不对:金币是 0 或别的数字、白屏/黑屏、红字报错 → 截图并记下金币数字。

## 2. 0.1 老存档迁移
目标:装过 0.1 并玩过的人,更新到 0.2 后进度还在,不多不少。
- 办法 A(推荐,**未验证**):先在同一台开发者工具里导入并玩 **0.1 的微信包**(`frontend-rebuild-hm/dist/wechat`),点几次升级、点几个居民,然后关闭;再导入 0.2 正式包(使用同一个 appid `touristappid`)。是否共用同一份存储取决于开发者工具,**我没验证**。
- 办法 B(网页,逻辑上可行,**未验证真实浏览器之外**):用 0.1 的 `dist/web` 玩一会儿,不清缓存,再打开 0.2 的网页(必须是同一个网址/端口,否则存储互相看不到)。
- 办法 C(开发者工具控制台,**未验证**):打开 0.2 之前,在 Console 里输入  
  `wx.setStorageSync('wyszz-0.1-ds-save', '{"schemaVersion":2,"level":3,"coinsMilli":45678,"carryNumerator":12345,"lastSettleTsMs":1699996400000,"settleCount":42,"lastGainMilli":10000,"totalGainMilli":345678,"lifetimeReputation":5,"spendableReputation":4,"visitCount":5,"visitCoinsMilli":15000,"offlinePending":false,"offlineStartTsMs":1699999000000}')`  
  然后重新编译。(网页版把 `wx.setStorageSync` 换成 `localStorage.setItem`。)这是 0.1 夹具里的真实存档字符串。
- 期望(我在电脑里的浏览器里看到的样子):Lv3、金币约 **45.6**(不是 45.6+60!)、声望 5、寻访 5、每分钟 +14.0,提示"存档已升级并恢复"。再关掉重开,金币**只会因为时间增加**,不会再多出 60;进度不丢。
- 不对:金币多了 60、等级/声望变回 1 或 0、提示"存档已损坏…新游戏" → 记下旧值与新值。

## 3. 点击居民/建筑/升级,金币变化
- 点居民:金币 **+3**,声望 +1(寻访次数 +1)。
- 点中间的市政厅(Lv1):等于请求升级——金币够 20 就扣 20、升到 Lv2、每分钟收益变 +12.0;不够时不扣钱,提示还差多少。
- 点其他建筑或空地:不给奖励(0.1 就是这样)。
- 点升级大按钮:同点市政厅。
- 不对:点居民没加 3、升级扣错数(Lv2→3 应 25,Lv3→4 应 30,Lv4→5 应 37)、点建筑也给了钱 → 记下点击前后金币数字。

## 4. 杀进程重开后进度保留
- 步骤:玩到金币变化、升一级;**彻底关闭**(手机上从多任务里划掉小游戏;开发者工具里点"重新编译"不等于杀进程,请用"清缓存"以外的"重启")。重新打开。
- 期望:等级、声望、寻访次数不变;金币 ≥ 关闭前(多出的是关闭这段时间的在线/离线收益)。
- 不对:进度回到 Lv1/新游戏、金币变少 → 记下关闭前后的数字和时间。

## 5. 离线收益:退到后台 1–2 分钟再回来
- 步骤:记下金币和每分钟收益。按 Home 键(或切到别的应用)等 **1–2 分钟**,再回来。
- 期望:弹出"离线收益"面板或金币增加。以 Lv1 为例,**每分钟约 +10**,所以 2 分钟约 +20(多一点少一点取决于秒数)。回来后金币 = 退出前 + 收益。
- 想快速测:网页内部包 `?debug=1` 面板点"后台"→等→点"前台"(**未验证**手感)。
- 把手机系统时间往回拨再回来:应提示"检测到时间回拨,本次离线不计收益"且金币不增。
- 不对:没有任何收益、收益明显和时间对不上、回来后又重复发一次 → 记下退出/回来时刻和前后金币。

## 6. 手机上胶囊按钮是否压住界面(已知遗留,只记录)
- 步骤:真手机(微信)打开,看右上角微信自带的"···/关闭"胶囊按钮有没有盖住左上或右上的等级/金币/声望卡片。
- 期望:这是已知遗留问题,**只需记录,不算本次失败**。请记:手机型号、微信版本、有没有遮挡、遮住了哪一块(截图)。
- 我这边的情况:界面有适配胶囊的代码,但我没有在真机上验证过。

## 其他请顺手留意(我的担心,未验证)
- **微信能不能启动**:核心用了 JavaScript 的 BigInt。太旧的微信/iOS 若不支持,游戏可能直接打不开。请记录你的微信与系统版本,打不开就截图。
- **点得准不准**:买地的"250 毫秒防误触"0.2.0 还没有界面,不用测。
- 读存储失败时会提示"存档读取失败,请重启",这是正常设计,只有极少数环境会碰到。
- 项目名仍显示 0.1、迁移时多一句"存档已升级并恢复":都是已知小事,见 report-C。

## 最后请你填的表
| 条目 | 设备/工具/版本 | 包(正式/内部) | 通过/不通过 | 截图或备注 |
|---|---|---|---|---|
| 1 新装 | | | | |
| 2 迁移 | | | | |
| 3 点击 | | | | |
| 4 杀进程 | | | | |
| 5 离线 | | | | |
| 6 胶囊 | | | (只记录) | |
