@next-bricks/visual-builder 1.39.16 → 1.39.18

package/dist/manifest.json

@@ -8,26 +8,32 @@
       "properties": [
         {
           "name": "titleLabel",
+          "description": "面板标题文本",
           "type": "string"
         },
         {
           "name": "active",
+          "description": "是否展开面板",
           "type": "boolean"
         },
         {
           "name": "badge",
+          "description": "标题栏右侧的数字徽标",
           "type": "number"
         }
       ],
       "events": [
         {
           "name": "active.change",
+          "description": "面板展开/折叠状态变化时触发",
           "detail": {
+            "description": "当前展开状态，true 为展开，false 为折叠",
             "type": "boolean"
           }
         },
         {
           "name": "active.firstActivated",
+          "description": "面板首次被展开时触发（仅触发一次）",
           "detail": {
             "type": "void"
           }
@@ -36,7 +42,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "",
+      "description": "工作台侧边栏面板，可折叠的内容面板，包含标题栏和可滚动的内容区",
       "insider": true
     },
     {
@@ -44,6 +50,7 @@
       "properties": [
         {
           "name": "titleLabel",
+          "description": "侧边栏标题文本",
           "type": "string"
         }
       ],
@@ -51,7 +58,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "",
+      "description": "工作台侧边栏容器，包含标题栏和面板容器，自动管理子面板（workbench-pane）的展开/折叠布局",
       "insider": true
     },
     {
@@ -59,27 +66,33 @@
       "properties": [
         {
           "name": "icon",
+          "description": "按钮图标配置",
           "attribute": false,
           "type": "GeneralIconProps"
         },
         {
           "name": "to",
+          "description": "路由跳转地址",
           "type": "string"
         },
         {
           "name": "active",
+          "description": "是否处于激活状态",
           "type": "boolean"
         },
         {
           "name": "href",
+          "description": "外部链接地址",
           "type": "string"
         },
         {
           "name": "target",
+          "description": "链接打开方式",
           "type": "string"
         },
         {
           "name": "tooltip",
+          "description": "鼠标悬停时显示的提示文字",
           "type": "string"
         }
       ],
@@ -87,7 +100,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "",
+      "description": "工作台侧边栏操作按钮，显示图标链接并在右侧显示 tooltip",
       "insider": true
     },
     {
@@ -95,10 +108,12 @@
       "properties": [
         {
           "name": "appId",
+          "description": "当前应用 ID，用于在切换应用时重置历史记录",
           "type": "string"
         },
         {
           "name": "menu",
+          "description": "侧边栏菜单配置",
           "attribute": false,
           "type": "SidebarMenu"
         }
@@ -107,7 +122,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "",
+      "description": "工作台侧边栏操作列表，根据菜单配置渲染一组 workbench-action 按钮，并根据当前路由高亮激活项",
       "insider": true
     },
     {
@@ -115,111 +130,139 @@
       "properties": [
         {
           "name": "nodes",
+          "description": "树节点数据列表",
           "attribute": false,
           "type": "WorkbenchNodeData[]"
         },
         {
           "name": "actions",
+          "description": "节点操作按钮配置列表",
           "attribute": false,
           "type": "WorkbenchTreeAction[]"
         },
         {
           "name": "actionsHidden",
+          "description": "是否隐藏节点操作按钮",
           "type": "boolean"
         },
         {
           "name": "placeholder",
+          "description": "无数据时显示的占位文本",
           "type": "string"
         },
         {
           "name": "isTransformName",
+          "description": "是否将节点名称转换为可读格式",
           "type": "boolean"
         },
         {
           "name": "searchPlaceholder",
+          "description": "搜索框占位文本",
           "type": "string"
         },
         {
           "name": "noSearch",
+          "description": "是否隐藏搜索框",
           "type": "boolean"
         },
         {
           "name": "activeKey",
+          "description": "当前激活节点的 key",
           "attribute": false,
           "type": "string | number"
         },
         {
           "name": "showMatchedNodeOnly",
+          "description": "搜索时是否只显示匹配的节点",
           "type": "boolean"
         },
         {
           "name": "matchNodeDataFields",
+          "description": "搜索时匹配的节点数据字段，\"*\" 表示匹配所有字段",
           "attribute": false,
           "type": "string | string[]"
         },
         {
           "name": "fixedActionsFor",
+          "description": "始终显示操作按钮的节点数据条件",
           "attribute": false,
           "type": "Record<string, unknown> | Record<string, unknown>[]"
         },
         {
           "name": "collapsible",
+          "description": "是否启用节点折叠功能",
           "type": "boolean"
         },
         {
           "name": "collapsedNodes",
+          "description": "当前已折叠节点的 ID 列表",
           "attribute": false,
           "type": "string[]"
         },
         {
           "name": "allowDrag",
+          "description": "是否允许拖拽排序",
           "type": "boolean"
         },
         {
           "name": "allowDragToRoot",
+          "description": "是否允许拖拽到根节点位置",
           "type": "boolean"
         },
         {
           "name": "allowDragToInside",
+          "description": "是否允许拖拽到节点内部成为子节点",
           "type": "boolean"
         },
         {
           "name": "nodeKey",
+          "description": "节点唯一标识字段名",
           "type": "string"
         },
         {
           "name": "skipNotify",
+          "description": "是否跳过节点点击时的通知",
           "type": "boolean"
         }
       ],
       "events": [
         {
           "name": "action.click",
+          "description": "点击节点操作按钮时触发",
           "detail": {
+            "description": "{ action: 操作标识, data: 节点数据 }",
             "type": "ActionClickDetail"
           }
         },
         {
           "name": "node.click",
+          "description": "点击节点时触发",
           "detail": {
+            "description": "节点的 data 数据",
             "type": "unknown"
           }
         },
         {
           "name": "node.drop",
+          "description": "拖拽节点完成时触发",
           "detail": {
+            "description": "拖拽完成后的节点位置信息",
             "type": "any"
           }
         },
         {
           "name": "context.menu",
+          "description": "右键点击节点时触发",
           "detail": {
+            "description": "{ active: true, node: 节点的 data 数据, x: 鼠标 X 坐标, y: 鼠标 Y 坐标 }",
             "type": "unknown"
           }
         },
         {
           "name": "node.toggle",
+          "description": "节点折叠/展开状态变化时触发",
           "detail": {
+            "description": "{ nodeId: 节点 ID, collapsed: 是否已折叠 }",
             "type": "{\n    nodeId: string;\n    collapsed: boolean;\n  }"
           }
         }
@@ -227,48 +270,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "",
-      "insider": true
-    },
-    {
-      "name": "visual-builder.workbench-history-action",
-      "properties": [
-        {
-          "name": "appId",
-          "type": "string"
-        },
-        {
-          "name": "projectId",
-          "type": "string"
-        }
-      ],
-      "events": [
-        {
-          "name": "history.item.click",
-          "description": "点击历史项标题触发",
-          "detail": {
-            "type": "HistoryData & { enableRollback: boolean }"
-          }
-        },
-        {
-          "name": "rollback",
-          "description": "点击回滚触发",
-          "detail": {
-            "type": "HistoryData"
-          }
-        },
-        {
-          "name": "rollback.all",
-          "description": "回滚全部",
-          "detail": {
-            "type": "void"
-          }
-        }
-      ],
-      "slots": [],
-      "methods": [],
-      "parts": [],
-      "description": "项目变更历史",
+      "description": "工作台树形组件，支持搜索、拖拽排序、折叠展开和节点操作",
       "insider": true
     },
     {
@@ -276,91 +278,117 @@
       "properties": [
         {
           "name": "label",
+          "description": "节点标签文字，支持内联双击编辑",
           "type": "string"
         },
         {
           "name": "type",
+          "description": "节点类型，\"page\" 渲染为页面缩略图样式（高 130px），\"board\" 渲染为列表图标样式（高 70px）",
           "type": "PageArchNodeType"
         },
         {
           "name": "external",
+          "description": "外部链接节点数据，仅 type=\"page\" 时显示，点击触发 external.click 事件",
           "attribute": false,
           "type": "ExtraNodeData"
         },
         {
           "name": "subNodes",
+          "description": "子节点列表，仅 type=\"page\" 时显示，每个子节点可双击和右键操作",
           "attribute": false,
           "type": "ExtraNodeData[]"
         },
         {
           "name": "active",
+          "description": "是否为当前激活节点，仅控制 CSS 样式（render: false），不触发重新渲染",
           "type": "boolean"
         },
         {
           "name": "notSynced",
+          "description": "是否标记为未同步状态，仅控制 CSS 样式（render: false），不触发重新渲染",
           "type": "boolean"
         },
         {
           "name": "disableChildAppend",
+          "description": "是否禁用追加子节点按钮，仅控制 CSS 样式（render: false），不触发重新渲染",
           "type": "boolean"
         },
         {
           "name": "autoFocusOnce",
+          "description": "自动聚焦标识符，设置后节点首次挂载时会自动进入标签编辑模式，同一标识符只触发一次",
           "type": "string"
         }
       ],
       "events": [
         {
           "name": "label.editing.change",
+          "description": "",
           "detail": {
+            "description": "当前标签是否正在编辑",
             "type": "boolean"
           }
         },
         {
           "name": "label.change",
+          "description": "",
           "detail": {
+            "description": "编辑完成后的新标签文字",
             "type": "string"
           }
         },
         {
           "name": "node.click",
+          "description": "",
           "detail": {
+            "description": "`void`",
             "type": "void"
           }
         },
         {
           "name": "node.dblclick",
+          "description": "",
           "detail": {
+            "description": "`void`",
             "type": "void"
           }
         },
         {
           "name": "node.contextmenu",
+          "description": "",
           "detail": {
+            "description": "`ContextMenuDetail` — { clientX: 鼠标 X 坐标, clientY: 鼠标 Y 坐标 }",
             "type": "ContextMenuDetail"
           }
         },
         {
           "name": "child.append",
+          "description": "",
           "detail": {
+            "description": "`void`",
             "type": "void"
           }
         },
         {
           "name": "external.click",
+          "description": "",
           "detail": {
+            "description": "`ExtraNodeData` — { id: 外链节点 ID, label: 外链节点标签 }",
             "type": "ExtraNodeData"
           }
         },
         {
           "name": "subNode.dblclick",
+          "description": "",
           "detail": {
+            "description": "`ExtraNodeData` — { id: 子节点 ID, label: 子节点标签 }",
             "type": "ExtraNodeData"
           }
         },
         {
           "name": "subNode.contextmenu",
+          "description": "",
           "detail": {
+            "description": "`SubNodeContextMenuData` — { node: { id: 子节点 ID, label: 子节点标签 }, clientX: 鼠标 X 坐标, clientY: 鼠标 Y 坐标 }",
             "type": "SubNodeContextMenuData"
           }
         }
@@ -368,38 +396,86 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `visual-builder.page-arch-node`"
+      "description": "Visual Builder 页面架构图节点，支持页面（page）和看板（board）两种类型，可内联编辑标签、追加子节点、显示外链和子节点"
+    },
+    {
+      "name": "visual-builder.workbench-history-action",
+      "properties": [
+        {
+          "name": "appId",
+          "type": "string"
+        },
+        {
+          "name": "projectId",
+          "type": "string"
+        }
+      ],
+      "events": [
+        {
+          "name": "history.item.click",
+          "description": "点击历史项标题触发",
+          "detail": {
+            "type": "HistoryData & { enableRollback: boolean }"
+          }
+        },
+        {
+          "name": "rollback",
+          "description": "点击回滚触发",
+          "detail": {
+            "type": "HistoryData"
+          }
+        },
+        {
+          "name": "rollback.all",
+          "description": "回滚全部",
+          "detail": {
+            "type": "void"
+          }
+        }
+      ],
+      "slots": [],
+      "methods": [],
+      "parts": [],
+      "description": "项目变更历史",
+      "insider": true
     },
     {
       "name": "visual-builder.contract-select",
       "properties": [
         {
           "name": "name",
+          "description": "表单字段名",
           "type": "string"
         },
         {
           "name": "required",
+          "description": "是否为必填项",
           "type": "boolean"
         },
         {
           "name": "label",
+          "description": "表单项标签",
           "type": "string"
         },
         {
           "name": "value",
+          "description": "当前选中的契约值，格式为 `contractName@namespace:version`",
           "attribute": false,
           "type": "any"
         },
         {
           "name": "suffix",
+          "description": "输入框后缀内容，使用 useBrick 自定义渲染",
           "attribute": false,
-          "type": "{ useBrick: UseSingleBrickConf | UseSingleBrickConf[] }"
+          "type": "{\n        useBrick: UseBrickConfOrRenderFunction;\n      }"
         }
       ],
       "events": [
         {
           "name": "change",
+          "description": "",
           "detail": {
+            "description": "选中的契约值字符串，格式为 `contractName@namespace:version`",
             "type": "string"
           }
         }
@@ -407,22 +483,25 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "契约选择构件"
+      "description": "契约选择构件，提供契约名称和版本的联动选择，格式为 `contractName@namespace:version`，支持在表单中使用"
     },
     {
       "name": "visual-builder.generate-snippets-context-menu",
       "properties": [
         {
           "name": "options",
+          "description": "菜单选项列表，每组包含标题和子菜单项",
           "attribute": false,
           "type": "SnippetOption[]"
         },
         {
           "name": "active",
+          "description": "菜单是否处于激活（显示）状态，通过 open/close 方法控制",
           "type": "boolean"
         },
         {
           "name": "position",
+          "description": "菜单显示位置，格式为 `[clientX, clientY]`，超出视口时自动修正",
           "attribute": false,
           "type": "Position"
         }
@@ -430,13 +509,17 @@
       "events": [
         {
           "name": "item.drag.start",
+          "description": "",
           "detail": {
+            "description": "`SnippetItem` — { text: 片段文本, icon: 图标, dragConf: { format: 数据格式, data: 数据内容 } }",
             "type": "SnippetItem"
           }
         },
         {
           "name": "item.drag.end",
+          "description": "",
           "detail": {
+            "description": "`SnippetItem` — { text: 片段文本, icon: 图标, dragConf: { format: 数据格式, data: 数据内容 } }",
             "type": "SnippetItem"
           }
         }
@@ -447,36 +530,45 @@
           "name": "open",
           "params": [
             {
-              "name": "param_1",
+              "name": "openInfo",
+              "description": "包含菜单位置的配置，position 通常设为 `[EVENT.clientX, EVENT.clientY]`",
               "type": "OpenInfo"
             }
-          ]
+          ],
+          "description": "打开上下文菜单并定位到指定位置",
+          "returns": {}
         },
         {
           "name": "close",
-          "params": []
+          "params": [],
+          "description": "关闭上下文菜单",
+          "returns": {}
         }
       ],
       "parts": [],
-      "description": "构件 `visual-builder.generate-snippets-context-menu`"
+      "description": "用于 Visual Builder 的代码片段右键上下文菜单，支持拖拽片段到画布，菜单位置自动适配视口边界"
     },
     {
       "name": "visual-builder.chat-conversation",
       "properties": [
         {
           "name": "messages",
+          "description": "对话消息列表，包含用户和 AI 助手的消息，支持流式（partial）和失败（failed）状态",
           "attribute": false,
           "type": "Message[]"
         },
         {
           "name": "errorBoundary",
+          "description": "是否为解析出的砖块启用错误边界，防止单个砖块异常导致整个预览崩溃",
           "type": "boolean"
         }
       ],
       "events": [
         {
           "name": "storyboard.update",
+          "description": "",
           "detail": {
+            "description": "`BrickConf[]` — 解析出的砖块配置列表",
             "type": "BrickConf[]"
           }
         }
@@ -484,37 +576,44 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "用于 Visual Builder 的智能聊天对话列表"
+      "description": "用于 Visual Builder 的智能聊天对话列表，解析 AI 回复中的 Storyboard 代码块并触发更新事件"
     },
     {
       "name": "visual-builder.chat-preview",
       "properties": [
         {
           "name": "storyboard",
+          "description": "要预览的砖块配置，支持单个或列表，更新后自动触发 iframe 重新渲染",
           "attribute": false,
           "type": "BrickConf | BrickConf[]"
         },
         {
           "name": "theme",
+          "description": "预览的主题，例如 \"dark-v2\"",
           "type": "string"
         },
         {
           "name": "uiVersion",
+          "description": "预览的 UI 版本，例如 \"8.2\"",
           "type": "string"
         },
         {
           "name": "app",
+          "description": "预览使用的 MicroApp 配置，影响 app 上下文",
           "type": "MicroApp"
         },
         {
           "name": "inspecting",
+          "description": "是否开启元素检查模式，开启后鼠标悬停和点击时会显示元素轮廓高亮",
           "type": "boolean"
         }
       ],
       "events": [
         {
           "name": "activeTarget.change",
+          "description": "",
           "detail": {
+            "description": "`InspectSelector | undefined` — 当前激活的检查目标选择器，未选中时为 undefined",
             "type": "InspectSelector | undefined"
           }
         }
@@ -526,38 +625,45 @@
           "params": [
             {
               "name": "payload",
+              "description": "要选中的元素选择器",
               "type": "InspectSelector"
             }
-          ]
+          ],
+          "description": "向 iframe 内的预览代理发送选中指令，高亮指定元素",
+          "returns": {}
         }
       ],
       "parts": [],
-      "description": "构件 `visual-builder.chat-preview`"
+      "description": "Visual Builder 的聊天预览构件，在 iframe 中渲染 Storyboard 并支持元素检查模式"
     },
     {
       "name": "visual-builder.pre-generated-preview",
       "properties": [
         {
           "name": "generations",
+          "description": "属性生成数据列表",
           "attribute": false,
           "type": "AttributeGeneration[]"
         },
         {
           "name": "category",
-          "description": "",
+          "description": "预览分类，影响数据容器的渲染方式",
           "default": "\"value\"",
           "type": "PreviewCategory"
         },
         {
           "name": "theme",
+          "description": "预览主题",
           "type": "string"
         },
         {
           "name": "uiVersion",
+          "description": "UI 版本",
           "type": "string"
         },
         {
           "name": "app",
+          "description": "微应用信息",
           "type": "MicroApp"
         }
       ],
@@ -565,7 +671,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `visual-builder.pre-generated-preview`"
+      "description": "预生成编排预览，在 iframe 中渲染属性生成结果的对比表格"
     },
     {
       "name": "visual-builder.pre-generated-table-view",
@@ -574,18 +680,20 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `visual-builder.pre-generated-table-view`"
+      "description": "预生成编排表格视图，使用 CSS Grid 布局渲染子构件"
     },
     {
       "name": "visual-builder.pre-generated-container",
       "properties": [
         {
           "name": "useBrick",
+          "description": "要渲染的构件配置",
           "attribute": false,
-          "type": "UseBrickConf"
+          "type": "UseBrickConfOrRenderFunction"
         },
         {
           "name": "dataSource",
+          "description": "传入构件的数据",
           "attribute": false,
           "type": "unknown"
         }
@@ -594,49 +702,54 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `visual-builder.pre-generated-container`"
+      "description": "预生成编排容器，使用 useBrick 渲染指定的构件配置，并将 dataSource 作为数据传入"
     },
     {
       "name": "visual-builder.property-editor",
       "properties": [
         {
           "name": "editorName",
-          "description": "构件名称",
+          "description": "构件名称，用于加载对应的属性编辑器",
           "type": "string"
         },
         {
           "name": "values",
-          "description": "值",
+          "description": "属性编辑器的当前值",
           "attribute": false,
           "type": "any"
         },
         {
           "name": "advancedMode",
-          "description": "高级模式",
+          "description": "是否启用高级模式，高级模式下直接编辑原始属性对象",
           "type": "boolean"
         },
         {
           "name": "dataList",
+          "description": "数据列表，用于编辑器中的数据绑定选项",
           "attribute": false,
           "type": "DataItem[]"
         },
         {
           "name": "editorPackages",
+          "description": "构件包信息，用于加载自定义编辑器",
           "attribute": false,
           "type": "BrickPackage[]"
         },
         {
           "name": "links",
+          "description": "链接配置，用于编辑器中的跳转链接选项",
           "attribute": false,
           "type": "any"
         },
         {
           "name": "extraLibs",
+          "description": "额外的代码补全库，用于代码编辑器的类型提示",
           "attribute": false,
           "type": "SelectOptions"
         },
         {
           "name": "childSlots",
+          "description": "子插槽选项，用于编辑器中选择子插槽",
           "attribute": false,
           "type": "SelectOptions"
         }
@@ -646,6 +759,7 @@
           "name": "validate.success",
           "description": "表单验证成功时触发事件",
           "detail": {
+            "description": "表单验证成功后的表单值",
             "type": "Record<string, unknown>"
           }
         },
@@ -653,24 +767,31 @@
           "name": "validate.error",
           "description": "表单验证报错时触发事件",
           "detail": {
+            "description": "表单验证错误信息数组",
             "type": "any[]"
           }
         },
         {
           "name": "values.change",
+          "description": "表单值发生变化时触发",
           "detail": {
+            "description": "当前表单的最新值",
             "type": "any"
           }
         },
         {
           "name": "token.click",
+          "description": "点击代码编辑器中的 token 时触发",
           "detail": {
+            "description": "被点击的 token 字符串",
             "type": "string"
           }
         },
         {
           "name": "trigger.action",
+          "description": "编辑器内部触发自定义动作时触发",
           "detail": {
+            "description": "触发的动作标识",
             "type": "string"
           }
         }
@@ -679,68 +800,83 @@
       "methods": [
         {
           "name": "validate",
-          "params": []
+          "params": [],
+          "description": "触发表单校验，验证成功后触发 validate.success 事件，失败后触发 validate.error 事件",
+          "returns": {}
         }
       ],
       "parts": [],
-      "description": "构件 `visual-builder.property-editor`"
+      "description": "构件属性编辑器，基于 Formily 渲染指定构件的属性编辑表单"
     },
     {
       "name": "visual-builder.raw-data-preview",
       "properties": [
         {
           "name": "previewUrl",
+          "description": "预览 iframe 地址，默认使用内置预览地址",
           "type": "string"
         },
         {
           "name": "generations",
+          "description": "属性生成数据列表",
           "attribute": false,
           "type": "AttributeGeneration[]"
         },
         {
           "name": "mocks",
+          "description": "模拟数据列表，作为各属性的候补示例数据",
           "attribute": false,
           "type": "Record<string, unknown>[]"
         },
         {
           "name": "busy",
+          "description": "是否处于加载中状态，为 true 时禁用批注和确认操作",
           "type": "boolean"
         },
         {
           "name": "category",
-          "description": "",
+          "description": "预览分类，影响数据容器的渲染方式",
           "default": "\"value\"",
           "type": "PreviewCategory"
         },
         {
           "name": "theme",
+          "description": "预览主题",
           "type": "string"
         },
         {
           "name": "uiVersion",
+          "description": "UI 版本",
           "type": "string"
         },
         {
           "name": "app",
+          "description": "微应用信息",
           "type": "MicroApp"
         }
       ],
       "events": [
         {
           "name": "comment",
+          "description": "提交批注时触发（在批注文本框中按 ⌘/Ctrl + 回车）",
           "detail": {
+            "description": "{ comment: 批注内容, propertyInstanceId: 属性实例 ID }",
             "type": "CommentDetail"
           }
         },
         {
           "name": "approve",
+          "description": "点击确认 checkbox 时触发",
           "detail": {
+            "description": "{ approved: 是否已确认, propertyInstanceId: 属性实例 ID }",
             "type": "ApproveDetail"
           }
         },
         {
           "name": "view.attr.prompt",
+          "description": "点击属性类型链接查看提示词时触发",
           "detail": {
+            "description": "{ generationId: 生成 ID, objectId: 对象 ID, objectName: 对象名称, propertyId: 属性 ID, propertyName: 属性名称, propertyType: 属性类型, candidates: 候选编排列表, mockData: 模拟数据 }",
             "type": "AttributeGeneration"
           }
         }
@@ -748,32 +884,37 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `visual-builder.raw-data-preview`"
+      "description": "原始数据预览，在 iframe 中渲染属性生成候选编排的对比表格，支持批注和确认操作"
     },
     {
       "name": "visual-builder.pre-generated-config",
       "properties": [
         {
           "name": "previewUrl",
+          "description": "预览 iframe 的地址，默认使用内置预览地址",
           "type": "string"
         },
         {
           "name": "attrList",
+          "description": "属性列表，支持对象属性（ObjectAttr）和指标属性（MetricAttr）",
           "attribute": false,
           "type": "ObjectAttr[]"
         },
         {
           "name": "mockList",
+          "description": "模拟数据列表，用于在预览列中展示真实渲染效果",
           "attribute": false,
           "type": "Record<string, unknown>[]"
         },
         {
           "name": "metricGroups",
+          "description": "指标分组配置，仅在 containerConfig.type 为 \"grouped-chart\" 时生效",
           "attribute": false,
           "type": "MetricGroup[]"
         },
         {
           "name": "containerConfig",
+          "description": "容器配置，决定生成的砖块布局类型（table/descriptions/cards/chart/grouped-chart）及数据绑定",
           "attribute": false,
           "type": "ContainerConfig"
         }
@@ -781,7 +922,9 @@
       "events": [
         {
           "name": "brick.change",
+          "description": "",
           "detail": {
+            "description": "`BrickConf | null` — 根据当前选择和权重生成的砖块配置，无选中时为 null",
             "type": "BrickConf | null"
           }
         }
@@ -789,26 +932,30 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `visual-builder.pre-generated-config`"
+      "description": "AI 预生成配置选择器，以 iframe 预览方式展示属性列表，允许用户勾选、排序和调整可视权重，生成最终砖块配置"
     },
     {
       "name": "visual-builder.pre-generated-config-preview",
       "properties": [
         {
           "name": "previewUrl",
+          "description": "预览 iframe 的地址，默认使用内置预览地址",
           "type": "string"
         },
         {
           "name": "container",
+          "description": "容器类型，\"table\" 渲染为表格，\"descriptions\" 渲染为描述列表，默认为 \"table\"",
           "type": "ContainerType"
         },
         {
           "name": "attrList",
+          "description": "属性列表，每项包含 id、name，以及可选的可视化配置",
           "attribute": false,
           "type": "ObjectAttr[]"
         },
         {
           "name": "mockList",
+          "description": "模拟数据列表，用于填充预览中的真实数据",
           "attribute": false,
           "type": "Record<string, unknown>[]"
         }
@@ -817,38 +964,45 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `visual-builder.pre-generated-config-preview`"
+      "description": "AI 预生成配置预览构件，在 iframe 中将属性列表渲染为表格或描述列表，用于直观展示配置结果"
     },
     {
       "name": "visual-builder.raw-metric-preview",
       "properties": [
         {
           "name": "previewUrl",
+          "description": "预览 iframe 地址，默认使用内置预览地址",
           "type": "string"
         },
         {
           "name": "generations",
+          "description": "指标生成数据列表",
           "attribute": false,
           "type": "MetricGeneration[]"
         },
         {
           "name": "grouped",
+          "description": "是否按分组显示，启用后表格额外显示分组列",
           "type": "boolean"
         },
         {
           "name": "busy",
+          "description": "是否处于加载中状态",
           "type": "boolean"
         },
         {
           "name": "theme",
+          "description": "预览主题",
           "type": "string"
         },
         {
           "name": "uiVersion",
+          "description": "UI 版本",
           "type": "string"
         },
         {
           "name": "app",
+          "description": "微应用信息",
           "type": "MicroApp"
         }
       ],
@@ -856,7 +1010,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `visual-builder.raw-metric-preview`"
+      "description": "原始指标预览，在 iframe 中渲染指标生成候选图表的对比表格"
     }
   ],
   "providers": [
@@ -882,10 +1036,10 @@
       "name": "visual-builder.get-dependency-tree"
     },
     {
-      "name": "visual-builder.get-config-by-data-for-ai"
+      "name": "visual-builder.inject-chat-preview-agent"
     },
     {
-      "name": "visual-builder.inject-chat-preview-agent"
+      "name": "visual-builder.get-config-by-data-for-ai"
     }
   ]
 }