# 《我要当市长》0.1 第二步 · 竖屏静态手机画面 · 交付报告

- 日期：2026-10-08
- 范围：**仅** 0.1 第二步「静态手机画面」——竖屏静态 UI + 点击区域 + 交互反馈占位
- 明确不做：时间收益、寻访奖励结算、升级扣费、任何真实数值变化、存档、后端、微信 SDK
- 状态：第二步完成，**未进入第三步**

---

## 一、硬约束遵守情况

| 约束 | 执行情况 |
| --- | --- |
| 继续使用现有 Docker + Node.js + TypeScript + Canvas 2D | ✅ 复用 `node:22-bookworm-slim` 与探针同栈；Node v22.23.3 / TypeScript 5.9.3 / Vite 6.4.4 |
| 不使用 Cocos / Phaser / Godot / Unity | ✅ 纯手写 Canvas 2D，无任何引擎 |
| 不引入新的第三方依赖 | ✅ 依赖只有 `typescript`、`vite` 两个，与第一步探针完全一致；自检脚本零框架（只用 Node 内置模块） |
| 不修改旧项目 little-town | ✅ 未写入、未改动该目录任何文件 |
| 不连接微信 SDK / 广告 / 存档 / 后端 / 数据库 | ✅ 无网络请求、无存储 API（未使用 localStorage / IndexedDB / cookie）、无后端 |
| 不实现时间收益 / 寻访奖励 / 升级扣费 / 真实数值变化 | ✅ 见第五节「静态数值边界」自检项 |
| 不得依赖 HTML/DOM 控件完成游戏画面 | ✅ 画面 100% 由 Canvas 2D 绘制；`index.html` 只有一个空 `<div id="app">` 作为画布容器 |

---

## 二、交付文件（绝对路径）

### 新增（画面工程）

| 文件 | 说明 |
| --- | --- |
| `/vol1/ai/projects/wyszz-new/app/package.json` | 工程定义，依赖仅 typescript + vite |
| `/vol1/ai/projects/wyszz-new/app/tsconfig.json` | 严格模式类型检查配置 |
| `/vol1/ai/projects/wyszz-new/app/tsconfig.verify.json` | 自检脚本编译配置 |
| `/vol1/ai/projects/wyszz-new/app/vite.config.ts` | 开发服务器 0.0.0.0:5174 |
| `/vol1/ai/projects/wyszz-new/app/index.html` | 画布宿主页（无 DOM 控件、禁止缩放/横向滚动） |
| `/vol1/ai/projects/wyszz-new/app/src/core/layout.ts` | 750×1334 布局常量 + 全部可点击区域矩形/圆 + 静态展示数值 |
| `/vol1/ai/projects/wyszz-new/app/src/core/hit.ts` | 命中判定纯函数（命中顺序 = 视觉层级） |
| `/vol1/ai/projects/wyszz-new/app/src/core/state.ts` | 界面状态机（抽屉/离线面板/飘字），不含任何数值计算 |
| `/vol1/ai/projects/wyszz-new/app/src/render/theme.ts` | 占位配色 |
| `/vol1/ai/projects/wyszz-new/app/src/render/draw.ts` | 全部绘制逻辑（五层画面） |
| `/vol1/ai/projects/wyszz-new/app/src/main.ts` | 画布适配、指针事件、渲染循环、调试接口 |
| `/vol1/ai/projects/wyszz-new/app/verify/interaction-test.ts` | 交互自检（27 项断言，无框架） |
| `/vol1/ai/projects/wyszz-new/app/verify/run-verify.sh` | 容器内一键校验脚本 |
| `/vol1/ai/projects/wyszz-new/app/package-lock.json` | 依赖锁定（安装时生成） |

### 修改

| 文件 | 改动 |
| --- | --- |
| `/vol1/ai/projects/wyszz-new/docker-compose.yml` | **新增** `app` 服务（端口 192.168.1.38:5174，非 root、无 docker socket、无 privileged、无 host 网络、512m/1cpu）；`probe` 服务原样保留 |

### 证据截图

| 文件 | 说明 |
| --- | --- |
| `/vol1/ai/projects/wyszz-new/docs/screenshots/第二步-01-默认主画面-750x1334.png` | 必需①：桌面浏览器竖屏视口默认画面 |
| `/vol1/ai/projects/wyszz-new/docs/screenshots/第二步-02-升级抽屉展开-750x1334.png` | 必需②：升级抽屉展开 |
| `/vol1/ai/projects/wyszz-new/docs/screenshots/第二步-03-竖屏手机模拟-492x874.png` | 必需③：竖屏手机模拟视口 |
| `/vol1/ai/projects/wyszz-new/docs/screenshots/第二步-04-离线占位面板层级-750x1334.png` | 补充：离线占位面板（默认隐藏）的视觉层级 |
| `/vol1/ai/projects/wyszz-new/docs/screenshots/第二步-05-真实浏览器点击反馈飘字.png` | 补充：真实浏览器里点击市政厅/居民后的「寻访 +1」飘字 |

---

## 三、画面结构与可点击区域（设计坐标 750×1334）

所有可点击区域都在 `layout.ts` 里以显式矩形（Rect）或圆形（Circle）声明，并在画面上用青色虚线画出边界。

| 区域 | 形状与坐标 | 对应需求 |
| --- | --- | --- |
| 顶部资源栏 | 矩形 (0,0,750,132)；面板 (16,12,718,108) | ① 金币 0 / 累计声望 0 / 可用声望 0 / 每分钟金币 10 |
| 中部城市区 | 矩形 (0,132,750,998) | ② 城市区 |
| 市政厅（点击区 A） | **矩形 (215,300,320,300)** | ② + ⑥ 点击反馈 |
| 居民（点击区 B） | **圆形 圆心(150,680) 半径 70** | ② + ⑥ 点击反馈 |
| 底部升级入口 | **矩形 (60,1176,630,108)** | ③ 「升级市政厅」按钮 + Lv.1 + 费用 20 |
| 升级抽屉 | **矩形 (16,802,718,316)**，高度 316/1334 = **23.7% ≤ 40%** | ④ 抽屉（等级/收益/费用/关闭） |
| 抽屉关闭按钮 | **矩形 (566,826,150,64)** | ④ 关闭 |
| 离线占位面板 | **矩形 (95,402,560,430)**（默认隐藏，模态） | ⑤ 视觉层级 |
| 离线面板关闭按钮 | **矩形 (250,736,250,72)** | ⑤ |

### 图层顺序（自下而上）

`② 中部城市区 → ① 顶部资源栏 → ④ 底部升级入口 → ④ 升级抽屉 → ③ 飘字反馈层 → ⑤ 离线占位面板`

- 升级抽屉顶边 y=802，**低于**居民圆底部 y=750 与市政厅矩形底部 y=600，因此抽屉打开时不遮挡任何一个寻访点击区域；
- 飘字层在抽屉之上、离线面板之下，且不参与命中判定（点击穿透）；
- 离线面板是唯一允许覆盖中部城市区的图层，且为模态：面板以外的一切点击都被吞掉，**不会误触升级按钮**。

---

## 四、构建与自动化验证

构建/校验命令（在容器内执行，不污染宿主机）：

```bash
docker run --rm --user node -v /vol1/ai/projects/wyszz-new/app:/app -w /app \
  node:22-bookworm-slim sh /app/verify/run-verify.sh
```

| 步骤 | 命令 | 结果 |
| --- | --- | --- |
| 依赖安装 | `npm install` | ✅ 15 packages，无新增第三方依赖 |
| 类型检查 | `npx tsc --noEmit` | ✅ **0 错误**（strict + noUnusedLocals + noUnusedParameters + isolatedModules） |
| 交互自检 | `npx tsc -p tsconfig.verify.json && node .verify-out/verify/interaction-test.js` | ✅ **27 项全部通过，0 失败** |
| 生产构建 | `npm run build`（tsc && vite build） | ✅ `dist/index.html` 1.14 kB；`dist/assets/index-*.js` 9.68 kB（gzip 4.25 kB），构建耗时 ~0.1 s |

### 交互自检覆盖的 27 项（摘录关键项）

- 几何：抽屉高度 23.7% ≤ 40%；抽屉不遮挡点击区 A / B；A 与 B 不重叠；升级入口不与 A/B 重叠
- 交互：点击市政厅/居民各产生「寻访 +1」飘字；升级入口**开关**抽屉；抽屉「关闭」按钮收起抽屉
- **关键验收**：抽屉打开时市政厅仍可点击、居民仍可点击、且点击不会误关抽屉
- 防误触：抽屉空白处不命中升级入口；离线面板可见时点击升级按钮位置与画面角落均不误触
- 连点：连续点击 60 次每次生效（tapCount=60）、飘字数量受上限保护、连点后按钮依旧有效
- 静态边界：金币 0 / 累计声望 0 / 可用声望 0 / Lv.1 / 费用 20 / 每分钟金币 10 在任何点击后都不变

---

## 五、真实浏览器验收（Windows 虚拟机 · Microsoft Edge 154 · 真实窗口真实鼠标点击）

视口 724×691（竖屏），缩放 s=0.518，点击坐标由设计坐标换算得到；页面标题实时输出状态用于判定。

| 步骤 | 操作 | 结果 |
| --- | --- | --- |
| T0 | 初始 | `抽屉开 | 飘字0`（承接上一步校准点击） |
| T1 | **抽屉打开时连点市政厅 5 次** | `抽屉开 | 飘字4` ✅ 全部命中，抽屉未被误关 |
| T2 | **抽屉打开时连点居民 5 次** | `抽屉开 | 飘字4` ✅ 全部命中，抽屉未被误关 |
| T3 | 点击抽屉「关闭」 | `抽屉关` ✅ |
| T4 | 点击升级入口 | `抽屉开` ✅ |
| T5 | 再次点击升级入口 | `抽屉关` ✅ 可开可关 |
| T6 | 点击画面空白处 | `抽屉关` 无变化 ✅ 不误触 |

> 说明：T1/T2 显示 4 而非 5，是因为飘字生命周期 900 ms，第 1 个飘字在读取标题时已自然消失；第 6 节的自检脚本在同一时刻断言了 60 次连点全部生效，可交叉印证连点不会失效。

### 竖屏无裁切 / 无横向滚动

- `html,body{overflow:hidden}`，`#app` 固定定位 + flex 居中 + `overflow:hidden`；
- 画布按 `scale = min(视口宽/750, 视口高/1334)` 等比缩放，整张设计图始终完整可见，不裁切、不产生滚动条；
- 已在 750×1334、724×691、492×874 三种竖屏视口下渲染验证，画面均完整无裁切。

---

## 六、局域网访问与手机真机验收

| 服务 | 地址 | 状态 |
| --- | --- | --- |
| 第二步画面（本轮成果） | **http://192.168.1.38:5174/** | ✅ HTTP 200，容器 `wyszz-app` 运行中 |
| 第一步环境探针（未改动） | http://192.168.1.38:5173/ | ✅ HTTP 200，容器 `wyszz-probe` 运行中 |

**待你验收（我无法代替真机操作）**：请用手机浏览器打开 `http://192.168.1.38:5174/`，确认：
1. 竖屏完整显示、可上下无横向滚动、双指缩放被禁用；
2. 点击市政厅与居民各 5 次，能看到「寻访 +1」飘字；
3. 点击「升级市政厅」能展开/收起抽屉，抽屉打开时仍能点市政厅与居民。

---

## 七、明确未实现（第二步范围内本就不做）

- 无金币/声望的任何增减，无时间收益（每分钟金币只是静态文字 10）；
- 无寻访奖励结算（飘字只是反馈动画，不加任何数值）；
- 无升级扣费、无等级变化（点击升级入口只开关抽屉）；
- 无离线收益领取/结算（离线面板是纯占位，默认隐藏，需要时用 `?debug=offline` 查看层级）；
- 无存档、无后端、无数据库、无微信 SDK、无广告。

## 八、遗留与未完成项

1. **手机真机验收未执行**（无真机可用），已提供局域网地址，见第六节。
2. 画面为占位美术（几何图形 + 文字），正式美术资源未接入（第三步及以后）。
3. 调试接口 `window.__wyszz` 与 URL 参数 `?debug=drawer|offline` 为验证用途保留，不参与玩法逻辑；正式接入微信小游戏前建议移除。
4. 页面标题带有视口/缩放/状态调试信息（`我要当市长 · Lv.1 | 724x691 | s=0.518 | 抽屉关 | 飘字0`），仅用于自动化验收，正式版应改回纯标题。

**本轮到此结束，未进入第三步，未加入任何经济逻辑。**
