@realsee/five 6.8.9 → 6.9.0-alpha.1

package/docs/documents/features_work.html

@@ -10,7 +10,7 @@
 <p><strong>Definition</strong>: <a href="../../five/work/work.d.ts">Work</a>, <a href="../../five/work/looseWorkType.d.ts">LooseWork</a>, <a href="../../five/work/workJsonType.d.ts">WorkJson</a></p>
 </blockquote>
 <p><code>Work</code> 及其相关核心接口定义如下：</p>
-<pre><code class="ts"><span class="hl-10">import</span><span class="hl-1"> </span><span class="hl-3">*</span><span class="hl-1"> </span><span class="hl-10">as</span><span class="hl-1"> </span><span class="hl-6">THREE</span><span class="hl-1"> </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;three&quot;</span><span class="hl-1">;</span><br/><span class="hl-10">import</span><span class="hl-1"> </span><span class="hl-10">type</span><span class="hl-1"> { </span><span class="hl-6">Mode</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">type</span><span class="hl-1"> </span><span class="hl-7">CubeFace</span><span class="hl-1"> = </span><span class="hl-9">&#39;up&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;down&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;right&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;front&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;back&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">/** Work 实体：VR 项目的根对象 */</span><br/><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">Work</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 唯一标识 (Work ID) */</span><br/><span class="hl-1">  </span><span class="hl-6">workCode</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 项目名称 */</span><br/><span class="hl-1">  </span><span class="hl-6">name</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 资源加载的基础路径 (Base URL) */</span><br/><span class="hl-1">  </span><span class="hl-6">baseURL</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 数据签发人 */</span><br/><span class="hl-1">  </span><span class="hl-6">issuer</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 过期时间 */</span><br/><span class="hl-1">  </span><span class="hl-6">expire</span><span class="hl-1">: </span><span class="hl-7">Date</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 允许访问的安全域名列表 */</span><br/><span class="hl-1">  </span><span class="hl-6">allowHosts</span><span class="hl-1">: </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-7">string</span><span class="hl-1">[];</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 初始化参数 (默认模态、视角等) */</span><br/><span class="hl-1">  </span><span class="hl-6">initial</span><span class="hl-1">: </span><span class="hl-7">WorkInitial</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 相对位姿 (用于多 Work 拼接时的坐标变换) */</span><br/><span class="hl-1">  </span><span class="hl-6">transform</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Matrix4</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 模型参数 (3D 模型资源信息) */</span><br/><span class="hl-1">  </span><span class="hl-6">model</span><span class="hl-1">?: </span><span class="hl-7">WorkModel</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 全景点位信息 (所有可观测点位的列表) */</span><br/><span class="hl-1">  </span><span class="hl-6">observers</span><span class="hl-1">: </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-7">WorkObserver</span><span class="hl-1">[];</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">/** 观察点：空间中可驻足观看的点位 */</span><br/><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">WorkObserver</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 所属 Work 引用 */</span><br/><span class="hl-1">  </span><span class="hl-6">work</span><span class="hl-1">: </span><span class="hl-7">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 在 observers 数组中的索引 */</span><br/><span class="hl-1">  </span><span class="hl-6">index</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点位序号 (通常与 index 相同) */</span><br/><span class="hl-1">  </span><span class="hl-6">panoIndex</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点位唯一 ID (通常格式为 `${workCode}[${panoIndex}]`) */</span><br/><span class="hl-1">  </span><span class="hl-6">panoId</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 点位是否激活可用 */</span><br/><span class="hl-1">  </span><span class="hl-6">active</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点位是否可加载 */</span><br/><span class="hl-1">  </span><span class="hl-6">loadable</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 点位所在楼层索引 */</span><br/><span class="hl-1">  </span><span class="hl-6">floorIndex</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 点位在模型坐标系下的观察位置 (用于渲染相机位置) */</span><br/><span class="hl-1">  </span><span class="hl-6">position</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点位在模型坐标系下的地面位置 (用于导航和 UI 定位) */</span><br/><span class="hl-1">  </span><span class="hl-6">standingPosition</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点位和模型的旋转对齐四元数 */</span><br/><span class="hl-1">  </span><span class="hl-6">quaternion</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Quaternion</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点位和模型的旋转对齐矩阵 */</span><br/><span class="hl-1">  </span><span class="hl-6">matrix</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Matrix4</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 可连通的相关点位序号 (用于全景游走) */</span><br/><span class="hl-1">  </span><span class="hl-6">accessibleNodes</span><span class="hl-1">: </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-7">number</span><span class="hl-1">[];</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 点位全景图资源信息 */</span><br/><span class="hl-1">  </span><span class="hl-6">images</span><span class="hl-1">: </span><span class="hl-7">WorkImage</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 获取点位的全局坐标 */</span><br/><span class="hl-1">  </span><span class="hl-5">getWorldPosition</span><span class="hl-1">(</span><span class="hl-3">this</span><span class="hl-1">: </span><span class="hl-7">WorkObserver</span><span class="hl-1">): </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 获取点位的全局地面坐标 */</span><br/><span class="hl-1">  </span><span class="hl-5">getWorldStandingPosition</span><span class="hl-1">(</span><span class="hl-3">this</span><span class="hl-1">: </span><span class="hl-7">WorkObserver</span><span class="hl-1">): </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 将方向向量转化为全景图 uv */</span><br/><span class="hl-1">  </span><span class="hl-5">vectorToEquirectangularUv</span><span class="hl-1">(</span><span class="hl-6">vector</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">, </span><span class="hl-6">uvOrigin</span><span class="hl-1">?: </span><span class="hl-9">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector2</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 将全景图 uv 转化为方向向量 */</span><br/><span class="hl-1">  </span><span class="hl-5">equirectangularUvToVector</span><span class="hl-1">(</span><span class="hl-6">uv</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector2</span><span class="hl-1">, </span><span class="hl-6">uvOrigin</span><span class="hl-1">?: </span><span class="hl-9">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 将方向向量转化为获六视图 uv */</span><br/><span class="hl-1">  </span><span class="hl-5">vectorToCubemapUv</span><span class="hl-1">(</span><span class="hl-6">vector</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">, </span><span class="hl-6">uvOrigin</span><span class="hl-1">?: </span><span class="hl-9">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;bottom-left&#39;</span><span class="hl-1">): [</span><span class="hl-13">cubeFace</span><span class="hl-1">: </span><span class="hl-7">CubeFace</span><span class="hl-1">, </span><span class="hl-13">cubemapUv</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector2</span><span class="hl-1">];</span><br/><span class="hl-1">  </span><span class="hl-8">/** 将六视图 uv 转化为方向向量 */</span><br/><span class="hl-1">  </span><span class="hl-5">cubemapUvToVector</span><span class="hl-1">(</span><span class="hl-6">cubeFace</span><span class="hl-1">: </span><span class="hl-7">CubeFace</span><span class="hl-1">, </span><span class="hl-6">uv</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector2</span><span class="hl-1">, </span><span class="hl-6">uvOrigin</span><span class="hl-1">?: </span><span class="hl-9">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">/** 初始化位姿参数 */</span><br/><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">WorkInitial</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">work</span><span class="hl-1">: </span><span class="hl-7">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 模态 */</span><br/><span class="hl-1">  </span><span class="hl-6">mode</span><span class="hl-1">?: </span><span class="hl-7">Mode</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点位序号 */</span><br/><span class="hl-1">  </span><span class="hl-6">panoIndex</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 相机水平角 */</span><br/><span class="hl-1">  </span><span class="hl-6">longitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 相机俯仰角 */</span><br/><span class="hl-1">  </span><span class="hl-6">latitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 相机可视角度（垂直）*/</span><br/><span class="hl-1">  </span><span class="hl-6">fov</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 相机观察点位置 [x, y, z] */</span><br/><span class="hl-1">  </span><span class="hl-6">offset</span><span class="hl-1">?: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 相机距离观察点距离 */</span><br/><span class="hl-1">  </span><span class="hl-6">distance</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">/** 模型数据 */</span><br/><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">WorkModel</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** work */</span><br/><span class="hl-1">  </span><span class="hl-6">work</span><span class="hl-1">: </span><span class="hl-7">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 模型文件地址 at3d / domez */</span><br/><span class="hl-1">  </span><span class="hl-6">file</span><span class="hl-1">?: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 模型贴图文件地址 */</span><br/><span class="hl-1">    </span><span class="hl-6">textures</span><span class="hl-1">?: </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-7">string</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-8">/** 模型贴图文件地址的父目录 */</span><br/><span class="hl-1">  </span><span class="hl-6">textureBase</span><span class="hl-1">?: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 指定上方向，对于 obj， ply 等定义不明确的需要指定上方向 */</span><br/><span class="hl-1">  </span><span class="hl-6">upAxis</span><span class="hl-1">?: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 3d tile */</span><br/><span class="hl-1">  </span><span class="hl-6">layers</span><span class="hl-1">: </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-7">WorkModelLayer</span><span class="hl-1">[];</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">/** 模型图层信息 */</span><br/><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">WorkModelLayer</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** work */</span><br/><span class="hl-1">  </span><span class="hl-6">work</span><span class="hl-1">: </span><span class="hl-7">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 模型类型 point_cloud mesh gaussian_splatting */</span><br/><span class="hl-1">  </span><span class="hl-6">type</span><span class="hl-1">: </span><span class="hl-9">&#39;point_cloud&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;mesh&#39;</span><span class="hl-1"> | </span><span class="hl-9">&#39;gaussian_splatting&#39;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 模型名称 */</span><br/><span class="hl-1">  </span><span class="hl-6">name</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 指定上方向 */</span><br/><span class="hl-1">  </span><span class="hl-6">upAxis</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** tileset.json 地址 */</span><br/><span class="hl-1">  </span><span class="hl-6">tileset</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">/** 全景图资源信息 */</span><br/><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">WorkImage</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">work</span><span class="hl-1">: </span><span class="hl-7">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 分辨率表 */</span><br/><span class="hl-1">  </span><span class="hl-6">sizeList</span><span class="hl-1">: </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-7">number</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-8">/** 瓦片信息 */</span><br/><span class="hl-1">  </span><span class="hl-6">tiles</span><span class="hl-1">: </span><span class="hl-3">readonly</span><span class="hl-1"> </span><span class="hl-7">WorkTile</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-8">/** 缩略图/预览图等 */</span><br/><span class="hl-1">  [</span><span class="hl-6">key</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">]: </span><span class="hl-7">any</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="ts"><span class="hl-11">import</span><span class="hl-1"> </span><span class="hl-8">*</span><span class="hl-1"> </span><span class="hl-11">as</span><span class="hl-1"> </span><span class="hl-5">THREE</span><span class="hl-1"> </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;three&quot;</span><span class="hl-1">;</span><br/><span class="hl-11">import</span><span class="hl-1"> </span><span class="hl-11">type</span><span class="hl-1"> { </span><span class="hl-5">Mode</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">type</span><span class="hl-1"> </span><span class="hl-9">CubeFace</span><span class="hl-1"> = </span><span class="hl-10">&#39;up&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;down&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;right&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;front&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;back&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-7">/** Work 实体：VR 项目的根对象 */</span><br/><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">Work</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 唯一标识 (Work ID) */</span><br/><span class="hl-1">  </span><span class="hl-5">workCode</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 项目名称 */</span><br/><span class="hl-1">  </span><span class="hl-5">name</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 资源加载的基础路径 (Base URL) */</span><br/><span class="hl-1">  </span><span class="hl-5">baseURL</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 数据签发人 */</span><br/><span class="hl-1">  </span><span class="hl-5">issuer</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 过期时间 */</span><br/><span class="hl-1">  </span><span class="hl-5">expire</span><span class="hl-1">: </span><span class="hl-9">Date</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 允许访问的安全域名列表 */</span><br/><span class="hl-1">  </span><span class="hl-5">allowHosts</span><span class="hl-1">: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">string</span><span class="hl-1">[];</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 初始化参数 (默认模态、视角等) */</span><br/><span class="hl-1">  </span><span class="hl-5">initial</span><span class="hl-1">: </span><span class="hl-9">WorkInitial</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 相对位姿 (用于多 Work 拼接时的坐标变换) */</span><br/><span class="hl-1">  </span><span class="hl-5">transform</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Matrix4</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 模型参数 (3D 模型资源信息) */</span><br/><span class="hl-1">  </span><span class="hl-5">model</span><span class="hl-1">?: </span><span class="hl-9">WorkModel</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 全景点位信息 (所有可观测点位的列表) */</span><br/><span class="hl-1">  </span><span class="hl-5">observers</span><span class="hl-1">: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">WorkObserver</span><span class="hl-1">[];</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">/** 观察点：空间中可驻足观看的点位 */</span><br/><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">WorkObserver</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 所属 Work 引用 */</span><br/><span class="hl-1">  </span><span class="hl-5">work</span><span class="hl-1">: </span><span class="hl-9">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 在 observers 数组中的索引 */</span><br/><span class="hl-1">  </span><span class="hl-5">index</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点位序号 (通常与 index 相同) */</span><br/><span class="hl-1">  </span><span class="hl-5">panoIndex</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点位唯一 ID (通常格式为 `${workCode}[${panoIndex}]`) */</span><br/><span class="hl-1">  </span><span class="hl-5">panoId</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 点位是否激活可用 */</span><br/><span class="hl-1">  </span><span class="hl-5">active</span><span class="hl-1">: </span><span class="hl-9">boolean</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点位是否可加载 */</span><br/><span class="hl-1">  </span><span class="hl-5">loadable</span><span class="hl-1">: </span><span class="hl-9">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 点位所在楼层索引 */</span><br/><span class="hl-1">  </span><span class="hl-5">floorIndex</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 点位在模型坐标系下的观察位置 (用于渲染相机位置) */</span><br/><span class="hl-1">  </span><span class="hl-5">position</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点位在模型坐标系下的地面位置 (用于导航和 UI 定位) */</span><br/><span class="hl-1">  </span><span class="hl-5">standingPosition</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点位和模型的旋转对齐四元数 */</span><br/><span class="hl-1">  </span><span class="hl-5">quaternion</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Quaternion</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点位和模型的旋转对齐矩阵 */</span><br/><span class="hl-1">  </span><span class="hl-5">matrix</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Matrix4</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 可连通的相关点位序号 (用于全景游走) */</span><br/><span class="hl-1">  </span><span class="hl-5">accessibleNodes</span><span class="hl-1">: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">number</span><span class="hl-1">[];</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 点位全景图资源信息 */</span><br/><span class="hl-1">  </span><span class="hl-5">images</span><span class="hl-1">: </span><span class="hl-9">WorkImage</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 获取点位的全局坐标 */</span><br/><span class="hl-1">  </span><span class="hl-4">getWorldPosition</span><span class="hl-1">(</span><span class="hl-8">this</span><span class="hl-1">: </span><span class="hl-9">WorkObserver</span><span class="hl-1">): </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 获取点位的全局地面坐标 */</span><br/><span class="hl-1">  </span><span class="hl-4">getWorldStandingPosition</span><span class="hl-1">(</span><span class="hl-8">this</span><span class="hl-1">: </span><span class="hl-9">WorkObserver</span><span class="hl-1">): </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 将方向向量转化为全景图 uv */</span><br/><span class="hl-1">  </span><span class="hl-4">vectorToEquirectangularUv</span><span class="hl-1">(</span><span class="hl-5">vector</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">, </span><span class="hl-5">uvOrigin</span><span class="hl-1">?: </span><span class="hl-10">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector2</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 将全景图 uv 转化为方向向量 */</span><br/><span class="hl-1">  </span><span class="hl-4">equirectangularUvToVector</span><span class="hl-1">(</span><span class="hl-5">uv</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector2</span><span class="hl-1">, </span><span class="hl-5">uvOrigin</span><span class="hl-1">?: </span><span class="hl-10">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 将方向向量转化为获六视图 uv */</span><br/><span class="hl-1">  </span><span class="hl-4">vectorToCubemapUv</span><span class="hl-1">(</span><span class="hl-5">vector</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">, </span><span class="hl-5">uvOrigin</span><span class="hl-1">?: </span><span class="hl-10">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;bottom-left&#39;</span><span class="hl-1">): [</span><span class="hl-13">cubeFace</span><span class="hl-1">: </span><span class="hl-9">CubeFace</span><span class="hl-1">, </span><span class="hl-13">cubemapUv</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector2</span><span class="hl-1">];</span><br/><span class="hl-1">  </span><span class="hl-7">/** 将六视图 uv 转化为方向向量 */</span><br/><span class="hl-1">  </span><span class="hl-4">cubemapUvToVector</span><span class="hl-1">(</span><span class="hl-5">cubeFace</span><span class="hl-1">: </span><span class="hl-9">CubeFace</span><span class="hl-1">, </span><span class="hl-5">uv</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector2</span><span class="hl-1">, </span><span class="hl-5">uvOrigin</span><span class="hl-1">?: </span><span class="hl-10">&#39;top-left&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;bottom-left&#39;</span><span class="hl-1">): </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">/** 初始化位姿参数 */</span><br/><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">WorkInitial</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">work</span><span class="hl-1">: </span><span class="hl-9">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 模态 */</span><br/><span class="hl-1">  </span><span class="hl-5">mode</span><span class="hl-1">?: </span><span class="hl-9">Mode</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点位序号 */</span><br/><span class="hl-1">  </span><span class="hl-5">panoIndex</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 相机水平角 */</span><br/><span class="hl-1">  </span><span class="hl-5">longitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 相机俯仰角 */</span><br/><span class="hl-1">  </span><span class="hl-5">latitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 相机可视角度（垂直）*/</span><br/><span class="hl-1">  </span><span class="hl-5">fov</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 相机观察点位置 [x, y, z] */</span><br/><span class="hl-1">  </span><span class="hl-5">offset</span><span class="hl-1">?: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Vector3</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 相机距离观察点距离 */</span><br/><span class="hl-1">  </span><span class="hl-5">distance</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">/** 模型数据 */</span><br/><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">WorkModel</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** work */</span><br/><span class="hl-1">  </span><span class="hl-5">work</span><span class="hl-1">: </span><span class="hl-9">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 模型文件地址 at3d / domez */</span><br/><span class="hl-1">  </span><span class="hl-5">file</span><span class="hl-1">?: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 模型贴图文件地址 */</span><br/><span class="hl-1">    </span><span class="hl-5">textures</span><span class="hl-1">?: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">string</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-7">/** 模型贴图文件地址的父目录 */</span><br/><span class="hl-1">  </span><span class="hl-5">textureBase</span><span class="hl-1">?: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 指定上方向，对于 obj， ply 等定义不明确的需要指定上方向 */</span><br/><span class="hl-1">  </span><span class="hl-5">upAxis</span><span class="hl-1">?: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 3d tile */</span><br/><span class="hl-1">  </span><span class="hl-5">layers</span><span class="hl-1">: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">WorkModelLayer</span><span class="hl-1">[];</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">/** 模型图层信息 */</span><br/><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">WorkModelLayer</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** work */</span><br/><span class="hl-1">  </span><span class="hl-5">work</span><span class="hl-1">: </span><span class="hl-9">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 模型类型 point_cloud mesh gaussian_splatting */</span><br/><span class="hl-1">  </span><span class="hl-5">type</span><span class="hl-1">: </span><span class="hl-10">&#39;point_cloud&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;mesh&#39;</span><span class="hl-1"> | </span><span class="hl-10">&#39;gaussian_splatting&#39;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 模型名称 */</span><br/><span class="hl-1">  </span><span class="hl-5">name</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 指定上方向 */</span><br/><span class="hl-1">  </span><span class="hl-5">upAxis</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** tileset.json 地址 */</span><br/><span class="hl-1">  </span><span class="hl-5">tileset</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">/** 全景图资源信息 */</span><br/><span class="hl-11">export</span><span class="hl-1"> </span><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">WorkImage</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">work</span><span class="hl-1">: </span><span class="hl-9">Work</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 分辨率表 */</span><br/><span class="hl-1">  </span><span class="hl-5">sizeList</span><span class="hl-1">: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">number</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-7">/** 瓦片信息 */</span><br/><span class="hl-1">  </span><span class="hl-5">tiles</span><span class="hl-1">: </span><span class="hl-8">readonly</span><span class="hl-1"> </span><span class="hl-9">WorkTile</span><span class="hl-1">[];</span><br/><span class="hl-1">  </span><span class="hl-7">/** 缩略图/预览图等 */</span><br/><span class="hl-1">  [</span><span class="hl-5">key</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">]: </span><span class="hl-9">any</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 
 <h2 id="concepts" class="tsd-anchor-link">Concepts<a href="#concepts" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
@@ -92,22 +92,22 @@ Five 会遍历 <code>work.model.layers</code> 并加载其中定义的所有图
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <h3 id="1-解析与加载-work" class="tsd-anchor-link">1. 解析与加载 Work<a href="#1-解析与加载-work" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>最基础的用法是从 API 获取数据并加载。</p>
-<pre><code class="ts"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1">, </span><span class="hl-6">parseWork</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">();</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">appendTo</span><span class="hl-1">(</span><span class="hl-6">document</span><span class="hl-1">.</span><span class="hl-5">getElementById</span><span class="hl-1">(</span><span class="hl-9">&quot;app&quot;</span><span class="hl-1">));</span><br/><br/><span class="hl-8">// 1. 获取数据</span><br/><span class="hl-5">fetch</span><span class="hl-1">(</span><span class="hl-9">&quot;https://vrlab-public.ljcdn.com/release/web/work.json&quot;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-5">then</span><span class="hl-1">(</span><span class="hl-6">res</span><span class="hl-1"> </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-6">res</span><span class="hl-1">.</span><span class="hl-5">json</span><span class="hl-1">())</span><br/><span class="hl-1">  .</span><span class="hl-5">then</span><span class="hl-1">(</span><span class="hl-6">json</span><span class="hl-1"> </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">// 2. 解析数据</span><br/><span class="hl-1">    </span><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">work</span><span class="hl-1"> = </span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-8">// 3. 加载到 Five</span><br/><span class="hl-1">    </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-6">work</span><span class="hl-1">);</span><br/><span class="hl-1">  });</span>
+<pre><code class="ts"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1">, </span><span class="hl-5">parseWork</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">();</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">appendTo</span><span class="hl-1">(</span><span class="hl-5">document</span><span class="hl-1">.</span><span class="hl-4">getElementById</span><span class="hl-1">(</span><span class="hl-10">&quot;app&quot;</span><span class="hl-1">));</span><br/><br/><span class="hl-7">// 1. 获取数据</span><br/><span class="hl-4">fetch</span><span class="hl-1">(</span><span class="hl-10">&quot;https://vrlab-public.ljcdn.com/release/web/work.json&quot;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-4">then</span><span class="hl-1">(</span><span class="hl-5">res</span><span class="hl-1"> </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-5">res</span><span class="hl-1">.</span><span class="hl-4">json</span><span class="hl-1">())</span><br/><span class="hl-1">  .</span><span class="hl-4">then</span><span class="hl-1">(</span><span class="hl-5">json</span><span class="hl-1"> </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-7">// 2. 解析数据</span><br/><span class="hl-1">    </span><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">work</span><span class="hl-1"> = </span><span class="hl-4">parseWork</span><span class="hl-1">(</span><span class="hl-5">json</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-7">// 3. 加载到 Five</span><br/><span class="hl-1">    </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">load</span><span class="hl-1">(</span><span class="hl-5">work</span><span class="hl-1">);</span><br/><span class="hl-1">  });</span>
 </code><button type="button">Copy</button></pre>
 
 <h3 id="2-访问-work-数据" class="tsd-anchor-link">2. 访问 Work 数据<a href="#2-访问-work-数据" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>加载完成后，可以通过 <code>five.work</code> 访问当前数据。</p>
-<pre><code class="ts"><span class="hl-8">// 获取所有观察点</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">observers</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">work</span><span class="hl-1">.</span><span class="hl-6">observers</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 获取当前所在的观察点</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">currentPanoIndex</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">state</span><span class="hl-1">.</span><span class="hl-6">panoIndex</span><span class="hl-1">;</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">currentObserver</span><span class="hl-1"> = </span><span class="hl-6">observers</span><span class="hl-1">[</span><span class="hl-6">currentPanoIndex</span><span class="hl-1">];</span><br/><br/><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;当前点位坐标:&quot;</span><span class="hl-1">, </span><span class="hl-6">currentObserver</span><span class="hl-1">.</span><span class="hl-6">position</span><span class="hl-1">);</span><br/><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;可通往的点位:&quot;</span><span class="hl-1">, </span><span class="hl-6">currentObserver</span><span class="hl-1">.</span><span class="hl-6">accessibleNodes</span><span class="hl-1">);</span>
+<pre><code class="ts"><span class="hl-7">// 获取所有观察点</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">observers</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">work</span><span class="hl-1">.</span><span class="hl-5">observers</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 获取当前所在的观察点</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">currentPanoIndex</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">state</span><span class="hl-1">.</span><span class="hl-5">panoIndex</span><span class="hl-1">;</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">currentObserver</span><span class="hl-1"> = </span><span class="hl-5">observers</span><span class="hl-1">[</span><span class="hl-5">currentPanoIndex</span><span class="hl-1">];</span><br/><br/><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;当前点位坐标:&quot;</span><span class="hl-1">, </span><span class="hl-5">currentObserver</span><span class="hl-1">.</span><span class="hl-5">position</span><span class="hl-1">);</span><br/><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;可通往的点位:&quot;</span><span class="hl-1">, </span><span class="hl-5">currentObserver</span><span class="hl-1">.</span><span class="hl-5">accessibleNodes</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 
 <h3 id="3-多-work-加载与管理" class="tsd-anchor-link">3. 多 Work 加载与管理<a href="#3-多-work-加载与管理" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>Five 支持同时加载多个 Work，常用于楼盘小区的多个样板间拼接，或大型商业空间的区域拼接。</p>
-<pre><code class="ts"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">work1</span><span class="hl-1"> = </span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json1</span><span class="hl-1">);</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">work2</span><span class="hl-1"> = </span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json2</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 同时加载两个 Work</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">([</span><span class="hl-6">work1</span><span class="hl-1">, </span><span class="hl-6">work2</span><span class="hl-1">]);</span><br/><br/><span class="hl-8">// 切换到指定 Work 的指定点位</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">setState</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&quot;Panorama&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">workCode:</span><span class="hl-1"> </span><span class="hl-6">work2</span><span class="hl-1">.</span><span class="hl-6">workCode</span><span class="hl-1">, </span><span class="hl-8">// 必须指定 workCode</span><br/><span class="hl-1">  </span><span class="hl-6">panoIndex:</span><span class="hl-1"> </span><span class="hl-11">0</span><br/><span class="hl-1">});</span>
+<pre><code class="ts"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">work1</span><span class="hl-1"> = </span><span class="hl-4">parseWork</span><span class="hl-1">(</span><span class="hl-5">json1</span><span class="hl-1">);</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">work2</span><span class="hl-1"> = </span><span class="hl-4">parseWork</span><span class="hl-1">(</span><span class="hl-5">json2</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// 同时加载两个 Work</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">load</span><span class="hl-1">([</span><span class="hl-5">work1</span><span class="hl-1">, </span><span class="hl-5">work2</span><span class="hl-1">]);</span><br/><br/><span class="hl-7">// 切换到指定 Work 的指定点位</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">setState</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">mode:</span><span class="hl-1"> </span><span class="hl-10">&quot;Panorama&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">workCode:</span><span class="hl-1"> </span><span class="hl-5">work2</span><span class="hl-1">.</span><span class="hl-5">workCode</span><span class="hl-1">, </span><span class="hl-7">// 必须指定 workCode</span><br/><span class="hl-1">  </span><span class="hl-5">panoIndex:</span><span class="hl-1"> </span><span class="hl-3">0</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 
 <h3 id="4-追加与替换-work" class="tsd-anchor-link">4. 追加与替换 Work<a href="#4-追加与替换-work" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>可以使用 <code>load</code> 方法的参数来控制是替换当前场景还是追加到当前场景。</p>
-<pre><code class="ts"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">work3</span><span class="hl-1"> = </span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json3</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 追加 Work (保留原有场景)</span><br/><span class="hl-8">// 第二个参数 &quot;inherit&quot; 表示保持当前相机视角和模态不变，不重置为新 Work 的初始视角</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-6">work3</span><span class="hl-1">, </span><span class="hl-9">&quot;inherit&quot;</span><span class="hl-1">, { </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&quot;add&quot;</span><span class="hl-1"> });</span><br/><br/><span class="hl-8">// 替换 Work (清空原有场景) - 默认行为</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-6">work3</span><span class="hl-1">, </span><span class="hl-9">&quot;inherit&quot;</span><span class="hl-1">, { </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&quot;replace&quot;</span><span class="hl-1"> });</span>
+<pre><code class="ts"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">work3</span><span class="hl-1"> = </span><span class="hl-4">parseWork</span><span class="hl-1">(</span><span class="hl-5">json3</span><span class="hl-1">);</span><br/><br/><span class="hl-7">// 追加 Work (保留原有场景)</span><br/><span class="hl-7">// 第二个参数 &quot;inherit&quot; 表示保持当前相机视角和模态不变，不重置为新 Work 的初始视角</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">load</span><span class="hl-1">(</span><span class="hl-5">work3</span><span class="hl-1">, </span><span class="hl-10">&quot;inherit&quot;</span><span class="hl-1">, { </span><span class="hl-5">mode:</span><span class="hl-1"> </span><span class="hl-10">&quot;add&quot;</span><span class="hl-1"> });</span><br/><br/><span class="hl-7">// 替换 Work (清空原有场景) - 默认行为</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">load</span><span class="hl-1">(</span><span class="hl-5">work3</span><span class="hl-1">, </span><span class="hl-10">&quot;inherit&quot;</span><span class="hl-1">, { </span><span class="hl-5">mode:</span><span class="hl-1"> </span><span class="hl-10">&quot;replace&quot;</span><span class="hl-1"> });</span>
 </code><button type="button">Copy</button></pre>
 
 <h2 id="common-pitfalls" class="tsd-anchor-link">Common Pitfalls<a href="#common-pitfalls" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>

package/docs/documents/quick-start.html

@@ -4,7 +4,7 @@
 </ul>
 <h2 id="installation" class="tsd-anchor-link">Installation<a href="#installation" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <p>通过 npm 或 yarn 安装：</p>
-<pre><code class="bash"><span class="hl-5">npm</span><span class="hl-1"> </span><span class="hl-9">install</span><span class="hl-1"> </span><span class="hl-9">three@^0.117.1</span><span class="hl-1"> </span><span class="hl-9">@realsee/five</span><br/><span class="hl-8"># or</span><br/><span class="hl-5">yarn</span><span class="hl-1"> </span><span class="hl-9">add</span><span class="hl-1"> </span><span class="hl-9">three@^0.117.1</span><span class="hl-1"> </span><span class="hl-9">@realsee/five</span>
+<pre><code class="bash"><span class="hl-4">npm</span><span class="hl-1"> </span><span class="hl-10">install</span><span class="hl-1"> </span><span class="hl-10">three@^0.117.1</span><span class="hl-1"> </span><span class="hl-10">@realsee/five</span><br/><span class="hl-7"># or</span><br/><span class="hl-4">yarn</span><span class="hl-1"> </span><span class="hl-10">add</span><span class="hl-1"> </span><span class="hl-10">three@^0.117.1</span><span class="hl-1"> </span><span class="hl-10">@realsee/five</span>
 </code><button type="button">Copy</button></pre>
 
 <blockquote>
@@ -12,7 +12,7 @@
 </blockquote>
 <h2 id="basic-usage" class="tsd-anchor-link">Basic Usage<a href="#basic-usage" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <p>初始化 Five 实例并加载 Work 数据：</p>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1">, </span><span class="hl-6">parseWork</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 1. 创建 Five 实例</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">();</span><br/><br/><span class="hl-8">// 2. 挂载到 DOM</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">app</span><span class="hl-1"> = </span><span class="hl-6">document</span><span class="hl-1">.</span><span class="hl-5">getElementById</span><span class="hl-1">(</span><span class="hl-9">&#39;app&#39;</span><span class="hl-1">);</span><br/><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">app</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-8">// 设置容器全屏</span><br/><span class="hl-1">  </span><span class="hl-6">app</span><span class="hl-1">.</span><span class="hl-6">style</span><span class="hl-1">.</span><span class="hl-6">width</span><span class="hl-1"> = </span><span class="hl-9">&#39;100vw&#39;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">app</span><span class="hl-1">.</span><span class="hl-6">style</span><span class="hl-1">.</span><span class="hl-6">height</span><span class="hl-1"> = </span><span class="hl-9">&#39;100vh&#39;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">appendTo</span><span class="hl-1">(</span><span class="hl-6">app</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-8">// 监听窗口大小变化</span><br/><span class="hl-1">  </span><span class="hl-6">window</span><span class="hl-1">.</span><span class="hl-5">addEventListener</span><span class="hl-1">(</span><span class="hl-9">&#39;resize&#39;</span><span class="hl-1">, () </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">refresh</span><span class="hl-1">());</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">// 3. 加载数据 (Work)</span><br/><span class="hl-8">// 这是一个公开测试数据</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">workURL</span><span class="hl-1"> = </span><span class="hl-9">&#39;https://raw.githubusercontent.com/realsee-developer/dnalogel/main/open-works/real/80o024DE2xyva3j5BE/work.json&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">fetch</span><span class="hl-1">(</span><span class="hl-6">workURL</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-5">then</span><span class="hl-1">(</span><span class="hl-6">res</span><span class="hl-1"> </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-6">res</span><span class="hl-1">.</span><span class="hl-5">json</span><span class="hl-1">())</span><br/><span class="hl-1">  .</span><span class="hl-5">then</span><span class="hl-1">(</span><span class="hl-6">json</span><span class="hl-1"> </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">// 解析并加载</span><br/><span class="hl-1">    </span><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">work</span><span class="hl-1"> = </span><span class="hl-5">parseWork</span><span class="hl-1">(</span><span class="hl-6">json</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-6">work</span><span class="hl-1">);</span><br/><span class="hl-1">  })</span><br/><span class="hl-1">  .</span><span class="hl-5">then</span><span class="hl-1">(() </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;模型加载完成&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">  })</span><br/><span class="hl-1">  .</span><span class="hl-5">catch</span><span class="hl-1">(</span><span class="hl-6">err</span><span class="hl-1"> </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">error</span><span class="hl-1">(</span><span class="hl-6">err</span><span class="hl-1">));</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1">, </span><span class="hl-5">parseWork</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 1. 创建 Five 实例</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">();</span><br/><br/><span class="hl-7">// 2. 挂载到 DOM</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">app</span><span class="hl-1"> = </span><span class="hl-5">document</span><span class="hl-1">.</span><span class="hl-4">getElementById</span><span class="hl-1">(</span><span class="hl-10">&#39;app&#39;</span><span class="hl-1">);</span><br/><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">app</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-7">// 设置容器全屏</span><br/><span class="hl-1">  </span><span class="hl-5">app</span><span class="hl-1">.</span><span class="hl-5">style</span><span class="hl-1">.</span><span class="hl-5">width</span><span class="hl-1"> = </span><span class="hl-10">&#39;100vw&#39;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-5">app</span><span class="hl-1">.</span><span class="hl-5">style</span><span class="hl-1">.</span><span class="hl-5">height</span><span class="hl-1"> = </span><span class="hl-10">&#39;100vh&#39;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">appendTo</span><span class="hl-1">(</span><span class="hl-5">app</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-7">// 监听窗口大小变化</span><br/><span class="hl-1">  </span><span class="hl-5">window</span><span class="hl-1">.</span><span class="hl-4">addEventListener</span><span class="hl-1">(</span><span class="hl-10">&#39;resize&#39;</span><span class="hl-1">, () </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">refresh</span><span class="hl-1">());</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">// 3. 加载数据 (Work)</span><br/><span class="hl-7">// 这是一个公开测试数据</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">workURL</span><span class="hl-1"> = </span><span class="hl-10">&#39;https://raw.githubusercontent.com/realsee-developer/dnalogel/main/open-works/real/80o024DE2xyva3j5BE/work.json&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-4">fetch</span><span class="hl-1">(</span><span class="hl-5">workURL</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-4">then</span><span class="hl-1">(</span><span class="hl-5">res</span><span class="hl-1"> </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-5">res</span><span class="hl-1">.</span><span class="hl-4">json</span><span class="hl-1">())</span><br/><span class="hl-1">  .</span><span class="hl-4">then</span><span class="hl-1">(</span><span class="hl-5">json</span><span class="hl-1"> </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-7">// 解析并加载</span><br/><span class="hl-1">    </span><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">work</span><span class="hl-1"> = </span><span class="hl-4">parseWork</span><span class="hl-1">(</span><span class="hl-5">json</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-11">return</span><span class="hl-1"> </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">load</span><span class="hl-1">(</span><span class="hl-5">work</span><span class="hl-1">);</span><br/><span class="hl-1">  })</span><br/><span class="hl-1">  .</span><span class="hl-4">then</span><span class="hl-1">(() </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;模型加载完成&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">  })</span><br/><span class="hl-1">  .</span><span class="hl-4">catch</span><span class="hl-1">(</span><span class="hl-5">err</span><span class="hl-1"> </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">error</span><span class="hl-1">(</span><span class="hl-5">err</span><span class="hl-1">));</span>
 </code><button type="button">Copy</button></pre>
 
 <h2 id="next-steps" class="tsd-anchor-link">Next Steps<a href="#next-steps" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>

package/docs/documents/release_notes_6.6.html

@@ -2,7 +2,7 @@
 <blockquote>
 <p>6.6.x 版本发布日志</p>
 </blockquote>
-<pre><code class="shell"><span class="hl-5">npm</span><span class="hl-1"> </span><span class="hl-9">install</span><span class="hl-1"> </span><span class="hl-9">@realsee/five@6.6</span>
+<pre><code class="shell"><span class="hl-4">npm</span><span class="hl-1"> </span><span class="hl-10">install</span><span class="hl-1"> </span><span class="hl-10">@realsee/five@6.6</span>
 </code><button type="button">Copy</button></pre>
 
 <h2 id="依赖升级" class="tsd-anchor-link">依赖升级<a href="#依赖升级" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
@@ -28,7 +28,7 @@
 <ul>
 <li><strong>firstHitOnly</strong>: 在 <code>THREE.Raycaster</code> 上扩展了 <code>firstHitOnly</code> 属性。当设置为 <code>true</code> 时，BVH 遍历算法会在找到第一个满足条件的交点后，利用该交点的距离对后续搜索进行剪枝（Pruning），避免遍历所有可能的交点。这对于点击拾取（Picking）操作有极大的性能提升。</li>
 </ul>
-<pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">raycaster</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-4">THREE</span><span class="hl-1">.</span><span class="hl-5">Raycaster</span><span class="hl-1">();</span><br/><span class="hl-8">// 开启首个命中优化</span><br/><span class="hl-6">raycaster</span><span class="hl-1">.</span><span class="hl-6">firstHitOnly</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">intersects</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-5">intersectRaycaster</span><span class="hl-1">(</span><span class="hl-6">raycaster</span><span class="hl-1">);</span>
+<pre><code class="typescript"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">raycaster</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-6">THREE</span><span class="hl-1">.</span><span class="hl-4">Raycaster</span><span class="hl-1">();</span><br/><span class="hl-7">// 开启首个命中优化</span><br/><span class="hl-5">raycaster</span><span class="hl-1">.</span><span class="hl-5">firstHitOnly</span><span class="hl-1"> = </span><span class="hl-8">true</span><span class="hl-1">;</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">intersects</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-4">intersectRaycaster</span><span class="hl-1">(</span><span class="hl-5">raycaster</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 
 <ul>
@@ -43,12 +43,12 @@
 <h2 id="新增特性" class="tsd-anchor-link">新增特性<a href="#新增特性" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <h3 id="imagebitmap-支持" class="tsd-anchor-link">ImageBitmap 支持<a href="#imagebitmap-支持" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>支持使用浏览器原生的 <code>ImageBitmap</code> API 替代传统的 <code>HTMLImageElement</code> 进行纹理加载。<code>ImageBitmap</code> 的解码过程可以在后台线程进行，避免了解码大图时阻塞主线程导致的掉帧现象。</p>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 开启 Native ImageBitmap 支持 (全局配置)</span><br/><span class="hl-6">Five</span><span class="hl-1">.</span><span class="hl-6">useNativeImageBitmap</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 之后创建的 Five 实例将自动应用此配置</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">({ ... });</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;@realsee/five&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 开启 Native ImageBitmap 支持 (全局配置)</span><br/><span class="hl-5">Five</span><span class="hl-1">.</span><span class="hl-5">useNativeImageBitmap</span><span class="hl-1"> = </span><span class="hl-8">true</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 之后创建的 Five 实例将自动应用此配置</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">({ ... });</span>
 </code><button type="button">Copy</button></pre>
 
 <h3 id="图片-exif-旋转支持" class="tsd-anchor-link">图片 Exif 旋转支持<a href="#图片-exif-旋转支持" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p><code>imageOptions</code> 新增 <code>forceUseExifOrientation</code> 参数。针对部分未在服务端处理旋转的图片，该参数可强制读取并应用图片 Exif 中的 Orientation 信息，确保渲染方向正确。</p>
-<pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-6">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">forceUseExifOrientation:</span><span class="hl-1"> </span><span class="hl-3">true</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">imageOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">forceUseExifOrientation:</span><span class="hl-1"> </span><span class="hl-8">true</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 
 <h3 id="航拍全景图优化" class="tsd-anchor-link">航拍全景图优化<a href="#航拍全景图优化" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>