@next-bricks/ai-portal 0.70.1 → 0.70.3

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:
+        - 数据
 ```

package/docs/ai-agents.react.md

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

package/docs/ai-employees.md

@@ -1,11 +1,85 @@
-构件 `ai-portal.ai-employees`
+---
+tagName: ai-portal.ai-employees
+displayName: WrappedAiPortalAiEmployees
+description: AI 数字人卡片列表，按行业和角色分组展示，支持 Tab 切换行业和点击跳转。
+category: ai-portal
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.ai-employees
+
+> AI 数字人卡片列表，按行业和角色分组展示，支持 Tab 切换行业和点击跳转。
+
+## Props
+
+| 属性        | 类型                      | 必填 | 默认值 | 说明                                                                    |
+| ----------- | ------------------------- | ---- | ------ | ----------------------------------------------------------------------- |
+| list        | `Employee[] \| undefined` | 否   | -      | 数字人列表数据                                                          |
+| industries  | `string[] \| undefined`   | 否   | -      | 行业列表，用于指定 Tab 的顺序，未在此列表中的行业将按出现顺序附加在末尾 |
+| urlTemplate | `string \| undefined`     | 否   | -      | 跳转到数字人详情页的 URL 模板，支持 {name} 等数字人字段插值             |
+| stickyTop   | `number \| undefined`     | 否   | -      | 行业 Tab 栏吸顶时距顶部的距离（px），不设置则不吸顶                     |
 
 ## Examples
 
 ### Basic
 
+展示 AI 数字人卡片列表，按行业 Tab 分组浏览。
+
+```yaml preview
+brick: ai-portal.ai-employees
+properties:
+  list:
+    - name: 运维工程师小李
+      industry: IT
+      role: 运维专家
+      description: 专注于服务器运维和故障处理。
+    - name: 开发工程师小王
+      industry: IT
+      role: 开发专家
+      description: 擅长全栈开发和架构设计。
+    - name: 数据分析师小张
+      industry: 金融
+      role: 数据分析
+      description: 专注于金融数据分析和风险评估。
+```
+
+### With URL Template
+
+配置 urlTemplate 属性，使每个数字人卡片点击后跳转到对应详情页。
+
+```yaml preview
+brick: ai-portal.ai-employees
+properties:
+  urlTemplate: /employees/{name}
+  list:
+    - name: 运维工程师小李
+      industry: IT
+      role: 运维专家
+      description: 专注于服务器运维和故障处理。
+    - name: 开发工程师小王
+      industry: IT
+      role: 开发专家
+      description: 擅长全栈开发和架构设计。
+```
+
+### With Industries and Sticky Tab
+
+配置 industries 和 stickyTop 属性，控制行业 Tab 顺序及吸顶效果。
+
 ```yaml preview
 brick: ai-portal.ai-employees
 properties:
-  textContent: Hello world
+  industries:
+    - 金融
+    - IT
+  stickyTop: 0
+  list:
+    - name: 数据分析师小张
+      industry: 金融
+      role: 数据分析
+      description: 专注于金融数据分析和风险评估。
+    - name: 运维工程师小李
+      industry: IT
+      role: 运维专家
+      description: 专注于服务器运维和故障处理。
 ```