VisActor · youngwinds · Mar 25, 2026 · Mar 24, 2026 · Mar 24, 2026 · Mar 24, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -44,7 +44,7 @@ VBI/
 │       ├── src/
 │       └── docs/
 ├── practices/                      # 不同复杂度的实践示例
-│   ├── demo/                       # 标准版示例
+│   ├── standard/                   # 标准版示例
 │   │   ├── src/
 │   │   └── docs/
 │   ├── minimalist/                 # 极简实现示例

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -44,7 +44,7 @@ VBI/
 │       ├── src/
 │       └── docs/
 ├── practices/                      # 不同复杂度的实践示例
-│   ├── demo/                       # 标准版示例
+│   ├── standard/                       # 标准版示例
 │   │   ├── src/
 │   │   └── docs/
 │   ├── minimalist/                 # 极简实现示例

diff --git a/apps/vbi_fe/package.json b/apps/vbi_fe/package.json
@@ -20,7 +20,7 @@
     "@visactor/vquery": "workspace:*",
     "@visactor/vseed": "workspace:*",
     "antd": "6.1.3",
-    "demo": "workspace:*",
+    "standard": "workspace:*",
     "react": "19.2.3",
     "react-dom": "19.2.3",
     "react-router-dom": "7.12.0",

diff --git a/apps/vbi_fe/src/pages/DocumentEditorPage.tsx b/apps/vbi_fe/src/pages/DocumentEditorPage.tsx
@@ -2,7 +2,7 @@ import { memo } from 'react';
 import { useParams, useNavigate } from 'react-router-dom';
 import { Button, Layout, Spin, Typography, Space } from 'antd';
 import { ArrowLeftOutlined } from '@ant-design/icons';
-import { APP } from 'demo';
+import { APP } from 'standard';
 import { useCollaborativeBuilder } from '../hooks/useCollaborativeBuilder';
 import { Collaborators } from '../components/Collaborators';
 

diff --git a/apps/vbi_fe/tsconfig.json b/apps/vbi_fe/tsconfig.json
@@ -38,7 +38,7 @@
       "path": "../../packages/vbi"
     },
     {
-      "path": "../../practices/demo"
+      "path": "../../practices/standard"
     }
   ],
   "include": ["src"]

diff --git a/apps/website/docs/zh-CN/vbi/api/_meta.json b/apps/website/docs/zh-CN/vbi/api/_meta.json
@@ -1,61 +1,21 @@
 [
   {
     "type": "file",
-    "name": "builder",
-    "label": "builder"
-  },
-  {
-    "type": "file",
-    "name": "chart-type",
-    "label": "builder.chartType",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "measures",
-    "label": "builder.measures",
-    "collapsed": true
+    "name": "index",
+    "label": "API"
   },
   {
     "type": "dir",
-    "name": "dimensions",
-    "label": "builder.dimensions",
-    "collapsed": true
+    "name": "chartBuilder",
+    "label": "chartBuilder",
+    "collapsible": true,
+    "collapsed": false
   },
   {
     "type": "dir",
-    "name": "where-filter",
-    "label": "builder.whereFilter",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "having-filter",
-    "label": "builder.havingFilter",
-    "collapsed": true
-  },
-  {
-    "type": "file",
-    "name": "theme",
-    "label": "builder.theme",
-    "collapsed": true
-  },
-  {
-    "type": "file",
-    "name": "locale",
-    "label": "builder.locale",
-    "collapsed": true
-  },
-  {
-    "type": "file",
-    "name": "limit",
-    "label": "builder.limit",
-    "collapsed": true
-  },
-  {
-    "type": "file",
-    "name": "undo-manager",
-    "label": "builder.undoManager",
-    "collapsed": true
+    "name": "reportBuilder",
+    "label": "reportBuilder",
+    "collapsible": true,
+    "collapsed": false
   }
 ]
diff --git a/apps/website/docs/zh-CN/vbi/api/chartBuilder/_meta.json b/apps/website/docs/zh-CN/vbi/api/chartBuilder/_meta.json
@@ -0,0 +1,55 @@
+[
+  {
+    "type": "file",
+    "name": "chartType",
+    "label": "chartBuilder.chartType"
+  },
+  {
+    "type": "dir",
+    "name": "measures",
+    "label": "chartBuilder.measures",
+    "collapsible": true,
+    "collapsed": true
+  },
+  {
+    "type": "dir",
+    "name": "dimensions",
+    "label": "chartBuilder.dimensions",
+    "collapsible": true,
+    "collapsed": true
+  },
+  {
+    "type": "dir",
+    "name": "whereFilter",
+    "label": "chartBuilder.whereFilter",
+    "collapsible": true,
+    "collapsed": true
+  },
+  {
+    "type": "dir",
+    "name": "havingFilter",
+    "label": "chartBuilder.havingFilter",
+    "collapsible": true,
+    "collapsed": true
+  },
+  {
+    "type": "file",
+    "name": "theme",
+    "label": "chartBuilder.theme"
+  },
+  {
+    "type": "file",
+    "name": "locale",
+    "label": "chartBuilder.locale"
+  },
+  {
+    "type": "file",
+    "name": "limit",
+    "label": "chartBuilder.limit"
+  },
+  {
+    "type": "file",
+    "name": "undoManager",
+    "label": "chartBuilder.undoManager"
+  }
+]
diff --git a/.../website/docs/zh-CN/vbi/api/chart-type.md → ...s/zh-CN/vbi/api/chartBuilder/chartType.md b/.../website/docs/zh-CN/vbi/api/chart-type.md → ...s/zh-CN/vbi/api/chartBuilder/chartType.md
@@ -1,4 +1,4 @@
-# chartType
+# ChartTypeBuilder
 
 图表类型构建器，用于切换和获取图表类型。支持表格、柱状图、折线图、饼图、散点图等多种图表类型
 

diff --git a/apps/website/docs/zh-CN/vbi/api/chartBuilder/dimensions/_meta.json b/apps/website/docs/zh-CN/vbi/api/chartBuilder/dimensions/_meta.json
@@ -0,0 +1,7 @@
+[
+  {
+    "type": "file",
+    "name": "dimensionNode",
+    "label": "dimensionNode"
+  }
+]
diff --git a/...h-CN/vbi/api/dimensions/dimension-node.md → .../chartBuilder/dimensions/dimensionNode.md b/...h-CN/vbi/api/dimensions/dimension-node.md → .../chartBuilder/dimensions/dimensionNode.md
@@ -2,6 +2,8 @@
 
 维度节点构建器，用于配置单个维度
 
+## 属性
+
 ## 方法
 
 ### constructor

diff --git a/.../website/docs/zh-CN/vbi/api/dimensions.md → .../vbi/api/chartBuilder/dimensions/index.md b/.../website/docs/zh-CN/vbi/api/dimensions.md → .../vbi/api/chartBuilder/dimensions/index.md
@@ -1,4 +1,4 @@
-# dimensions
+# DimensionsBuilder
 
 维度构建器，用于添加、修改、删除维度配置。维度是数据的分类字段，如：时间、地区、产品类别
 

diff --git a/apps/website/docs/zh-CN/vbi/api/chartBuilder/havingFilter/_meta.json b/apps/website/docs/zh-CN/vbi/api/chartBuilder/havingFilter/_meta.json
@@ -0,0 +1,12 @@
+[
+  {
+    "type": "file",
+    "name": "havingNode",
+    "label": "havingNode"
+  },
+  {
+    "type": "file",
+    "name": "havingGroup",
+    "label": "havingGroup"
+  }
+]
diff --git a/...-CN/vbi/api/having-filter/having-group.md → .../chartBuilder/havingFilter/havingGroup.md b/...-CN/vbi/api/having-filter/having-group.md → .../chartBuilder/havingFilter/havingGroup.md
@@ -2,6 +2,8 @@
 
 Having 分组构建器，用于配置一组条件的逻辑关系（AND/OR）
 
+## 属性
+
 ## 方法
 
 ### constructor

diff --git a/...h-CN/vbi/api/having-filter/having-node.md → ...i/chartBuilder/havingFilter/havingNode.md b/...h-CN/vbi/api/having-filter/having-node.md → ...i/chartBuilder/havingFilter/havingNode.md
@@ -2,6 +2,8 @@
 
 Having 过滤节点构建器，用于配置单个 Having 过滤条件
 
+## 属性
+
 ## 方法
 
 ### constructor

diff --git a/...bsite/docs/zh-CN/vbi/api/having-filter.md → ...bi/api/chartBuilder/havingFilter/index.md b/...bsite/docs/zh-CN/vbi/api/having-filter.md → ...bi/api/chartBuilder/havingFilter/index.md
@@ -1,4 +1,4 @@
-# havingFilter
+# HavingFilterBuilder
 
 Having 过滤构建器，用于添加、修改、删除分组后过滤条件。Having 过滤在数据聚合后生效，用于筛选分组结果
 

diff --git a/apps/website/docs/zh-CN/vbi/api/builder.md → .../docs/zh-CN/vbi/api/chartBuilder/index.md b/apps/website/docs/zh-CN/vbi/api/builder.md → .../docs/zh-CN/vbi/api/chartBuilder/index.md
@@ -25,7 +25,7 @@
 **定义**:
 
 ```typescript
-constructor(doc: Y.Doc, options: VBIChartBuilderOptions<TQueryDSL, TSeedDSL>)
+constructor(doc: Y.Doc, options: VBIChartBuilderOptions<TQueryDSL, TSeedDSL>, dsl: Y.Map<any>)
 ```
 
 **参数**:
@@ -34,6 +34,7 @@ constructor(doc: Y.Doc, options: VBIChartBuilderOptions<TQueryDSL, TSeedDSL>)
 | --- | --- | --- |
 | `doc` | Y.Doc | - |
 | `options` | VBIChartBuilderOptions<TQueryDSL, TSeedDSL> | - |
+| `dsl` | Y.Map<any> | - |
 
 ### applyUpdate
 

diff --git a/apps/website/docs/zh-CN/vbi/api/limit.md → .../docs/zh-CN/vbi/api/chartBuilder/limit.md b/apps/website/docs/zh-CN/vbi/api/limit.md → .../docs/zh-CN/vbi/api/chartBuilder/limit.md
@@ -1,4 +1,4 @@
-# limit
+# LimitBuilder
 
 数据量限制构建器，用于设置和获取当前 limit
 

diff --git a/apps/website/docs/zh-CN/vbi/api/locale.md → ...docs/zh-CN/vbi/api/chartBuilder/locale.md b/apps/website/docs/zh-CN/vbi/api/locale.md → ...docs/zh-CN/vbi/api/chartBuilder/locale.md
@@ -1,4 +1,4 @@
-# locale
+# LocaleBuilder
 
 语言构建器，用于设置和获取当前语言
 

diff --git a/apps/website/docs/zh-CN/vbi/api/chartBuilder/measures/_meta.json b/apps/website/docs/zh-CN/vbi/api/chartBuilder/measures/_meta.json
@@ -0,0 +1,7 @@
+[
+  {
+    "type": "file",
+    "name": "measureNode",
+    "label": "measureNode"
+  }
+]
diff --git a/apps/website/docs/zh-CN/vbi/api/measures.md → ...CN/vbi/api/chartBuilder/measures/index.md b/apps/website/docs/zh-CN/vbi/api/measures.md → ...CN/vbi/api/chartBuilder/measures/index.md
@@ -1,4 +1,4 @@
-# measures
+# MeasuresBuilder
 
 度量构建器，用于添加、修改、删除度量配置。度量是数据的数值字段，如：销售额、利润、数量
 

diff --git a/...cs/zh-CN/vbi/api/measures/measure-node.md → .../api/chartBuilder/measures/measureNode.md b/...cs/zh-CN/vbi/api/measures/measure-node.md → .../api/chartBuilder/measures/measureNode.md
@@ -2,6 +2,8 @@
 
 度量节点构建器，用于配置单个度量
 
+## 属性
+
 ## 方法
 
 ### constructor

diff --git a/apps/website/docs/zh-CN/vbi/api/theme.md → .../docs/zh-CN/vbi/api/chartBuilder/theme.md b/apps/website/docs/zh-CN/vbi/api/theme.md → .../docs/zh-CN/vbi/api/chartBuilder/theme.md
@@ -1,4 +1,4 @@
-# theme
+# ThemeBuilder
 
 主题构建器，用于设置和获取当前主题
 

diff --git a/...ebsite/docs/zh-CN/vbi/api/undo-manager.md → ...zh-CN/vbi/api/chartBuilder/undoManager.md b/...ebsite/docs/zh-CN/vbi/api/undo-manager.md → ...zh-CN/vbi/api/chartBuilder/undoManager.md
@@ -1,4 +1,4 @@
-# undoManager
+# UndoManager
 
 撤销/重做管理器，提供基于 YJS 的撤销和重做功能，支持栈管理和历史清除操作
 

diff --git a/apps/website/docs/zh-CN/vbi/api/chartBuilder/whereFilter/_meta.json b/apps/website/docs/zh-CN/vbi/api/chartBuilder/whereFilter/_meta.json
@@ -0,0 +1,12 @@
+[
+  {
+    "type": "file",
+    "name": "whereNode",
+    "label": "whereNode"
+  },
+  {
+    "type": "file",
+    "name": "whereGroup",
+    "label": "whereGroup"
+  }
+]
diff --git a/...ebsite/docs/zh-CN/vbi/api/where-filter.md → ...vbi/api/chartBuilder/whereFilter/index.md b/...ebsite/docs/zh-CN/vbi/api/where-filter.md → ...vbi/api/chartBuilder/whereFilter/index.md
@@ -1,4 +1,4 @@
-# whereFilter
+# WhereFilterBuilder
 
 Where 过滤构建器，用于添加、修改、删除行级过滤条件。Where 过滤在数据查询前生效，用于筛选原始数据
 

diff --git a/...zh-CN/vbi/api/where-filter/where-group.md → ...pi/chartBuilder/whereFilter/whereGroup.md b/...zh-CN/vbi/api/where-filter/where-group.md → ...pi/chartBuilder/whereFilter/whereGroup.md
@@ -2,6 +2,8 @@
 
 Where 分组构建器，用于配置一组条件的逻辑关系（AND/OR）
 
+## 属性
+
 ## 方法
 
 ### constructor

diff --git a/.../zh-CN/vbi/api/where-filter/where-node.md → ...api/chartBuilder/whereFilter/whereNode.md b/.../zh-CN/vbi/api/where-filter/where-node.md → ...api/chartBuilder/whereFilter/whereNode.md
@@ -1,7 +1,9 @@
-# WhereNodeBuilder
+# WhereFilterNodeBuilder
 
 Where 过滤节点构建器，用于配置单个 Where 过滤条件
 
+## 属性
+
 ## 方法
 
 ### constructor

diff --git a/apps/website/docs/zh-CN/vbi/api/dimensions/_meta.json b/apps/website/docs/zh-CN/vbi/api/dimensions/_meta.json
diff --git a/apps/website/docs/zh-CN/vbi/api/having-filter/_meta.json b/apps/website/docs/zh-CN/vbi/api/having-filter/_meta.json
diff --git a/apps/website/docs/zh-CN/vbi/api/index.md b/apps/website/docs/zh-CN/vbi/api/index.md
@@ -1,3 +1,4 @@
 ---
 overview: true
+title: API
 ---
diff --git a/apps/website/docs/zh-CN/vbi/api/measures/_meta.json b/apps/website/docs/zh-CN/vbi/api/measures/_meta.json
diff --git a/apps/website/docs/zh-CN/vbi/api/reportBuilder/_meta.json b/apps/website/docs/zh-CN/vbi/api/reportBuilder/_meta.json
@@ -0,0 +1,9 @@
+[
+  {
+    "type": "dir",
+    "name": "page",
+    "label": "reportBuilder.page",
+    "collapsible": true,
+    "collapsed": true
+  }
+]