u-space 0.0.7 → 0.0.9

package/docs/api-tools.md

@@ -0,0 +1,254 @@
+# Tools API
+
+`u-space` 提供了一组实用工具类，包括测量、剖切和标注功能。
+
+## MeasureTool
+
+用于 3D 场景中的距离测量、面积测量和角度测量，测量结果会以可视化线条渲染到场景中。
+
+```typescript
+import { MeasureTool } from 'u-space';
+
+const measureTool = new MeasureTool(viewer.scene);
+```
+
+### `measureDistance(pointA, pointB, options?)`
+
+测量两点之间的距离，并在场景中绘制连线。
+
+```typescript
+const result = measureTool.measureDistance(
+  { x: 0, y: 0, z: 0 },
+  { x: 5, y: 0, z: 5 },
+  { lineColor: 0xffff00 },
+);
+console.log(result.value, result.unit); // 7.071 m
+```
+
+### `measureArea(points, options?)`
+
+测量由 3 个或更多共面点围成的多边形面积。
+
+```typescript
+const result = measureTool.measureArea([
+  { x: 0, y: 0, z: 0 },
+  { x: 5, y: 0, z: 0 },
+  { x: 5, y: 0, z: 5 },
+  { x: 0, y: 0, z: 5 },
+], { lineColor: 0x00ff00 });
+console.log(result.value, result.unit); // 25 m²
+```
+
+### `measureAngle(pointA, vertex, pointC, options?)`
+
+测量以中间点为顶点的夹角（单位：度）。
+
+```typescript
+const result = measureTool.measureAngle(
+  { x: 3, y: 0, z: 0 },
+  { x: 0, y: 0, z: 0 },
+  { x: 0, y: 0, z: 3 },
+);
+console.log(result.value, result.unit); // 90 °
+```
+
+### `MeasureResult`
+
+所有测量方法返回 `MeasureResult` 对象：
+
+| 属性     | 类型        | 说明                               |
+| :------- | :---------- | :--------------------------------- |
+| `id`     | `string`    | 测量的唯一标识。                   |
+| `type`   | `string`    | `'distance'` / `'area'` / `'angle'`。|
+| `value`  | `number`    | 测量值。                           |
+| `unit`   | `string`    | 单位（`m`、`m²`、`°`）。          |
+| `points` | `Vector3[]` | 测量点坐标。                       |
+| `object` | `Group`     | 场景中的可视化对象。               |
+
+### `MeasureStyleOptions`
+
+| 属性        | 类型                  | 默认值     | 说明         |
+| :---------- | :-------------------- | :--------- | :----------- |
+| `lineColor` | `ColorRepresentation` | 因方法而异 | 线条颜色。   |
+
+### 管理方法
+
+```typescript
+measureTool.get('measure_dist_0');  // 获取指定测量
+measureTool.remove('measure_dist_0'); // 移除指定测量
+measureTool.removeAll();              // 清除全部
+measureTool.getAll();                 // 获取所有测量结果
+measureTool.dispose();                // 释放资源
+```
+
+---
+
+## ClippingTool
+
+提供剖切面和剖切盒功能，基于 WebGPU 的 `ClippingGroup` 实现。需要被剖切的对象必须是 `ClippingGroup` 的子节点。
+
+```typescript
+import { ClippingTool } from 'u-space';
+
+const clippingTool = new ClippingTool(viewer.scene);
+
+// 将场景中已有的物体移入 ClippingGroup，使其受剖切影响
+clippingTool.attach();
+```
+
+### `attach()` / `detach()`
+
+`attach()` 将场景根节点的所有子对象移入内部的 `ClippingGroup`，使其受剖切面影响。`detach()` 反向操作，将对象移回场景根节点。
+
+也可以手动将对象添加到 `clippingTool.group` 中：
+
+```typescript
+clippingTool.group.add(myModel); // 仅 myModel 受剖切
+```
+
+### `addPlane(id, options?)`
+
+添加一个剖切面。
+
+```typescript
+clippingTool.addPlane('cutY', {
+  normal: { x: 0, y: -1, z: 0 },  // 法线方向
+  constant: 1.5,                    // 距离原点的偏移
+  showHelper: true,                 // 显示 Helper
+  helperSize: 5,
+  helperColor: 0xff0000,
+});
+```
+
+#### `ClippingPlaneOptions`
+
+| 属性          | 类型                  | 默认值             | 说明                     |
+| :------------ | :-------------------- | :----------------- | :----------------------- |
+| `normal`      | `{x, y, z}`          | `{x:0, y:-1, z:0}` | 法线方向。               |
+| `constant`    | `number`              | `0`                | 距原点偏移。             |
+| `showHelper`  | `boolean`             | `false`            | 是否显示 PlaneHelper。   |
+| `helperSize`  | `number`              | `5`                | Helper 尺寸。            |
+| `helperColor` | `ColorRepresentation` | `0xff0000`         | Helper 颜色。            |
+
+### `addBox(id, box, options?)` / `addBoxFromObject(id, object, padding?, options?)`
+
+添加由 6 个面组成的剖切盒。
+
+```typescript
+import { Box3 } from 'three/webgpu';
+
+// 从 Box3 创建
+const box = new Box3().setFromObject(myModel);
+clippingTool.addBox('clipBox', box);
+
+// 从对象创建（带边距）
+clippingTool.addBoxFromObject('clipBox', myModel, 0.5);
+```
+
+### 动态调整
+
+```typescript
+clippingTool.setPlaneConstant('cutY', 2.0); // 修改剖切位置
+viewer.render();
+```
+
+### Helper 控制
+
+```typescript
+clippingTool.showHelper('cutY', 5, 0xff0000);
+clippingTool.hideHelper('cutY');
+```
+
+### 管理方法
+
+```typescript
+clippingTool.get('cutY');       // 获取 Plane 对象
+clippingTool.removePlane('cutY'); // 移除单个
+clippingTool.removeBox('clipBox'); // 移除剖切盒（6 个面）
+clippingTool.removeAll();          // 移除全部
+clippingTool.enable();             // 启用剖切
+clippingTool.disable();            // 禁用剖切
+clippingTool.dispose();            // 释放资源（对象移回场景根节点）
+```
+
+---
+
+## AnnotationManager
+
+管理 3D 标注，支持引线标注和 HTML 标签。配合 `CSSRenderer` 使用可实现 HTML 浮动标签。
+
+```typescript
+import { AnnotationManager } from 'u-space';
+
+const annotationManager = new AnnotationManager(viewer.scene);
+```
+
+### `setCSSObjectFactory(factory)`
+
+设置 CSS 对象工厂函数（来自 `CSSRenderer`），使标注可渲染为 CSS 叠加元素。
+
+```typescript
+annotationManager.setCSSObjectFactory(
+  (el) => viewer.cssRenderer.createCSS2DObject(el),
+);
+```
+
+### `add(id, options)`
+
+添加一个标注。
+
+```typescript
+annotationManager.add('label-01', {
+  position: { x: 0, y: 3, z: 0 },
+  content: '<b>设备 A</b><br>温度: 25°C',
+  labelOffset: { x: 0, y: 2, z: 0 },
+  showLeaderLine: true,
+  lineColor: 0xffffff,
+  labelStyle: {
+    background: 'rgba(0, 0, 0, 0.8)',
+    padding: '8px 12px',
+    borderRadius: '6px',
+  },
+});
+```
+
+#### `AnnotationOptions`
+
+| 属性             | 类型                      | 默认值      | 说明                   |
+| :--------------- | :------------------------ | :---------- | :--------------------- |
+| `position`       | `{x, y, z}`              | —           | 标注锚点位置。         |
+| `content`        | `string`                 | —           | HTML 内容。            |
+| `labelOffset`    | `{x, y, z}`              | `{0, 2, 0}` | 标签相对锚点的偏移。   |
+| `showLeaderLine` | `boolean`                | `true`      | 是否显示引线。         |
+| `lineColor`      | `ColorRepresentation`    | `0xffffff`  | 引线颜色。             |
+| `labelStyle`     | `Partial<CSSStyleDeclaration>` | —      | 自定义 CSS 样式。      |
+
+### `addText(text, position, options?)`
+
+快捷添加纯文本标注。
+
+```typescript
+annotationManager.addText('入口', { x: 5, y: 0, z: 0 });
+```
+
+### 更新与控制
+
+```typescript
+annotationManager.updateContent('label-01', '温度: 30°C');
+annotationManager.updatePosition('label-01', { x: 1, y: 3, z: 0 });
+annotationManager.show('label-01');
+annotationManager.hide('label-01');
+annotationManager.showAll();
+annotationManager.hideAll();
+```
+
+### 管理方法
+
+```typescript
+annotationManager.get('label-01');   // 获取标注对象
+annotationManager.remove('label-01'); // 移除标注
+annotationManager.removeAll();        // 移除全部
+annotationManager.keys();             // 获取所有 ID
+annotationManager.size;               // 标注数量
+annotationManager.dispose();          // 释放资源
+```

package/docs/api-viewer.md

@@ -101,35 +101,101 @@ const camera = viewer.createOrthographicCamera();
 viewer.setCamera(camera);
 ```
 
-### `controls.setCameraViewpoint(viewpoint, enableTransition?)`
+### `resize(width?, height?)`
 
-将相机平滑过渡到指定的位置、目标和缩放。
+手动触发容器尺寸更新。可选传入指定宽高。
 
 ```typescript
-await viewer.controls.setCameraViewpoint({
-  position: { x: 10, y: 5, z: 10 },
-  target: { x: 0, y: 0, z: 0 },
-  zoom: 1.0,
+// 手动触发 resize（如容器尺寸变化后）
+viewer.resize();
+
+// 指定新尺寸
+viewer.resize(800, 600);
+```
+
+### `screenshot(options?)`
+
+捕获当前渲染画面并返回 Data URL。
+
+```typescript
+const dataUrl = await viewer.screenshot();
+
+// 指定格式和分辨率
+const dataUrl = await viewer.screenshot({
+  width: 1920,
+  height: 1080,
+  type: 'image/png',
+  quality: 1.0,
 });
+```
+
+#### `ScreenshotOptions`
+
+| 属性      | 类型                                            | 默认值        | 说明                   |
+| :-------- | :---------------------------------------------- | :------------ | :--------------------- |
+| `width`   | `number`                                        | 容器宽度      | 截图宽度。             |
+| `height`  | `number`                                        | 容器高度      | 截图高度。             |
+| `type`    | `'image/png'` \| `'image/jpeg'` \| `'image/webp'` | `'image/png'` | 图片格式。             |
+| `quality` | `number`                                        | `1.0`         | 图片质量（0-1）。      |
+
+### `setBackground(background)`
+
+设置场景背景颜色、纹理或清除背景。
+
+```typescript
+viewer.setBackground(0x333333);       // 颜色
+viewer.setBackground('#87ceeb');      // CSS 颜色字符串
+viewer.setBackground(hdrTexture);     // 纹理
+viewer.setBackground(null);           // 清除背景
+```
+
+### `setEnvironment(envMap)`
+
+设置场景环境贴图（用于反射/IBL）。
+
+```typescript
+viewer.setEnvironment(hdrTexture);
+viewer.setEnvironment(null); // 清除
+```
+
+### `enableShadow()` / `disableShadow()`
+
+开启或关闭阴影渲染。
+
+```typescript
+viewer.enableShadow();
+viewer.disableShadow();
+```
+
+### `enableFog(options?)` / `enableFogExp2(options?)` / `disableFog()`
+
+开启线性雾、指数雾或关闭雾效。
+
+```typescript
+// 线性雾
+viewer.enableFog({ color: 0xcccccc, near: 10, far: 100 });
+
+// 指数雾
+viewer.enableFogExp2({ color: 0xcccccc, density: 0.01 });
 
-// 禁用过渡动画，立即跳转
-await viewer.controls.setCameraViewpoint(viewpoint, false);
+// 关闭雾效
+viewer.disableFog();
 ```
 
-**参数：**
+#### `FogOptions`
 
-| 参数               | 类型                   | 默认值  | 说明                                |
-| :----------------- | :--------------------- | :------ | :---------------------------------- |
-| `viewpoint`        | `CameraViewpointData`  | —       | 包含 `position`、`target`、`zoom`。 |
-| `enableTransition` | `boolean`              | `true`  | 是否启用平滑过渡动画。             |
+| 属性    | 类型                  | 默认值      | 说明           |
+| :------ | :-------------------- | :---------- | :------------- |
+| `color` | `ColorRepresentation` | `0xcccccc`  | 雾的颜色。     |
+| `near`  | `number`              | `10`        | 雾的起始距离。 |
+| `far`   | `number`              | `100`       | 雾的结束距离。 |
 
-#### `CameraViewpointData`
+#### `FogExp2Options`
 
-| 属性       | 类型       | 说明                 |
-| :--------- | :--------- | :------------------- |
-| `position` | `IVector3` | 相机位置。           |
-| `target`   | `IVector3` | 相机注视目标位置。   |
-| `zoom`     | `number`   | 相机缩放值。         |
+| 属性      | 类型                  | 默认值      | 说明           |
+| :-------- | :-------------------- | :---------- | :------------- |
+| `color`   | `ColorRepresentation` | `0xcccccc`  | 雾的颜色。     |
+| `density` | `number`              | `0.01`      | 雾的密度。     |
 
 ## 调试工具
 

package/docs/changelog.md

@@ -0,0 +1,105 @@
+# 更新日志
+
+## 0.0.8 (开发中)
+
+### 新增
+
+- **Viewer** — `resize()`、`screenshot()`、`setBackground()`、`setEnvironment()`、`enableShadow()`/`disableShadow()`、`enableFog()`/`enableFogExp2()`/`disableFog()`
+- **CameraControls** — `flyTo()`、`getCameraViewpoint()`、`lock()`/`unlock()`、`setViewMode('2d' | '3d')`
+- **ObjectManager** — `show()`/`hide()`、`isolate()`、`showAll()`、`setOpacity()`、`getBoundingBox()`、`forEach()`、`filter()`
+- **InteractionManager** — `enable()`/`disable()`、`setInteractable()`、`addIgnore()`/`removeIgnore()`
+- **Selection** — 新增框选（rubber-band）和单选/多选/切换模块，支持 `select`/`deselect`/`change` 事件
+- **MaterialEffects** — `wireframe()`/`removeWireframe()`、`transparent()`/`removeTransparent()`、`xray()`/`removeXray()`、`fadeIn()`/`fadeOut()`
+- **Model** — `getBoundingBox()`、`getCenter()`、`setMaterial()`
+- **SceneManager** — 新模块，多场景创建、注册、切换与序列化
+- **LightManager** — 新模块，灯光便捷创建、4 种预设（indoor/outdoor/studio/warehouse）、Helper 可视化
+- **MeasureTool** — 新工具，距离/面积/角度测量，结果可视化渲染到场景
+- **ClippingTool** — 新工具，基于 WebGPU `ClippingGroup` 的剖切面与剖切盒
+- **AnnotationManager** — 新工具，3D 引线标注 + HTML 浮动标签
+- **示例** — 新增 8 个交互式示例页面
+
+### 修复
+
+- **Selection** — 框选覆盖层改为挂载到容器元素（而非 canvas），修复框选矩形不可见的问题
+- **ClippingTool** — 从 `renderer.clippingPlanes`（WebGL API）重写为 `ClippingGroup`（WebGPU API），修复剖切无效的问题
+- **MaterialEffects** — fade 动画在对象移除场景后自动停止，避免内存泄漏
+- **InteractionManager** — `dispose()` 中清除 `clickTimer`，避免定时器泄漏
+- **LightManager** — 修复 `removeAll()`/`hideAllHelpers()` 中遍历 Map 同时删除的问题
+- **ObjectManager** — `setOpacity()` 先检查 `isMesh` 再类型转换
+- **ClippingTool** — `PlaneHelper` 颜色使用 `new Color(color).getHex()` 替代直接 `as number`
+- **MeasureTool** — 移除 WebGPU 不支持的 `linewidth` 属性
+
+---
+
+## 0.0.7
+
+### 变更
+
+- 文档拆分：将插件文档拆分为独立文件
+- 新增 CameraControls 独立文档页
+- 修复 getting-started 中的死链
+- 修复 sbmx loader 示例使用新的 MaterialEffects API
+
+---
+
+## 0.0.6
+
+### 新增
+
+- **MaterialEffects** — 可组合的材质特效系统，支持安全共享材质和 remove API
+- **RenderPipeline** — 内置 Bloom、SSGI、TRAA 后处理及 OutputComposer API
+- **CSSRenderer** — CSS2D / CSS2.5D / CSS3D 叠加渲染 HTML 元素
+- 从 `package.json` 导出 `version`，统一示例 importmap
+
+---
+
+## 0.0.5
+
+### 变更
+
+- 版本发布（无重大功能变更）
+
+---
+
+## 0.0.4
+
+### 新增
+
+- **Model** — 动画播放支持（`playAnimation`、`stopAnimation`、`updateAnimation`）
+- **ViewerEventMap** — 事件回调新增 `delta` 时间参数
+
+---
+
+## 0.0.3
+
+### 新增
+
+- **ObjectControls** 插件 — 交互式移动、旋转、缩放 3D 对象
+- **TopologyDrawer** 插件 — 在场景任意表面交互式绘制拓扑路径图
+- **Topology** — `exportData()` / `importData()` 数据序列化
+
+### 变更
+
+- **Interactions** — `contextmenu` 事件替换为 `rightclick`
+- **Poi** — 优化渲染性能，新增 `scaleFactor` 参数
+- 文档全面完善：本地搜索、侧边栏优化、各插件文档页
+
+---
+
+## 0.0.0
+
+### 新增
+
+- 项目初始化：Viewer 核心、WebGPU 渲染器、场景/相机/控制器
+- 模型加载系统：双层缓存（内存 + 持久化）、Draco/KTX2/Meshopt 支持
+- 交互系统：射线检测、事件冒泡、自定义 3D 对象事件
+- 对象系统：Model、Poi、Topology、基础网格（Sphere/Plane/Circle/Tube/Extrude/Shape）
+- ObjectManager 集中式对象注册
+- 补间动画系统
+- u-manager 插件：场景加载、动画、属性、视点管理
+- tiles 插件：ArcGIS 3D 瓦片 / GIS 地球渲染
+- minimap 插件：2D 小地图
+- keyboard-controls 插件：WASD 键盘控制
+- tracking-controls 插件：相机跟随
+- atmosphere 插件：天空/大气渲染
+- curve-movement 插件：曲线路径动画

package/docs/examples-guide.md

@@ -86,3 +86,107 @@
 - 使用 `viewer.renderPipeline.enableTRAA()` / `disableTRAA()` 切换时间抗锯齿。
 - 使用 `viewer.renderPipeline.setOutputComposer()` 自定义后处理链（示例中实现了灰度滤镜）。
 - 使用 `setOutputComposer(null)` 恢复默认渲染管线。
+
+## 8. `test_viewer_utils.html`：Viewer 工具方法
+
+该示例演示了 `Viewer` 新增的便捷方法：截图导出、背景切换、雾效控制和阴影开关。
+
+### 核心要点：
+
+- 使用 `viewer.screenshot()` 导出当前渲染画面为 PNG 文件。
+- 使用 `viewer.setBackground(color)` 快速切换场景背景颜色。
+- 使用 `viewer.enableFog()` / `viewer.disableFog()` 控制雾效。
+- 使用 `viewer.enableShadow()` / `viewer.disableShadow()` 控制阴影渲染。
+- 使用 `viewer.resize(width, height)` 手动触发尺寸更新。
+
+## 9. `test_camera_controls.html`：CameraControls 增强方法
+
+该示例演示了 `CameraControls` 的飞行定位、视角存取、锁定和二三维切换功能。
+
+### 核心要点：
+
+- 使用 `viewer.controls.flyTo(position, target)` 将相机飞行到指定坐标。
+- 使用 `viewer.controls.getCameraViewpoint()` 获取当前视角数据。
+- 使用 `viewer.controls.setCameraViewpoint(data)` 恢复保存的视角。
+- 使用 `viewer.controls.lock()` / `unlock()` 锁定或解锁相机控制。
+- 使用 `viewer.controls.setViewMode('2d')` / `setViewMode('3d')` 在二三维视图间切换。
+
+## 10. `test_object_manager.html`：ObjectManager 增强方法
+
+该示例演示了 `ObjectManager` 的显隐控制、孤立显示、透明度设置、包围盒查询和过滤功能。
+
+### 核心要点：
+
+- 使用 `viewer.objectManager.show(id)` / `hide(id)` 控制对象可见性。
+- 使用 `viewer.objectManager.isolate(ids)` 孤立显示指定对象。
+- 使用 `viewer.objectManager.setOpacity(id, value)` 设置材质透明度。
+- 使用 `viewer.objectManager.getBoundingBox()` 查询所有对象的包围盒。
+- 使用 `viewer.objectManager.filter(predicate)` 按条件过滤对象。
+
+## 11. `test_material_effects.html`：MaterialEffects 增强效果
+
+该示例演示了材质效果系统的线框、半透明、X 光和淡入淡出功能。
+
+### 核心要点：
+
+- 使用 `MaterialEffects.wireframe(object)` 开启线框渲染模式。
+- 使用 `MaterialEffects.highlightColor(object, { opacity })` 设置半透明效果。
+- 使用 `MaterialEffects.highlightColor(object, { color, opacity, overwrite: true, depthWrite: false })` 实现 X 光透视效果。
+- 使用 `MaterialEffects.fadeOut(object)` / `fadeIn(object)` 执行淡入淡出动画。
+- 使用 `MaterialEffects.removeHighlightColor(object)` 恢复原始材质状态。
+
+## 12. `test_selection.html`：Selection 选择系统
+
+该示例演示了对象选择系统的单选和框选功能。
+
+### 核心要点：
+
+- 创建 `Selection` 实例并监听 `select`、`deselect`、`change` 事件。
+- 使用 `selection.select()` / `deselect()` / `toggle()` / `clear()` 进行程序化选择操作。
+- 使用 `selection.enableBoxSelection()` 开启鼠标框选模式。
+- 框选模式下可配合 `viewer.controls.lock()` 避免框选与相机旋转冲突。
+
+## 13. `test_measure.html`：MeasureTool 测量工具
+
+该示例演示了 3D 场景中的距离、面积和角度测量。
+
+### 核心要点：
+
+- 使用 `measureTool.measureDistance(pointA, pointB)` 测量两点距离。
+- 使用 `measureTool.measureArea(points)` 测量多边形面积。
+- 使用 `measureTool.measureAngle(pointA, vertex, pointC)` 测量夹角。
+- 测量结果以可视化线条渲染到场景中，返回的 `MeasureResult` 包含数值和单位。
+
+## 14. `test_annotation.html`：AnnotationManager 标注管理
+
+该示例演示了 3D 标注的创建、更新和管理，配合 `CSSRenderer` 实现 HTML 浮动标签。
+
+### 核心要点：
+
+- 创建 `AnnotationManager` 实例并通过 `setCSSObjectFactory()` 绑定 `CSSRenderer`。
+- 使用 `annotationManager.add(id, options)` 添加带引线和自定义样式的标注。
+- 使用 `annotationManager.addText(text, position)` 快捷添加纯文本标注。
+- 使用 `updateContent()` 动态更新标注内容，`updatePosition()` 移动标注位置。
+- 使用 `hideAll()` / `showAll()` 批量控制标注显隐。
+
+## 15. `test_clipping.html`：ClippingTool 剖切工具
+
+该示例演示了剖切面的创建和实时调整。
+
+### 核心要点：
+
+- 创建 `ClippingTool` 实例并调用 `attach()` 将场景物体移入 ClippingGroup。
+- 使用 `clippingTool.addPlane(id, options)` 添加剖切面。
+- 使用滑块通过 `clippingTool.setPlaneConstant()` 实时调整剖切位置。
+- 使用 `showHelper()` / `hideHelper()` 切换剖切面可视化辅助。
+
+## 16. `test_lights.html`：LightManager 灯光管理
+
+该示例演示了灯光管理器的灯光预设和 Helper 可视化功能。
+
+### 核心要点：
+
+- 创建 `LightManager` 实例并使用 `applyPreset()` 一键应用灯光预设。
+- 支持 4 种预设：`indoor`（室内）、`outdoor`（室外）、`studio`（摄影棚）、`warehouse`（仓库）。
+- 使用 `showAllHelpers()` / `hideAllHelpers()` 显示或隐藏灯光辅助可视化。
+- 每种预设会自动清除旧灯光并创建新的灯光组合。

package/docs/getting-started.md

@@ -137,7 +137,7 @@ console.log(window.__USPACE__.version);
 - 探索如何 [加载模型与使用对象](./api-objects.md)
 - 理解 [交互系统](./api-interactions.md)
 - 使用 [Managers API](./api-managers.md) 注册和检索对象
-- 通过 [Plugins API](./api-plugins.md) 添加瓦片地图、小地图、键盘控制等功能
+- 通过插件添加 [瓦片地图](./api-plugin-tiles.md)、[小地图](./api-plugin-minimap.md)、[键盘控制](./api-plugin-keyboard-controls.md) 等功能
 - 使用 [Animations API](./api-animations.md) 为属性添加动画
 - 使用 [Effects API](./api-effects.md) 应用视觉特效
 - 浏览 [示例指南](./examples-guide.md)

package/docs/index.md

@@ -33,13 +33,15 @@ features:
 | 文档 | 说明 |
 | :--- | :--- |
 | [Viewer](./api-viewer) | 核心类：渲染器、场景、相机、控制器、事件 |
+| [CameraControls](./api-camera-controls) | 相机控制：飞行、视角切换、视点过渡 |
 | [CSSRenderer](./api-css-renderer) | CSS 渲染器：CSS2D / CSS2.5D / CSS3D 叠加 HTML 元素 |
 | [RenderPipeline](./api-render-pipeline) | 后处理管线：Bloom、SSGI、TRAA、自定义后处理 |
 | [Objects](./api-objects) | 3D 对象：模型加载、基础网格、Poi、Topology |
-| [Interactions](./api-interactions) | 交互管理：射线检测、鼠标/触摸事件 |
-| [Managers](./api-managers) | 对象管理：按 ID / 名称 / 类型检索 |
+| [Interactions](./api-interactions) | 交互管理：射线检测、鼠标/触摸事件、框选 |
+| [Managers](./api-managers) | 对象管理、场景管理、灯光管理 |
 | [Animations](./api-animations) | 补间动画：`tweenAnimation`、`Tween`、缓动模式 |
-| [Effects](./api-effects) | 视觉特效：高亮、流动、呼吸、流体（TSL） |
+| [Effects](./api-effects) | 视觉特效：高亮、呼吸、线框、淡入淡出、流动、流体（TSL） |
+| [Tools](./api-tools) | 工具：测量（距离/面积/角度）、剖切（面/盒）、标注管理 |
 
 ### 插件
 
@@ -47,12 +49,12 @@ features:
 
 | 插件 | 说明 |
 | :--- | :--- |
-| [keyboard-controls](./api-plugins#keyboard-controls) | WASD / 方向键控制相机移动与旋转 |
-| [minimap](./api-plugins#minimap) | 2D 小地图叠加层 |
-| [tiles](./api-plugins#tiles) | ArcGIS 3D 瓦片 / GIS 地球渲染 |
-| [u-manager](./api-plugins#u-manager) | 场景加载、拓扑、动画、属性、视点管理 |
-| [curve-movement](./api-plugins#curve-movement) | 沿样条曲线移动相机或对象 |
-| [tracking-controls](./api-plugins#tracking-controls) | 相机跟随移动目标 |
-| [atmosphere](./api-plugins#atmosphere) | 天空/大气渲染（开发中） |
-| [object-controls](./api-plugins#object-controls) | 交互式移动、旋转、缩放 3D 对象 |
-| [topology-drawer](./api-plugins#topology-drawer) | 在场景任意表面交互式绘制拓扑路径图 |
+| [keyboard-controls](./api-plugin-keyboard-controls) | WASD / 方向键控制相机移动与旋转 |
+| [minimap](./api-plugin-minimap) | 2D 小地图叠加层 |
+| [tiles](./api-plugin-tiles) | ArcGIS 3D 瓦片 / GIS 地球渲染 |
+| [u-manager](./api-plugin-u-manager) | 场景加载、拓扑、动画、属性、视点管理 |
+| [curve-movement](./api-plugin-curve-movement) | 沿样条曲线移动相机或对象 |
+| [tracking-controls](./api-plugin-tracking-controls) | 相机跟随移动目标 |
+| [atmosphere](./api-plugin-atmosphere) | 天空/大气渲染（开发中） |
+| [object-controls](./api-plugin-object-controls) | 交互式移动、旋转、缩放 3D 对象 |
+| [topology-drawer](./api-plugin-topology-drawer) | 在场景任意表面交互式绘制拓扑路径图 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-space",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "type": "module",
   "types": "dist/src/index.d.ts",
   "module": "dist/index.js",