@realsee/five-webgpu 1.0.0-alpha.5 → 1.0.0-alpha.6

package/ai_guides/api.md

@@ -24,7 +24,7 @@ const five = new Five(initArgs?: FiveInitArgs);
 | `five.scene` | `THREE.Scene` | The Three.js scene used for non-model elements. |
 | `five.modelScene` | `ModelScene` | The Three.js scene used for the model. |
 | `five.camera` | `Camera` | The internal camera. |
-| `five.renderer` | `THREE.WebGLRenderer` | The WebGL renderer. |
+| `five.renderer` | `THREE.WebGPURenderer` | The WebGPU renderer. |
 | `five.needsRender` | `boolean` | Set to `true` to request a render frame in the next loop. |
 | `five.plugins` | `Object` | Access to registered plugins. |
 
@@ -32,7 +32,7 @@ const five = new Five(initArgs?: FiveInitArgs);
 
 | Property | Type | Description |
 | :--- | :--- | :--- |
-| `Five.Mode` | `Enum` | Available modes: `Panorama`, `Model`, `Floorplan`, `Topview`, `Mapview`, `VRPanorama`, `XRPanorama`. |
+| `Five.Mode` | `Enum` | Available modes: `Panorama`, `Model`, `Floorplan`, `Topview`, `Mapview`, `VRPanorama`. |
 
 ## Initialization Configuration (`FiveInitArgs`)
 
@@ -40,8 +40,8 @@ Configuration object passed to the `Five` constructor.
 
 ```typescript
 interface FiveInitArgs {
-  /** External WebGLRenderer. If provided, internal renderer creation is skipped. */
-  renderer?: THREE.WebGLRenderer;
+  /** External WebGPURenderer. If provided, internal renderer creation is skipped. */
+  renderer?: THREE.WebGPURenderer;
 
   /** Width/Height of the viewport relative to container (0-1). */
   viewport?: { left: number; bottom: number; width: number; height: number };
@@ -80,12 +80,13 @@ interface FiveInitArgs {
 
 ## Core Methods
 
-### `load(work, state?, options?)`
+### `load(inputWork, state?, options?, userAction?)`
 Loads a "Work" (dataset) into the Five instance.
 
-- **work**: The data object (`LooseWork` or `Work`) containing scene information.
+- **inputWork**: The data object (`LooseWork` or `Work`) containing scene information.
 - **state**: Initial state overrides. `"inherit"`, `"initial"`, or a `State` object.
 - **options**: Loading options (e.g., transition duration).
+- **userAction**: Whether the load was triggered by a user action. Defaults to `true`.
 
 ### `appendTo(element, size?)`
 Mounts the Five canvas to a DOM element.
@@ -243,8 +244,8 @@ These events follow a standard naming convention and provide typed event objects
 | :--- | :--- | :--- |
 | `works.load` | Triggered when work data starts loading. | `WorksEvent` |
 | `models.load` | Triggered when models are loaded. | `ModelSceneEvent` |
-| `model.tileLoad` | Triggered when a 3D tile is loaded. | `Tile` |
-| `model.tileUnload` | Triggered when a 3D tile is unloaded. | `Tile` |
+| `models.tileLoad` | Triggered when a 3D tile is loaded. | `ModelTileEvent` |
+| `models.tileUnload` | Triggered when a 3D tile is unloaded. | `ModelTileEvent` |
 | `pano.arrived` | Triggered when arrival at a panorama node. | `PanoEvent` |
 | `pano.texture.progress` | Triggered when panorama texture loading progresses. | `{ progress, panoIndex }` |
 | `render` | Triggered after each render frame. | `RenderEvent` |

package/ai_guides/features/camera-animation.md

@@ -104,7 +104,7 @@ five.changeMode(mode: Mode, options?, animationOptions?): Promise<void>
 
 | Parameter | Type | Default | Description |
 | :--- | :--- | :--- | :--- |
-| `modeChangeDuration` | `number` | `1000` | 模态切换 (如 Panorama -> Mapview) 的默认时长 (ms)。 |
+| `modeChangeDuration` | `number` | `800` | 模态切换 (如 Panorama -> Mapview) 的默认时长 (ms)。 |
 
 ### MovePanoOptions Configuration (移动参数)
 

package/ai_guides/features/event.md

@@ -70,7 +70,6 @@ Five 的事件系统将事件主要分为以下几类：
 
 - `pano.arrived`: 成功到达新点位（移动动画结束）。
 - `pano.moving`: 正在移动到新点位（动画进行中）。
-- `pano.willChange`: 即将发生点位变更（旧版兼容）。
 - `pano.error`: 点位加载或移动出错。
 
 ### State Events (状态变更)

package/ai_guides/features/five.md

@@ -17,7 +17,7 @@
 ```typescript
 interface FiveInitArgs {
   /** 外部传入的渲染器 (如果传入，部分渲染配置将失效) */
-  renderer?: THREE.WebGLRenderer;
+  renderer?: THREE.WebGPURenderer;
   /**
    * 屏幕渲染区域 { left, bottom, width, height }
    * 必须配合外部 renderer 使用
@@ -35,7 +35,7 @@ interface FiveInitArgs {
   textureOptions?: TextureOptions;
   /** 是否按需渲染 (默认 true, 推荐开启以节省性能) */
   onlyRenderIfNeeds?: boolean;
-  /** 模式切换动画时长 (ms, 默认 1000) */
+  /** 模式切换动画时长 (ms, 默认 800) */
   modeChangeDuration?: number;
   /** 是否支持滚轮缩放 (默认 true) */
   enableWheel?: boolean;
@@ -55,7 +55,7 @@ Five 实例是整个 3D 场景的入口。
 
 ### Rendering Loop (渲染循环)
 Five 内部维护了一个 `requestAnimationFrame` 循环。
-- **按需渲染**: 默认开启 `onlyRenderIfNeeds`，仅在画面发生变化（如视角移动、数据加载）时才触发 WebGL 绘制，大幅降低能耗。
+- **按需渲染**: 默认开启 `onlyRenderIfNeeds`，仅在画面发生变化（如视角移动、数据加载）时才触发渲染，大幅降低能耗。
 - **手动触发**: 可以通过 `five.needsRender = true` 强制下一帧进行渲染。
 
 ### Resource Loading (资源加载)
@@ -71,7 +71,7 @@ Five 内部维护了一个 `requestAnimationFrame` 循环。
 | `textureOptions` | `TextureOptions` | `{}` | 贴图加载策略，同上 |
 | `onlyRenderIfNeeds` | `boolean` | `true` | 是否仅在需要时渲染，建议保持 `true` |
 | `antialias` | `boolean` | `false` | 抗锯齿，开启会增加性能消耗 |
-| `modeChangeDuration` | `number` | `1000` | 模式切换动画时长 (ms) |
+| `modeChangeDuration` | `number` | `800` | 模式切换动画时长 (ms) |
 | `enableWheel` | `boolean` | `true` | 是否支持滚轮缩放 |
 
 ## Examples
@@ -103,7 +103,7 @@ five.load(workData);
 import * as THREE from "three/webgpu";
 import { Five } from "@realsee/five-webgpu";
 
-const renderer = new THREE.WebGLRenderer();
+const renderer = new THREE.WebGPURenderer();
 renderer.setSize(window.innerWidth, window.innerHeight);
 document.body.appendChild(renderer.domElement);
 
@@ -152,8 +152,8 @@ five.updateCameraWithKeyframes(keyframes, 2000).then(() => {
 ### 实例方法 (Instance Methods)
 
 - **`appendTo(element: HTMLElement)`**: 将 canvas 挂载到指定 DOM 元素。
-- **`load(work: Work, state?: State, duration?: number)`**: 加载场景数据。详见 [work.md](./work.md)。
-- **`dispose()`**: 销毁实例，释放 WebGL 上下文与内存。
+- **`load(inputWork, state?: "inherit" | "initial" | Partial<State>, options?: number | FiveLoadOptions, userAction?: boolean)`**: 加载场景数据。详见 [work.md](./work.md)。
+- **`dispose()`**: 销毁实例并释放相关渲染资源。
 - **`updateCamera(pose: Partial<Pose>, duration: number, userAction?: boolean)`**: 移动相机（不触发点位移动）。移动相机的视角或位置，不会改变当前所在的 PanoIndex。如果动画中途被打断，Promise 会被 reject。
 - **`updateCameraWithKeyframes(keyframes: { progress: number; value: Pose; key?: string }[], duration: number, userAction?: boolean)`**: 通过关键帧动画移动相机。
 - **`refresh()`**: 强制刷新画布尺寸。通常在窗口 resize 时调用，Five 会自动监听 resize，但在某些布局变化场景下可能需要手动调用。
@@ -164,7 +164,7 @@ five.updateCameraWithKeyframes(keyframes, 2000).then(() => {
     1. **状态同步**：相机姿态已通过动画过渡到目标状态（`stateSynced` 为 true）。
     2. **模型加载**：如果是 Floorplan/Topview/Mapview/Model 模态，需等待模型加载完成 (`modelScene.loaded`)。
     3. **瓦片加载**：如果是 Panorama 模态且传入了 `{ tile: true }`，需等待当前视角的瓦片加载完成。
-- **`setState(state: Partial<State>, options?: ChangeStateOptions)`**: 变更当前状态（如点位、视角）。详见 [state.md](./state.md)。
+- **`setState(state: Partial<State>, immediately?: boolean, userAction?: boolean)`**: 变更当前状态（如点位、视角）。详见 [state.md](./state.md)。
 - **`on(event, callback)` / `off(event, callback)`**: 事件监听。详见 [event.md](./event.md)。
 
 ## Related

package/ai_guides/features/gesture.md

@@ -44,7 +44,7 @@ interface GestureEvent {
 
 Five 的手势系统基于 Hammer.js 封装，主要包含以下几种手势：
 
-*   **gesture.create**: 所有事件创建时。
+*   **gesture.fire**: 任意事件被触发。
 *   **gesture.pan**: 拖拽/平移。
 *   **gesture.pinch**: 双指缩放。
 *   **gesture.tap**: 点击。

package/ai_guides/features/load-external-model.md

@@ -30,7 +30,7 @@ export type LoadResultType<Scene = THREE.Object3D> = {
 
 // 通用配置项接口
 interface BaseLoaderOptions {
-  upAxis?: 'Y' | 'Z';         // 期望输出的上轴，默认为 'Z' (Five 坐标系)
+  upAxis?: 'Y' | 'Z';         // 期望输出的上轴，默认为 'Z'（加载器输出坐标系）
   modelUpAxis?: 'Y' | 'Z';    // (部分加载器支持) 原始模型的上轴，用于自动旋转修正
   fetcher?: Fetcher;          // 自定义网络请求 Fetcher
   light?: boolean;            // 是否使用简化/无光照材质 (取决于加载器实现)
@@ -44,15 +44,15 @@ interface BaseLoaderOptions {
 这些加载函数（如 `loadGltf`, `loadPly`）是 `@realsee/five-webgpu` 包导出的**独立函数**，而非 `Five` 实例的方法。你需要单独引入它们使用。
 
 ### 坐标系转换 (Up-Axis Conversion)
-Five 使用 **Z-up** (Z 轴向上) 的右手坐标系。
+Five 运行时场景使用 **Y-up** (Y 轴向上) 的右手坐标系；加载器默认输出通常为 **Z-up**。
 许多外部模型（如 standard GLTF, FBX）通常是 **Y-up** 的。
 加载器提供了 `upAxis` 和 `modelUpAxis` 选项来自动处理旋转：
-- `upAxis`: 你期望得到的结果坐标系上轴（通常保持默认 'Z'）。
+- `upAxis`: 你期望得到的加载器输出坐标系上轴（通常保持默认 'Z'）。
 - `modelUpAxis`: 原始文件的上轴（如 GLTF 默认为 'Y'，PLY 默认为 'Z'）。
-如果不指定，加载器会尝试使用合理的默认值将模型旋转到 Z 轴向上。
+如果不指定，加载器会使用各自的默认值；将结果直接添加到 `five.scene` 时，应按需设置 `upAxis: 'Y'` 与 Five 的运行时坐标系对齐。
 
 ### 资源销毁 (Disposal)
-加载的模型包含 Geometry、Material 和 Texture 等 WebGL 资源。当你不再需要该模型时（例如切换场景或移除物体），**必须**调用返回结果中的 `dispose()` 方法来释放内存，否则会导致内存泄漏。
+加载的模型包含 Geometry、Material 和 Texture 等 GPU 资源。当你不再需要该模型时（例如切换场景或移除物体），**必须**调用返回结果中的 `dispose()` 方法来释放资源，否则会导致内存泄漏。
 
 ### Fetcher
 所有加载器支持传入自定义 `fetcher`。这在需要鉴权、自定义 Header 或处理特定 CDN 逻辑时非常有用。如果不传，默认使用内部的 `internalFetcher`。
@@ -241,7 +241,7 @@ import { loadSplat } from '@realsee/five-webgpu';
 
 loadSplat('https://example.com/scene.splat', {
   modelUpAxis: 'Y', // 假设原始数据是 Y-up
-  upAxis: 'Z',      // 转换到 Five 的 Z-up
+  upAxis: 'Y',      // 转换到 Five 的 Y-up 运行时坐标系
 }).then((result) => {
   const splatMesh = result.scene;
   five.scene.add(splatMesh);

package/ai_guides/features/load-progress.md

@@ -85,11 +85,11 @@ const progress = tile.content.loadProgress; // [0, 1]
 监控单个 Tile 的加载与卸载事件，用于更精细的调试或资源统计。
 
 ```ts
-five.on("model.tileLoad", (tile) => {
+five.on("models.tileLoad", ({ tile }) => {
   console.log(`Tile loaded: ${tile.debugLabel}, Size: ${tile.content.byteLength}`);
 });
 
-five.on("model.tileUnload", (tile) => {
+five.on("models.tileUnload", ({ tile }) => {
   console.log(`Tile unloaded: ${tile.debugLabel}`);
 });
 ```

package/ai_guides/features/mode.md

@@ -1,8 +1,8 @@
 # Mode (模式)
 
-- **Summary**: Five 支持多种交互模式，包括全景漫游、模型浏览、VR/XR 等，适用于不同的看房场景。
-- **Schema**: 字符串枚举类型，定义了 6 种交互模式。
-- **Concepts**: Panorama, Mapview, Floorplan, Topview, Model, VR/XR。
+- **Summary**: Five 支持全景漫游、模型浏览等五种交互模式，适用于不同的看房场景。
+- **Schema**: 字符串枚举类型，定义了 5 种交互模式。
+- **Concepts**: Panorama, Mapview, Floorplan, Topview, Model。
 - **Examples**: 模式切换与事件监听。
 
 ## Schema
@@ -18,8 +18,6 @@ type Mode =
   | "Floorplan"  // 模型户型图模式
   | "Topview"    // 模型平面图模式
   | "Model"      // 模型游走模式
-  | "VRPanorama" // Cardboard VR 眼镜模式
-  | "XRPanorama" // WebXR 虚拟现实 VR 眼镜模式
 ```
 
 ## Concepts
@@ -34,8 +32,6 @@ type Mode =
     *   交互：鼠标拖拽 / Pan手势平移相机；滚轮 / Pinch手势缩放画面；点击 / Tap切换到最近全景点。
 *   **Model (模型漫游)**: 适用于第一人称在场景中自由游览。交互同 Panorama，但不限制相机只能在观察点位置。
     *   交互：鼠标拖拽 / Pan手势旋转视角；滚轮 / Pinch手势缩放视场角；点击 / Tap移动到指定位置。
-*   **VRPanorama / XRPanorama**: 适配 VR 设备（如 Google Cardboard, Apple Vision Pro 等）的沉浸式模式。
-    *   交互：配合设备手柄或头部追踪，基本交互逻辑同 Panorama。
 
 ## Configuration
 
@@ -135,22 +131,6 @@ interface ModelConfig {
 }
 ```
 
-### VRPanorama / XRPanorama (VR 模式)
-
-继承自 Panorama 配置，但移除了俯仰角限制（`maxLatitude`, `minLatitude`），因为 VR 模式下视角由设备姿态控制。
-
-```typescript
-interface VRPanoramaConfig {
-  // ... 同 Panorama 基础配置
-  // 移除: maxLatitude, minLatitude
-}
-
-interface XRPanoramaConfig {
-  // ... 同 Panorama 基础配置
-  // 移除: maxLatitude, minLatitude
-}
-```
-
 ## Examples
 
 ### 快速上手 (Quick Example)

package/ai_guides/features/model.md

@@ -146,7 +146,7 @@ if (model) {
   console.log("模型是否细化完成:", model.refined);
 
   // 监听模型细化事件
-  five.on("model.refined", () => {
+  five.on("models.refined", () => {
     console.log("模型高清资源加载完毕");
   });
 }

package/ai_guides/features/state.md

@@ -79,8 +79,8 @@ const state = five.state;
 
 // 在当前状态基础上，向右旋转 90 度，并略微拉远距离
 five.setState({
-  longitude: tate.longitude + Math.PI / 2,
-  distance: tate.distance + 2.0
+  longitude: state.longitude + Math.PI / 2,
+  distance: state.distance + 2.0
 });
 ```
 

package/ai_guides/features/ultra-hdr.md

@@ -1,13 +1,13 @@
-# UltraHDR / GainMap 渲染
+# UltraHDR / gainmap 渲染
 
-本篇说明 five-webgpu 如何用 UltraHDR（GainMap）方案还原全景图的高动态范围，重点是**最终 RGB 是如何算出来的**。
+本篇说明 five-webgpu 如何用 UltraHDR（gainmap）方案还原全景图的高动态范围，重点是**最终 RGB 是如何算出来的**。
 
 ## 基本原理
 
 UltraHDR 不直接存 HDR 像素，而是拆成两部分：
 
 - **SDR 底图（base / color）**：普通的 8bit 全景图，直接可显示。
-- **GainMap（增益图）**：每个像素存一个 `[0,1]` 的增益值，表示该像素相对 SDR 需要放大多少亮度。
+- **gainmap（增益图）**：每个像素存一个 `[0,1]` 的增益值，表示该像素相对 SDR 需要放大多少亮度。
 
 渲染时的公式是：
 
@@ -15,11 +15,11 @@ UltraHDR 不直接存 HDR 像素，而是拆成两部分：
 finalRGB = sdrRGB * boost(gain)
 ```
 
-`boost` 是由 GainMap 值加上一组元数据（HDR config）算出的每通道增益系数。当没有 HDR（增益全为 1 / 未启用）时 `boost = 1`，退化为普通 SDR。
+`boost` 是由 gainmap 值加上一组元数据（HDR config）算出的每通道增益系数。当没有 HDR（增益全为 1 / 未启用）时 `boost = 1`，退化为普通 SDR。
 
 ## 相关数据结构
 
-GainMap 元数据来自每个点位的 `hdrConfig`（`HDRCfgData`）：
+gainmap 元数据来自每个点位的 `observer.images.gainmap?.cfg`（`GainmapCfgData`）：该点位无 HDR 数据时 `images.gainmap` 字段不存在。
 
 | 字段 | 含义 |
 | --- | --- |
@@ -27,9 +27,9 @@ GainMap 元数据来自每个点位的 `hdrConfig`（`HDRCfgData`）：
 | `minContentBoost` | 内容侧最小亮度增益（gain=0 时对应，通常为 1） |
 | `hdrCapacityMin` | 显示器 HDR 容量下限（通常为 1） |
 | `hdrCapacityMax` | 显示器 HDR 容量上限 |
-| `gamma` | GainMap 的编码 gamma（解码用 `1/gamma`） |
-| `offsetSdr` | SDR 偏移，默认 0（Adobe 规范默认 `1/64`） |
-| `offsetHdr` | HDR 偏移，默认 0（Adobe 规范默认 `1/64`） |
+| `gamma` | gainmap 的编码 gamma（解码用 `1/gamma`） |
+| `offsetSdr` | SDR 偏移，缺省 `1/64`（UltraHDR 规范默认值） |
+| `offsetHdr` | HDR 偏移，缺省 `1/64`（UltraHDR 规范默认值） |
 
 另外还有一个运行时可调参数：
 
@@ -37,7 +37,7 @@ GainMap 元数据来自每个点位的 `hdrConfig`（`HDRCfgData`）：
 
 ## 最终 RGB 的计算步骤
 
-对应实现见 `PanoSourceNode.computeHDRBoost`（以及瓦片路径下等价的 `tiling.ts#computeHDRBoostNode`）。
+对应实现见 `lib/five/model/materials/tsl/utils.ts#hdrBoost` / `#hdrOffset`（以及瓦片路径下等价的 `lib/five/core/tiling.ts#computeHDRBoostNode`）。
 
 ### 1. 计算显示权重 weight
 
@@ -55,11 +55,11 @@ weight = clamp(
 - `weight = 1`：显示器能力达到内容上限 → 全量增益。
 - 中间值：按比例插值。
 
-> 瓦片路径（`computeHDRBoostNode`）对分母做了保护：`max(denom, 1e-6)` 并乘以 `step(1e-6, denom)`，避免非 HDR（capacity 全为 1）时除零产生 NaN。
+> 两条路径都对分母做了保护：`max(denom, 1e-6)` 并乘以 `step(1e-6, denom)`，避免非 HDR（capacity 全为 1）时除零产生 NaN（此时权重取 0，退化为 SDR）。
 
-### 2. GainMap 解码（gamma）
+### 2. gainmap 解码（gamma）
 
-GainMap 采样值经 gamma 还原为线性增益量（每通道独立），解码使用 gamma 的倒数：
+gainmap 采样值经 gamma 还原为线性增益量（每通道独立），解码使用 gamma 的倒数：
 
 ```
 gainLinear = pow(gainRGB, 1/gamma)   // 对 r/g/b 分别做 pow，与 Adobe 规范一致
@@ -84,7 +84,7 @@ boost = exp2(logGain * weight)     // 每通道
 
 ### 5. 得到最终颜色
 
-应用 GainMap 偏移得到最终 HDR 颜色（`offset` 为 0 时退化为 `sdr * boost`）：
+应用 gainmap 偏移得到最终 HDR 颜色（`offset` 为 0 时退化为 `sdr * boost`）：
 
 ```
 finalRGB = (sdrRGB + offsetSdr) * boost - offsetHdr
@@ -121,22 +121,22 @@ finalRGB = (sdrRGB + offsetSdr) * boost - offsetHdr
 
 解码端 `applyGain`（带 displayBoost 的重载）核心逻辑：
 
-```cpp
+```
 logBoost   = log2(minContentBoost) * (1 - gain) + log2(maxContentBoost) * gain;
 gainFactor = exp2(logBoost * displayBoost / maxContentBoost);
 finalRGB   = sdr * gainFactor;
 ```
 
 说明：
-- `gain` 是 GainMap 采样值（`[0,1]`）。该库固定 `gamma = 1.0`、`offsetSdr = offsetHdr = 0`、`hdrCapacityMin = 1`、`hdrCapacityMax = maxContentBoost`，所以权重简化成 `displayBoost / maxContentBoost`。
+- `gain` 是 gainmap 采样值（`[0,1]`）。该库固定 `gamma = 1.0`、`offsetSdr = offsetHdr = 0`、`hdrCapacityMin = 1`、`hdrCapacityMax = maxContentBoost`，所以权重简化成 `displayBoost / maxContentBoost`。
 - 元数据里的 `minContentBoost` / `maxContentBoost` 是**线性倍数**（非 log），在着色器里才取 `log2`。
 - 来源：[ittiam-systems/libultrahdr](https://github.com/ittiam-systems/libultrahdr) / [AOSP libultrahdr](https://android.googlesource.com/platform/external/libultrahdr)。内容为改写。
 
-### 2) MONOGRID `gainmap-js` v3.4.0（Adobe GainMap 规范的 three.js 移植）
+### 2) MONOGRID `gainmap-js` v3.4.0（Adobe gainmap 规范的 three.js 移植）
 
 解码 fragment shader 原式（等价重排）：
 
-```glsl
+```
 logRecovery = pow(recovery, gamma);        // gamma uniform = 1.0 / metadataGamma
 logBoost    = gainMapMin * (1 - logRecovery) + gainMapMax * logRecovery;
 hdrColor    = (sdr + offsetSdr) * exp2(logBoost * weightFactor) - offsetHdr;
@@ -161,17 +161,24 @@ weightFactor = clamp(
 1. **元数据空间约定（最关键，仍需确认）**
    - 本项目对 `minContentBoost / maxContentBoost / hdrCapacityMin / hdrCapacityMax` 在 shader 内部统一取 `log2`，说明这些字段在数据里是**线性倍数**（如 `maxContentBoost = 100`、`hdrCapacityMax = 1000`）。这与 **libultrahdr 约定一致**。
    - 但 **Adobe / gainmap-js 约定相反**：这些字段在元数据里就已经是 **log2 空间**。
-   - 风险：如果 GainMap 资源是按 Adobe/UltraHDR 标准（XMP `hdrgm`）导出的，那里的 `HDRCapacityMin/Max`、`GainMapMin/Max` 已经是 log2 值，本项目再套一次 `log2` 就会**二次取对数**导致结果错误。务必确认打包侧写入的到底是线性倍数还是 log2 值。
+   - 风险：如果 gainmap 资源是按 Adobe/UltraHDR 标准（XMP `hdrgm`）导出的，那里的 `HDRCapacityMin/Max`、`GainMapMin/Max` 已经是 log2 值，本项目再套一次 `log2` 就会**二次取对数**导致结果错误。务必确认打包侧写入的到底是线性倍数还是 log2 值。
 
-2. **gamma 方向（✅ 已修复）**
-   - 现在解码使用 `pow(gainRGB, 1/gamma)`，与 Adobe / gainmap-js 规范一致。
-   - `gamma = 1`（当前默认）时与旧行为相同，无回归；`gamma ≠ 1` 时结果才会正确。
-   - 同时修正了 `PanoSourceNode.update` 里 `gamma ?? 1000` 的可疑默认值为 `?? 1`。
+2. **gamma 方向（✅ 已修复，pano 与瓦片两条路径一致）**
+   - 解码使用 `pow(gainRGB, 1/gamma)`（规范：`log_recovery = pow(recovery, 1.0 / map_gamma)`），与 Adobe / gainmap-js 规范一致；`gamma` 做了 `> 0` 保护，`gain` 先 clamp 到 `[0,1]`。
+   - `gamma = 1`（当前数据默认）时与旧行为相同，无回归；`gamma ≠ 1` 时结果才会正确。
+   - 注意：`PanoSourceNode` 已删除，公式现在在 `tsl/utils.ts#hdrBoost` 与 `tiling.ts#computeHDRBoostNode` 各有一份，改动需同步。
 
 3. **offset 偏移（✅ 已支持）**
-   - 完整式：`hdr = (sdr + offsetSdr) * boost - offsetHdr`，由 `applyHDROffset` / `applyHDROffsetNode` 统一应用。
-   - `offsetSdr` / `offsetHdr` 已加入 `HDRCfgData` 与瓦片 uniform，可从 `hdrConfig` 读取。
-   - **默认值为 0**（等价于 `sdr * boost`，与历史行为一致）。注意 Adobe 规范默认是 `1/64`；若资源按非零 offset 编码，需在配置里显式提供对应值，暗部才能严格还原。
+   - 完整式：`hdr = (sdr + offsetSdr) * boost - offsetHdr`，由 `tsl/utils.ts#hdrOffset`（pano 路径）与 `tiling.ts#hdrOffsetNode`（瓦片路径）应用，不需要额外的 `applyHDROffset` 包装。
+   - `offsetSdr` / `offsetHdr` 已加入 `GainmapCfgData`（支持 `offset_sdr` / `offset_hdr` 下划线写法）、pano 材质 uniform（`pano0HdrOffsetSdr` 等）与瓦片 uniform，可从 `images.gainmap.cfg` 读取。
+   - **缺省值为 `1/64`**（见导出的 `DEFAULT_GAINMAP_CFG_DATA`，与 UltraHDR 规范默认一致）：cfg 里没有该字段时按 `1/64` 解码。
+   - ⚠️ 编码/解码 offset 必须一致：若打包侧按 `offsetSdr = offsetHdr = 0` 生成 gain map，需在 cfg 里显式写 `0`（否则近黑会略有抬升）；反之若按规范 `1/64` 编码，现在的默认值正好匹配。因此**建议打包侧始终在 cfg 中显式写入这两个字段**。
+
+4. **gainmap 纹理的色彩空间（✅ 已改为 `NoColorSpace`）**
+   - 规范要求 gain map 直接使用 `encoded_recovery / 255`（其自带的色彩配置文件不生效）。
+   - 现在 pano 路径（`panorama` / `floorplan` / `mapview` 的 `loadCubeTexture`）与瓦片路径（`core/tiling.ts` 的 `loadTexture`）都显式传 `colorSpace: THREE.NoColorSpace`；SDR 底图仍为 `SRGBColorSpace`。
+   - three 的 GPU 纹理格式在**首次创建时**按 colorSpace 决定（WebGPU：sRGB → `rgba8unorm-srgb` 做硬件解码），之后只重传像素、不重建格式。因此瓦片纹理池改为按 `尺寸 + colorSpace` 分桶，避免色图与 gainmap 串用同一张池化纹理。
+   - 观感变化：gainmap 中间调不再被 sRGB 曲线压低（`maxDisplayBoost=4`、`maxContentBoost=100`、capacity `1..1000` 时，gain=0.5 的 boost 由约 1.22 → 1.59），亮部更亮；gain=0 与 gain=1 两端不变。若打包侧曾把 `recovery` 按 sRGB 预补偿写进 JPEG（非标准做法），需回退此项。
 
 ### weight 公式对比
 
@@ -191,14 +198,16 @@ weight = clamp( (log2(maxDisplayBoost) - hdrCapacityMin)
 
 ## 关键代码位置
 
-- `lib/five/model/materials/nodes/PanoSourceNode.ts`
-  - `computeHDRBoost(gainRGB, maxDisplayBoost)`：增益系数计算（TSL 节点）。
-  - `sampleHDR(cameraDirection, maxDisplayBoost, rgba?)`：采样 SDR 底图与 GainMap 并输出 `sdrColor.rgb * boost`。
+- `lib/five/model/materials/tsl/utils.ts`
+  - `hdrBoost(gainRGB, maxDisplayBoost, maxContentBoost, minContentBoost, capacityMin, capacityMax, gamma)`：增益系数计算（TSL 节点，含 gamma 解码与容量权重）。
+  - `hdrOffset(sdrRGB, boost, offsetSdr, offsetHdr)`：应用 offset 得到最终 HDR 颜色。
+- `lib/five/model/materials/tsl/defines.ts`
+  - `pano0HdrColor` / `pano1HdrColor`：拼接 `hdrBoost` 与 `hdrOffset`，材质 uniform 由 `pbmMaterial.ts` 的 `pano0Hdr*` / `pano1Hdr*` 属性驱动。
 - `lib/five/core/tiling.ts`
-  - `computeHDRBoostNode(gainRGB, uniforms)`：瓦片细化路径下的等价实现（带除零保护）。
-  - `TileMaterial.setupNode()`：`mix(sdr, sdr*boost, enabled)` 的烘焙逻辑。
-- `lib/five/utils/hdr-data.ts`：`HDRCfgData` 定义与 `parseHDRCfgData` 解析。
+  - `computeHDRBoostNode(gainRGB, uniforms)` / `hdrOffsetNode(...)`：瓦片细化路径下的等价实现（带除零保护）。
+  - `TileMaterial.setupNode()` / `BoundingMaterial`：`mix(sdr, (sdr + offsetSdr) * boost - offsetHdr, enabled)` 的烘焙逻辑。
+- `lib/five/utils/gainmap-data.ts`：`GainmapCfgData` 定义与 `parseGainmapCfgData` 解析（兼容 camelCase 与下划线 key）。
 
 ## 使用示例
 
-参见 `examples/hdr/index.ts` 与 `examples/_tools/hdr-viewer/panes/hdr.ts`：到达点位后从 `observer.images.hdrConfig` 拉取元数据，`maxDisplayBoost` 可实时调节以观察增益变化。
+参见 `examples/hdr/index.ts` 与 `examples/_tools/hdr-viewer/panes/hdr.ts`：到达点位后从 `observer.images.gainmap?.cfg` 拉取元数据（无 HDR 时该字段不存在），`maxDisplayBoost` 可实时调节以观察增益变化。

package/ai_guides/quick-start.md

@@ -7,9 +7,9 @@
 通过 npm 或 yarn 安装：
 
 ```bash
-npm install three@^0.117.1 @realsee/five-webgpu
+npm install three@^0.183.2 @realsee/five-webgpu
 # or
-yarn add three@^0.117.1 @realsee/five-webgpu
+yarn add three@^0.183.2 @realsee/five-webgpu
 ```
 
 > **注意**: Five 依赖 `three`，请确保安装了兼容的版本。

package/ai_guides/release_notes/6.8.md

@@ -134,7 +134,7 @@ gaussian_splatting 的模型同时也支持 rayscast 射线检测。同点云的
 #### 加载进度
 - 新增 tile.content.loadProgress 属性，用于查看每个瓦片的加载进度 (0-1)。
 - 新增 tile.content.byteLength 属性，可在加载过程中获取瓦片内容的字节长度。
-- 同时，model.tileLoad 和 model.tileUnload 事件被添加，用于监控瓦片的生命周期。
+- 同时，models.tileLoad 和 models.tileUnload 事件被添加，用于监控瓦片的生命周期。
 - 加载函数（loadGltf, loadPly 等）现在支持 onDownloadProgress 回调，用于监控文件下载进度。
 
 #### 射线检测增强
@@ -199,7 +199,7 @@ UV 转换工具函数
 1. 优化 mapview 下滚动缩放。避免滚落所发有时会退回的问题。
 2. 优化 floorplan 从下向上看时的交互的屏幕上下滑动反人类下意识的问题。
 3. 优化 camera.autoNearFar 的计算结果。优化对于小物品的 near 过远以及 出现 z-fighting 的问题。
-4. 添加了 gesture.create 事件，发生在所有事件创建时。
+4. 添加了 gesture.fire 事件，发生在任意事件被触发。
 5. gestureEvent.center gestureEvent.pointers 中加入了 buttons button shiftKey ctrlKey metaKey altKey 字段。
 
 ## 内部机制改动

package/ai_guides/support.md

@@ -14,10 +14,6 @@ Five 需要浏览器支持 **WebGL 1.0** (推荐 WebGL 2.0 以获得更好性能
 | **Edge** | >= 13 | |
 | **Android Webview** | >= 93 (Chrome内核) | |
 
-## WebXR Support
-
-如果需要使用 VR 模式 (XRPanorama)，需要浏览器支持 [WebXR Device API](https://developer.mozilla.org/en-US/docs/Web/API/WebXR_Device_API)。
-
 ## Related
 
 *   [Quick Start](./quick-start.md)

package/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJytWVtT2zgU/i9+Vru6W8pboWWHGShM6bI70+HBJGqi4tiM5XCZDv99RzYQyTHkyLsvyRDOp+87Fx8dyb+zpq5bl81+EExzpIhGhAuJiMgxYlJpxCVFRDCNGGYYSaw4koQKJGXOEcNSISIIR1xxJLBSSFJMkKRSXqGsMT9LM29tXbls9jujufZfVbE22Sz7atr7urm52Fy7eWOvTYayG1stshmhCmWbpsxm2bwsnDPuD1stzMPHIeLjql2XGeqtslnWusUHv8SH/ocnlHEqAsZPv4qHs9tezgsZFfKFzFataX4W81e+wP5NqldQRyfproMpjDEEQIqy+cqWi8ZU2ewHp+LKq1A8UJEQX2hgI1Kaa18tGjGmlKdXJMzyQb2pFrZaXtblZm1AQYghqUFQKkeaMaQV7dSoPFLzMEnQQ7KmJ5RpxgLqb2Zp62oC+xgQKECF5XhxuzKNmSBgDAgT4HtKGP3CmS93pmphUX+xTq0AgvMcEawlIgQLRAjhiBBKECHMfwiMCJHdR44Iyb2J4oj4xkUo1led8ih5fxrXbpoE8SEAGqs8jNWx/58z8xbOGUOgrEoGrKf1whyuimqZ4OoAA+XVQ97yuy0TabcQICvBYsiayJjERviQ7WJuqlQntxgoLyW729A34+pNM08gHwNCFbBQwdn1r6RCDuzBfCrgOy+qGs72ag3lEnjA9d08pHWHIQjKLHG0oVQL08BJA3swX9iRLtqiTfBxa57evxlDvjH5ht2NFL5JB0r+rpsbB1eyNYf6HQ1Q/3xL7v4xBMhKMYlYL4xztq5SWEMImFVHrId11TZ1WaZU1g4Kys3HJsVT41b7Z9XQev85gNBoMvfP36Ft5qWBkcX2ADoWnTti+EVd2kUqZweCEEfbebzG4ca19TqVuUcBqDkbnV+iCIPGl3djHFcQF6G7x+tiaVKOWyEguUtx2U+KXIZV/NzWU1TEEKDnIpotzmsHm+W9YbKnguLOU0HxcD+AbwVQv5h+s4CPA32wTXYEm+w99RcgzO9GrD9f+7uRtyo9TeI4NL0SWf6sK4zdkb0DnPm91f6Hm+poFOjG0m3P71vEcWXbT80SVvPvrgArFarVsMk2xbr4T7L2LQJT5m/KRpSd2Bvzv6h7b6HU4vGZRT6UV51wGc3RB6fA/bE3TLk28pt/R8nUgPKv20XRmuK6BFRvZJ5Cz3guERP9jZX/I9bgI31ky9Y0IA1b8/2PkieNyfoEfq0XMIe35gAyqcKWcOwTVbSmsUUJa1ABILWymJICcawEYpppxDGhqPtt+2f3X04kRZxyiTijGnFOuos7b7pbiweFs/MdF/YVZoQCRE3Hm1C/yPmqrpbJ1BEKcGGNCR2jfnR2XpQT2GMgRIAaCbsv8LOqfEwXMAACBBA5EoEug77mp+U+RELeGnD5Rv4nSdhBAiQwOlqCfTonqtgFA4Tw0YJ8Tus0ISPg/UL8y6VwzralYZ/3c/Z2KVuDoLrbFfx3QHhpzf1J8RjsCO81zldr2MQgdB6fT5tibVrTXBblBjrthpDUXi0x7Xz239EVk6vLO7OYoGccCouGf8k4Fo2XYpkQlQiaGh2fnS46ZHCsf17c15gz7QRZIXKyqvjiyN92HW6uTXe2Bd+PvSKSK4cSiSQjuJdC5EBKmgyohI5LDrnOrp1p7oBPaAhIdloI1vnLCB5o8BkF83tjoLdCsAHTyxO24/WbvXAMtb/xShldePsD43nfNAFHS2+Z0nyl1BjJnEoklWBIau4/VF9dMo/bgoMem97R8FaGpXjm1KHznxbFbWvvzMlmbauimgMjMQoDRD6nYYl/eTSf67U5sctVa6sljHoEBCGO7rSOyvreVstuDfoZmPwdDIBWRUUeLsEm0DIIbZz1vL/T82UXvv0tNs7ZojooNw1MxhAB8F0rvOv7kW2MfwfnEv0f4PbRPz39C6uA5YA="
+window.hierarchyData = "eJytWttu2zgQ/Rc9s10Ob6L81qTNIkDaBE23u0CRB8VmbTayFEhymqDIvy8oNTYpy/FQuy82bM/hOTOcGV7kX0ldVW2TzL4BFYporgmIDAgoKglPJSNCcQIyFYQD1UQxEEQxKYlKs4xwEIqAFBkRWhLJqCKKCyCKZ+KGJLX5Xph5a6uySWa/EqapeyvztUlmySfT/qzqu+vNbTOv7a1JSHJny0UyA6ZJsqmLZJbMi7xpTPOHLRfm8e0Q8XbVrouE9FbJLGmbxRs3xJv+i2eSCKY8xnc/8sfL+17OCxmT6oXMlq2pv+fzLZ9nf5BqC+roFN93MIYxhCBISTJf2WJRmzKZfRNM3TgVWnoqIuKLDWxAyjQloEAQLiQ4es21R39SbcqFLZdfq2KzNqgghJDYIGRUkUwyApR2cjKqAjmPkxQ9Roty1JJ51J/N0lblBPYxIE6Ai4GfCvcrU5sJCsaAWAUiCH/emA8PpmxxYX+xjs0BoJkiACAJABMEgHMCICgBkO5FZQQgdS/a2WWCAKOcAGPUveibTnkwe3+apt3UEeJ9ADZWmR+rc/dbY+YtnjOEIFmB+u3iY7Uwp6u8XEa4OsBgeWHIW3yxRSTtDoJlZWLIGskYxcb5kO16bspYJ3cYLK8YWWk/m6ba1PMI8jEgVoH0FVze/ohKZM8ezZd6fFd5WeHZttZYLpUNuL6Yx7juMARhmdMsWFHKhanxpJ49lk/7Hem6zdsIH3fm8f3bLeBAXf+WadeNIfPr9u+qvmvwSnbmSL8Z9ev2n8/R3T+EYFkZDVivTdPYqoxh9SFoVh2wnlZlW1dFEZNZeygstxrbK340zer4btW3Pn4SAKZhULSntp4XBkcW2iPouBAH6a6rwi5iOTsQglgEy3k4xummaat1LHOPwlCnbGz/EkQYtX15NcZhBonMn9bzdb40MQcuHxDdpSQVXW+S1J/r3209RkUIQXouRbAKVQ1uL+8M4z2VsvdUyuF6gF8KsH6lhyvn3NOHW2RHsNHeMw3E1RVxVd3FQQVFFuRtnMRxaLRCkbJeF/ixO7MPiFO/szpe3JxCOtzK7np+3yLOS9u+q5e4nH91BFyqcMqHva7O1/l/knVsEKQyoHpE2YW9M/+LutcGik0eN7PEhfKmEx6c169OPiLXx94w5uLILf4dpZAQUv51v8hbk98WiOwNzGPoueQZ4aq/s3IfQg0u0me2aE2N0rAzR5SSGjrcT+CnaoFzeGeOIEuDa4xzN1F5a2qbF7gG5QGiMyvjlAhQjAhKNRFUS9J/t/3Y/8oEJ4JzIEKAJkLSPhczTvdz8SRv7HzPhWOJGaAQ98Y0rN9+kKtVVS6jqQMUhjq4vt0O8tTYeV5MYA+BCAGg2IiAvKwuy+IpXsAAiLm0F/zAvLucnzb3PhIhgXM4MP+TJOwhERIEjKZgP50TVeyDEUIkHUvI39M6TcgI+LgQ93jJ32fbwvD3xzl7u5ilQQrWbafcu0f41ZqfF/mTtyK81ji31rgdgwIaVF1e52vTmvprXmywu10fEturFchuNXbvwRVTUxUPZjFBzzgUGQ0GYiwaL8kyISoBND46tMsI9+RzTJfLsca0E2T5yMmquPC7lbvtOt3cmu5si74f2yKiVXBJiRK8Tx8e3Pu6geNkYCV0XHt3gpe3jakfkBXqA6KdVmnvrwiedroh3Yyi+Z0x0luVDpleKmzP64O9cAx1vPGqNJWDY+VV3zQRR0tnGdN8lQZJlJZAVJZqklKlSQr9jtD95yAovwZ7bHpFw6EZTtOeUwfPqd4t8vvWPpiLzdqWeTlHRmIUhoi8Do4KH57M+2ptLuxy1dpyiaMeAWGIg9o6K6qftlx2Y7D3yMnfwyBosyDJ/SH4BFqOoR1kX9bd8Li085/+5pumsXl5UmxqnIwh4rjvafgg9rcfZ7Y27hlcE+n/AHeM/vn5X6pE5Qk="

package/docs/assets/navigation.js

@@ -1 +1 @@
-window.navigationData = "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"
+window.navigationData = "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"