VisActor · youngwinds · Mar 17, 2026 · Mar 17, 2026 · Mar 17, 2026 · Mar 17, 2026
diff --git a/apps/website/components/vseed/VSeedRender.tsx b/apps/website/components/vseed/VSeedRender.tsx
@@ -70,8 +70,10 @@ export const VSeedRender = withVisible((props: { vseed: VSeed }) => {
   const builderRef = useRef<Builder>(null)
   const dark = useDark()
   const selectedDimValueRef = useRef<string[]>([])
+  const hasValidDataset = Array.isArray(vseed.dataset) && vseed.dataset.length > 0
+
   useEffect(() => {
-    if (!ref.current) {
+    if (!hasValidDataset || !ref.current) {
       return
     }
     const theme = dark ? 'dark' : 'light'
@@ -189,7 +191,23 @@ export const VSeedRender = withVisible((props: { vseed: VSeed }) => {
       window.table = tableInstance
       return () => tableInstance.release()
     }
-  }, [vseed, dark])
+  }, [vseed, dark, hasValidDataset])
+
+  if (!hasValidDataset) {
+    return (
+      <div
+        style={{
+          height: 300,
+          width: '100%',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+        }}
+      >
+        暂无数据
+      </div>
+    )
+  }
 
   return (
     <div

diff --git a/apps/website/docs/zh-CN/vbi/api/builder.md b/apps/website/docs/zh-CN/vbi/api/builder.md
@@ -6,7 +6,6 @@
 | --- | --- | --- |
 | **doc** | `Y.Doc` | - |
 | **dsl** | `Y.Map<any>` | - |
-| **undoManager** | `UndoManager` | - |
 | **chartType** | `ChartTypeBuilder` | - |
 | **measures** | `MeasuresBuilder` | - |
 | **dimensions** | `DimensionsBuilder` | - |
@@ -15,6 +14,7 @@
 | **theme** | `ThemeBuilder` | - |
 | **locale** | `LocaleBuilder` | - |
 | **limit** | `LimitBuilder` | - |
+| **undoManager** | `UndoManager` | - |
 
 
 ## 方法
@@ -38,23 +38,28 @@ constructor(doc: Y.Doc)
 **定义**:
 
 ```typescript
-applyUpdate(update: Uint8Array)
+applyUpdate(update: Uint8Array, transactionOrigin: any): void
 ```
 
+**返回**: `void`
+
 **参数**:
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
 | `update` | Uint8Array | - |
+| `transactionOrigin` | any | - |
 
 ### encodeStateAsUpdate
 
 **定义**:
 
 ```typescript
-encodeStateAsUpdate(targetStateVector: Uint8Array)
+encodeStateAsUpdate(targetStateVector: Uint8Array): Uint8Array<ArrayBufferLike>
 ```
 
+**返回**: `Uint8Array<ArrayBufferLike>`
+
 **参数**:
 
 | 参数 | 类型 | 说明 |
@@ -91,6 +96,16 @@ build(): VBIDSL
 
 **返回**: `VBIDSL`
 
+### isEmpty
+
+**定义**:
+
+```typescript
+isEmpty(): boolean
+```
+
+**返回**: `boolean`
+
 ### getSchema
 
 **定义**:

diff --git a/apps/website/docs/zh-CN/vbi/api/dimensions.md b/apps/website/docs/zh-CN/vbi/api/dimensions.md
@@ -11,14 +11,14 @@
 **定义**:
 
 ```typescript
-constructor(_doc: Y.Doc, dsl: Y.Map<any>)
+constructor(doc: Y.Doc, dsl: Y.Map<any>)
 ```
 
 **参数**:
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `_doc` | Y.Doc | - |
+| `doc` | Y.Doc | - |
 | `dsl` | Y.Map<any> | - |
 
 ### add
@@ -42,12 +42,12 @@ add(field: string, callback: (node: DimensionNodeBuilder) => void): DimensionsBu
 
 ### remove
 
-删除指定字段的维度
+删除指定 ID 的维度
 
 **定义**:
 
 ```typescript
-remove(field: VBIDimension['field']): DimensionsBuilder
+remove(id: string): DimensionsBuilder
 ```
 
 **返回**: `DimensionsBuilder`
@@ -56,16 +56,16 @@ remove(field: VBIDimension['field']): DimensionsBuilder
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `field` | VBIDimension['field'] | - 字段名 |
+| `id` | string | - 维度 ID |
 
 ### update
 
-更新指定维度字段的配置
+更新指定维度 ID 的配置
 
 **定义**:
 
 ```typescript
-update(field: string, callback: (node: DimensionNodeBuilder) => void): DimensionsBuilder
+update(id: string, callback: (node: DimensionNodeBuilder) => void): DimensionsBuilder
 ```
 
 **返回**: `DimensionsBuilder`
@@ -74,17 +74,17 @@ update(field: string, callback: (node: DimensionNodeBuilder) => void): Dimension
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `field` | string | - 字段名 |
+| `id` | string | - 维度 ID |
 | `callback` | (node: DimensionNodeBuilder) => void | - 回调函数 |
 
 ### find
 
-根据字段名查找维度
+按回调条件查找第一个维度，行为与 Array.find 一致
 
 **定义**:
 
 ```typescript
-find(field: VBIDimension['field']): DimensionNodeBuilder | undefined
+find(predicate: (node: DimensionNodeBuilder, index: number) => boolean): DimensionNodeBuilder | undefined
 ```
 
 **返回**: `DimensionNodeBuilder \| undefined`
@@ -93,7 +93,7 @@ find(field: VBIDimension['field']): DimensionNodeBuilder | undefined
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `field` | VBIDimension['field'] | - 字段名 |
+| `predicate` | (node: DimensionNodeBuilder, index: number) => boolean | - 查找条件 |
 
 ### findAll
 

diff --git a/apps/website/docs/zh-CN/vbi/api/dimensions/dimension-node.md b/apps/website/docs/zh-CN/vbi/api/dimensions/dimension-node.md
@@ -18,6 +18,18 @@ constructor(yMap: Y.Map<any>)
 | --- | --- | --- |
 | `yMap` | Y.Map<any> | - |
 
+### getId
+
+获取节点 ID
+
+**定义**:
+
+```typescript
+getId(): string
+```
+
+**返回**: `string`
+
 ### getField
 
 获取字段名

diff --git a/apps/website/docs/zh-CN/vbi/api/having-filter.md b/apps/website/docs/zh-CN/vbi/api/having-filter.md
@@ -127,12 +127,12 @@ remove(idOrIndex: string | number): HavingFilterBuilder
 
 ### find
 
-根据 ID 查找条件（过滤或分组）
+按回调条件查找第一个条件（过滤或分组），行为与 Array.find 一致
 
 **定义**:
 
 ```typescript
-find(id: string): HavingFilterNodeBuilder | HavingGroupBuilder | undefined
+find(predicate: (entry: HavingFilterNodeBuilder | HavingGroupBuilder, index: number) => boolean): HavingFilterNodeBuilder | HavingGroupBuilder | undefined
 ```
 
 **返回**: `HavingFilterNodeBuilder \| HavingGroupBuilder \| undefined`
@@ -141,7 +141,7 @@ find(id: string): HavingFilterNodeBuilder | HavingGroupBuilder | undefined
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `id` | string | - ID |
+| `predicate` | (entry: HavingFilterNodeBuilder \| HavingGroupBuilder, index: number) => boolean | - 查找条件 |
 
 ### clear
 

diff --git a/apps/website/docs/zh-CN/vbi/api/measures.md b/apps/website/docs/zh-CN/vbi/api/measures.md
@@ -11,14 +11,14 @@
 **定义**:
 
 ```typescript
-constructor(_doc: Y.Doc, dsl: Y.Map<any>)
+constructor(doc: Y.Doc, dsl: Y.Map<any>)
 ```
 
 **参数**:
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `_doc` | Y.Doc | - |
+| `doc` | Y.Doc | - |
 | `dsl` | Y.Map<any> | - |
 
 ### add
@@ -42,12 +42,12 @@ add(field: string, callback: (node: MeasureNodeBuilder) => void): MeasuresBuilde
 
 ### remove
 
-删除指定字段的度量
+删除指定 ID 的度量
 
 **定义**:
 
 ```typescript
-remove(field: VBIMeasure['field']): MeasuresBuilder
+remove(id: string): MeasuresBuilder
 ```
 
 **返回**: `MeasuresBuilder`
@@ -56,7 +56,7 @@ remove(field: VBIMeasure['field']): MeasuresBuilder
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `field` | VBIMeasure['field'] | - 字段名 |
+| `id` | string | - 度量 ID |
 
 ### update
 
@@ -65,7 +65,7 @@ remove(field: VBIMeasure['field']): MeasuresBuilder
 **定义**:
 
 ```typescript
-update(field: string, callback: (node: MeasureNodeBuilder) => void): MeasuresBuilder
+update(id: string, callback: (node: MeasureNodeBuilder) => void): MeasuresBuilder
 ```
 
 **返回**: `MeasuresBuilder`
@@ -74,17 +74,17 @@ update(field: string, callback: (node: MeasureNodeBuilder) => void): MeasuresBui
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `field` | string | - 字段名 |
+| `id` | string | - 度量 ID |
 | `callback` | (node: MeasureNodeBuilder) => void | - 回调函数 |
 
 ### find
 
-根据字段名查找度量
+按回调条件查找第一个度量，行为与 Array.find 一致
 
 **定义**:
 
 ```typescript
-find(field: VBIMeasure['field']): MeasureNodeBuilder | undefined
+find(predicate: (node: MeasureNodeBuilder, index: number) => boolean): MeasureNodeBuilder | undefined
 ```
 
 **返回**: `MeasureNodeBuilder \| undefined`
@@ -93,7 +93,7 @@ find(field: VBIMeasure['field']): MeasureNodeBuilder | undefined
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `field` | VBIMeasure['field'] | - 字段名 |
+| `predicate` | (node: MeasureNodeBuilder, index: number) => boolean | - 查找条件 |
 
 ### findAll
 

diff --git a/apps/website/docs/zh-CN/vbi/api/measures/measure-node.md b/apps/website/docs/zh-CN/vbi/api/measures/measure-node.md
@@ -18,6 +18,18 @@ constructor(yMap: Y.Map<any>)
 | --- | --- | --- |
 | `yMap` | Y.Map<any> | - |
 
+### getId
+
+获取节点 ID
+
+**定义**:
+
+```typescript
+getId(): string
+```
+
+**返回**: `string`
+
 ### getField
 
 获取字段名

diff --git a/apps/website/docs/zh-CN/vbi/api/where-filter.md b/apps/website/docs/zh-CN/vbi/api/where-filter.md
@@ -127,12 +127,12 @@ remove(idOrIndex: string | number): WhereFilterBuilder
 
 ### find
 
-根据 ID 查找条件（过滤或分组）
+按回调条件查找第一个条件（过滤或分组），行为与 Array.find 一致
 
 **定义**:
 
 ```typescript
-find(id: string): WhereFilterNodeBuilder | WhereGroupBuilder | undefined
+find(predicate: (entry: WhereFilterNodeBuilder | WhereGroupBuilder, index: number) => boolean): WhereFilterNodeBuilder | WhereGroupBuilder | undefined
 ```
 
 **返回**: `WhereFilterNodeBuilder \| WhereGroupBuilder \| undefined`
@@ -141,7 +141,7 @@ find(id: string): WhereFilterNodeBuilder | WhereGroupBuilder | undefined
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `id` | string | - ID |
+| `predicate` | (entry: WhereFilterNodeBuilder \| WhereGroupBuilder, index: number) => boolean | - 查找条件 |
 
 ### clear