# 湖南 10 场景音乐旅程

这是 `energy-field` 之后的第二版音乐视觉资产原型，目标从单一抽象能量场推进到“湖南/长沙 10 个场景串联的音乐旅程”。

## 入口

在项目根目录启动静态服务：

```bash
python3 -m http.server 4613 --bind 127.0.0.1
```

打开：

```text
http://127.0.0.1:4613/
```

或者直接打开资产：

```text
http://127.0.0.1:4613/hunan-journey/index.html?auto=1&ar=2.58&mode=hybrid&ui=0
```

张家界高精样板：

```text
http://127.0.0.1:4613/hunan-journey/index.html?ar=2.58&mode=scenes&scene=5&ui=0
```

常用参数：

- `?auto=1`：自动按音乐节奏/时间轴切换 10 个场景。
- `?mode=hybrid`：默认演出模式，按 32 拍结构穿插独立 3D 均衡器段落、湖南场景插入和融合过渡。
- `?mode=scenes`：场景巡检模式，湖南场景占主画面。
- `?mode=equalizer` / `?mode=visual3d`：独立 3D 视觉均衡器模式，不插入湖南场景。
- `?ui=0`：隐藏主控 UI，但保留左下角极简恢复按钮；键盘 `H` 也可恢复。
- `?capture=1`：完全隐藏 UI 和恢复按钮，用于录屏。
- `?ar=2.58|16:9|2.333|0.5625`：支持 2.58:1、16:9、21:9、9:16 多画幅构图。

## 当前版本覆盖

- 根目录 `index.html` 已作为主项目视觉控制台，统一提供顺播预览、录屏输出、纯净预览和单场景巡检入口。
- 根入口默认改为简洁演出预览：首屏只保留高频操作，单场景巡检、项目资产和调试模式需要展开“高级控制”。
- 根入口新增多画幅选择和全屏预览：2.58:1、16:9、21:9、9:16；切换后演出、录屏、纯均衡器和单场景入口会同步重建 URL。
- `manifest.json` 已作为 10 场景清单，控制台和验证脚本共用。
- 第 5 场“张家界 · 武陵源”已作为第一版高精样板：新增程序化岩纹、密集峰林、云海、玻璃栈道、瀑布、植被冠层和能量地形母体。
- 导演镜头已改为连续阻尼 camera rig：相机轨道、注视点和 FOV 都按帧间时间平滑过渡，节拍只影响推进速度和轻微呼吸，不再每拍硬抽动。
- 根入口全屏按钮已修复：预览 iframe 具备 fullscreen 权限，验证脚本通过真实点击确认可进入 iframe fullscreen。
- 10 个程序化场景：橘子洲头、杜甫江阁、岳麓书院/爱晚亭、天门山、武陵源、凤凰古城、岳阳楼、梅溪湖、长沙 IFS、文和友/太平街。
- 10 个场景已配置不同的均衡器 anchor/layout：水面场景贴水线，天门山把音波放到星空层，武陵源移到云海谷地，IFS 使用塔冠高度，文和友贴近霓虹街道。
- 独立 3D 均衡器已从单条波形线升级为体积化 `energyField`：1150 个 instanced 小柱、径向能量 spire、环带和核心脉冲组成紫蓝音乐地貌，方向对齐参考视频中的能量场。
- 自动播放被浏览器拦截时会显示“点击启动音乐”；点击后播放 `spectrum/demo.mp3` 并接入 Web Audio analyser，不再静默退回成一条假节拍直线。
- Web Audio `AnalyserNode` 低频/中频/高频分析。
- 低频 onset 触发节奏脉冲、平滑镜头推进和场景插入。
- 均衡器不再只是小比例融合层；`hybrid` 模式先给独立 3D 视觉均衡器完整段落，再切入湖南场景段落，中间保留融合过渡。
- 白天 / 黄昏 / 夜晚光照预设会跟随乐句和场景阶段变化。
- 无音频授权或自动播放被浏览器阻止时，使用 fallback BPM 继续驱动画面。
- `window.__hooks` 自测接口：`ready`、`error`、`stats`、`setScene()`、`settle()`、`freeze()`、`beat`。

## 验证

```bash
node scripts/verify-waic-visuals.mjs http://127.0.0.1:4613
```

当前验证覆盖根入口 4 个画幅按钮、16:9 切换、真实点击全屏、点击启动 demo audio、hybrid 开场体积化 `energyField`、湖南场景插入，以及 10 个场景各自的 equalizer anchor/layout。

## 建模边界

当前是“组合演示页”的第二阶段资产原型，重点验证节奏驱动、10 场景切换、可辨识主体、大屏构图和一个高精样板的资产语法。第 5 场已明显高于其他低模场景，但仍不是最终照片级比例化重建。后续应把 1、10 场也按第 5 场的资产密度补齐，并逐步补 Sky/Water/PMREM、三态昼夜、独立 headless 自测。