@next-bricks/ai-portal 0.70.1 → 0.70.3

package/dist/manifest.json

@@ -3,25 +3,12 @@
   "package": "@next-bricks/ai-portal",
   "name": "ai-portal",
   "bricks": [
-    {
-      "name": "ai-portal.home-container",
-      "properties": [
-        {
-          "name": "sticky",
-          "type": "boolean"
-        }
-      ],
-      "events": [],
-      "slots": [],
-      "methods": [],
-      "parts": [],
-      "description": "构件 `ai-portal.home-container`"
-    },
     {
       "name": "ai-portal.cruise-canvas",
       "properties": [
         {
           "name": "conversationId",
+          "description": "对话 ID",
           "type": "string"
         },
         {
@@ -43,75 +30,92 @@
         },
         {
           "name": "supports",
+          "description": "功能开关配置，键为功能名，值为是否启用",
           "attribute": false,
           "type": "Record<string, boolean>"
         },
         {
           "name": "showHiddenJobs",
+          "description": "是否显示隐藏的 Job 节点",
           "type": "boolean"
         },
         {
           "name": "showHumanActions",
+          "description": "是否显示 Human-in-the-loop 操作按钮",
           "type": "boolean"
         },
         {
           "name": "showFeedback",
+          "description": "是否显示反馈按钮",
           "type": "boolean"
         },
         {
           "name": "showFeedbackAfterFailed",
+          "description": "是否在任务失败时也显示反馈按钮",
           "type": "boolean"
         },
         {
           "name": "showFeedbackOnView",
+          "description": "是否在查看生成视图时显示反馈按钮",
           "type": "boolean"
         },
         {
           "name": "showUiSwitch",
+          "description": "是否显示切换到对话流视图的按钮",
           "type": "boolean"
         },
         {
           "name": "hideMermaid",
+          "description": "是否隐藏 Mermaid 图表渲染，通过 CSS 属性选择器控制样式",
           "type": "boolean"
         },
         {
           "name": "showJsxEditor",
+          "description": "是否显示 JSX 编辑器按钮",
           "type": "boolean"
         },
         {
           "name": "previewUrlTemplate",
+          "description": "生成视图预览页的 URL 模板，支持 {viewId} 等字段插值",
           "type": "string"
         },
         {
           "name": "showCases",
+          "description": "示例场景列表，用于在空对话时展示快速入口",
           "attribute": false,
           "type": "ShowCaseType[]"
         },
         {
           "name": "exampleProjects",
+          "description": "示例项目列表，用于展示可参考的已有项目",
           "attribute": false,
           "type": "ExampleProject[]"
         },
         {
           "name": "tryItOutUrl",
+          "description": "\"试一试\"跳转 URL",
           "type": "string"
         },
         {
           "name": "separateInstructions",
+          "description": "是否将任务说明独立展示，而非内联在节点中",
           "type": "boolean"
         },
         {
           "name": "aiEmployees",
+          "description": "可 @ 提及的数字人列表",
           "attribute": false,
           "type": "AIEmployee[]"
         },
         {
           "name": "commands",
+          "description": "命令列表，支持通过 / 或搜索触发联想",
           "attribute": false,
           "type": "Command[]"
         },
         {
           "name": "uploadOptions",
+          "description": "文件上传配置",
           "attribute": false,
           "type": "UploadOptions"
         }
@@ -119,37 +123,49 @@
       "events": [
         {
           "name": "share",
+          "description": "",
           "detail": {
+            "description": "void",
             "type": "void"
           }
         },
         {
           "name": "terminate",
+          "description": "",
           "detail": {
+            "description": "void",
             "type": "void"
           }
         },
         {
           "name": "feedback.submit",
+          "description": "",
           "detail": {
+            "description": "{ plan: 计划步骤列表, result: 结果列表, feedback: 反馈文本 }",
             "type": "FeedbackDetail"
           }
         },
         {
           "name": "feedback.on.view",
+          "description": "",
           "detail": {
+            "description": "生成视图的 viewId",
             "type": "string"
           }
         },
         {
           "name": "ui.switch",
+          "description": "",
           "detail": {
+            "description": "切换目标 UI 模式，值为 \"chat\"",
             "type": "\"chat\""
           }
         },
         {
           "name": "detail.change",
+          "description": "",
           "detail": {
+            "description": "{ projectId: 关联的项目 ID }",
             "type": "ConversationDetail"
           }
         }
@@ -158,54 +174,157 @@
       "methods": [
         {
           "name": "resumed",
-          "params": []
+          "params": [],
+          "description": "通知组件任务已恢复，用于继续中断的对话",
+          "returns": {}
         },
         {
           "name": "feedbackSubmitDone",
-          "params": []
+          "params": [],
+          "description": "通知组件反馈提交成功",
+          "returns": {}
         },
         {
           "name": "feedbackSubmitFailed",
-          "params": []
+          "params": [],
+          "description": "通知组件反馈提交失败",
+          "returns": {}
         },
         {
           "name": "feedbackOnViewDone",
           "params": [
             {
               "name": "viewId",
+              "description": "对应的视图 ID",
+              "type": "string"
+            }
+          ],
+          "description": "通知组件查看视图的反馈处理完成",
+          "returns": {}
+        }
+      ],
+      "parts": [],
+      "description": "AI 任务执行画布，以节点图形式展示任务的执行过程，支持任务回放、反馈及 UI 切换等功能。",
+      "category": "ai-portal"
+    },
+    {
+      "name": "ai-portal.chat-box",
+      "properties": [
+        {
+          "name": "disabled",
+          "type": "boolean"
+        },
+        {
+          "name": "placeholder",
+          "type": "string"
+        },
+        {
+          "name": "autoFocus",
+          "type": "boolean"
+        },
+        {
+          "name": "aiEmployees",
+          "attribute": false,
+          "type": "AIEmployee[]"
+        },
+        {
+          "name": "commands",
+          "attribute": false,
+          "type": "Command[]"
+        },
+        {
+          "name": "uploadOptions",
+          "attribute": false,
+          "type": "UploadOptions"
+        }
+      ],
+      "events": [
+        {
+          "name": "message.submit",
+          "description": "",
+          "deprecated": "Use `chat.submit` event instead",
+          "detail": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "chat.submit",
+          "detail": {
+            "type": "ChatPayload"
+          }
+        }
+      ],
+      "slots": [],
+      "methods": [
+        {
+          "name": "setValue",
+          "params": [
+            {
+              "name": "value",
               "type": "string"
             }
           ]
+        },
+        {
+          "name": "getValue",
+          "params": []
+        },
+        {
+          "name": "focusOnInput",
+          "params": []
+        }
+      ],
+      "parts": [],
+      "description": "大型聊天输入框，用于首页"
+    },
+    {
+      "name": "ai-portal.home-container",
+      "properties": [
+        {
+          "name": "sticky",
+          "type": "boolean"
         }
       ],
+      "events": [],
+      "slots": [
+        {
+          "name": "default",
+          "description": "页面内容区域"
+        }
+      ],
+      "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.cruise-canvas`"
+      "description": "AI Portal 首页容器，通过 sticky 属性控制顶部吸附行为，内容通过默认插槽传入。",
+      "category": "layout-component"
     },
     {
       "name": "ai-portal.stat-with-mini-chart",
       "properties": [
         {
           "name": "label",
+          "description": "统计指标标签名称",
           "type": "string"
         },
         {
           "name": "value",
+          "description": "统计数值文本",
           "type": "string"
         },
         {
           "name": "size",
-          "description": "",
+          "description": "展示尺寸，medium 时图表高度为 92px，small 时为 55px",
           "default": "\"medium\"",
           "type": "\"medium\" | \"small\""
         },
         {
           "name": "lineColor",
-          "description": "",
+          "description": "折线颜色",
           "default": "\"var(--color-brand)\"",
           "type": "string"
         },
         {
           "name": "showArea",
+          "description": "是否在折线下方显示渐变填充区域",
           "type": "boolean"
         },
         {
@@ -220,18 +339,19 @@
         },
         {
           "name": "xField",
-          "description": "",
+          "description": "x 轴字段名（数据中时间字段的 key）",
           "default": "\"0\"",
           "type": "string"
         },
         {
           "name": "yField",
-          "description": "",
+          "description": "y 轴字段名（数据中数值字段的 key）",
           "default": "\"1\"",
           "type": "string"
         },
         {
           "name": "data",
+          "description": "图表数据源，每项为包含 xField 和 yField 字段的对象",
           "attribute": false,
           "type": "Record<string, number>[]"
         }
@@ -240,66 +360,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.stat-with-mini-chart`"
-    },
-    {
-      "name": "ai-portal.icon-button",
-      "properties": [
-        {
-          "name": "icon",
-          "attribute": false,
-          "type": "(GeneralIconProps & HTMLAttributes<GeneralIcon>)"
-        },
-        {
-          "name": "tooltip",
-          "type": "string"
-        },
-        {
-          "name": "tooltipHoist",
-          "type": "boolean"
-        },
-        {
-          "name": "active",
-          "type": "boolean"
-        },
-        {
-          "name": "disabled",
-          "type": "boolean"
-        },
-        {
-          "name": "variant",
-          "type": "IconButtonVariant"
-        },
-        {
-          "name": "reduceIconSize",
-          "description": "是否缩小图标尺寸（部分 easyops 图标过大）",
-          "type": "boolean"
-        }
-      ],
-      "events": [],
-      "slots": [],
-      "methods": [],
-      "parts": [],
-      "description": "构件 `ai-portal.icon-button`"
-    },
-    {
-      "name": "ai-portal.show-cases",
-      "properties": [
-        {
-          "name": "list",
-          "attribute": false,
-          "type": "ShowCaseType[]"
-        },
-        {
-          "name": "limit",
-          "type": "number"
-        }
-      ],
-      "events": [],
-      "slots": [],
-      "methods": [],
-      "parts": [],
-      "description": "构件 `ai-portal.show-cases`"
+      "description": "构件 `ai-portal.stat-with-mini-chart`\n\n带迷你折线图的统计数据展示构件，在统计数值旁边渲染一个迷你折线图。"
     },
     {
       "name": "ai-portal.elevo-sidebar",
@@ -381,7 +442,9 @@
       "events": [
         {
           "name": "logout",
+          "description": "",
           "detail": {
+            "description": "void",
             "type": "void"
           }
         },
@@ -389,6 +452,7 @@
           "name": "action.click",
           "description": "点击对话历史操作按钮时触发",
           "detail": {
+            "description": "{ action: 点击的操作项（含 project 等扩展字段）, item: 当前对话历史记录项, project: 关联的项目（可选） }",
             "type": "ActionClickDetail"
           }
         },
@@ -396,18 +460,23 @@
           "name": "project.action.click",
           "description": "点击项目操作按钮时触发",
           "detail": {
+            "description": "{ action: 点击的操作项, project: 当前项目对象 }",
             "type": "ProjectActionClickDetail"
           }
         },
         {
           "name": "add.project",
+          "description": "",
           "detail": {
+            "description": "void",
             "type": "void"
           }
         },
         {
           "name": "add.serviceflow",
+          "description": "",
           "detail": {
+            "description": "void",
             "type": "void"
           }
         },
@@ -415,6 +484,7 @@
           "name": "personal.action.click",
           "description": "点击个人操作按钮时触发",
           "detail": {
+            "description": "{ action: 点击的操作项 }",
             "type": "PersonalActionClickDetail"
           }
         }
@@ -426,90 +496,124 @@
           "params": [
             {
               "name": "delay",
-              "description": "Delay in milliseconds before pulling the latest chat history.",
+              "description": "拉取前的等待时长（毫秒），用于等待任务标题生成完成",
               "type": "number"
             }
           ],
-          "description": "",
+          "description": "延迟一段时间后拉取最新对话历史",
           "returns": {}
         },
         {
           "name": "open",
-          "params": []
+          "params": [],
+          "description": "展开侧边栏（behavior 为 drawer 时有效）",
+          "returns": {}
         },
         {
           "name": "close",
-          "params": []
+          "params": [],
+          "description": "折叠侧边栏（behavior 为 drawer 时有效）",
+          "returns": {}
         },
         {
           "name": "removeProject",
           "params": [
             {
               "name": "projectId",
+              "description": "要移除的项目 instanceId",
               "type": "string"
             }
-          ]
+          ],
+          "description": "从历史列表中移除指定项目及其对话",
+          "returns": {}
         },
         {
           "name": "addProject",
           "params": [
             {
               "name": "project",
+              "description": "要追加的项目对象",
               "type": "Project"
             }
-          ]
+          ],
+          "description": "向项目列表中追加一个新项目",
+          "returns": {}
         },
         {
           "name": "moveConversation",
           "params": [
             {
               "name": "conversationId",
+              "description": "要移动的对话 ID",
               "type": "string"
             }
-          ]
+          ],
+          "description": "将指定对话标记为已移入项目，从历史列表中隐藏",
+          "returns": {}
         }
       ],
       "parts": [],
-      "description": "构件 `ai-portal.elevo-sidebar`"
+      "description": "Elevo AI 侧边栏，包含 Logo 导航、新建对话、历史记录、项目列表及个人账户操作，支持折叠和抽屉两种行为模式。",
+      "category": "layout-component"
     },
     {
-      "name": "ai-portal.mcp-tools",
+      "name": "ai-portal.icon-button",
       "properties": [
         {
-          "name": "list",
+          "name": "icon",
           "attribute": false,
-          "type": "McpTool[]"
+          "type": "(GeneralIconProps & HTMLAttributes<GeneralIcon>)"
         },
         {
-          "name": "stickyTop",
-          "type": "number"
+          "name": "tooltip",
+          "type": "string"
+        },
+        {
+          "name": "tooltipHoist",
+          "type": "boolean"
+        },
+        {
+          "name": "active",
+          "type": "boolean"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean"
+        },
+        {
+          "name": "variant",
+          "type": "IconButtonVariant"
+        },
+        {
+          "name": "reduceIconSize",
+          "description": "是否缩小图标尺寸（部分 easyops 图标过大）",
+          "type": "boolean"
         }
       ],
       "events": [],
-      "slots": [],
+      "slots": [
+        {
+          "name": "default",
+          "description": "图标旁边的文字内容（可选）"
+        }
+      ],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.mcp-tools`"
+      "description": "图标按钮，支持多种视觉变体、禁用状态、Tooltip 提示及文字插槽。",
+      "category": "interact-basic"
     },
     {
-      "name": "ai-portal.ai-employees",
+      "name": "ai-portal.show-cases",
       "properties": [
         {
           "name": "list",
+          "description": "案例数据列表，每项可包含 scenario 字段用于分组筛选",
           "attribute": false,
-          "type": "Employee[]"
-        },
-        {
-          "name": "industries",
-          "attribute": false,
-          "type": "string[]"
-        },
-        {
-          "name": "urlTemplate",
-          "type": "string"
+          "type": "ShowCaseType[]"
         },
         {
-          "name": "stickyTop",
+          "name": "limit",
+          "description": "每个场景分组下最多显示的案例数量",
           "type": "number"
         }
       ],
@@ -517,38 +621,34 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.ai-employees`"
+      "description": "构件 `ai-portal.show-cases`\n\n案例列表展示构件，支持按场景分组筛选，展示多个优秀案例卡片。"
     },
     {
-      "name": "ai-portal.ai-agents",
+      "name": "ai-portal.mcp-tools",
       "properties": [
         {
           "name": "list",
           "attribute": false,
-          "type": "Agent[]"
-        },
-        {
-          "name": "urlTemplate",
-          "type": "string"
+          "type": "McpTool[]"
         },
         {
-          "name": "withContainer",
-          "description": "",
-          "deprecated": true,
-          "default": "true"
+          "name": "stickyTop",
+          "type": "number"
         }
       ],
       "events": [],
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.ai-agents`"
+      "description": "MCP 工具列表组件，按服务分组展示工具信息，支持按平台分类过滤和吸顶标签栏。",
+      "category": "display-component"
     },
     {
       "name": "ai-portal.chat-stream",
       "properties": [
         {
           "name": "conversationId",
+          "description": "对话 ID",
           "type": "string"
         },
         {
@@ -570,63 +670,77 @@
         },
         {
           "name": "supports",
+          "description": "功能开关配置，键为功能名，值为是否启用",
           "attribute": false,
           "type": "Record<string, boolean>"
         },
         {
           "name": "showHumanActions",
+          "description": "是否显示 Human-in-the-loop 操作按钮",
           "type": "boolean"
         },
         {
           "name": "showFeedback",
+          "description": "是否显示反馈按钮",
           "type": "boolean"
         },
         {
           "name": "showFeedbackAfterFailed",
+          "description": "是否在任务失败时也显示反馈按钮",
           "type": "boolean"
         },
         {
           "name": "showFeedbackOnView",
+          "description": "是否在查看生成视图时显示反馈按钮",
           "type": "boolean"
         },
         {
           "name": "showUiSwitch",
+          "description": "是否显示切换到画布视图的按钮",
           "type": "boolean"
         },
         {
           "name": "hideMermaid",
+          "description": "是否隐藏 Mermaid 图表渲染，通过 CSS 属性选择器控制样式",
           "type": "boolean"
         },
         {
           "name": "previewUrlTemplate",
+          "description": "生成视图预览页的 URL 模板，支持 {viewId} 等字段插值",
           "type": "string"
         },
         {
           "name": "showCases",
+          "description": "示例场景列表，用于在空对话时展示快速入口",
           "attribute": false,
           "type": "ShowCaseType[]"
         },
         {
           "name": "exampleProjects",
+          "description": "示例项目列表，用于展示可参考的已有项目",
           "attribute": false,
           "type": "ExampleProject[]"
         },
         {
           "name": "tryItOutUrl",
+          "description": "\"试一试\"跳转 URL",
           "type": "string"
         },
         {
           "name": "aiEmployees",
+          "description": "可 @ 提及的数字人列表",
           "attribute": false,
           "type": "AIEmployee[]"
         },
         {
           "name": "commands",
+          "description": "命令列表，支持通过 / 或搜索触发联想",
           "attribute": false,
           "type": "Command[]"
         },
         {
           "name": "uploadOptions",
+          "description": "文件上传配置",
           "attribute": false,
           "type": "UploadOptions"
         }
@@ -634,43 +748,57 @@
       "events": [
         {
           "name": "share",
+          "description": "",
           "detail": {
+            "description": "void",
             "type": "void"
           }
         },
         {
           "name": "terminate",
+          "description": "",
           "detail": {
+            "description": "void",
             "type": "void"
           }
         },
         {
           "name": "feedback.submit",
+          "description": "",
           "detail": {
+            "description": "{ plan: 计划步骤列表, result: 结果列表, feedback: 反馈文本 }",
             "type": "FeedbackDetail"
           }
         },
         {
           "name": "feedback.on.view",
+          "description": "",
           "detail": {
+            "description": "生成视图的 viewId",
             "type": "string"
           }
         },
         {
           "name": "ui.switch",
+          "description": "",
           "detail": {
+            "description": "切换目标 UI 模式，值为 \"canvas\"",
             "type": "\"canvas\""
           }
         },
         {
           "name": "detail.change",
+          "description": "",
           "detail": {
+            "description": "{ projectId: 关联的项目 ID }",
             "type": "ConversationDetail"
           }
         },
         {
           "name": "split.change",
+          "description": "",
           "detail": {
+            "description": "是否已切换到分屏模式",
             "type": "boolean"
           }
         }
@@ -679,87 +807,127 @@
       "methods": [
         {
           "name": "resumed",
-          "params": []
+          "params": [],
+          "description": "通知组件任务已恢复，用于继续中断的对话",
+          "returns": {}
         },
         {
           "name": "feedbackSubmitDone",
-          "params": []
+          "params": [],
+          "description": "通知组件反馈提交成功",
+          "returns": {}
         },
         {
           "name": "feedbackSubmitFailed",
-          "params": []
+          "params": [],
+          "description": "通知组件反馈提交失败",
+          "returns": {}
         },
         {
           "name": "feedbackOnViewDone",
           "params": [
             {
               "name": "viewId",
+              "description": "对应的视图 ID",
               "type": "string"
             }
-          ]
+          ],
+          "description": "通知组件查看视图的反馈处理完成",
+          "returns": {}
         }
       ],
       "parts": [],
-      "description": "构件 `ai-portal.chat-stream`"
+      "description": "AI 对话流视图，以聊天气泡形式展示对话过程，支持文件上传、命令联想、回放及用户反馈等功能。",
+      "category": "ai-portal"
     },
     {
-      "name": "ai-portal.tab-list",
+      "name": "ai-portal.ai-employees",
       "properties": [
         {
-          "name": "tabs",
+          "name": "list",
+          "description": "数字人列表数据",
           "attribute": false,
-          "type": "Tab[]"
+          "type": "Employee[]"
         },
         {
-          "name": "activeTab",
+          "name": "industries",
+          "description": "行业列表，用于指定 Tab 的顺序，未在此列表中的行业将按出现顺序附加在末尾",
           "attribute": false,
+          "type": "string[]"
+        },
+        {
+          "name": "urlTemplate",
+          "description": "跳转到数字人详情页的 URL 模板，支持 {name} 等数字人字段插值",
           "type": "string"
-        }
-      ],
-      "events": [
+        },
         {
-          "name": "tab.click",
-          "detail": {
-            "type": "Tab"
-          }
+          "name": "stickyTop",
+          "description": "行业 Tab 栏吸顶时距顶部的距离（px），不设置则不吸顶",
+          "type": "number"
         }
       ],
+      "events": [],
       "slots": [],
       "methods": [],
-      "parts": [
+      "parts": [],
+      "description": "AI 数字人卡片列表，按行业和角色分组展示，支持 Tab 切换行业和点击跳转。",
+      "category": "ai-portal"
+    },
+    {
+      "name": "ai-portal.ai-agents",
+      "properties": [
         {
-          "name": "tabs",
-          "description": "The tab list container"
+          "name": "list",
+          "description": "AI Agent 列表数据",
+          "attribute": false,
+          "type": "Agent[]"
         },
         {
-          "name": "tab",
-          "description": "The individual tab"
+          "name": "urlTemplate",
+          "description": "跳转到 Agent 详情页的 URL 模板，支持 {name} 等 Agent 字段插值",
+          "type": "string"
+        },
+        {
+          "name": "withContainer",
+          "description": "",
+          "deprecated": true,
+          "default": "true"
         }
       ],
-      "description": "构件 `ai-portal.tab-list`"
+      "events": [],
+      "slots": [],
+      "methods": [],
+      "parts": [],
+      "description": "AI Agents 卡片列表，展示可用的 AI 智能体，支持点击跳转到对应详情页。",
+      "category": "ai-portal"
     },
     {
       "name": "ai-portal.page-container",
       "properties": [
         {
           "name": "pageTitle",
+          "description": "页面标题，同时会调用 applyPageTitle 更新浏览器标签页标题",
           "type": "string"
         },
         {
           "name": "breadcrumbs",
+          "description": "面包屑导航配置，每项包含 text 和 url",
           "attribute": false,
           "type": "Breadcrumb[]"
         },
         {
           "name": "size",
+          "description": "内容区域宽度模式，通过 CSS attribute selector 控制样式，不触发重新渲染",
           "type": "\"medium\" | \"small\" | \"full\""
         },
         {
           "name": "variant",
+          "description": "页面变体，通过 CSS attribute selector 控制样式，不触发重新渲染",
           "type": "\"default\" | \"form\""
         },
         {
           "name": "sticky",
+          "description": "是否固定头部（含面包屑和标题）到页面顶部",
           "type": "boolean"
         },
         {
@@ -781,7 +949,47 @@
       ],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.page-container`"
+      "description": "构件 `ai-portal.page-container`\n\n页面容器构件，提供统一的页面布局，包含面包屑导航、页面标题和内容区域。"
+    },
+    {
+      "name": "ai-portal.tab-list",
+      "properties": [
+        {
+          "name": "tabs",
+          "description": "标签页配置列表，每项包含 id 和 label",
+          "attribute": false,
+          "type": "Tab[]"
+        },
+        {
+          "name": "activeTab",
+          "description": "当前激活的标签页 id",
+          "attribute": false,
+          "type": "string"
+        }
+      ],
+      "events": [
+        {
+          "name": "tab.click",
+          "description": "",
+          "detail": {
+            "description": "{ id: 标签页ID, label: 标签页标题 }",
+            "type": "Tab"
+          }
+        }
+      ],
+      "slots": [],
+      "methods": [],
+      "parts": [
+        {
+          "name": "tabs",
+          "description": "The tab list container"
+        },
+        {
+          "name": "tab",
+          "description": "The individual tab"
+        }
+      ],
+      "description": "构件 `ai-portal.tab-list`\n\n标签页列表构件，展示可切换的标签页，点击后触发事件并自动更新选中状态。"
     },
     {
       "name": "ai-portal.dropdown-select",
@@ -830,7 +1038,9 @@
       "events": [
         {
           "name": "change",
+          "description": "",
           "detail": {
+            "description": "{ label: 选项标签, value: 选项值 }",
             "type": "DropdownOptions"
           }
         }
@@ -838,18 +1048,21 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.dropdown-select`"
+      "description": "下拉选择器，提供选项列表供用户选择，支持搜索过滤功能。",
+      "category": "interact-basic"
     },
     {
       "name": "ai-portal.preview-container",
       "properties": [
         {
           "name": "source",
+          "description": "TSX 源码字符串，将被解析并渲染为页面视图",
           "attribute": false,
           "type": "string"
         },
         {
           "name": "url",
+          "description": "渲染上下文中可访问的 URL，传入后可在视图内通过路由相关 API 使用",
           "type": "string"
         }
       ],
@@ -857,118 +1070,174 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.preview-container`"
+      "description": "构件 `ai-portal.preview-container`\n\nTSX 源码预览容器，将 TSX 源码字符串解析并渲染为完整的页面视图。"
     },
     {
-      "name": "ai-portal.chat-box",
+      "name": "ai-portal.action-buttons",
       "properties": [
         {
-          "name": "disabled",
-          "type": "boolean"
+          "name": "items",
+          "description": "按钮列表配置，每项包含文本、唯一键值及可选图标",
+          "attribute": false,
+          "type": "ActionItem[]"
         },
         {
-          "name": "placeholder",
-          "type": "string"
-        },
+          "name": "activeKey",
+          "description": "当前选中按钮的键值，选中后显示删除图标，再次点击可取消选中",
+          "type": "string | null"
+        }
+      ],
+      "events": [
         {
-          "name": "autoFocus",
-          "type": "boolean"
-        },
+          "name": "change",
+          "description": "",
+          "detail": {
+            "description": "{ key: 按钮键值, text: 按钮文本, icon: 按钮图标 } | null — 选中时为选中的 ActionItem，取消选中时为 null",
+            "type": "ActionItem | null"
+          }
+        }
+      ],
+      "slots": [],
+      "methods": [],
+      "parts": [],
+      "description": "动作按钮组，支持选中状态切换，用于聊天框的功能入口。",
+      "category": "ai-portal"
+    },
+    {
+      "name": "ai-portal.goal-card-list",
+      "properties": [
         {
-          "name": "aiEmployees",
+          "name": "goalList",
           "attribute": false,
-          "type": "AIEmployee[]"
+          "type": "GoalItem[]"
         },
         {
-          "name": "commands",
+          "name": "cardStyle",
           "attribute": false,
-          "type": "Command[]"
+          "type": "React.CSSProperties"
         },
         {
-          "name": "uploadOptions",
-          "attribute": false,
-          "type": "UploadOptions"
+          "name": "activeKey",
+          "type": "string"
         }
       ],
       "events": [
         {
-          "name": "message.submit",
+          "name": "item.click",
           "description": "",
-          "deprecated": "Use `chat.submit` event instead",
           "detail": {
-            "type": "string"
+            "description": "{ title: 目标标题, state: 目标状态, id: 序号, instanceId: 实例ID, level: 层级 }",
+            "type": "GoalItem"
+          }
+        },
+        {
+          "name": "item.status.change",
+          "description": "",
+          "detail": {
+            "description": "{ title: 目标标题, state: 更新后的目标状态, id: 序号, instanceId: 实例ID, level: 层级 }",
+            "type": "GoalItem"
+          }
+        },
+        {
+          "name": "item.title.change",
+          "description": "",
+          "detail": {
+            "description": "{ title: 更新后的标题, state: 目标状态, id: 序号, instanceId: 实例ID, level: 层级 }",
+            "type": "GoalItem"
           }
         },
         {
-          "name": "chat.submit",
+          "name": "item.new.chat",
+          "description": "",
           "detail": {
-            "type": "ChatPayload"
+            "description": "{ title: 目标标题, state: 目标状态, id: 序号, instanceId: 实例ID, level: 层级 }",
+            "type": "GoalItem"
           }
         }
       ],
       "slots": [],
       "methods": [
         {
-          "name": "setValue",
+          "name": "appendChildDone",
           "params": [
             {
-              "name": "value",
+              "name": "pendingId",
+              "description": "待定子目标的临时 instanceId",
               "type": "string"
+            },
+            {
+              "name": "newItem",
+              "description": "创建完成后的真实目标数据",
+              "type": "GoalItem"
             }
-          ]
-        },
-        {
-          "name": "getValue",
-          "params": []
-        },
-        {
-          "name": "focusOnInput",
-          "params": []
+          ],
+          "description": "将待定子目标提交为正式目标项",
+          "returns": {}
         }
       ],
       "parts": [],
-      "description": "大型聊天输入框，用于首页"
+      "description": "目标卡片列表，以分层卡片形式展示目标项，支持内联编辑标题、状态切换、新建对话及追加子目标。",
+      "category": "display-component"
     },
     {
-      "name": "ai-portal.action-buttons",
+      "name": "ai-portal.project-conversations",
       "properties": [
         {
-          "name": "items",
+          "name": "list",
           "attribute": false,
-          "type": "ActionItem[]"
+          "type": "Conversation[]"
         },
         {
-          "name": "activeKey",
-          "type": "string | null"
+          "name": "urlTemplate",
+          "type": "string"
+        },
+        {
+          "name": "actions",
+          "attribute": false,
+          "type": "ActionType[]"
+        },
+        {
+          "name": "goals",
+          "attribute": false,
+          "type": "Goal[]"
         }
       ],
       "events": [
         {
-          "name": "change",
+          "name": "goal.click",
           "detail": {
-            "type": "ActionItem | null"
+            "type": "Conversation"
+          }
+        },
+        {
+          "name": "action.click",
+          "detail": {
+            "type": "ActionClickDetail"
           }
         }
       ],
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.action-buttons`"
+      "description": "构件 `ai-portal.project-conversations`"
     },
     {
       "name": "ai-portal.project-knowledges",
       "properties": [
         {
           "name": "list",
+          "description": "知识列表数据，为 undefined 时显示加载状态",
           "attribute": false,
           "type": "Knowledge[]"
         },
         {
           "name": "urlTemplate",
+          "description": "知识详情链接模板，支持使用知识字段插值",
           "type": "string"
         },
         {
           "name": "actions",
+          "description": "操作菜单配置，每条知识行尾显示可操作的菜单项",
           "attribute": false,
           "type": "ActionType[]"
         }
@@ -976,13 +1245,17 @@
       "events": [
         {
           "name": "action.click",
+          "description": "",
           "detail": {
+            "description": "{ action: 操作项配置, item: 所属知识数据 }",
             "type": "ActionClickDetail"
           }
         },
         {
           "name": "item.click",
+          "description": "",
           "detail": {
+            "description": "{ instanceId: 知识ID, name: 知识名称, description: 描述, time: 时间戳, user: 创建人 }",
             "type": "Knowledge"
           }
         }
@@ -990,18 +1263,20 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.project-knowledges`"
+      "description": "构件 `ai-portal.project-knowledges`\n\n项目知识库列表构件，展示项目中的知识条目，支持操作菜单和点击跳转。"
     },
     {
       "name": "ai-portal.activity-timeline",
       "properties": [
         {
           "name": "list",
+          "description": "活动记录列表",
           "attribute": false,
           "type": "Activity[]"
         },
         {
           "name": "chatUrlTemplate",
+          "description": "跳转到对话详情页的 URL 模板，支持 {conversation_id} 等活动记录字段插值",
           "type": "string"
         }
       ],
@@ -1009,95 +1284,63 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.activity-timeline`"
-    },
-    {
-      "name": "ai-portal.project-conversations",
-      "properties": [
-        {
-          "name": "list",
-          "attribute": false,
-          "type": "Conversation[]"
-        },
-        {
-          "name": "urlTemplate",
-          "type": "string"
-        },
-        {
-          "name": "actions",
-          "attribute": false,
-          "type": "ActionType[]"
-        },
-        {
-          "name": "goals",
-          "attribute": false,
-          "type": "Goal[]"
-        }
-      ],
-      "events": [
-        {
-          "name": "goal.click",
-          "detail": {
-            "type": "Conversation"
-          }
-        },
-        {
-          "name": "action.click",
-          "detail": {
-            "type": "ActionClickDetail"
-          }
-        }
-      ],
-      "slots": [],
-      "methods": [],
-      "parts": [],
-      "description": "构件 `ai-portal.project-conversations`"
+      "description": "活动时间线，展示目标的操作历史记录，支持多种动作类型的可视化展示。",
+      "category": "ai-portal"
     },
     {
       "name": "ai-portal.chat-input",
       "properties": [
         {
           "name": "placeholder",
+          "description": "输入框占位文字",
           "type": "string"
         },
         {
           "name": "autoFocus",
+          "description": "是否自动聚焦",
           "type": "boolean"
         },
         {
           "name": "submitDisabled",
+          "description": "是否禁用发送按钮，通常在 AI 正在处理时设为 true",
           "type": "boolean"
         },
         {
           "name": "supportsTerminate",
+          "description": "是否显示终止任务按钮，需与 submitDisabled 配合使用",
           "type": "boolean"
         },
         {
           "name": "terminating",
+          "description": "是否正在终止任务，为 true 时显示加载状态",
           "type": "boolean"
         },
         {
           "name": "autoFade",
+          "description": "是否在输入框为空时自动淡出，通过 CSS 属性选择器控制样式",
           "type": "boolean"
         },
         {
           "name": "uploadOptions",
+          "description": "文件上传配置",
           "attribute": false,
           "type": "UploadOptions"
         },
         {
           "name": "aiEmployees",
+          "description": "可 @ 提及的数字人列表",
           "attribute": false,
           "type": "AIEmployee[]"
         },
         {
           "name": "commands",
+          "description": "命令列表，支持通过 / 或搜索触发联想",
           "attribute": false,
           "type": "Command[]"
         },
         {
           "name": "suggestionsPlacement",
-          "description": "",
+          "description": "命令/提及联想弹出层的显示位置",
           "default": "\"bottom\"",
           "type": "\"top\" | \"bottom\""
         }
@@ -1108,18 +1351,23 @@
           "description": "",
           "deprecated": "Use `chat.submit` event instead",
           "detail": {
+            "description": "用户输入的消息文本内容",
             "type": "string"
           }
         },
         {
           "name": "chat.submit",
+          "description": "",
           "detail": {
+            "description": "{ content: 消息内容, files: 上传的文件列表, cmd: 命令载荷, aiEmployeeId: @提及的数字人 ID }",
             "type": "ChatPayload"
           }
         },
         {
           "name": "terminate",
+          "description": "",
           "detail": {
+            "description": "void",
             "type": "void"
           }
         }
@@ -1131,13 +1379,17 @@
           "params": [
             {
               "name": "value",
+              "description": "要设置的文本内容",
               "type": "string"
             }
-          ]
+          ],
+          "description": "设置输入框的值并聚焦",
+          "returns": {}
         }
       ],
       "parts": [],
-      "description": "小型聊天输入框，用于对话等页面"
+      "description": "小型聊天输入框，用于对话等页面，支持命令联想、@提及数字人、文件上传及终止任务等功能。",
+      "category": "ai-portal"
     },
     {
       "name": "ai-portal.elevo-logo",
@@ -1146,21 +1398,25 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.elevo-logo`"
+      "description": "Elevo 品牌 Logo 图片组件，固定展示 Elevo logo（95×28px）。",
+      "category": "display-component"
     },
     {
       "name": "ai-portal.show-case",
       "properties": [
         {
           "name": "caseTitle",
+          "description": "案例标题，同时用于计算卡片背景色",
           "type": "string"
         },
         {
           "name": "summary",
+          "description": "案例摘要描述",
           "type": "string"
         },
         {
           "name": "url",
+          "description": "点击卡片跳转的目标链接",
           "type": "string"
         }
       ],
@@ -1168,17 +1424,19 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.show-case`"
+      "description": "构件 `ai-portal.show-case`\n\n案例展示卡片构件，以彩色背景卡片展示单个优秀案例，点击可跳转到案例详情。"
     },
     {
       "name": "ai-portal.blank-state",
       "properties": [
         {
           "name": "illustration",
+          "description": "插画类型，可选 \"goals\"、\"activities\"、\"collaboration-spaces\"、\"serviceflows\"，默认使用 activities 插画",
           "type": "BlankStateIllustration"
         },
         {
           "name": "description",
+          "description": "描述文字",
           "type": "string"
         }
       ],
@@ -1186,14 +1444,15 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.blank-state`"
+      "description": "空状态展示组件，提供预置插画和描述文字，并支持通过默认插槽插入自定义内容。",
+      "category": "ai-portal"
     },
     {
       "name": "ai-portal.sticky-container",
       "properties": [
         {
           "name": "variant",
-          "description": "",
+          "description": "变体风格，通过 CSS attribute selector 控制样式，不触发重新渲染",
           "default": "\"default\"",
           "type": "StickyContainerVariant"
         },
@@ -1220,7 +1479,7 @@
       ],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.sticky-container`"
+      "description": "构件 `ai-portal.sticky-container`\n\n粘性容器构件，使内容在页面滚动时固定在顶部。"
     },
     {
       "name": "ai-portal.elevo-card",
@@ -1248,10 +1507,20 @@
         }
       ],
       "events": [],
-      "slots": [],
+      "slots": [
+        {
+          "name": "actions",
+          "description": "卡片右上角操作区域"
+        },
+        {
+          "name": "footer",
+          "description": "卡片底部操作区域"
+        }
+      ],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.elevo-card`"
+      "description": "Elevo 风格的卡片组件，支持图标或图片头像、标题、描述、操作按钮及底部插槽。",
+      "category": "display-component"
     },
     {
       "name": "ai-portal.flow-tabs",
@@ -1270,72 +1539,71 @@
       "events": [
         {
           "name": "tab.click",
+          "description": "",
           "detail": {
+            "description": "{ id: 标签 ID, label: 标签显示文本 }",
             "type": "Tab"
           }
         }
       ],
-      "slots": [],
-      "methods": [],
-      "parts": [],
-      "description": "构件 `ai-portal.flow-tabs`"
-    },
-    {
-      "name": "ai-portal.running-flow",
-      "properties": [
+      "slots": [
         {
-          "name": "spec",
-          "attribute": false,
-          "type": "FlowStage[]"
-        }
-      ],
-      "events": [
+          "name": "toolbar",
+          "description": "标签栏右侧工具栏区域"
+        },
         {
-          "name": "activity.click",
-          "detail": {
-            "type": "string"
-          }
+          "name": "default",
+          "description": "标签页内容区域"
         }
       ],
-      "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.running-flow`"
+      "description": "流程标签页组件，提供带背景画布动效的标签导航，支持工具栏插槽和默认内容插槽。",
+      "category": "navigate"
     },
     {
       "name": "ai-portal.stage-flow",
       "properties": [
         {
           "name": "spec",
+          "description": "阶段流程配置数据，每个阶段包含名称和活动列表",
           "attribute": false,
           "type": "Stage[]"
         },
         {
           "name": "aiEmployees",
+          "description": "AI 员工列表，用于在活动中显示分配的员工名称",
           "attribute": false,
           "type": "AIEmployee[]"
         },
         {
           "name": "readOnly",
+          "description": "是否为只读模式，只读时不显示编辑、添加、删除操作",
           "type": "boolean"
         }
       ],
       "events": [
         {
           "name": "change",
+          "description": "",
           "detail": {
+            "description": "更新后的阶段列表",
             "type": "Stage[]"
           }
         },
         {
           "name": "add.activity",
+          "description": "",
           "detail": {
+            "description": "{ stage: 所属阶段数据 }",
             "type": "{ stage: Stage }"
           }
         },
         {
           "name": "edit.activity",
+          "description": "",
           "detail": {
+            "description": "{ stage: 所属阶段, activity: 活动数据, activityIndex: 活动索引 }",
             "type": "EditActivityDetail"
           }
         }
@@ -1347,47 +1615,85 @@
           "params": [
             {
               "name": "stage",
+              "description": "目标阶段",
               "type": "Stage"
             },
             {
               "name": "activity",
+              "description": "要添加的活动数据",
               "type": "FlowActivity"
             }
-          ]
+          ],
+          "description": "向指定阶段添加活动",
+          "returns": {}
         },
         {
           "name": "editActivity",
           "params": [
             {
               "name": "stage",
+              "description": "目标阶段",
               "type": "Stage"
             },
             {
               "name": "activity",
+              "description": "更新后的活动数据",
               "type": "FlowActivity"
             },
             {
               "name": "activityIndex",
+              "description": "活动在阶段中的索引",
               "type": "number"
             }
-          ]
+          ],
+          "description": "编辑指定阶段中的某个活动",
+          "returns": {}
         },
         {
           "name": "deleteActivity",
           "params": [
             {
               "name": "stage",
+              "description": "目标阶段",
               "type": "Stage"
             },
             {
               "name": "activityIndex",
+              "description": "活动在阶段中的索引",
               "type": "number"
             }
-          ]
+          ],
+          "description": "删除指定阶段中的某个活动",
+          "returns": {}
+        }
+      ],
+      "parts": [],
+      "description": "构件 `ai-portal.stage-flow`\n\n阶段流程编辑器构件，支持以泳道方式展示和编辑服务流的阶段与活动。"
+    },
+    {
+      "name": "ai-portal.running-flow",
+      "properties": [
+        {
+          "name": "spec",
+          "description": "流程阶段配置数据，每个阶段包含名称和活动列表",
+          "attribute": false,
+          "type": "FlowStage[]"
         }
       ],
+      "events": [
+        {
+          "name": "activity.click",
+          "description": "",
+          "detail": {
+            "description": "活动的 taskId",
+            "type": "string"
+          }
+        }
+      ],
+      "slots": [],
+      "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.stage-flow`"
+      "description": "构件 `ai-portal.running-flow`\n\n运行中的流程视图构件，以泳道方式展示各阶段的活动及其运行状态（completed、working、input-required 等）。"
     },
     {
       "name": "ai-portal.notice-dropdown",
@@ -1443,15 +1749,15 @@
       "events": [
         {
           "name": "notice.click",
-          "description": "消息项点击事件",
+          "description": "",
           "detail": {
-            "description": "消息 ID",
+            "description": "{ id: 消息ID, type: 消息类型, isRead: 是否已读, title: 标题, description: 描述, time: 时间戳, url: 详情链接 }",
             "type": "NoticeItem"
           }
         },
         {
           "name": "mark.all.read",
-          "description": "全部已读点击事件",
+          "description": "",
           "detail": {
             "type": "void"
           }
@@ -1528,45 +1834,52 @@
       "properties": [
         {
           "name": "panelTitle",
+          "description": "面板标题",
           "type": "string"
         },
         {
           "name": "aiEmployeeId",
+          "description": "预设数字人 ID，对话提交时会携带该 ID",
           "type": "string"
         },
         {
           "name": "cmd",
+          "description": "预设命令载荷，对话提交时会携带该命令",
           "attribute": false,
           "type": "CommandPayload"
         },
         {
           "name": "width",
+          "description": "面板宽度",
           "attribute": false,
           "type": "string | number"
         },
         {
           "name": "height",
+          "description": "面板高度",
           "attribute": false,
           "type": "string | number"
         },
         {
           "name": "placeholder",
+          "description": "输入框占位文字",
           "type": "string"
         },
         {
           "name": "uploadOptions",
+          "description": "文件上传配置",
           "attribute": false,
           "type": "UploadOptions"
         },
         {
           "name": "help",
-          "description": "Show help messages when no conversation exists.",
+          "description": "无对话时显示的帮助内容配置",
           "attribute": false,
-          "type": "{ useBrick: UseBrickConf }"
+          "type": "{ useBrick: UseBrickConfOrRenderFunction }"
         },
         {
           "name": "maskClosable",
-          "description": "Whether to close the panel when clicking the mask.",
+          "description": "是否点击遮罩关闭面板",
           "default": "false",
           "type": "boolean"
         }
@@ -1576,48 +1889,63 @@
       "methods": [
         {
           "name": "open",
-          "params": []
+          "params": [],
+          "description": "打开对话面板",
+          "returns": {}
         },
         {
           "name": "close",
-          "params": []
+          "params": [],
+          "description": "关闭对话面板",
+          "returns": {}
         },
         {
           "name": "setInputValue",
           "params": [
             {
               "name": "content",
+              "description": "要设置的文本内容",
               "type": "string"
             }
-          ]
+          ],
+          "description": "设置输入框的内容",
+          "returns": {}
         },
         {
           "name": "send",
           "params": [
             {
               "name": "payload",
+              "description": "消息载荷，包含文本内容及可选的文件、命令等",
               "type": "ChatPayload"
             }
-          ]
+          ],
+          "description": "直接发送一条消息",
+          "returns": {}
         },
         {
           "name": "showFile",
           "params": [
             {
               "name": "file",
+              "description": "要预览的文件信息",
               "type": "FileInfo"
             }
-          ]
+          ],
+          "description": "在面板中显示文件预览",
+          "returns": {}
         }
       ],
       "parts": [],
-      "description": "弹出式对话面板。"
+      "description": "弹出式 AI 对话面板，以模态框形式展示对话界面，支持与 AI 助手进行多轮对话。",
+      "category": "ai-portal"
     },
     {
       "name": "ai-portal.space-logo",
       "properties": [
         {
           "name": "size",
+          "description": "Logo 容器尺寸（px），图标为容器的 87.5%，圆角为容器的 25%，默认 48",
           "type": "number"
         }
       ],
@@ -1632,6 +1960,7 @@
       "properties": [
         {
           "name": "text",
+          "description": "欢迎语文本内容",
           "type": "string"
         }
       ],
@@ -1639,76 +1968,14 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.chat-panel-welcome`"
-    },
-    {
-      "name": "ai-portal.goal-card-list",
-      "properties": [
-        {
-          "name": "goalList",
-          "attribute": false,
-          "type": "GoalItem[]"
-        },
-        {
-          "name": "cardStyle",
-          "attribute": false,
-          "type": "React.CSSProperties"
-        },
-        {
-          "name": "activeKey",
-          "type": "string"
-        }
-      ],
-      "events": [
-        {
-          "name": "item.click",
-          "detail": {
-            "type": "GoalItem"
-          }
-        },
-        {
-          "name": "item.status.change",
-          "detail": {
-            "type": "GoalItem"
-          }
-        },
-        {
-          "name": "item.title.change",
-          "detail": {
-            "type": "GoalItem"
-          }
-        },
-        {
-          "name": "item.new.chat",
-          "detail": {
-            "type": "GoalItem"
-          }
-        }
-      ],
-      "slots": [],
-      "methods": [
-        {
-          "name": "appendChildDone",
-          "params": [
-            {
-              "name": "pendingId",
-              "type": "string"
-            },
-            {
-              "name": "newItem",
-              "type": "GoalItem"
-            }
-          ]
-        }
-      ],
-      "parts": [],
-      "description": "构件 `ai-portal.goal-card-list`"
+      "description": "构件 `ai-portal.chat-panel-welcome`\n\n聊天面板欢迎语构件，展示带有 Elevo 头像的欢迎消息。"
     },
     {
       "name": "ai-portal.space-chat-guide",
       "properties": [
         {
           "name": "spaceDetail",
+          "description": "空间详情信息，必填，用于展示空间相关的引导内容",
           "attribute": false,
           "type": "SpaceDetail"
         }
@@ -1717,32 +1984,37 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.space-chat-guide`"
+      "description": "构件 `ai-portal.space-chat-guide`\n\n空间聊天引导构件，根据空间详情展示引导信息，帮助用户快速开始聊天。"
     },
     {
       "name": "ai-portal.space-workbench",
       "properties": [
         {
           "name": "notices",
+          "description": "消息通知列表",
           "attribute": false,
           "type": "NoticeItem[]"
         },
         {
           "name": "knowledges",
+          "description": "知识库列表",
           "attribute": false,
           "type": "KnowledgeItem[]"
         },
         {
           "name": "spaceDetail",
+          "description": "空间详情信息，必填",
           "attribute": false,
           "type": "SpaceDetail"
         },
         {
           "name": "notifyCenterUrl",
+          "description": "消息中心跳转链接，必填",
           "type": "string"
         },
         {
           "name": "uploadOptions",
+          "description": "文件上传配置选项",
           "attribute": false,
           "type": "UploadOptions"
         }
@@ -1750,42 +2022,51 @@
       "events": [
         {
           "name": "go.back",
+          "description": "",
           "detail": {
             "type": "void"
           }
         },
         {
           "name": "members.click",
+          "description": "",
           "detail": {
             "type": "void"
           }
         },
         {
           "name": "notice.click",
+          "description": "",
           "detail": {
+            "description": "{ id: 消息ID, type: 消息类型, isRead: 是否已读, title: 标题, time: 时间戳 }",
             "type": "NoticeItem"
           }
         },
         {
           "name": "mark.all.read",
+          "description": "",
           "detail": {
             "type": "void"
           }
         },
         {
           "name": "space.edit",
+          "description": "",
           "detail": {
             "type": "void"
           }
         },
         {
           "name": "knowledge.click",
+          "description": "",
           "detail": {
+            "description": "知识条目数据",
             "type": "KnowledgeItem"
           }
         },
         {
           "name": "knowledge.add",
+          "description": "",
           "detail": {
             "type": "void"
           }
@@ -1794,7 +2075,7 @@
       "slots": [],
       "methods": [],
       "parts": [],
-      "description": "构件 `ai-portal.space-workbench`"
+      "description": "构件 `ai-portal.space-workbench`\n\n协作空间工作台，集成顶部导航、侧边栏（知识库、业务实例）、聊天区域和服务流等核心功能的一体化工作台构件。"
     }
   ],
   "providers": [