# 0.1 收尾任务书（按模型等级分配）

本文只含任务书，没有实现代码。

## 0. 0.1 现状（来自 00-最终交付报告）

已验证（本机与替身环境）：契约样例 32/32、浏览器 59/59、微信 Worker + mock-wx 替身 37/37；预算约 41 draw calls、29.2k 三角形、10 programs。

未验证，或有缺口：
1. 微信官方模拟器、真机、AppID 上传：未验证。
2. 公网预览：返回 404，需要你在 Cloudflare 添加路由。
3. 帧率约 19.9 fps 是软件渲染（SwiftShader）的数字，不代表手机，不能当性能结论。
4. 已知小项：`hall.glow` 没有做视觉着色；默认视角下 4 个居民里有 2 个中心点会"自命中"（其余有可点区域）。
5. 契约自带的隔离检查工具对前端项目误报 3178 条，目前没有适合本项目的隔离检查。
6. 计划要求的"玩家无需讲解完成第一次寻访与升级"只能由真人试玩确认，自动化测试替代不了。

## 1. 分工总览

| 编号 | 任务 | 等级 | 为什么 |
| --- | --- | --- | --- |
| 你 | Cloudflare 路由、AppID、真机、真人试玩 | 不用模型 | 需要你的账号与设备 |
| L1 | 项目专用隔离检查 + 一键回归脚本 | 低 | 机械、边界清楚 |
| L2 | 真机/官方模拟器验收清单与结果记录模板 | 低 | 纯文档 |
| L3 | 修两个小项（glow 着色、居民点击区） | 低，但要严格约束 | 改动小；必须在副本里做、全量回归 |
| L4 | 文档一致性与 SHA256 清单复核 | 低 | 机械核对 |
| H1 | 0.1 独立验收评审（对照契约与计划 0.1 条件） | **高** | 要判断"测试是否真的覆盖了条件"，找漏洞 |
| H2 | 微信适配层真机风险评审 | **高** | 替身测不到真机行为，需要对微信 API 与 WebGL 的深入知识；只评审不改代码 |

执行顺序：L1、L2、L4 可并行；L3 在 L1 完成后做；H1、H2 在 L1–L4 全部完成后做，用最新包。

---

## 2. 通用头（每份任务书开头粘贴）

```
你是《我要当岛主》0.1 收尾阶段的执行 Agent。
项目目录：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/
允许读取：该项目目录，以及 /vol1/ai/projects/wyszz-new/frontend-rebuild-contract-v1/，
  和 /vol1/ai/projects/wyszz-new/docs/ 下的企划书 v0.3、迭代计划 v2、计划修改报告。
禁止读取、修改或引用：wechat-game-0.1-ds/、3d-spike-ds/、wechat-spike-ds/、app/、little-town/、
  MIMO 目录、任何旧截图、旧公开页面、旧模型与素材、docs/ 里的旧截图和旧"第二步"报告。
硬规则：
 1. 不造假：没运行过的测试、没拍过的截图、没验证过的链接、没做过的真机结果，一律写"未验证"。
 2. 不要进入 0.2。不要改 0.1 已冻结的规则与数值（见契约）。
 3. 开始前，先把项目目录完整复制一份到 /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-<任务编号>/，
    并只在副本里工作；不要改原目录。
 4. 报告必须包含：做了什么、运行的命令与原始输出、改动文件清单及 SHA256、
    读过的目录清单、未验证项、你不确定的地方。
 5. 遇到你判断不了的问题，停下来写进"待决问题"，不要猜。
 6. Node 在 /mnt/ssd/apps/nodejs_v24/bin，先 export PATH 再运行。
```

---

## 3. L1：项目专用隔离检查 + 一键回归（低等级）

```
[通用头，任务编号 L1]

背景：契约包自带的隔离检查工具套在前端项目上会误报 3178 条，所以现在没有可用的隔离检查。

任务：
1. 在副本的 tools/ 下新增一个"项目专用隔离检查"脚本：
   - 扫描 src/、test/、tools/、docs/ 的文本文件，
   - 检查是否出现被禁目录名（wechat-game-0.1-ds、3d-spike-ds、wechat-spike-ds、app/、little-town、MIMO）的引用或路径，
   - 检查是否有指向这些目录的 import / require / 文件读取。
   - 忽略 node_modules/、dist/、release/、evidence/。
   - ISOLATION.md 里用于"声明禁区"的文字允许出现，请单独列为白名单并说明。
   - 输出：发现的每一处（文件、行号、命中文本）和最终 PASS/FAIL。
2. 在 package.json 增加一个"全量回归"命令，依次运行：
   类型检查、构建、契约样例、玩法、UI、视觉、浏览器测试、微信替身测试、隔离检查；
   任何一步失败整体失败；末尾打印各步结果表。
   只调用现有测试，不改测试内容，不降低任何断言。
3. 实际运行全量回归，报告里贴出完整原始输出。
4. 故意制造一个违规（例如在临时文件里写入被禁目录名）确认检查能报出，再删除该临时文件；报告里写明这次验证。

不要修改 src/ 里的游戏代码。
```

## 4. L2：真机/官方模拟器验收清单（低等级）

```
[通用头，任务编号 L2]

任务：写一份面向普通用户（不是程序员）的验收操作手册，保存到副本 docs/12-真机与官方模拟器验收手册.md，并配一个结果记录模板。

内容必须包括：
1. 前置条件：微信开发者工具版本要求、AppID（没有时可用测试号的限制说明）、基础库版本选择、手机要求。
   只写你能从项目文件或官方文档确认的内容；查不到的写"未确认"并说明去哪里确认。
2. 如何把 dist/wechat 导入微信开发者工具、如何预览/真机调试（分步骤，每步写"应看到什么"）。
3. 检查项表格（每项：操作、预期、通过/失败/未验证、备注）：
   - 首屏出现城市与资源栏；单指拖动旋转；双指缩放；
   - 点击建筑和居民会寻访，金币+3、声望+1；拖动不会触发寻访；
   - 升级入口打开面板，不阻断连续点击；
   - 金币不足时升级不扣费；Lv1 10/分钟、Lv2 12/分钟、下次费用 25；
   - 退出再进入的离线收益结算；
   - 切后台再回来不重复结算；
   - 存档在重启后保留；
   - 帧率观察、发热、文字是否遮挡、刘海屏适配。
   这些预期数值请从契约与交付说明核对，不要自己编。
4. 结果记录模板：机型、系统版本、微信版本、基础库版本、测试日期、截图文件名、每项结果、问题描述。
   并写明"没有测过的项必须填 未验证，不能留白或填通过"。
5. 常见失败的排查提示（只写你有依据的）。

不要修改任何代码。
```

## 5. L3：两个小项修复（低等级，严格约束）

```
[通用头，任务编号 L3]

前提：L1 已完成并通过，副本里已有全量回归命令。若 L1 还没完成，不要开始。

任务一：hall.glow 视觉着色。
  现状：市政厅有"光晕"状态字段，但画面上没有对应着色。
  做法：先阅读 docs/01-视觉设计说明.md，按其中的色彩与风格，做最小改动让该状态在画面上可见。
  只改渲染层。不得改 src/core。
任务二：居民点击区。
  现状：默认视角下 4 个居民里有 2 个，其中心点"自命中"（点击中心的命中结果不是该居民自己），其余有可点区域。
  做法：先写清楚复现步骤和原因分析（贴出实际输出），再做最小改动。
  只改点击命中与渲染层，不得改变寻访规则、金币和声望的数值。

每项都要：
 1. 改动前先运行全量回归，记录基线输出。
 2. 改动后重新运行全量回归，所有原有断言必须仍通过，样例数不得减少。
 3. 新增针对该修复的测试（只增不删）。
 4. 如果任何一个原有测试失败，立刻回退这一项并写进报告，不要修改测试来迁就代码。
 5. 预算不得超过：draw calls 60、三角形 40000、programs 16、世界材质 7。报告里贴出前后对比。
 6. 如果你需要改 src/core 才能完成，停下来，写进待决问题，不要改。
 7. 截图只能来自你这次实际运行的画面，并写明运行环境（软件渲染不是真机）。
```

## 6. L4：文档与校验和复核（低等级）

```
[通用头，任务编号 L4]

任务：核对交付文档与实际文件的一致性，只出报告，不改源码。
1. 逐个打开 docs/00 至 docs/10 与 docs/11，列出每个文档里出现的数字
   （测试通过数、draw calls、三角形数、fps、文件名、路径、命令），
   在实际文件和实际运行结果里逐项核对。能重新运行的就重新运行，贴原始输出。
2. 重新计算 docs/07-文件SHA256清单.txt 里每个文件的 SHA256，列出所有不一致、缺失、多出的文件。
3. 列出文档里互相矛盾的说法、失效的路径、过时的描述。
4. 检查所有文档是否明确写了"未验证"边界：微信官方模拟器、真机、官方上传、公网预览、访客模拟器，
   有没有任何地方把替身结果写成了真机结果。
5. 不要直接修订文档。把每个问题列成表格（文件、行号、问题、建议改法），交给我处理。
```

---

## 7. H1：0.1 独立验收评审（**必须用高等级模型**）

原因：这是"找漏洞"的工作。要判断测试有没有真正覆盖条件、有没有只是断言了显示字符串、浮点或取整有没有隐患。低等级模型容易照着"全部通过"的结论走。

```
[通用头，任务编号 H1。你是独立验收员，不是实现者；不要修改任何源码，只出评审报告。]

输入：最新的副本包（L1–L4 之后）、契约包 frontend-rebuild-contract-v1、
  迭代计划 v2 第 5 节（0.1 的目标、公式、进入下一版条件）、企划书 v0.3 的 0.1 相关部分。

任务：独立判断 0.1 是否满足计划第 5 节"进入下一版的条件"，逐条给出证据。
必须逐项回答：
 1. 对照契约的类型与接口，实现是否有偏离？（逐项列出）
 2. 契约样例 32/32 是否真的覆盖了：升级前先结算旧产速、金币不足不扣费、毫币整数与进位余量、
    离线结算无上限、时钟回拨保护、v1→v2 存档迁移、重复结算、重复点击。每一项给出对应样例名；
    没有覆盖的，自己设计补充用例（只写到你的评审目录，不改项目），并说明预期结果与实际结果。
 3. 测试里有没有"只检查显示字符串而没有检查账务"的断言？
 4. 在线与离线同样时长同样等级是否得到相同收益？请设计跨升级、跨前后台、跨多次退出的组合场景验证。
 5. 存档损坏、存储写失败、数值超大、时间戳异常时，会不会丢档或产生负数/NaN？
 6. 连续高频点击与反馈动画：是否可能丢点击或阻塞？
 7. 0.1 对 0.2 的扩展点是否留得合理（土地、种子字段、存档版本升级路径）？指出会让 0.2 返工的设计。
 8. 隔离：用你自己的方式核查项目是否引用了禁区目录。

输出：结论（通过 / 有条件通过 / 不通过）、问题表（严重度 P0/P1/P2、位置、复现步骤、建议）、
  你实际运行的命令及输出、"我没能验证的"清单。
不要为了让结论好看而放宽标准；找不到问题时，说明你尝试过哪些攻击面。
```

## 8. H2：微信适配层真机风险评审（**必须用高等级模型**）

原因：替身（Worker + mock-wx）测不到真机行为。这件事需要对微信小游戏 API、WebGL 上下文、触摸事件、画布文字绘制等有准确知识，并且要能联网核实官方文档；低等级模型容易凭印象编造 API 行为。

```
[通用头，任务编号 H2。你只做评审，不要修改源码。]

任务：评审 src/wechat/ 与相关构建配置，找出"替身通过但真机很可能失败"的风险。
所有关于微信 API 行为的结论，必须附上官方文档 URL 和查阅日期；查不到官方依据的，标注"未找到官方依据"，
不得凭印象陈述。

重点检查：
 1. 画布创建与屏幕尺寸、像素比、横竖屏、刘海屏安全区。
 2. 触摸事件：触点数据、多点触控、取消事件、坐标系，与拖动/点击区分是否一致。
 3. WebGL 上下文创建参数与 WebGL2 可用性、Three.js 在小游戏环境的适配问题（全局对象、DOM 依赖、纹理加载、字体）。
 4. 画布文字作为纹理：字体可用性、清晰度、内存占用。
 5. 本地存储：同步/异步 API、容量限制、写失败处理，存档键与格式。
 6. 前后台切换：onShow/onHide 的回调顺序、时间源（Date 与单调时钟），离线结算触发是否会重复或遗漏。
 7. 主包体积与分包要求，基础库版本要求。
 8. 帧循环：requestAnimationFrame 的来源，低帧率下的逻辑时间步。
 9. 替身 mock-wx 与真实 wx 的差异清单：逐个 API 说明 mock 做了什么假设。

输出：风险表（严重度、位置、依据 URL、真机可能出现的现象、建议的最小验证方法），
  以及给用户的真机验证时"应重点盯的 10 件事"。
```

---

## 9. 你拿到结果后怎么办

1. 把每个任务的报告路径发给我，我按 09 手册里的关卡清单审。
2. L3 通过后，由我决定是否把副本的改动合并回主目录；不要让低等级模型直接改原目录。
3. H1/H2 若出现 P0，先修再继续；P1/P2 记入 0.2 前的待办。
4. 与此同时，你自己去做：Cloudflare 路由、AppID、真机与真人试玩。
