u-space 0.0.19 → 0.0.21

package/dist/plugins/u-manager/semantics/SemanticLoader.d.ts

@@ -1,6 +1,6 @@
 import { Loader } from 'three/webgpu';
 import type { Viewer } from 'u-space';
-import { BuildingGroup } from './BuildingGroup';
+import { BuildingGroup } from './objects/BuildingGroup';
 export declare class SemanticLoader extends Loader {
     viewer: Viewer;
     constructor(viewer: Viewer);

package/dist/plugins/u-manager/semantics/SemanticParser.d.ts

@@ -1,4 +1,4 @@
-import { BuildingGroup } from './BuildingGroup';
+import { BuildingGroup } from './objects/BuildingGroup';
 import type { SemanticObject } from './semantic.types';
 export declare class SemanticParser {
     parse(semanticData: SemanticObject): BuildingGroup[];

package/dist/plugins/u-manager/semantics/index.d.ts

@@ -1,6 +1,9 @@
 export * from './semantic.types';
 export * from './types';
-export * from './FloorMesh';
-export * from './BuildingGroup';
+export * from './objects/FloorMesh';
+export * from './objects/VerticalShaftMesh';
+export * from './objects/ElevatorMesh';
+export * from './objects/VentMesh';
+export * from './objects/BuildingGroup';
 export * from './SemanticParser';
 export * from './SemanticLoader';

package/dist/plugins/u-manager/semantics/{BuildingGroup.d.ts → objects/BuildingGroup.d.ts}

@@ -1,14 +1,24 @@
 import { BaseGroup } from 'u-space';
+import type { ElevatorMesh } from './ElevatorMesh';
 import type { FloorMesh } from './FloorMesh';
-import type { SemanticKind } from './types';
+import type { SemanticKind } from '../types';
+import type { VentMesh } from './VentMesh';
 export declare class BuildingGroup extends BaseGroup {
     isBuildingGroup: boolean;
     type: string;
     floorMeshes: FloorMesh[];
+    elevatorMeshes: ElevatorMesh[];
+    ventMeshes: VentMesh[];
     constructor();
     addFloor(mesh: FloorMesh): this;
     getFloorAt(index: number): FloorMesh;
     removeFloor(mesh: FloorMesh): this;
+    addElevator(mesh: ElevatorMesh): this;
+    getElevatorAt(index: number): ElevatorMesh;
+    removeElevator(mesh: ElevatorMesh): this;
+    addVent(mesh: VentMesh): this;
+    getVentAt(index: number): VentMesh;
+    removeVent(mesh: VentMesh): this;
     isolateFloor(mesh: FloorMesh | number): this;
     showAllFloors(): this;
     planishFloors(kind?: SemanticKind): this;

package/dist/plugins/u-manager/semantics/objects/ElevatorMesh.d.ts

@@ -0,0 +1,8 @@
+import type { Elevator } from '../semantic.types';
+import { VerticalShaftMesh } from './VerticalShaftMesh';
+export declare class ElevatorMesh extends VerticalShaftMesh<Elevator> {
+    readonly isElevatorMesh = true;
+    type: string;
+    constructor(elevator: Elevator);
+    static create(elevator: Elevator): ElevatorMesh | null;
+}

package/dist/plugins/u-manager/semantics/{FloorMesh.d.ts → objects/FloorMesh.d.ts}

@@ -1,6 +1,6 @@
 import { Box3, BufferGeometry, Matrix4, MeshStandardNodeMaterial, Sphere, Vector3, Vector4, type Intersection, type Raycaster } from 'three/webgpu';
 import { BaseMesh, type InteractionEvent, type InteractionEventMap } from 'u-space';
-import type { SemanticColor, SemanticGeometryEntry, SemanticKind } from './types';
+import type { SemanticColor, SemanticGeometryEntry, SemanticKind } from '../types';
 type FloorMeshEventPayload<T> = T extends {
     event: InteractionEvent;
 } ? {
@@ -32,6 +32,7 @@ export declare class FloorMesh extends BaseMesh<BufferGeometry, MeshStandardNode
     spacesInstances: Map<string, number>;
     doorsInstances: Map<string, number>;
     windowsInstances: Map<string, number>;
+    staircasesInstances: Map<string, number>;
     semanticInstances: Map<string, number>;
     constructor(entries: SemanticGeometryEntry[]);
     planish(kind?: SemanticKind): this;

package/dist/plugins/u-manager/semantics/objects/VentMesh.d.ts

@@ -0,0 +1,8 @@
+import type { Vent } from '../semantic.types';
+import { VerticalShaftMesh } from './VerticalShaftMesh';
+export declare class VentMesh extends VerticalShaftMesh<Vent> {
+    readonly isVentMesh = true;
+    type: string;
+    constructor(vent: Vent);
+    static create(vent: Vent): VentMesh | null;
+}

package/dist/plugins/u-manager/semantics/objects/VerticalShaftMesh.d.ts

@@ -0,0 +1,25 @@
+import { ExtrudeMesh } from 'u-space';
+import type { VerticalShaft } from '../semantic.types';
+export type VerticalShaftKind = 'Elevators' | 'Vents';
+export interface VerticalShaftMaterialParameters {
+    color: number;
+    opacity: number;
+}
+export interface VerticalShaftMeshParameters<TShaft extends VerticalShaft = VerticalShaft> {
+    shaft: TShaft;
+    kind: VerticalShaftKind;
+    material: VerticalShaftMaterialParameters;
+}
+export declare function createVerticalShaftMesh<TMesh extends VerticalShaftMesh>(createMesh: () => TMesh): TMesh | null;
+export declare class VerticalShaftMesh<TShaft extends VerticalShaft = VerticalShaft> extends ExtrudeMesh {
+    readonly isVerticalShaftMesh = true;
+    type: string;
+    readonly shaft: TShaft;
+    readonly semanticId: string;
+    readonly semanticKind: VerticalShaftKind;
+    readonly semanticName: string;
+    readonly bottom: number;
+    readonly top: number;
+    readonly height: number;
+    constructor({ shaft, kind, material }: VerticalShaftMeshParameters<TShaft>);
+}

package/dist/plugins/u-manager/semantics/semantic.types.d.ts

@@ -2,6 +2,8 @@ export interface Building {
     ID: string;
     Name: string;
     Stories: number[];
+    Elevators?: number[];
+    Vents?: number[];
 }
 export interface Polygon {
     shape?: number[];
@@ -67,6 +69,30 @@ export interface Window {
     Polygon?: Polygon;
     Width: number;
 }
+export interface VerticalShaftStory {
+    Doors?: number[];
+    FloorIndex: number;
+}
+export interface VerticalShaft {
+    BeginFloorIndex: number;
+    Depth?: number;
+    EndFloorIndex: number;
+    Height?: number;
+    ID: string;
+    Name: string;
+    Polygon?: Polygon;
+    Stories?: VerticalShaftStory[];
+    Width?: number;
+    Elevation?: number;
+    TotalHeight?: number;
+}
+export interface Elevator extends VerticalShaft {
+}
+export interface Vent extends VerticalShaft {
+    WindowElevation?: number;
+    WindowHeight?: number;
+    WindowWidth?: number;
+}
 export interface Asset {
     Generator: string;
     GplUUID?: any;
@@ -83,5 +109,7 @@ export interface SemanticObject {
     Walls?: Wall[];
     Windows?: Window[];
     Columns?: Column[];
+    Elevators?: Elevator[];
+    Vents?: Vent[];
     Asset?: Asset;
 }

package/dist/plugins/u-manager/semantics/types.d.ts

@@ -1,5 +1,5 @@
 import type { BufferGeometry, Color, Matrix4, Vector3, Vector4 } from 'three/webgpu';
-export type SemanticKind = 'Walls' | 'Columns' | 'Spaces' | 'Doors' | 'Windows';
+export type SemanticKind = 'Walls' | 'Columns' | 'Spaces' | 'Doors' | 'Windows' | 'Staircases';
 export type SemanticColor = Color | Vector3 | Vector4;
 export interface SemanticGeometryEntry {
     id: string;

package/docs/api-plugin-atmosphere.md

@@ -1,6 +1,6 @@
 # atmosphere
 
-天空和大气渲染插件，基于 `@takram/three-atmosphere` 的 WebGPU 节点实现。启用后会接入 Viewer 的 `renderer.contextNode`、`scene.backgroundNode` 和 RenderPipeline 的 output effect/MRT 扩展点，提供天空背景、太阳/月亮方向、aerial perspective 大气透视、lens flare、tone mapping、temporal antialias 和大气方向光阴影。
+天空和大气渲染插件，基于 `@takram/three-atmosphere` 的 WebGPU 节点实现。启用后会接入 Viewer 的 `renderer.contextNode`、`scene.backgroundNode`、可选的 `scene.environmentNode` 和 RenderPipeline 的 output effect/MRT 扩展点，提供天空背景、天空环境、太阳/月亮方向、lens flare、tone mapping、temporal antialias、dithering 和大气方向光阴影。
 
 ```typescript
 import { Atmosphere } from 'u-space/plugins/atmosphere';
@@ -16,8 +16,8 @@ atmosphere.enable({
 ## 能力
 
 - 使用经纬高将本地场景原点映射到 WGS84/ECEF，用 `date` 计算太阳和月亮方向。
-- 写入 `scene.backgroundNode`，可选写入 `scene.environmentNode`，让天空背景和环境光保持一致。
-- 通过 RenderPipeline output effect 追加大气透视、lens flare、tone mapping、temporal antialias 和 dithering，不占用业务侧的 `setOutputComposer()`。
+- 写入 `scene.backgroundNode = skyBackground()`；`useSkyEnvironment` 开启时写入 `scene.environmentNode = skyEnvironment()`，关闭插件会恢复启用前的背景和环境节点。
+- 通过 RenderPipeline output effect 追加 lens flare、tone mapping、temporal antialias 和 dithering，不占用业务侧的 `setOutputComposer()`。
 - 开启 `temporalAntialias` 时注册独立的 `atmosphereVelocity` MRT 通道，并避免和 RenderPipeline 自带 TRAA 重复运行。
 - 创建 `AtmosphereLight` 作为太阳方向光，并在每帧跟随相机控制器 target 更新阴影目标。
 
@@ -82,13 +82,13 @@ atmosphere.update({
 | `showMoon` | `boolean` | `true` | 显示月亮 |
 | `showStars` | `boolean` | `true` | 显示星空 |
 | `showGround` | `boolean` | `false` | 是否渲染大气地面 |
-| `useSkyEnvironment` | `boolean` | `true` | 是否使用天空节点作为 `scene.environmentNode` |
+| `useSkyEnvironment` | `boolean` | `true` | 是否使用 `skyEnvironment()` 作为 `scene.environmentNode` |
 | `raymarchScattering` | `boolean` | `true` | 是否启用 raymarch scattering |
-| `lighting` | `boolean` | `true` | aerial perspective 是否包含光照 |
-| `transmittance` | `boolean` | `true` | aerial perspective 是否包含透射 |
-| `inscattering` | `boolean` | `true` | aerial perspective 是否包含内散射 |
-| `moonScattering` | `boolean` | `true` | 是否包含月光散射 |
-| `lensFlare` | `boolean` | `true` | 是否在 aerial perspective 后启用 lens flare |
+| `lighting` | `boolean` | `true` | 保留项：当前后处理链不再插入 aerial perspective，暂不生效 |
+| `transmittance` | `boolean` | `true` | 保留项：当前后处理链不再插入 aerial perspective，暂不生效 |
+| `inscattering` | `boolean` | `true` | 保留项：当前后处理链不再插入 aerial perspective，暂不生效 |
+| `moonScattering` | `boolean` | `true` | 是否在天空背景中包含月光散射 |
+| `lensFlare` | `boolean` | `true` | 是否在 output effect 链中启用 lens flare |
 | `temporalAntialias` | `boolean` | `true` | 是否在大气后处理链中启用 temporal antialias |
 | `dithering` | `boolean` | `true` | 是否在 temporal antialias 后追加 dithering |
 | `toneMapping` | `ToneMapping \| false` | `AgXPunchyToneMapping` | 大气后处理链使用的 tone mapping；设为 `false` 可跳过 |
@@ -105,7 +105,9 @@ atmosphere.update({
 
 ## 注意事项
 
-`Atmosphere` 不会占用 `viewer.renderPipeline.setOutputComposer()`。它通过 output effect 追加大气后处理；开启 `temporalAntialias` 时才会注册独立的 `atmosphereVelocity` MRT 通道，并会避免和 RenderPipeline 自带 TRAA 重复运行。业务设置自定义 composer 时，大气 output effect 和它的输出变换开关都会被 RenderPipeline 跳过，让 composer 保持完整接管输出的原语义。
+`Atmosphere` 不会占用 `viewer.renderPipeline.setOutputComposer()`。它通过 output effect 追加 lens flare、tone mapping、temporal antialias 和 dithering；开启 `temporalAntialias` 时才会注册独立的 `atmosphereVelocity` MRT 通道，并会避免和 RenderPipeline 自带 TRAA 重复运行。业务设置自定义 composer 时，大气 output effect 和它的输出变换开关都会被 RenderPipeline 跳过，让 composer 保持完整接管输出的原语义。
+
+`scene.backgroundNode` 使用 `skyBackground()`，`scene.environmentNode` 使用独立的 `skyEnvironment()`，两者不是同一个天空节点。`showGround` 默认为 `false`，当相机视线落到天空节点的地面半球时背景可能呈暗色；需要渲染大气地面时传入 `showGround: true`。
 
 插件会在 `beforeRender` 中刷新相机 ECEF 位置、太阳/月亮方向和阴影 target，因此相机移动时的大气状态会跟随每一帧更新。`setDate()` 只更新传入的时间，不会自动推进时钟；需要动态昼夜变化时，由业务侧定时调用 `setDate()` 或 `update({ date })`。
 

package/docs/api-plugin-tiles.md

@@ -14,13 +14,45 @@ arcgisTilesRenderer.invalidate(120.002269, 30.284849, 4);
 viewer.frameloop = 'always';
 
 arcgisTilesRenderer.enable();
+
+// 经纬高转场景世界坐标
+const position = arcgisTilesRenderer.lonLatHeightToPosition(120.002269, 30.284849, 8);
+
+// 场景世界坐标转经纬高
+const location = arcgisTilesRenderer.positionToLonLatHeight(position);
 ```
 
 **方法：**
 
-| 方法                        | 说明                                                                                           |
-| :-------------------------- | :--------------------------------------------------------------------------------------------- |
-| `invalidate(lon, lat, alt)` | 将瓦片原点设置为指定的 WGS84 坐标（度）。可多次调用。返回一个取消订阅的函数。                  |
-| `enable()`                  | 将瓦片添加到场景并启动更新循环。                                                               |
-| `disable()`                 | 从场景中移除瓦片并暂停更新循环。                                                               |
-| `dispose()`                 | 禁用并完全释放瓦片渲染器。                                                                     |
+| 方法 | 说明 |
+| :--- | :--- |
+| `invalidate(lon, lat, alt)` | 将瓦片原点设置为指定的 WGS84 经纬高。`lon`、`lat` 使用度，`alt` 使用米。可多次调用。返回一个取消订阅的函数。 |
+| `lonLatHeightToPosition(lon, lat, height?, target?)` | 将 WGS84 经纬高转换为当前场景的世界坐标。`lon`、`lat` 使用度，`height` 使用米，返回 `Vector3`。 |
+| `positionToLonLatHeight(position, target?)` | 将当前场景的世界坐标转换为 WGS84 经纬高，返回 `{ lon, lat, height }`。`lon`、`lat` 使用度，`height` 使用米。 |
+| `enable()` | 将瓦片添加到场景并启动更新循环。 |
+| `disable()` | 从场景中移除瓦片并暂停更新循环。 |
+| `dispose()` | 禁用并完全释放瓦片渲染器。 |
+
+## 坐标转换
+
+`invalidate(lon, lat, alt)` 会通过 `3d-tiles-renderer` 的 `ReorientationPlugin` 把指定 WGS84 经纬高移动到场景原点。重定位完成后，默认场景轴向为：
+
+- `+Y`：高度方向（Up）
+- `+Z`：北向（North）
+- `+X`：西向（West），东向为 `-X`
+
+`lonLatHeightToPosition()` 和 `positionToLonLatHeight()` 复用瓦片当前的 `group.matrixWorld` 与 WGS84 椭球坐标，适合在 GIS 点位、POI、业务模型和 Three.js 场景世界坐标之间互转。
+
+```typescript
+import { Vector3 } from 'three/webgpu';
+
+const poiPosition = arcgisTilesRenderer.lonLatHeightToPosition(120.0024, 30.285, 12);
+poi.position.copy(poiPosition);
+
+const worldPosition = object.getWorldPosition(new Vector3());
+const { lon, lat, height } = arcgisTilesRenderer.positionToLonLatHeight(worldPosition);
+```
+
+传给 `positionToLonLatHeight()` 的 `position` 必须是场景世界坐标。如果坐标来自某个对象的局部空间，先通过 `object.localToWorld(localPosition)` 或 `object.getWorldPosition()` 转成世界坐标。
+
+如果在瓦片 root tileset 加载前调用 `invalidate()`，重定位会等到 root tileset 加载后才真正应用。需要在业务逻辑中立即使用转换结果时，应确保 `invalidate()` 已经完成，或在瓦片加载完成后再调用转换方法。

package/docs/api-plugin-u-manager.md

@@ -1,12 +1,12 @@
 # u-manager
 
-`u-manager` 是一套全面的加载器和解析器，用于从服务器路径流式传输、解密并显示结构化场景数据。支持场景、拓扑、动画、属性、相机视点和楼层语义模型。
+`u-manager` 是一套全面的加载器和解析器，用于从服务器路径流式传输、解密并显示结构化场景数据。支持场景、拓扑、动画、属性、相机视点、楼层和井道语义模型。
 
 所有加载器均继承自 Three.js 的 `Loader`，并提供 `setPath(path)` 方法，在调用 `loadAsync()` 前配置基础数据目录。
 
 ## `SemanticLoader`
 
-加载 `db/semantic_model.json` 楼层语义数据，并按建筑返回 `BuildingGroup[]`。每个建筑包含多个 `FloorMesh`，每个楼层把墙、柱、空间等语义对象合并为一个 TSL 材质驱动的网格。
+加载 `db/semantic_model.json` 楼层语义数据，并按建筑返回 `BuildingGroup[]`。每个建筑包含多个 `FloorMesh`，每个楼层把墙、柱、空间等语义对象合并为一个 TSL 材质驱动的网格；建筑级电梯井和通风井会使用 `ExtrudeMesh` 独立渲染。
 
 ```typescript
 import { Vector3, Vector4 } from 'three';
@@ -36,19 +36,44 @@ floor.addEventListener('click', ({ event }) => {
 
 ### `BuildingGroup`
 
-`BuildingGroup` 继承自 `BaseGroup`，用于组织一个建筑下的所有楼层。
+`BuildingGroup` 继承自 `BaseGroup`，用于组织一个建筑下的所有楼层、电梯井和通风井。
 
 | 属性 / 方法 | 说明 |
 | :---------- | :--- |
 | `floorMeshes` | 当前建筑内的 `FloorMesh[]`。 |
+| `elevatorMeshes` | 当前建筑内由 `Elevators` 语义生成的 `ExtrudeMesh[]`。 |
+| `ventMeshes` | 当前建筑内由 `Vents` 语义生成的 `ExtrudeMesh[]`。 |
 | `addFloor(floor)` | 添加楼层，并同步加入 group。 |
 | `removeFloor(floor)` | 移除楼层，并同步从 group 移除。 |
 | `getFloorAt(index)` | 按楼层下标获取 `FloorMesh`。 |
+| `addElevator(elevator)` / `removeElevator(elevator)` | 添加或移除电梯井，并同步更新 group。 |
+| `getElevatorAt(index)` | 按下标获取电梯井 `ExtrudeMesh`。 |
+| `addVent(vent)` / `removeVent(vent)` | 添加或移除通风井，并同步更新 group。 |
+| `getVentAt(index)` | 按下标获取通风井 `ExtrudeMesh`。 |
 | `isolateFloor(floor \| index)` | 只显示指定楼层，隐藏其他楼层。 |
 | `showAllFloors()` | 显示全部楼层。 |
 | `planishFloors(kind?)` | 压扁所有楼层；传入 `kind` 时只压扁该语义类型。 |
 | `unplanishFloors(kind?)` | 恢复所有楼层；传入 `kind` 时只恢复该语义类型。 |
 
+### 电梯井和通风井
+
+`SemanticLoader` 会读取 `semantic_model.json` 中建筑引用的 `Elevators` 和 `Vents`。每个井道使用 `Polygon.shape` 作为底面轮廓，`Elevation` 作为底面高度，`TotalHeight` 作为拉伸高度，并以 building 级 `ExtrudeMesh` 加入 `BuildingGroup`。
+
+```typescript
+const elevator = building.getElevatorAt(0);
+const vent = building.getVentAt(0);
+
+if (elevator) {
+  await viewer.controls.flyToObject(elevator);
+}
+
+if (vent) {
+  building.removeVent(vent);
+}
+```
+
+电梯井和通风井会在渲染阶段沿法线轻微内收，减少与墙体共面时的闪面。`Spaces` 实例也会使用稳定的 per-instance 渲染偏移抖动，缓解完全重叠空间之间的 z-fighting；这些偏移只影响渲染顶点，不改变语义 ID、实例矩阵和包围体查询的使用方式。
+
 ### `FloorMesh`
 
 `FloorMesh` 继承自 `BaseMesh`，表示一个楼层。它不是 `BatchedMesh`，而是把同一楼层内的语义对象合并为一份几何，并通过 TSL + `DataTexture` 在 GPU 侧按 `semanticIndex` 控制颜色、透明度、显示隐藏和实例矩阵。

package/docs/changelog.md

@@ -1,5 +1,16 @@
 # 更新日志
 
+## 未发布
+
+### 新增
+
+- **u-manager semantics** — `SemanticLoader` 支持解析建筑级 `Elevators` 和 `Vents`，以 `Polygon.shape` 作为底面轮廓、`Elevation` 作为底面高度、`TotalHeight` 作为拉伸高度生成 `ExtrudeMesh`，并通过 `BuildingGroup.elevatorMeshes`、`BuildingGroup.ventMeshes` 及 add/get/remove 方法管理。
+
+### 修复
+
+- **透明语义体块渲染** — 电梯井/通风井在渲染阶段沿法线轻微内收，`Spaces` 实例使用稳定 per-instance 渲染偏移抖动，缓解与墙体或完全重叠空间共面时的 z-fighting。
+- **atmosphere 插件** — 后处理链移除 aerial perspective 节点，保留 lens flare、tone mapping、temporal antialias 和 dithering；`scene.backgroundNode` 使用 `skyBackground()`，`scene.environmentNode` 使用 `skyEnvironment()`，并继续在关闭插件时恢复启用前的背景和环境节点。
+
 ## 0.0.18
 
 ### 变更

package/docs/examples-guide.md

@@ -34,7 +34,8 @@
 
 - 动态实例化复杂插件（`ArcgisTilesRenderer`），并传入核心 viewer 引用。
 - 由于瓦片是异步流式加载并持续更新视口的，需使用 `viewer.frameloop = 'always'`。
-- 通过插件的 `invalidate(lon, lat, zoom)` 方法定位到指定的经纬度位置。
+- 通过插件的 `invalidate(lon, lat, alt)` 方法定位到指定的经纬高位置。
+- 使用 `lonLatHeightToPosition()` / `positionToLonLatHeight()` 在 WGS84 经纬高和场景世界坐标之间互转。
 
 ## 4. `test_umanager.html`：场景组合与解析器
 

package/docs/index.md

@@ -52,10 +52,10 @@ features:
 | [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) | 场景加载、语义楼层、拓扑、动画、属性、视点管理 |
+| [u-manager](./api-plugin-u-manager) | 场景加载、语义楼层、语义井道、拓扑、动画、属性、视点管理 |
 | [curve-movement](./api-plugin-curve-movement) | 沿样条曲线移动相机或对象 |
 | [tracking-controls](./api-plugin-tracking-controls) | 相机跟随移动目标 |
-| [atmosphere](./api-plugin-atmosphere) | 天空背景、大气透视、太阳/月亮光照与阴影 |
+| [atmosphere](./api-plugin-atmosphere) | 天空背景、天空环境、太阳/月亮光照与阴影 |
 | [object-controls](./api-plugin-object-controls) | 交互式移动、旋转、缩放 3D 对象 |
 | [topology-drawer](./api-plugin-topology-drawer) | 在场景任意表面交互式绘制拓扑路径图 |
 

package/docs/mcp.md

@@ -1,6 +1,6 @@
 # u-space MCP
 
-`u-space-mcp` 是面向 `u-space` 文档的 Model Context Protocol（MCP）服务器。它把当前文档打包成只读 MCP 工具，方便 Mastra、Claude Desktop、Cursor 等 MCP 客户端在回答 `u-space` API、插件和示例问题时直接检索官方文档，包括 `u-manager` 的 `SemanticLoader`、`BuildingGroup` 和 `FloorMesh` 语义楼层 API。
+`u-space-mcp` 是面向 `u-space` 文档的 Model Context Protocol（MCP）服务器。它把当前文档打包成只读 MCP 工具，方便 Mastra、Claude Desktop、Cursor 等 MCP 客户端在回答 `u-space` API、插件和示例问题时直接检索官方文档，包括 `u-manager` 的 `SemanticLoader`、`BuildingGroup`、`FloorMesh` 语义楼层 API、电梯井/通风井语义体块，以及 atmosphere 插件的 `skyBackground()`、`skyEnvironment()` 和 RenderPipeline output effect 配置。
 
 ## 安装与启动
 

package/package.json

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