用途：把水面当作几何运动、表面朝向与参与性光学层来处理，而非仅用蓝色透明材质。适用于需要解析式多波位移与法线、有界 RGBA 高度场水池模拟、局部落点、可拖拽物体位移、差分面积焦散，以及在着色器内对水池边界与球体做光线追踪的场景。
主要能力：定义波带并求位移；由同一组波解析推导法线；选择位移几何或仅法线水面；为启发式折射建立场景颜色归属；声明吸收使用真实深度还是回退路径长度估计；通过区分正反面的菲涅尔混合解析反射与折射；由共享波响应推导泡沫与闪光；从导数中过滤未解析的法线频段。资料还包含可参考或复制的示例与资产。
使用方式：按解析水面构建顺序执行上述步骤；阅读 references/water-surface-system.md 了解位移/法线契约、光学层级、正反面折射、吸收回退与诊断通道；阅读交互式水池体积实现了解有界 RGBA 高度/速度/法线模拟、局部落点、移动球体位移、差分面积焦散及着色器内光线追踪。
限制与失败条件：法线贴图运动与位移波峰不一致；启发式折射可采样前景物体但未披露该限制；回退路径长度被当作重建的场景厚度；有界水池焦散与模拟高度法线脱节；微波纹混叠成闪烁噪声；泡沫是与共享波峰指标无关的滚动贴图；用恒定不透明度替代菲涅尔；反射、折射与透明度叠加而无能量控制。
路由边界：随机方向谱、FFT 级联、雅可比破碎、持久海洋泡沫及相机穿越界面应使用 $threejs-spectral-ocean；本技能的启发式屏幕折射偏移假设从空气观察有界体积，开放界面需该技能的前向投影。雨致水洼湿度、涟漪遮罩与天气耦合溅水应使用 $threejs-precipitation-surfaces。本技能负责作者化解析波、有界高度场模拟、光线追踪水池体积光学与有界水面光学。