# 发布手机版 · 交给 agent 执行的说明

整份内容可以直接复制给另一个 agent。

---

**任务：把 HEX TRAILS 的 50 关手机版发布到一个手机能访问的网址。**

仓库：`git@git.zeroplus.fun:Zeroplus/HexTrails.git`，分支 `main`（本地路径 `/Users/wukaibing/Codex/hex-arrow`）。构建脚本 `scripts/build-phone.mjs` 已经写好并测过，你**不需要改游戏代码**。

## 第一步，构建

```bash
node scripts/build-phone.mjs --standalone --out=build/phone-standalone
```

产物约 5.2MB：`index.html`（完整 HTML 文档，样式已内联）+ `src/` 22 个 ES module + `assets/` 7 个资源（贴图、图标图集、背景、托盘、两个 woff2 字体）。

如果目标托管平台**自带 `<html>` / `<head>` / `<body>` 外壳**（比如 Claude Artifacts），改用不带 `--standalone` 的默认模式，产出的 `index.html` 只有 body 内容：

```bash
node scripts/build-phone.mjs
```

两种模式只差文档外壳，其余完全一样。**别把两者搞混**——给普通静态托管发了片段版，页面会没有 viewport meta，手机上按 980px 宽渲染。

## 第二步，发布

发到任意静态托管都行（Vercel / Netlify / Cloudflare Pages / GitHub Pages / 对象存储）。要求只有三条：

1. **保持目录结构。** `index.html` 里是 `<script type="module" src="src/app.js">`，模块之间用相对路径互相 import，`assets/` 也是相对路径引用。不要扁平化目录，不要给资源加 hash 重命名，除非你同时改写所有引用。
2. **`.js` 必须以 `text/javascript` 返回。** 用 `application/octet-stream` 返回的话 ES module 会被浏览器拒绝执行，页面白屏。
3. **全站 HTTPS 或全站 HTTP，别混。**

## 第三步，验收（必做，逐条确认）

用手机宽度（375px）打开发布后的网址，确认：

- [ ] 标题栏是 `LEVEL 01`，`待解棋子 8`
- [ ] 左上角有九宫格图标、右上角有齿轮图标（**不是空白、不是破图**）
- [ ] 底部三个圆按钮里有撤销 / 重来 / 灯泡图标
- [ ] toast 里**没有**「棋子图片加载失败，已切换基础绘制」——出现这句说明 `assets/tiles-matte-clean-v8.png` 没发上去或 404
- [ ] 棋盘上 8 枚彩色六角棋子带箭头，背景有轨道线
- [ ] 点一下第 1 关左下角那枚粉色棋子，它应该沿轨道滑出棋盘，计数变成 7
- [ ] 页面**没有横向滚动条**

浏览器控制台不应有 404 或模块加载错误。有的话先查是不是第 1 条（目录结构）或第 2 条（MIME）。

**已知的、不是 bug 的现象**：375×812 下棋盘只占上半屏，下半屏是空的。这是游戏现有布局，和未打包的原版一模一样，不要去「修」它。

## 背景

这 50 关是 `c50` 版本。构建脚本会把 campaign 注册表换成只含这一版，从而甩掉千关版那个 9.2MB 的 `src/levels-v05.js`——完整静态构建是 10MB+，这里是 645KB 代码 + 4.5MB 图。

进度存在浏览器 localStorage（key `hex-trails-campaign-c50`），通一关自动进下一关。清空进度：

```js
localStorage.setItem('hex-trails-campaign-c50', JSON.stringify({current:0,completed:[]}))
```

## 如果只是自己在局域网里玩

不用发布，电脑跑着 `npm run dev`，手机连同一个 Wi-Fi 打开：

```
http://<电脑的局域网IP>:4173/index.html?campaign=c50
```

IP 用 `ipconfig getifaddr en0` 查。服务已绑 `0.0.0.0`，不用改配置。