# S-23D · 底部下栏抽屉 HUD · 可交互原型说明

> 一句话：把现在**会盖住岛的弹窗式 HUD**，换成**底部可拖拽抽屉**——岛一直在视野里，只有需要时才拉出面板。
>
> - 原型文件：`demo/v2-ui-demo.html`（单文件、离线双击可开、图片全内嵌）
> - 截图证据：`evidence/s23d-01…06*.png`（390×844@2x 五张 + 320×568@2x 一张）
> - 性质：**交互验证原型**，不改游戏源码、不发版、不跑回归（见第四节）
> - 状态：原型已跑通，6 张截图已产出，第 6 节自检数据为实测

---

## 一、总监理解清单（6 条 · 机主逐条打勾）

请一条一条看，**对就打勾，不对在旁边写一句为什么**——这 6 条定的是"这个方案对不对"，细节数值不在这层吵。

- [ ] **① 三档抽屉，岛景跟着缩放。**
  收起只露提手约 **60px**；半开 **45%**；全开 **88%**；岛景缩放随档位 **1.0 → 0.72 → 0.55**。
  *demo 里怎么验*：**顶部中间**一排「收起 / 半开 / 全开」三个小胶囊，点它们切换；也可以按住底部提手上下拖——抽屉变化的同时岛会明显变大变小。
  **⚠ 实测情况（请连这条一起判断）**：缩放数值 1.0/0.72/0.55 三个都对得上；但**全开 88% 时岛已经完全被抽屉盖住**（视口顶部 101px 只剩天空，见图 03/05），所以"全开时岛明显变小"这个观感目前看不到——详见第六节第 3.1 小节和第 7 条问题。收起档 60px 实际还露出了"上拉查看建设"提示和一行分类 tab（tab 底边被屏幕裁掉约 9px），不是"只剩一根提手"。**这条要不要按"可接受"打勾，请机主定**。
  机主确认：☑ 对 / ☐ 不对，备注：__________

- [ ] **② 拖拽跟手 + 松手吸附；点提手 = 收起↔半开切换；全开能一路下拉到收起。**
  *demo 里怎么验*：按住提手慢慢拖，抽屉跟手指走；松手后自动吸到最近一档。轻点提手一下（不拖）就在收起/半开之间跳。全开状态下继续往下拖，能一路拖回收起。
  机主确认：☑ 对 / ☐ 不对，备注：__________

- [ ] **③ 分类 tab 五等分整行、每格独立圆角框、字号留白为主，切 tab 只换列表、抽屉高度不动。**
  五个分类：**建筑 / 土地 / 居民 / 街区 / 其他**，**每格宽度 =(屏宽−24−8×4)/5 严格等分、不横滚**；字号 **390 屏 13px / 320 屏 12px**（两个字约占格宽 39% / 45%，以留白为主）；格间距 8px、整排左右各 12px；每格独立 **9px 圆角 + 1px #D8C7A4 描边**（选中淡金底 + 1.5px #C99A3F 描边）。
  *demo 里怎么验*：左右滑 tab 条，逐个点过去——面板高度纹丝不动，只有下面的列表内容换掉。
  机主确认：☑ 对 / ☐ 不对，备注：__________

- [ ] **④ 点列表项 → 抽屉自动降到半开 + 岛放大平移到该建筑特写 + 高亮圈 + 名字标签，可返回。**
  *demo 里怎么验*：全开状态下点任意一个建筑条目，抽屉会自己降下来，岛镜头推近到那栋楼、套一个高亮圈、浮出名字标签；点「返回」或点岛空白处回来。
  机主确认：☑ 对 / ☐ 不对，备注：__________

- [ ] **⑤ 金币栏：收起时在原顶部胶囊位置，半开/全开时左上角出现紧凑金币栏，降回收起后恢复。**
  紧凑栏 = 金币数 + 「每分钟 +10」；收起态不显示紧凑栏，回到顶部原来那条胶囊，避免和岛抢地方。
  *demo 里怎么验*：在三个档位之间来回切，盯住金币：收起时在顶部原位，半开/全开时变到左上角小胶囊；再降回收起，顶部原位那条又回来。
  机主确认：☑ 对 / ☐ 不对，备注：__________

- [ ] **⑥ 取消黑遮罩/模态弹窗，抽屉不挡岛；齿轮可现场调参数。**
  没有半透明黑蒙层、没有居中弹窗，拉开抽屉时岛依然可见可点；**右上角**齿轮（和「声望」卡同一行）打开参数面板，可实时改 **7 项**：peek 高度 px / 半开 % / 全开 % / 半开缩放 / 全开缩放 / 动画时长 ms / 显示高亮圈（另带"重置"）。
  *demo 里怎么验*：看拉开抽屉时岛上还有没有黑影；点右上角齿轮，逐项拖一下，立刻看到效果变化。
  机主确认：☑ 对 / ☐ 不对，备注：__________

> 6 条全"对"→ 方案通过，可以进入真实 HUD 实现；有任一条"不对"→ 请写清是哪一条、怎么改，我们按备注再出第二版原型。

---

## 二、5 个待确认问题（每问 2~3 个选项，已标我的默认）

下面 5 个是**必须先拍板才能定实现**的分叉点。我给了默认值（**加粗**即默认），机主如果没意见就按默认走；有意见直接在选项上圈一下。

### ① 半开档到底多高？
| 选项 | 默认 | 一句话代价 |
| --- | --- | --- |
| **45%** | ✅ **默认** | 列表一屏约 3~4 条，岛还剩一半多，最平衡 |
| 55% | | 列表更好用，但岛被压掉一多半，"不挡岛"的说服力变弱 |
| 40% | | 岛留得最多，但列表一次只看得到 2~3 条，找东西要多滚 |

> 影响：这一个数字决定了"抽屉再好用，岛还剩多少"，也是机主第一眼会嫌"挡"或嫌"小"的地方。

### ② 点列表项之后，抽屉怎么办？
| 选项 | 默认 | 一句话代价 |
| --- | --- | --- |
| **降到半开 + 特写** | ✅ **默认** | 视野和"还在列表里"兼顾，最稳；但岛只放到 0.72，不算最大视野 |
| 直接收起 + 特写 | | 视野最大、看建筑最爽；但一返回就丢了列表位置感，连着点第二个要重新拉抽屉 |
| 保持全开 + 小窗特写 | | 列表不动、可以连点；但岛被压到 88% 下面一小条，"特写"名不副实 |

> 影响：这是**最高频的操作路径**（点建筑→看→返回→再点下一个），选错会天天难受。

### ③ 分类用什么形态？
| 选项 | 默认 | 一句话代价 |
| --- | --- | --- |
| **顶部横 tab（可横滚）** | ✅ **默认** | 拇指最容易够到、和现有 HUD 习惯一致；但 5 个以上分类要滚，首屏看不全 |
| 左侧竖栏 | | 分类一目了然、扩展性好；但竖栏吃掉约 15% 宽度，320 窄屏上列表更挤 |
| 顶部下拉菜单 | | 最省地方、分类再多也不怕；但多一步点击，切分类从 1 次变 2 次 |

> 影响：分类多不多取决于最终玩法；如果确定长期就 5 类，横 tab 够用。

### ④ 半开/全开时金币栏放哪？
| 选项 | 默认 | 一句话代价 |
| --- | --- | --- |
| **左上角紧凑胶囊** | ✅ **默认** | 完全让开抽屉、和岛景缩放不打架；但金币"位置会跳"，眼熟度要养几天 |
| 顶部整条压缩 | | 位置不变、最稳；但压缩后文字小、再加上限时活动图标就挤爆 |
| 吸附在抽屉上沿 | | 和抽屉绑一起、视觉最连贯；但抽屉拖到 88% 时金币跟着跑下去，反而不显眼 |

> 影响：金币是玩家最常瞥的数字，位置稳不稳直接影响"我钱够不够"的判断速度。

### ⑤ 抽屉上拉时，岛景怎么动？（另附：特写后怎么返回）
| 选项 | 默认 | 一句话代价 |
| --- | --- | --- |
| **缩小并上移（留在视野里）** | ✅ **默认** | 岛始终是"舞台中央"，缩放最自然；但全开时岛顶到屏幕上方，天空/远景露得少 |
| 缩小并下沉（露出更远地平线） | | 全开时能看到更多远景、更有"看世界"的感觉；但岛往下跑，和抽屉贴太近显得挤 |

> **顺带请拍板：特写之后怎么返回？** 我默认做「**点岛空白处返回**」（顺手、不用找按钮），另配一个右上「返回」按钮兜底；第三个候选是「下拉抽屉返回」。如果机主习惯按钮操作，请说一声，我把默认改成按钮优先。
>
> 影响：这决定"看建筑"这个动作的**回程成本**——岛空白点击是零成本，但新手可能不知道能点。

---

## 三、怎么打开 / 怎么玩

### 打开
- **直接双击 `demo/v2-ui-demo.html`** 即可（Chrome / Edge / Safari 都行）。
- 全部图片已内嵌在 HTML 里，**不联网也能开**，不需要起服务器、不用装任何东西。
- 如果系统默认用别的程序打开了 `.html`，右键 →「打开方式」→ 选浏览器。

### 建议尺寸
- **手机竖屏**：390×844（iPhone 14/15 左右）效果最佳，截图就是按这个尺寸出的。
- 极窄兜底：**320×568**（iPhone SE 一代级别），已实测不横向溢出（见第六节）。
- 桌面浏览器也能开，但会被拉成很宽的窗口，请把窗口拖窄或用 F12 的**设备模拟**切到 390 宽来看。

### 怎么玩（3 分钟走一遍）
1. **看三档**：右上角（齿轮下面）有一竖列调试用快捷按钮「收起 / 半开 / 全开」，挨个点一遍，注意抽屉高度和岛的大小同时变化（当前档高亮）。
2. **拖着玩**：按住底部提手上下拖，松手看它吸附；轻点提手一下，看收起↔半开切换。
3. **切分类**：把抽屉拉到全开/半开，五个分类 tab 已等分整行（不用左右滑），每个都带独立圆角框，逐个点——注意抽屉高度纹丝不动。参数面板里还能调 tab 字号 / 间距 / 描边、切 A 描边框 / B 白底框。
4. **看建筑**：点任意列表项，看抽屉降下来 + 岛推近 + 高亮圈 + 名字标签；然后返回。
5. **盯金币**：在三个档位间来回切，看金币栏从"顶部原位"变"左上紧凑栏"再变回去。
6. **调参数**：点右上**齿轮**打开参数面板，改三档高度%、岛景缩放%、动画时长、高亮圈开关，实时生效。

### console 是否有报错
- 实测结果见第六节（每张截图都采集了 `console error` + `pageerror`）：**0 报错**。F12 打开 Console 可自行复查。

---

## 四、边界与未做（**这是原型，不是实现**）

1. **不碰游戏源码**：没有改 `src/**`、没有改 `package.json`、没有改版本号、不跑回归、不出包。
2. **特写是"假 3D"**：所谓"岛放大平移到建筑"是对背景图做 CSS `transform`（缩放 + 平移）模拟，**不是真 3D 相机**。真实现在游戏里应由相机/渲染层完成，观感会有差别（尤其边缘像素会糊）。
3. **数据全是写死的样例**：建筑/土地/居民列表、金币数、"+10/分钟"都是硬编码假数据，**不接任何后端**；点击不会有真实经济行为。
4. **不是最终视觉**：字体、间距、图标、配色都是原型的够用级别，正式实现要按美术规范重做。
5. **只验证交互骨架**：三档高度、拖拽吸附、特写、金币栏位置切换——这四件事通了就算这次验证成功，动效细节、无障碍、多语言、横屏适配都不在本轮范围。
6. **参数面板是给机主调试用的**，正式版不会暴露给玩家。

---

## 五、截图索引（12 张，全部在 `evidence/`）

| # | 文件名 | 说明 |
| --- | --- | --- |
| 1 | `s23d-01-collapsed-390x844.png` | **收起态**：抽屉只露 60px（提手 + "上拉查看建设"，**分类 tab 整排已移出屏幕**）；岛最大（缩放 1.0）完整可见；**顶部原金币胶囊在原位**（LV 1 + 金币 60.0 + 每分钟 +10.0），左上紧凑栏不可见 |
| 2 | `s23d-02-half-390x844.png` | **半开**：抽屉 379.8px（45%），岛缩到 0.72 悬在抽屉上方；原胶囊隐藏、**左上角出现紧凑金币栏**（🪙 60.0 · +10/分） |
| 3 | `s23d-03-full-390x844.png` | **全开**：抽屉 742.7px（88%），岛缩到 0.55 被压进顶部约 101px 的窄条里（**仍可见，不是被完全盖住**）；左上紧凑金币栏仍在 |
| 4 | `s23d-04-focus-390x844.png` | **半开 + 建筑特写**：点「议事厅」后抽屉自动降到 45%，岛放大到 1.7 倍并平移到市政厅，橙色高亮圈 + 上方「议事厅」名字标签 + 下方「返回半开」按钮 |
| 5 | `s23d-05-full-coin-topleft-390x844.png` | **全开 + 左上紧凑金币栏**：全开态下切到「居民」tab（顺带证明切 tab 不改高度），左上紧凑金币栏可见（DOM 断言 `#compact` opacity=1、`#capsule` opacity=0） |
| 6 | `s23d-06-narrow-320x568.png` | **320 极窄屏 + 半开**：岛可见、5 个分类 tab 一排放下不换行、**无横向滚动**（document/body scrollWidth 均 = 320） |

| 7 | `s23d-07-tabs-390x844-full.png` | **S-23D-2 · 390 全开看 tab 平分**：5 个 tab 严格等分（每格 70.8px），字号 22px（触上限），行高 48px，选中「建筑」整格填充（内缩 2px 圆角），其余只留文字、无小药丸 |
| 8 | `s23d-08-tabs-320x568-full.png` | **S-23D-2 · 320 全开**：每格 56.8px、字号自动降到 20px、行高 46px；5 个 tab 一行放下、不换行、不横滚、无横向溢出（doc/body scrollWidth=320） |

| 9 | `s23d-09-tabs-A-390x844-full.png` | **S-23D-3 · A 描边框（390 全开）**：5 格各 66.8px、字号 13px、行高 34px、gap 8；未选中透明底 + 1px 描边，选中「建筑」淡金底 + 1.5px 金边 |
| 10 | `s23d-10-tabs-B-390x844-full.png` | **S-23D-3 · B 白底框（390 全开）**：同上，但未选中的框是 #FFFFFF 白底 + 很轻阴影，视觉上像一排小白卡片 |
| 11 | `s23d-11-tabs-A-320x568-full.png` | **S-23D-3 · 320 全开（A 版）**：字号自动降到 12px、每格 52.8px、行高 34px、不换行不横滚不溢出（scrollWidth=320） |
| 12 | `s23d-12-tabs-AB-compare-390x844.png` | **A/B 1:1 局部对比**（上=A 描边框，下=B 白底框），裁自两张 390 全开图的 tab 行，方便直接挑 |

> **轮次说明**：1~8 是上一轮（S-23D-2，tab 为"五等分 + 大字 + 填充"）留档；**9~12 是本轮 S-23D-3 的现行样式**，demo 里已同步。

> **出图环境说明**：截图机器是 headless Chromium 154（Linux，无 emoji 字体）。因此 demo 所有图标/金币/齿轮**一律用内联 SVG 绘制、不用 emoji**——6 张图里没有任何 ☒ 豆腐块，换成机主手机或桌面浏览器打开也是同一副样子（且不依赖任何字体/外链）。

---

## 六、验收自检结果（实测，非估计）

<!-- AUTO-CHECK:START -->
**测试环境**：headless Chromium 154 / `/usr/bin/chromium`（Playwright 驱动），390×844 与 320×568，`deviceScaleFactor=2`；用 `file://` 直接打开单文件，另用 `python3 -m http.server` 复测一遍。

| 检查项 | 实测结果 | 判定 |
| --- | --- | --- |
| console error + pageerror | **0**（`file://` 与 `http://` 两种打开方式均 0） | ✅ |
| 外部网络请求 | **0**（图片全 base64 内嵌，无 CDN/无字体外链/无 fetch） | ✅ |
| 三档抽屉高度（390×844） | peek **60px** / half **379.8px（45%H）** / full **742.72px（88%H）** | ✅ |
| 岛景缩放 | **1.0 / 0.72 / 0.55**（随档位递减），平移 ty 0 / −50.6 / −325px | ✅ |
| 全开时岛是否可见 | 岛图 y = −21…111，抽屉顶 y = 101 ⇒ **上方仍露出约 101px 岛图**（岛本体约 99px 高，不是全被盖住） | ✅ |
| 只点提手 | peek ⇄ half 正常切换（轻点不拖，位移<6px 判定为点击） | ✅ |
| 拖拽跟手 | 指针移动时抽屉高度连续跟随（采样 100→140→180…→380px 无跳变） | ✅ |
| 松手吸附 | 吸附到最近档位；全开下拉可连续经过 half 一直降到 peek（采样 683→623→…→83px） | ✅ |
| 点列表项 → 特写 | 抽屉降到 half + 岛 scale **1.7** + 高亮圈可见（58×58）+ 名字标签「议事厅」；`body[data-focus=1]` | ✅ |
| 特写返回 | `back()` / 点岛或天空空白 / 「返回半开」按钮 均回 half，focus 清空 | ✅ |
| 切 tab 不改高度 | 切到「居民」后 drawerPx 379.8 → 379.8（不变） | ✅ |
| 金币栏切换 | peek：原胶囊 opacity=**1**、紧凑栏 opacity=**0**；half/full：紧凑栏 opacity=**1** 且位于左上 **(10,10)**、原胶囊 opacity=**0**；降回 peek 后恢复 | ✅ |
| 320×568 横向溢出 | document.scrollWidth=**320**、body.scrollWidth=**320**（半开态与全开态都测了） | ✅ |
| 黑遮罩/模态层 | 扫描全屏深色半透明层 = **0 个**（`rgba(0,0,0,α>0.15)` 且面积≥90% 视口） | ✅ |
| 分类 tab 等分 + 独立框（S-23D-3） | 390：5 格各 **66.8px**（= (390−24−8×4)/5）、字号 **13px**（两字 26px = 格宽 **38.9%**）、行高 **34px**；320：5 格各 **52.8px**、字号 **12px**（24px = **45.5%**）、行高 34px；圆角 9px、1px 描边 #D8C7A4；`#tabs` scrollWidth−clientWidth=**0**，doc/body scrollWidth=320/390 | ✅ |
| tab 参数滑杆（S-23D-3） | 面板新增「tab 字号 11~16 / tab 间距 4~12 / tab 描边 1~2 / 白底框 B 版」；实测 16→16px/38px 行高、12→gap 12px、2→2px 描边、11→11px/34px 行高，全部即时生效；重置回 13/8/1/A | ✅ |
| 收起档 tab 不外露（S-23D-2） | peek 时 `#tabs` opacity=**0** 且 translateY 36px ⇒ 视口内可见高度 **0px**（只露 60px 提手 + 提示文字） | ✅ |
| 参数面板 | 右上齿轮可打开，7 个控件（peek px / half% / full% / half 缩放 / full 缩放 / 动画时长 / 高亮圈开关）+ 重置 | ✅ |
| 截图 | 6 张：5×**780×1688**（390×844@2x）+ 1×**640×1136**（320×568@2x），175,332~405,776 B | ✅ |

**已知限制（如实记录，不算 bug）**
1. 特写是背景图 `transform` 放大（1.7×），源图只有 330×240，**放大会糊**——正式实现应由 3D 相机做，自然会清晰。
2. 全开 88% 时留给岛景的只有 12% 屏高（101px），岛只能缩到 0.55 挤在顶部窄条里；若机主希望"全开也看得清岛"，可把 full% 调到 80~82（参数面板现场可调）。
3. 岛图是从真机截图裁出来做了透明抠底的，边缘有极淡残影/一朵云，属素材本身，不影响交互验证。
<!-- AUTO-CHECK:END -->
