@next-bricks/ai-portal 0.70.0 → 0.70.2

package/dist-types/project-knowledges/index.d.ts

@@ -20,11 +20,16 @@ export interface ActionClickDetail {
 }
 /**
  * 构件 `ai-portal.project-knowledges`
+ *
+ * 项目知识库列表构件，展示项目中的知识条目，支持操作菜单和点击跳转。
  */
 export declare class ProjectKnowledges extends ReactNextElement implements ProjectKnowledgesProps {
     #private;
+    /** 知识列表数据，为 undefined 时显示加载状态 */
     accessor list: Knowledge[] | undefined;
+    /** 知识详情链接模板，支持使用知识字段插值 */
     accessor urlTemplate: string | undefined;
+    /** 操作菜单配置，每条知识行尾显示可操作的菜单项 */
     accessor actions: ActionType[] | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/running-flow/index.d.ts

@@ -24,9 +24,12 @@ export interface RunningFlowMapEvents {
 }
 /**
  * 构件 `ai-portal.running-flow`
+ *
+ * 运行中的流程视图构件，以泳道方式展示各阶段的活动及其运行状态（completed、working、input-required 等）。
  */
 export declare class RunningFlow extends ReactNextElement implements RunningFlowProps {
     #private;
+    /** 流程阶段配置数据，每个阶段包含名称和活动列表 */
     accessor spec: FlowStage[] | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/show-case/index.d.ts

@@ -8,10 +8,15 @@ export interface ShowCaseProps {
 }
 /**
  * 构件 `ai-portal.show-case`
+ *
+ * 案例展示卡片构件，以彩色背景卡片展示单个优秀案例，点击可跳转到案例详情。
  */
 export declare class ShowCase extends ReactNextElement implements ShowCaseProps {
+    /** 案例标题，同时用于计算卡片背景色 */
     accessor caseTitle: string | undefined;
+    /** 案例摘要描述 */
     accessor summary: string | undefined;
+    /** 点击卡片跳转的目标链接 */
     accessor url: string | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/show-cases/index.d.ts

@@ -8,9 +8,13 @@ export interface ShowCasesProps {
 }
 /**
  * 构件 `ai-portal.show-cases`
+ *
+ * 案例列表展示构件，支持按场景分组筛选，展示多个优秀案例卡片。
  */
 export declare class ShowCases extends ReactNextElement implements ShowCasesProps {
+    /** 案例数据列表，每项可包含 scenario 字段用于分组筛选 */
     accessor list: ShowCaseType[] | undefined;
+    /** 每个场景分组下最多显示的案例数量 */
     accessor limit: number | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/space-workbench/chat-panel-welcome/index.d.ts

@@ -6,8 +6,11 @@ export interface ChatPanelWelcomeProps {
 }
 /**
  * 构件 `ai-portal.chat-panel-welcome`
+ *
+ * 聊天面板欢迎语构件，展示带有 Elevo 头像的欢迎消息。
  */
 export declare class ChatPanelWelcome extends ReactNextElement implements ChatPanelWelcomeProps {
+    /** 欢迎语文本内容 */
     accessor text: string | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/space-workbench/index.d.ts

@@ -14,13 +14,20 @@ export interface SpaceWorkbenchProps {
 }
 /**
  * 构件 `ai-portal.space-workbench`
+ *
+ * 协作空间工作台，集成顶部导航、侧边栏（知识库、业务实例）、聊天区域和服务流等核心功能的一体化工作台构件。
  */
 export declare class SpaceWorkbench extends ReactNextElement implements SpaceWorkbenchProps {
     #private;
+    /** 消息通知列表 */
     accessor notices: NoticeItem[] | undefined;
+    /** 知识库列表 */
     accessor knowledges: KnowledgeItem[] | undefined;
+    /** 空间详情信息，必填 */
     accessor spaceDetail: SpaceDetail;
+    /** 消息中心跳转链接，必填 */
     accessor notifyCenterUrl: string;
+    /** 文件上传配置选项 */
     accessor uploadOptions: UploadOptions | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/space-workbench/space-chat-guide/index.d.ts

@@ -7,8 +7,11 @@ export interface SpaceChatGuideProps {
 }
 /**
  * 构件 `ai-portal.space-chat-guide`
+ *
+ * 空间聊天引导构件，根据空间详情展示引导信息，帮助用户快速开始聊天。
  */
 export declare class SpaceChatGuide extends ReactNextElement implements SpaceChatGuideProps {
+    /** 空间详情信息，必填，用于展示空间相关的引导内容 */
     accessor spaceDetail: SpaceDetail;
     render(): React.JSX.Element;
 }

package/dist-types/space-workbench/space-logo/index.d.ts

@@ -10,6 +10,7 @@ export interface SpaceLogoProps {
  * 协作空间的 Logo 展示组件
  */
 export declare class SpaceLogo extends ReactNextElement implements SpaceLogoProps {
+    /** Logo 容器尺寸（px），图标为容器的 87.5%，圆角为容器的 25%，默认 48 */
     accessor size: number | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/stage-flow/index.d.ts

@@ -28,14 +28,35 @@ export interface EditActivityDetail {
 }
 /**
  * 构件 `ai-portal.stage-flow`
+ *
+ * 阶段流程编辑器构件，支持以泳道方式展示和编辑服务流的阶段与活动。
  */
 export declare class StageFlow extends ReactNextElement implements StageFlowProps {
     #private;
+    /** 阶段流程配置数据，每个阶段包含名称和活动列表 */
     accessor spec: Stage[] | undefined;
+    /** AI 员工列表，用于在活动中显示分配的员工名称 */
     accessor aiEmployees: AIEmployee[] | undefined;
+    /** 是否为只读模式，只读时不显示编辑、添加、删除操作 */
     accessor readOnly: boolean | undefined;
+    /**
+     * 向指定阶段添加活动
+     * @param stage 目标阶段
+     * @param activity 要添加的活动数据
+     */
     addActivity(stage: Stage, activity: FlowActivity): void;
+    /**
+     * 编辑指定阶段中的某个活动
+     * @param stage 目标阶段
+     * @param activity 更新后的活动数据
+     * @param activityIndex 活动在阶段中的索引
+     */
     editActivity(stage: Stage, activity: FlowActivity, activityIndex: number): void;
+    /**
+     * 删除指定阶段中的某个活动
+     * @param stage 目标阶段
+     * @param activityIndex 活动在阶段中的索引
+     */
     deleteActivity(stage: Stage, activityIndex: number): void;
     render(): React.JSX.Element;
 }

package/dist-types/stat-with-mini-chart/index.d.ts

@@ -9,18 +9,25 @@ export interface StatWithMiniChartProps extends Pick<MiniLineChartProps, "data"
 }
 /**
  * 构件 `ai-portal.stat-with-mini-chart`
+ *
+ * 带迷你折线图的统计数据展示构件，在统计数值旁边渲染一个迷你折线图。
  */
 export declare class StatWithMiniChart extends ReactNextElement implements StatWithMiniChartProps {
+    /** 统计指标标签名称 */
     accessor label: string | undefined;
+    /** 统计数值文本 */
     accessor value: string | undefined;
     /**
+     * 展示尺寸，medium 时图表高度为 92px，small 时为 55px
      * @default "medium"
      */
     accessor size: "medium" | "small" | undefined;
     /**
+     * 折线颜色
      * @default "var(--color-brand)"
      */
     accessor lineColor: string | undefined;
+    /** 是否在折线下方显示渐变填充区域 */
     accessor showArea: boolean | undefined;
     /**
      * Specify the minimum value of the y-axis.
@@ -33,13 +40,16 @@ export declare class StatWithMiniChart extends ReactNextElement implements StatW
      */
     accessor max: number | undefined;
     /**
+     * x 轴字段名（数据中时间字段的 key）
      * @default "0"
      */
     accessor xField: string | undefined;
     /**
+     * y 轴字段名（数据中数值字段的 key）
      * @default "1"
      */
     accessor yField: string | undefined;
+    /** 图表数据源，每项为包含 xField 和 yField 字段的对象 */
     accessor data: Record<string, number>[] | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/sticky-container/index.d.ts

@@ -8,12 +8,15 @@ export type StickyContainerVariant = "default" | "home";
 /**
  * 构件 `ai-portal.sticky-container`
  *
+ * 粘性容器构件，使内容在页面滚动时固定在顶部。
+ *
  * @slot - 内容
  * @slot header - 头部
  * @slot toolbar - 工具栏
  */
 export declare class StickyContainer extends ReactNextElement implements StickyContainerProps {
     /**
+     * 变体风格，通过 CSS attribute selector 控制样式，不触发重新渲染
      * @default "default"
      */
     accessor variant: StickyContainerVariant | undefined;

package/dist-types/tab-list/index.d.ts

@@ -18,12 +18,16 @@ export interface TabListMapping {
 /**
  * 构件 `ai-portal.tab-list`
  *
+ * 标签页列表构件，展示可切换的标签页，点击后触发事件并自动更新选中状态。
+ *
  * @part tabs - The tab list container
  * @part tab - The individual tab
  */
 export declare class TabList extends ReactNextElement implements TabListProps {
     #private;
+    /** 标签页配置列表，每项包含 id 和 label */
     accessor tabs: Tab[] | undefined;
+    /** 当前激活的标签页 id */
     accessor activeTab: string | undefined;
     render(): React.JSX.Element;
 }

package/docs/action-buttons.md

@@ -1,31 +1,80 @@
-构件 `ai-portal.action-buttons`
+---
+tagName: ai-portal.action-buttons
+displayName: WrappedAiPortalActionButtons
+description: 动作按钮组，支持选中状态切换，用于聊天框的功能入口。
+category: ai-portal
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.action-buttons
+
+> 动作按钮组，支持选中状态切换，用于聊天框的功能入口。
+
+## Props
+
+| 属性      | 类型                          | 必填 | 默认值 | 说明                                                       |
+| --------- | ----------------------------- | ---- | ------ | ---------------------------------------------------------- |
+| items     | `ActionItem[] \| undefined`   | 否   | -      | 按钮列表配置，每项包含文本、唯一键值及可选图标             |
+| activeKey | `string \| null \| undefined` | 否   | -      | 当前选中按钮的键值，选中后显示删除图标，再次点击可取消选中 |
+
+## Events
+
+| 事件   | detail                                                                                                                          | 说明                         |
+| ------ | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
+| change | `ActionItem \| null` — { key: 按钮键值, text: 按钮文本, icon: 按钮图标 } \| null — 选中时为选中的 ActionItem，取消选中时为 null | 选中或取消选中动作按钮时触发 |
 
 ## Examples
 
 ### Basic
 
+展示动作按钮组的基本用法，点击按钮切换选中状态。
+
 ```yaml preview
 brick: ai-portal.chat-box
 children:
   - brick: ai-portal.action-buttons
+    slot: actions
     properties:
       items:
-        - event: think
+        - key: think
           text: 深度思考
           icon:
-            - lib: antd
-              theme: outlined
-              icon: reddit
-        - event: networking
+            lib: antd
+            theme: outlined
+            icon: reddit
+        - key: networking
           text: 联网搜索
           icon:
             lib: antd
             theme: outlined
             icon: global
     events:
-      think:
-        action: console.log
-      networking:
+      change:
         action: console.log
-    slot: actions
+```
+
+### With activeKey
+
+通过 `activeKey` 属性预设选中的按钮。
+
+```yaml preview
+brick: ai-portal.action-buttons
+properties:
+  activeKey: think
+  items:
+    - key: think
+      text: 深度思考
+      icon:
+        lib: antd
+        theme: outlined
+        icon: reddit
+    - key: networking
+      text: 联网搜索
+      icon:
+        lib: antd
+        theme: outlined
+        icon: global
+events:
+  change:
+    action: console.log
 ```

package/docs/action-buttons.react.md

@@ -0,0 +1,80 @@
+---
+tagName: ai-portal.action-buttons
+displayName: WrappedAiPortalActionButtons
+description: 动作按钮组，支持选中状态切换，用于聊天框的功能入口。
+category: ai-portal
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalActionButtons
+
+> 动作按钮组，支持选中状态切换，用于聊天框的功能入口。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalActionButtons } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性      | 类型                          | 必填 | 默认值 | 说明                                                       |
+| --------- | ----------------------------- | ---- | ------ | ---------------------------------------------------------- |
+| items     | `ActionItem[] \| undefined`   | 否   | -      | 按钮列表配置，每项包含文本、唯一键值及可选图标             |
+| activeKey | `string \| null \| undefined` | 否   | -      | 当前选中按钮的键值，选中后显示删除图标，再次点击可取消选中 |
+
+## Events
+
+| 事件     | detail                                                                                                                          | 说明                         |
+| -------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
+| onChange | `ActionItem \| null` — { key: 按钮键值, text: 按钮文本, icon: 按钮图标 } \| null — 选中时为选中的 ActionItem，取消选中时为 null | 选中或取消选中动作按钮时触发 |
+
+## Examples
+
+### Basic
+
+展示动作按钮组的基本用法，点击按钮切换选中状态。
+
+```tsx
+<WrappedAiPortalChatBox>
+  <WrappedAiPortalActionButtons
+    slot="actions"
+    items={[
+      {
+        key: "think",
+        text: "深度思考",
+        icon: { lib: "antd", theme: "outlined", icon: "reddit" },
+      },
+      {
+        key: "networking",
+        text: "联网搜索",
+        icon: { lib: "antd", theme: "outlined", icon: "global" },
+      },
+    ]}
+    onChange={(e) => console.log(e.detail)}
+  />
+</WrappedAiPortalChatBox>
+```
+
+### With activeKey
+
+通过 `activeKey` 属性预设选中的按钮。
+
+```tsx
+<WrappedAiPortalActionButtons
+  activeKey="think"
+  items={[
+    {
+      key: "think",
+      text: "深度思考",
+      icon: { lib: "antd", theme: "outlined", icon: "reddit" },
+    },
+    {
+      key: "networking",
+      text: "联网搜索",
+      icon: { lib: "antd", theme: "outlined", icon: "global" },
+    },
+  ]}
+  onChange={(e) => console.log(e.detail)}
+/>
+```

package/docs/activity-timeline.md

@@ -1,9 +1,28 @@
-构件 `ai-portal.activity-timeline`
+---
+tagName: ai-portal.activity-timeline
+displayName: WrappedAiPortalActivityTimeline
+description: 活动时间线，展示目标的操作历史记录，支持多种动作类型的可视化展示。
+category: ai-portal
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.activity-timeline
+
+> 活动时间线，展示目标的操作历史记录，支持多种动作类型的可视化展示。
+
+## Props
+
+| 属性            | 类型                      | 必填 | 默认值 | 说明                                                                   |
+| --------------- | ------------------------- | ---- | ------ | ---------------------------------------------------------------------- |
+| list            | `Activity[] \| undefined` | 否   | -      | 活动记录列表                                                           |
+| chatUrlTemplate | `string \| undefined`     | 否   | -      | 跳转到对话详情页的 URL 模板，支持 {conversation_id} 等活动记录字段插值 |
 
 ## Examples
 
 ### Basic
 
+展示活动时间线的基本用法，渲染包含多种动作类型的操作历史记录。
+
 ```yaml preview
 brick: ai-portal.activity-timeline
 properties:
@@ -18,7 +37,8 @@ properties:
       time: 1757863597
       metadata:
         after:
-          user_name: Lucy
+          owner:
+            user_name: Lucy
     - user_id: u002
       user_name: Lucy
       action_type: start_conversation
@@ -33,18 +53,20 @@ properties:
       metadata:
         sub_goals_count: 2
         sub_goals:
-          - title: "先计划"
-          - title: "再执行"
+          - title: 先计划
+          - title: 再执行
     - user_id: u002
       user_name: Lucy
       action_type: alter_user
       time: 1757904096
       metadata:
         before:
-          - user_name: Jim
+          users:
+            - user_name: Jim
         after:
-          - user_name: Joy
-          - user_name: Green
+          users:
+            - user_name: Joy
+            - user_name: Green
     - user_id: u001
       user_name: Tom
       action_type: add_comment
@@ -52,3 +74,25 @@ properties:
       metadata:
         comment_content: Good!
 ```
+
+### With Chat URL Template
+
+配置 chatUrlTemplate 属性，使对话链接可点击跳转。
+
+```yaml preview
+brick: ai-portal.activity-timeline
+properties:
+  chatUrlTemplate: /chat/{conversation_id}
+  list:
+    - user_id: u002
+      user_name: Lucy
+      action_type: start_conversation
+      time: 1757904096
+      metadata:
+        conversation_id: c001
+        conversation_title: 项目规划
+    - user_id: u001
+      user_name: Tom
+      action_type: create_goal
+      time: 1757853597
+```

package/docs/activity-timeline.react.md

@@ -0,0 +1,109 @@
+---
+tagName: ai-portal.activity-timeline
+displayName: WrappedAiPortalActivityTimeline
+description: 活动时间线，展示目标的操作历史记录，支持多种动作类型的可视化展示。
+category: ai-portal
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalActivityTimeline
+
+> 活动时间线，展示目标的操作历史记录，支持多种动作类型的可视化展示。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalActivityTimeline } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性            | 类型                      | 必填 | 默认值 | 说明                                                                   |
+| --------------- | ------------------------- | ---- | ------ | ---------------------------------------------------------------------- |
+| list            | `Activity[] \| undefined` | 否   | -      | 活动记录列表                                                           |
+| chatUrlTemplate | `string \| undefined`     | 否   | -      | 跳转到对话详情页的 URL 模板，支持 {conversation_id} 等活动记录字段插值 |
+
+## Examples
+
+### Basic
+
+展示活动时间线的基本用法，渲染包含多种动作类型的操作历史记录。
+
+```tsx
+<WrappedAiPortalActivityTimeline
+  list={[
+    {
+      user_id: "u001",
+      user_name: "Tom",
+      action_type: "create_goal",
+      time: 1757853597,
+    },
+    {
+      user_id: "u001",
+      user_name: "Tom",
+      action_type: "alter_owner",
+      time: 1757863597,
+      metadata: { after: { owner: { user_name: "Lucy" } } },
+    },
+    {
+      user_id: "u002",
+      user_name: "Lucy",
+      action_type: "start_conversation",
+      time: 1757904096,
+      metadata: { conversation_id: "c001", conversation_title: "项目规划" },
+    },
+    {
+      user_id: "u002",
+      user_name: "Lucy",
+      action_type: "decompose_goals",
+      time: 1757904096,
+      metadata: {
+        sub_goals_count: 2,
+        sub_goals: [{ title: "先计划" }, { title: "再执行" }],
+      },
+    },
+    {
+      user_id: "u002",
+      user_name: "Lucy",
+      action_type: "alter_user",
+      time: 1757904096,
+      metadata: {
+        before: { users: [{ user_name: "Jim" }] },
+        after: { users: [{ user_name: "Joy" }, { user_name: "Green" }] },
+      },
+    },
+    {
+      user_id: "u001",
+      user_name: "Tom",
+      action_type: "add_comment",
+      time: 1757904096,
+      metadata: { comment_content: "Good!" },
+    },
+  ]}
+/>
+```
+
+### With Chat URL Template
+
+配置 chatUrlTemplate 属性，使对话链接可点击跳转。
+
+```tsx
+<WrappedAiPortalActivityTimeline
+  chatUrlTemplate="/chat/{conversation_id}"
+  list={[
+    {
+      user_id: "u002",
+      user_name: "Lucy",
+      action_type: "start_conversation",
+      time: 1757904096,
+      metadata: { conversation_id: "c001", conversation_title: "项目规划" },
+    },
+    {
+      user_id: "u001",
+      user_name: "Tom",
+      action_type: "create_goal",
+      time: 1757853597,
+    },
+  ]}
+/>
+```

package/docs/ai-agents.md

@@ -1,11 +1,71 @@
-构件 `ai-portal.ai-agents`
+---
+tagName: ai-portal.ai-agents
+displayName: WrappedAiPortalAiAgents
+description: AI Agents 卡片列表，展示可用的 AI 智能体，支持点击跳转到对应详情页。
+category: ai-portal
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.ai-agents
+
+> AI Agents 卡片列表，展示可用的 AI 智能体，支持点击跳转到对应详情页。
+
+## Props
+
+| 属性        | 类型                   | 必填 | 默认值 | 说明                                                          |
+| ----------- | ---------------------- | ---- | ------ | ------------------------------------------------------------- |
+| list        | `Agent[] \| undefined` | 否   | -      | AI Agent 列表数据                                             |
+| urlTemplate | `string \| undefined`  | 否   | -      | 跳转到 Agent 详情页的 URL 模板，支持 {name} 等 Agent 字段插值 |
 
 ## Examples
 
 ### Basic
 
+展示 AI Agents 卡片列表的基本用法。
+
+```yaml preview
+brick: ai-portal.ai-agents
+properties:
+  list:
+    - name: 运维专家
+      description: 擅长处理服务器运维、故障排查和性能优化等问题。
+      icon:
+        lib: antd
+        icon: tool
+      tags:
+        - 运维
+        - 故障排查
+    - name: 数据分析师
+      description: 专注于数据处理、报表生成和趋势分析。
+      icon:
+        lib: antd
+        icon: bar-chart
+      tags:
+        - 数据
+        - 分析
+```
+
+### With URL Template
+
+配置 urlTemplate 属性，使每个 Agent 卡片点击后跳转到对应详情页。
+
 ```yaml preview
 brick: ai-portal.ai-agents
 properties:
-  textContent: Hello world
+  urlTemplate: /agents/{name}
+  list:
+    - name: 运维专家
+      description: 擅长处理服务器运维、故障排查和性能优化等问题。
+      icon:
+        lib: antd
+        icon: tool
+      tags:
+        - 运维
+    - name: 数据分析师
+      description: 专注于数据处理、报表生成和趋势分析。
+      icon:
+        lib: antd
+        icon: bar-chart
+      tags:
+        - 数据
 ```