# 夜空中泳池 · 五女泡澡交互网页 — 产品说明文档

> 文件：`sky-pool.html`（单文件，约 700KB，完全离线，双击即开）
> 版本：2026-09-09

## 一、这个页面是做什么的

这是一个**可交互的 3D 视觉场景网页**：五位女性角色在**夜空中的悬浮无边泳池**里泡澡。用户可通过触摸/鼠标操控镜头、点选角色、甚至直接上手"揉捏"角色的乳房，用以**具象化演绎小说中的色情场景**，尤其是乳房揉搓、摇晃、乳浪的动态视觉与手感。

本质上是**写书建模的视觉辅助工具**——把文字里描写"巨乳揉捏、乳浪层叠、指尖陷奶"的画面，以立体的、可触摸的方式呈现出来，帮助内容安全写书时建立画面感与感官参照。

## 二、要达到的效果与目的

### 1. 视觉震撼（氛围）
- **夜空剧场**：星空、明月、云海、地平线城市灯火、深渊倒影的水面，营造夜色幽蓝的浪漫与神秘。
- **五女共浴**：五位女主浸泡水中，山水相交，水面反射星光。
- **女性美感**：写实躯干（沙漏形） + 卡通脸，皮肤用物理材质（奶油光泽 + 通透微光），乳房饱满有轮廓、配乳晕乳尖。

### 2. 写书感官参照（核心价值）
- 聚焦角色后，左侧/底部弹出该角色的**乳体描写**与**写书参考乳浪意象**（如「K杯冰钟」「乳浪如山」「冰蓝纹路随体温一层层褪」）。
- 揉乳时**乳房实时变形**——按下去凹陷、松开回弹、乳浪向外荡开、乳尖硬起，供作者跨媒介感受"手感"与"动感"。

### 3. 可玩可动（交互）
- 手动控制镜头：拖动旋转视角、捏合缩放远近，全面观察。
- 四个体位视角切换：全景 / 揉乳 / 乳交 / 提臀。
- 直接上手揉乳，有物理反馈。

## 三、操作方法

### 鼠标（桌面端）
| 操作 | 效果 |
|------|------|
| 点击底部人物栏头像 | 聚焦到该角色 |
| 空白处按住拖拽 | 旋转视角（左右转动 / 上下俯仰） |
| 滚轮 | 缩放远近 |
| 按住乳房拖拽 | 揉捏乳房（凹陷 + 乳浪 + 乳尖硬起） |
| 右上角「全景/揉乳/乳交/提臀」 | 切换体位视角 |
| 左上「← 返回泳池全景」 | 退出聚焦 |
| 点击描述卡标题栏 | 展开 / 收起描写卡片 |

### 触摸（手机端）
| 操作 | 效果 |
|------|------|
| 点底部人物栏 | 聚焦 |
| 单指空白处拖拽 | 旋转视角 |
| 双指捏合 / 张开 | 缩放 |
| 单指按住乳房拖拽 | 揉捏乳房 |
| 点描述卡细条 | 展开 / 收起描写 |

> 手势智能区分：悬停/落在乳房上 = 揉乳；落在空白处 = 转视角；双指 = 缩放。三种操作互不冲突。

### 调试参数（URL 附带）
```
sky-pool.html?focus=0&view=knead&snap=1&squeeze=1
```
- `focus=0..4`：直接聚焦第 N 个角色
- `view=overview|knead|titfuck|tui`：直接切换视角
- `snap=1`：镜头瞬移（不缓动），便于截图
- `squeeze=1`：自动演示揉乳变形

## 四、页面结构

```
sky-pool.html
├── <style>              样式(含移动端 @media 适配)
├── 角色数据模型          CHARACTERS 数组(5人的人设/乳体参数/描写/意象)
├── three.js (内联)       3D 引擎库
└── 场景引擎脚本
    ├── 场景:星空/月亮/云海/城市灯火/水面/池体
    ├── 人物建模:写实躯干+卡通脸+乳房(变形球)
    ├── 相机系统:基位+用户手控(yaw/pitch/dist)
    ├── 手势识别:rotate / knead / pinch
    ├── 乳质变形 shader:捏压凹陷+乳浪+乳尖硬起
    └── UI:人物栏/视角按钮/描述卡/返回/水牌
```

## 五、角色一览（乳体设定）

| 角色 | 定位 | 乳体关键词 |
|------|------|-----------|
| 宫宵月 | 落痕女帝 · 秦天之母 | 全书最大人族乳，雪白 S 型，乳浪如山 |
| 姜凝香 | 玄霜圣女 · 冰钟巨乳 | K杯近L圆钟，冰蓝微光，由凉渐温 |
| 影姬 | 玄阴龙鼎 · 暗卫姐姐 | 圆润半球，媚体乳纹，弹性极佳 |
| 王姐 | 工地大姐 · 厚重H杯 | 小麦色结实，H杯厚重，乳浪慢而沉 |
| 方圆 | 博士妹妹 · 娇小F杯 | 娇小文静，F杯娇紧，弹得快 |

## 六、技术要点

- **单文件、离线**：three.js 内联（约 600KB），无需网络/构建，双击即开。
- **性能**：低多边形人体 + 程序化点云星空 + 实例化水面；只有特写时才启用精细乳体变形。
- **皮肤材质**：`MeshPhysicalMaterial`——clearcoat 奶油光泽 + sheen 通透微光 + 微 emissive，模拟次表面透光，避免塑料感。
- **乳体变形**：顶点 shader（`onBeforeCompile` 注入），以"抓取点"为圆心做高斯衰减：
  - `uHand`：向抓取点凹陷（捏入）
  - `uWave`：以抓取点为中心向外荡开的波纹（乳浪）
  - `uNip`：乳尖外鼓（硬起）
  - 每个角色独立一套乳质参数（弹量/分量/乳浪频率/敏感度），手感各异。
- **手势系统**：指针事件区分 `rotate / knead / pinch` 三种手势——悬停/落在乳房上即揉乳，空白处即转视角，双指即缩放；移动端 `touch-action:none` 确保拖拽不引发页面滚动。

## 七、移动端适配

- viewport `user-scalable=no`，禁止页面级缩放，交由 canvas 自己处理捏合。
- 人物栏紧凑、标题缩小错位、描述卡改为**底部可折叠细条**（默认收起，只显示角色名+tag，点按展开，不遮挡人物）。
- 竖屏镜头按比例自动拉近（`zoomScale` 0.62 / 0.78），聚焦后人物填满画面。

## 八、已知限制

- 人物为**风格化低多边形**，非写实照片级精度；兼顾"卡通脸 + 写实身体"的折中。
- 揉乳手感在特写视角最明显；远视角变形较微弱。
- 水面波纹为程序化 shader 模拟，非真实流体。