@next-bricks/ai-portal 0.70.1 → 0.70.3

package/docs/project-conversations.react.md

@@ -0,0 +1,110 @@
+---
+tagName: ai-portal.project-conversations
+displayName: WrappedAiPortalProjectConversations
+description: 项目会话列表构件，展示项目中的会话记录，支持目标分类、操作菜单。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalProjectConversations
+
+> 项目会话列表构件，展示项目中的会话记录，支持目标分类、操作菜单。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalProjectConversations } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性        | 类型             | 必填 | 默认值 | 说明                                                                         |
+| ----------- | ---------------- | ---- | ------ | ---------------------------------------------------------------------------- |
+| list        | `Conversation[]` | 否   | -      | 会话列表数据，为 undefined 时显示加载状态                                    |
+| urlTemplate | `string`         | 否   | -      | 会话详情链接模板，支持使用会话字段插值，如 /conversations/{{conversationId}} |
+| actions     | `ActionType[]`   | 否   | -      | 操作菜单配置，每项会话行尾显示可操作的菜单项                                 |
+| goals       | `Goal[]`         | 否   | -      | 目标列表，用于显示会话关联的目标名称                                         |
+
+## Events
+
+| 事件          | detail                                                                                                        | 说明                         |
+| ------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------- |
+| onGoalClick   | `Conversation` — { conversationId: 会话ID, title: 会话标题, startTime: 开始时间, goalInstanceId: 目标实例ID } | 点击会话关联的目标标签时触发 |
+| onActionClick | `ActionClickDetail` — { action: 操作项配置, item: 所属会话数据 }                                              | 点击操作菜单项时触发         |
+
+## Examples
+
+### 基础使用
+
+展示会话列表，当 list 为 undefined 时显示加载态。
+
+```tsx
+<WrappedAiPortalProjectConversations
+  list={[
+    {
+      conversationId: "conv-a",
+      title: "标题一",
+      description: "这是一段描述",
+      startTime: 1757904096,
+    },
+    { conversationId: "conv-b", title: "标题二", startTime: 1757863597 },
+  ]}
+/>
+```
+
+### 带目标分类
+
+配置 goals 后会话卡片会显示关联的目标名称标签。
+
+```tsx
+<WrappedAiPortalProjectConversations
+  goals={[
+    { instanceId: "GOAL0001", title: "提升研发效率" },
+    { instanceId: "GOAL0002", title: "降低故障率" },
+  ]}
+  list={[
+    {
+      conversationId: "conv-a",
+      title: "关联目标的会话",
+      startTime: 1757904096,
+      goalInstanceId: "GOAL0001",
+    },
+    {
+      conversationId: "conv-b",
+      title: "全局会话（无目标）",
+      startTime: 1757863597,
+    },
+  ]}
+/>
+```
+
+### 带操作菜单
+
+配置 actions 后每行显示可操作的菜单项。
+
+```tsx
+<WrappedAiPortalProjectConversations
+  actions={[
+    { text: "删除", event: "delete", icon: { lib: "antd", icon: "delete" } },
+  ]}
+  list={[
+    {
+      conversationId: "conv-a",
+      title: "会话标题一",
+      description: "这是一段描述",
+      startTime: 1757904096,
+      username: "alice",
+    },
+    { conversationId: "conv-b", title: "会话标题二", startTime: 1757863597 },
+  ]}
+  onActionClick={(e) => console.log("操作点击:", e.detail)}
+/>
+```
+
+### 加载状态
+
+list 为 undefined 时显示加载中状态。
+
+```tsx
+<WrappedAiPortalProjectConversations />
+```

package/docs/project-knowledges.md

@@ -1,23 +1,88 @@
-构件 `ai-portal.project-knowledges`
+---
+tagName: ai-portal.project-knowledges
+displayName: WrappedAiPortalProjectKnowledges
+description: 项目知识库列表构件，展示项目中的知识条目，支持操作菜单和点击跳转。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.project-knowledges
+
+> 项目知识库列表构件，展示项目中的知识条目，支持操作菜单和点击跳转。
+
+## Props
+
+| 属性        | 类型           | 必填 | 默认值 | 说明                                         |
+| ----------- | -------------- | ---- | ------ | -------------------------------------------- |
+| list        | `Knowledge[]`  | 否   | -      | 知识列表数据，为 undefined 时显示加载状态    |
+| urlTemplate | `string`       | 否   | -      | 知识详情链接模板，支持使用知识字段插值       |
+| actions     | `ActionType[]` | 否   | -      | 操作菜单配置，每条知识行尾显示可操作的菜单项 |
+
+## Events
+
+| 事件         | detail                                                                                              | 说明                 |
+| ------------ | --------------------------------------------------------------------------------------------------- | -------------------- |
+| action.click | `ActionClickDetail` — { action: 操作项配置, item: 所属知识数据 }                                    | 点击操作菜单项时触发 |
+| item.click   | `Knowledge` — { instanceId: 知识ID, name: 知识名称, description: 描述, time: 时间戳, user: 创建人 } | 点击知识条目时触发   |
 
 ## Examples
 
-### Basic
+### 基础使用
+
+展示知识库列表，当 list 为 undefined 时显示加载态。
+
+```yaml preview
+brick: ai-portal.project-knowledges
+properties:
+  list:
+    - instanceId: "knowledge-a"
+      name: "服务器排查手册"
+      description: "包含常见服务器故障的排查步骤"
+      time: 1757904096
+      user: "alice"
+    - instanceId: "knowledge-b"
+      name: "数据库优化指南"
+      time: 1757863597
+```
+
+### 带操作菜单
+
+配置 actions 后每条知识行尾显示可操作的菜单项。
 
 ```yaml preview
 brick: ai-portal.project-knowledges
 properties:
+  actions:
+    - text: "删除"
+      event: "delete"
+      icon:
+        lib: "antd"
+        icon: "delete"
   list:
-    - knowledgeId: "knowledge-a"
-      title: 标题一
-      description: 这是一段描述
+    - instanceId: "knowledge-a"
+      name: "服务器排查手册"
+      description: "包含常见服务器故障的排查步骤"
       time: 1757904096
-    - knowledgeId: "knowledge-b"
-      title: 标题二
+      user: "alice"
+    - instanceId: "knowledge-b"
+      name: "数据库优化指南"
       time: 1757863597
+events:
+  action.click:
+    action: console.log
+    args:
+      - "操作点击:"
+      - "<% EVENT.detail %>"
+  item.click:
+    action: console.log
+    args:
+      - "知识点击:"
+      - "<% EVENT.detail %>"
 ```
 
-### Loading
+### 加载状态
+
+list 为 undefined 时显示加载中状态。
 
 ```yaml preview
 brick: ai-portal.project-knowledges

package/docs/project-knowledges.react.md

@@ -0,0 +1,85 @@
+---
+tagName: ai-portal.project-knowledges
+displayName: WrappedAiPortalProjectKnowledges
+description: 项目知识库列表构件，展示项目中的知识条目，支持操作菜单和点击跳转。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalProjectKnowledges
+
+> 项目知识库列表构件，展示项目中的知识条目，支持操作菜单和点击跳转。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalProjectKnowledges } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性        | 类型           | 必填 | 默认值 | 说明                                         |
+| ----------- | -------------- | ---- | ------ | -------------------------------------------- |
+| list        | `Knowledge[]`  | 否   | -      | 知识列表数据，为 undefined 时显示加载状态    |
+| urlTemplate | `string`       | 否   | -      | 知识详情链接模板，支持使用知识字段插值       |
+| actions     | `ActionType[]` | 否   | -      | 操作菜单配置，每条知识行尾显示可操作的菜单项 |
+
+## Events
+
+| 事件          | detail                                                                                              | 说明                 |
+| ------------- | --------------------------------------------------------------------------------------------------- | -------------------- |
+| onActionClick | `ActionClickDetail` — { action: 操作项配置, item: 所属知识数据 }                                    | 点击操作菜单项时触发 |
+| onItemClick   | `Knowledge` — { instanceId: 知识ID, name: 知识名称, description: 描述, time: 时间戳, user: 创建人 } | 点击知识条目时触发   |
+
+## Examples
+
+### 基础使用
+
+展示知识库列表，当 list 为 undefined 时显示加载态。
+
+```tsx
+<WrappedAiPortalProjectKnowledges
+  list={[
+    {
+      instanceId: "knowledge-a",
+      name: "服务器排查手册",
+      description: "包含常见服务器故障的排查步骤",
+      time: 1757904096,
+      user: "alice",
+    },
+    { instanceId: "knowledge-b", name: "数据库优化指南", time: 1757863597 },
+  ]}
+/>
+```
+
+### 带操作菜单
+
+配置 actions 后每条知识行尾显示可操作的菜单项。
+
+```tsx
+<WrappedAiPortalProjectKnowledges
+  actions={[
+    { text: "删除", event: "delete", icon: { lib: "antd", icon: "delete" } },
+  ]}
+  list={[
+    {
+      instanceId: "knowledge-a",
+      name: "服务器排查手册",
+      description: "包含常见服务器故障的排查步骤",
+      time: 1757904096,
+      user: "alice",
+    },
+    { instanceId: "knowledge-b", name: "数据库优化指南", time: 1757863597 },
+  ]}
+  onActionClick={(e) => console.log("操作点击:", e.detail)}
+  onItemClick={(e) => console.log("知识点击:", e.detail)}
+/>
+```
+
+### 加载状态
+
+list 为 undefined 时显示加载中状态。
+
+```tsx
+<WrappedAiPortalProjectKnowledges />
+```

package/docs/running-flow.md

@@ -1,8 +1,32 @@
-构件 `ai-portal.running-flow`
+---
+tagName: ai-portal.running-flow
+displayName: WrappedAiPortalRunningFlow
+description: 运行中的流程视图构件，以泳道方式展示各阶段的活动及其运行状态。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.running-flow
+
+> 运行中的流程视图构件，以泳道方式展示各阶段的活动及其运行状态（completed、working、input-required 等）。
+
+## Props
+
+| 属性 | 类型          | 必填 | 默认值 | 说明                                         |
+| ---- | ------------- | ---- | ------ | -------------------------------------------- |
+| spec | `FlowStage[]` | 否   | -      | 流程阶段配置数据，每个阶段包含名称和活动列表 |
+
+## Events
+
+| 事件           | detail                   | 说明                                       |
+| -------------- | ------------------------ | ------------------------------------------ |
+| activity.click | `string` — 活动的 taskId | 点击活动时触发，仅当活动有 taskId 时可触发 |
 
 ## Examples
 
-### Basic
+### 基础使用
+
+以泳道方式展示多阶段流程及各活动状态。
 
 ```yaml preview
 brick: ai-portal.running-flow
@@ -20,3 +44,34 @@ properties:
           state: working
         - name: sprinting
 ```
+
+### 带点击事件
+
+配置 taskId 后活动可点击，点击时触发 activity.click 事件。
+
+```yaml preview
+brick: ai-portal.running-flow
+properties:
+  spec:
+    - name: 需求阶段
+      serviceFlowActivities:
+        - name: 需求收集
+          taskId: "task-001"
+          state: completed
+          startTime: 1757800000
+          endTime: 1757810000
+        - name: 需求评审
+          taskId: "task-002"
+          state: working
+          startTime: 1757810000
+    - name: 开发阶段
+      serviceFlowActivities:
+        - name: 编码实现
+          taskId: "task-003"
+events:
+  activity.click:
+    action: console.log
+    args:
+      - "活动点击，taskId:"
+      - "<% EVENT.detail %>"
+```

package/docs/running-flow.react.md

@@ -0,0 +1,90 @@
+---
+tagName: ai-portal.running-flow
+displayName: WrappedAiPortalRunningFlow
+description: 运行中的流程视图构件，以泳道方式展示各阶段的活动及其运行状态。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalRunningFlow
+
+> 运行中的流程视图构件，以泳道方式展示各阶段的活动及其运行状态（completed、working、input-required 等）。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalRunningFlow } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性 | 类型          | 必填 | 默认值 | 说明                                         |
+| ---- | ------------- | ---- | ------ | -------------------------------------------- |
+| spec | `FlowStage[]` | 否   | -      | 流程阶段配置数据，每个阶段包含名称和活动列表 |
+
+## Events
+
+| 事件            | detail                   | 说明                                       |
+| --------------- | ------------------------ | ------------------------------------------ |
+| onActivityClick | `string` — 活动的 taskId | 点击活动时触发，仅当活动有 taskId 时可触发 |
+
+## Examples
+
+### 基础使用
+
+以泳道方式展示多阶段流程及各活动状态。
+
+```tsx
+<WrappedAiPortalRunningFlow
+  spec={[
+    {
+      name: "Requirement",
+      serviceFlowActivities: [
+        { name: "Requirement collects", state: "completed" },
+        { name: "Requirement documents", state: "input-required" },
+      ],
+    },
+    {
+      name: "Sprint Planning",
+      serviceFlowActivities: [
+        { name: "planning", state: "working" },
+        { name: "sprinting" },
+      ],
+    },
+  ]}
+/>
+```
+
+### 带点击事件
+
+配置 taskId 后活动可点击，点击时触发 onActivityClick 事件。
+
+```tsx
+<WrappedAiPortalRunningFlow
+  spec={[
+    {
+      name: "需求阶段",
+      serviceFlowActivities: [
+        {
+          name: "需求收集",
+          taskId: "task-001",
+          state: "completed",
+          startTime: 1757800000,
+          endTime: 1757810000,
+        },
+        {
+          name: "需求评审",
+          taskId: "task-002",
+          state: "working",
+          startTime: 1757810000,
+        },
+      ],
+    },
+    {
+      name: "开发阶段",
+      serviceFlowActivities: [{ name: "编码实现", taskId: "task-003" }],
+    },
+  ]}
+  onActivityClick={(e) => console.log("活动点击，taskId:", e.detail)}
+/>
+```

package/docs/show-case.md

@@ -1,13 +1,58 @@
-构件 `ai-portal.show-case`
+---
+tagName: ai-portal.show-case
+displayName: WrappedAiPortalShowCase
+description: 案例展示卡片构件，以彩色背景卡片展示单个优秀案例，点击可跳转到案例详情。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.show-case
+
+> 案例展示卡片构件，以彩色背景卡片展示单个优秀案例，点击可跳转到案例详情。
+
+## Props
+
+| 属性      | 类型     | 必填 | 默认值 | 说明                             |
+| --------- | -------- | ---- | ------ | -------------------------------- |
+| caseTitle | `string` | 否   | -      | 案例标题，同时用于计算卡片背景色 |
+| summary   | `string` | 否   | -      | 案例摘要描述                     |
+| url       | `string` | 否   | -      | 点击卡片跳转的目标链接           |
 
 ## Examples
 
-### Basic
+### 基础使用
+
+展示带标题、描述和跳转链接的案例卡片，背景色由标题内容决定。
 
 ```yaml preview
 brick: ai-portal.show-case
 properties:
-  conversationId: c-1
   caseTitle: 故障排查－操作系统内存高
   summary: 服务已经正常启动，正常运行，但用户在外部访问失败服务已经正常启动，正常运行但用户正常运行
+  url: "/cases/memory-issue"
+```
+
+### 多个卡片对比
+
+不同标题产生不同背景色。
+
+```yaml preview
+brick: div
+properties:
+  style:
+    display: flex
+    gap: 16px
+children:
+  - brick: ai-portal.show-case
+    properties:
+      caseTitle: 故障排查－操作系统内存高
+      summary: 内存使用率持续居高不下的排查与处理过程
+  - brick: ai-portal.show-case
+    properties:
+      caseTitle: 主机磁盘空间不足
+      summary: 磁盘使用率超过90%的清理与扩容方案
+  - brick: ai-portal.show-case
+    properties:
+      caseTitle: 网络连通性异常分析
+      summary: 服务间网络不通的问题定位与解决步骤
 ```

package/docs/show-case.react.md

@@ -0,0 +1,60 @@
+---
+tagName: ai-portal.show-case
+displayName: WrappedAiPortalShowCase
+description: 案例展示卡片构件，以彩色背景卡片展示单个优秀案例，点击可跳转到案例详情。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalShowCase
+
+> 案例展示卡片构件，以彩色背景卡片展示单个优秀案例，点击可跳转到案例详情。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalShowCase } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性      | 类型     | 必填 | 默认值 | 说明                             |
+| --------- | -------- | ---- | ------ | -------------------------------- |
+| caseTitle | `string` | 否   | -      | 案例标题，同时用于计算卡片背景色 |
+| summary   | `string` | 否   | -      | 案例摘要描述                     |
+| url       | `string` | 否   | -      | 点击卡片跳转的目标链接           |
+
+## Examples
+
+### 基础使用
+
+展示带标题、描述和跳转链接的案例卡片，背景色由标题内容决定。
+
+```tsx
+<WrappedAiPortalShowCase
+  caseTitle="故障排查－操作系统内存高"
+  summary="服务已经正常启动，正常运行，但用户在外部访问失败服务已经正常启动，正常运行但用户正常运行"
+  url="/cases/memory-issue"
+/>
+```
+
+### 多个卡片对比
+
+不同标题产生不同背景色。
+
+```tsx
+<div style={{ display: "flex", gap: "16px" }}>
+  <WrappedAiPortalShowCase
+    caseTitle="故障排查－操作系统内存高"
+    summary="内存使用率持续居高不下的排查与处理过程"
+  />
+  <WrappedAiPortalShowCase
+    caseTitle="主机磁盘空间不足"
+    summary="磁盘使用率超过90%的清理与扩容方案"
+  />
+  <WrappedAiPortalShowCase
+    caseTitle="网络连通性异常分析"
+    summary="服务间网络不通的问题定位与解决步骤"
+  />
+</div>
+```

package/docs/show-cases.md

@@ -1,8 +1,27 @@
-构件 `ai-portal.show-cases`
+---
+tagName: ai-portal.show-cases
+displayName: WrappedAiPortalShowCases
+description: 案例列表展示构件，支持按场景分组筛选，展示多个优秀案例卡片。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.show-cases
+
+> 案例列表展示构件，支持按场景分组筛选，展示多个优秀案例卡片。
+
+## Props
+
+| 属性  | 类型             | 必填 | 默认值 | 说明                                               |
+| ----- | ---------------- | ---- | ------ | -------------------------------------------------- |
+| list  | `ShowCaseType[]` | 否   | -      | 案例数据列表，每项可包含 scenario 字段用于分组筛选 |
+| limit | `number`         | 否   | -      | 每个场景分组下最多显示的案例数量                   |
 
 ## Examples
 
-### Basic
+### 基础使用
+
+展示案例列表，自动按 scenario 字段生成分组筛选标签。
 
 ```yaml preview
 brick: ai-portal.show-cases
@@ -16,4 +35,35 @@ properties:
       title: Hi
       summary: There
       scenario: 主机巡检
+    - conversationId: c-3
+      title: 磁盘空间不足处理
+      summary: 磁盘使用率超过阈值的清理步骤
+      scenario: 主机故障排查
+```
+
+### 限制显示数量
+
+通过 limit 限制每个分组下最多显示的条数。
+
+```yaml preview
+brick: ai-portal.show-cases
+properties:
+  limit: 2
+  list:
+    - conversationId: c-1
+      title: 案例一
+      summary: 摘要一
+      scenario: 场景A
+    - conversationId: c-2
+      title: 案例二
+      summary: 摘要二
+      scenario: 场景A
+    - conversationId: c-3
+      title: 案例三
+      summary: 摘要三
+      scenario: 场景A
+    - conversationId: c-4
+      title: 案例四
+      summary: 摘要四
+      scenario: 场景B
 ```