@next-bricks/ai-portal 0.70.1 → 0.70.3

package/docs/show-cases.react.md

@@ -0,0 +1,92 @@
+---
+tagName: ai-portal.show-cases
+displayName: WrappedAiPortalShowCases
+description: 案例列表展示构件，支持按场景分组筛选，展示多个优秀案例卡片。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalShowCases
+
+> 案例列表展示构件，支持按场景分组筛选，展示多个优秀案例卡片。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalShowCases } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性  | 类型             | 必填 | 默认值 | 说明                                               |
+| ----- | ---------------- | ---- | ------ | -------------------------------------------------- |
+| list  | `ShowCaseType[]` | 否   | -      | 案例数据列表，每项可包含 scenario 字段用于分组筛选 |
+| limit | `number`         | 否   | -      | 每个场景分组下最多显示的案例数量                   |
+
+## Examples
+
+### 基础使用
+
+展示案例列表，自动按 scenario 字段生成分组筛选标签。
+
+```tsx
+<WrappedAiPortalShowCases
+  list={[
+    {
+      conversationId: "c-1",
+      title: "故障排查－操作系统内存高",
+      summary:
+        "服务已经正常启动，正常运行，但用户在外部访问失败服务已经正常启动，正常运行但用户正常运行",
+      scenario: "主机故障排查",
+    },
+    {
+      conversationId: "c-2",
+      title: "Hi",
+      summary: "There",
+      scenario: "主机巡检",
+    },
+    {
+      conversationId: "c-3",
+      title: "磁盘空间不足处理",
+      summary: "磁盘使用率超过阈值的清理步骤",
+      scenario: "主机故障排查",
+    },
+  ]}
+/>
+```
+
+### 限制显示数量
+
+通过 limit 限制每个分组下最多显示的条数。
+
+```tsx
+<WrappedAiPortalShowCases
+  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",
+    },
+  ]}
+/>
+```

package/docs/space-chat-guide.md

@@ -0,0 +1,32 @@
+---
+tagName: ai-portal.space-chat-guide
+displayName: WrappedAiPortalSpaceChatGuide
+description: 空间聊天引导构件，根据空间详情展示引导信息，帮助用户快速开始聊天。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.space-chat-guide
+
+> 空间聊天引导构件，根据空间详情展示引导信息，帮助用户快速开始聊天。
+
+## Props
+
+| 属性        | 类型          | 必填 | 默认值 | 说明                                           |
+| ----------- | ------------- | ---- | ------ | ---------------------------------------------- |
+| spaceDetail | `SpaceDetail` | 是   | -      | 空间详情信息，必填，用于展示空间相关的引导内容 |
+
+## Examples
+
+### 基础使用
+
+根据空间详情展示聊天引导内容。
+
+```yaml preview
+brick: ai-portal.space-chat-guide
+properties:
+  spaceDetail:
+    name: "产品设计空间"
+    instanceId: "space-001"
+    description: "这是一个用于产品设计协作的空间"
+```

package/docs/space-chat-guide.react.md

@@ -0,0 +1,39 @@
+---
+tagName: ai-portal.space-chat-guide
+displayName: WrappedAiPortalSpaceChatGuide
+description: 空间聊天引导构件，根据空间详情展示引导信息，帮助用户快速开始聊天。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalSpaceChatGuide
+
+> 空间聊天引导构件，根据空间详情展示引导信息，帮助用户快速开始聊天。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalSpaceChatGuide } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性        | 类型          | 必填 | 默认值 | 说明                                           |
+| ----------- | ------------- | ---- | ------ | ---------------------------------------------- |
+| spaceDetail | `SpaceDetail` | 是   | -      | 空间详情信息，必填，用于展示空间相关的引导内容 |
+
+## Examples
+
+### 基础使用
+
+根据空间详情展示聊天引导内容。
+
+```tsx
+<WrappedAiPortalSpaceChatGuide
+  spaceDetail={{
+    name: "产品设计空间",
+    instanceId: "space-001",
+    description: "这是一个用于产品设计协作的空间",
+  }}
+/>
+```

package/docs/space-logo.md

@@ -0,0 +1,53 @@
+---
+tagName: ai-portal.space-logo
+displayName: WrappedAiPortalSpaceLogo
+description: 协作空间的 Logo 展示组件
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.space-logo
+
+> 协作空间的 Logo 展示组件
+
+## Props
+
+| 属性 | 类型     | 必填 | 默认值 | 说明                                                      |
+| ---- | -------- | ---- | ------ | --------------------------------------------------------- |
+| size | `number` | 否   | `48`   | Logo 容器尺寸（px），图标为容器的 87.5%，圆角为容器的 25% |
+
+## Examples
+
+### 基础使用
+
+使用默认尺寸（48px）展示协作空间 Logo。
+
+```yaml preview
+brick: ai-portal.space-logo
+```
+
+### 自定义尺寸
+
+通过 size 属性控制 Logo 容器的像素大小，图标和圆角按比例缩放。
+
+```yaml preview
+brick: div
+properties:
+  style:
+    display: flex
+    gap: 16px
+    alignItems: center
+children:
+  - brick: ai-portal.space-logo
+    properties:
+      size: 32
+  - brick: ai-portal.space-logo
+    properties:
+      size: 48
+  - brick: ai-portal.space-logo
+    properties:
+      size: 64
+  - brick: ai-portal.space-logo
+    properties:
+      size: 96
+```

package/docs/space-logo.react.md

@@ -0,0 +1,46 @@
+---
+tagName: ai-portal.space-logo
+displayName: WrappedAiPortalSpaceLogo
+description: 协作空间的 Logo 展示组件
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalSpaceLogo
+
+> 协作空间的 Logo 展示组件
+
+## 导入
+
+```tsx
+import { WrappedAiPortalSpaceLogo } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性 | 类型     | 必填 | 默认值 | 说明                                                      |
+| ---- | -------- | ---- | ------ | --------------------------------------------------------- |
+| size | `number` | 否   | `48`   | Logo 容器尺寸（px），图标为容器的 87.5%，圆角为容器的 25% |
+
+## Examples
+
+### 基础使用
+
+使用默认尺寸（48px）展示协作空间 Logo。
+
+```tsx
+<WrappedAiPortalSpaceLogo />
+```
+
+### 自定义尺寸
+
+通过 size 属性控制 Logo 容器的像素大小，图标和圆角按比例缩放。
+
+```tsx
+<div style={{ display: "flex", gap: "16px", alignItems: "center" }}>
+  <WrappedAiPortalSpaceLogo size={32} />
+  <WrappedAiPortalSpaceLogo size={48} />
+  <WrappedAiPortalSpaceLogo size={64} />
+  <WrappedAiPortalSpaceLogo size={96} />
+</div>
+```

package/docs/space-workbench.md

@@ -1,11 +1,43 @@
-构件 `ai-portal.space-workbench`
+---
+tagName: ai-portal.space-workbench
+displayName: WrappedAiPortalSpaceWorkbench
+description: 协作空间工作台，集成顶部导航、侧边栏（知识库、业务实例）、聊天区域和服务流等核心功能的一体化工作台构件。
+category: ""
+source: "@next-bricks/ai-portal"
+---
 
-空间工作台构件，用于展示空间的顶部导航栏，包括空间信息、成员管理、消息通知等功能。
+# ai-portal.space-workbench
+
+> 协作空间工作台，集成顶部导航、侧边栏（知识库、业务实例）、聊天区域和服务流等核心功能的一体化工作台构件。
+
+## Props
+
+| 属性            | 类型              | 必填 | 默认值 | 说明                   |
+| --------------- | ----------------- | ---- | ------ | ---------------------- |
+| spaceDetail     | `SpaceDetail`     | 是   | -      | 空间详情信息，必填     |
+| notifyCenterUrl | `string`          | 是   | -      | 消息中心跳转链接，必填 |
+| notices         | `NoticeItem[]`    | 否   | -      | 消息通知列表           |
+| knowledges      | `KnowledgeItem[]` | 否   | -      | 知识库列表             |
+| uploadOptions   | `UploadOptions`   | 否   | -      | 文件上传配置选项       |
+
+## Events
+
+| 事件            | detail                                                                                     | 说明                   |
+| --------------- | ------------------------------------------------------------------------------------------ | ---------------------- |
+| go.back         | `void`                                                                                     | 点击返回按钮时触发     |
+| members.click   | `void`                                                                                     | 点击成员按钮时触发     |
+| notice.click    | `NoticeItem` — { id: 消息ID, type: 消息类型, isRead: 是否已读, title: 标题, time: 时间戳 } | 点击消息通知项时触发   |
+| mark.all.read   | `void`                                                                                     | 点击全部已读按钮时触发 |
+| space.edit      | `void`                                                                                     | 点击编辑空间按钮时触发 |
+| knowledge.click | `KnowledgeItem` — 知识条目数据                                                             | 点击知识条目时触发     |
+| knowledge.add   | `void`                                                                                     | 点击添加知识按钮时触发 |
 
 ## Examples
 
 ### 基础使用
 
+展示包含空间信息、消息通知的协作空间工作台。
+
 ```yaml preview
 brick: ai-portal.space-workbench
 properties:
@@ -49,10 +81,21 @@ events:
     action: console.log
     args:
       - "点击了编辑空间"
+  knowledge.click:
+    action: console.log
+    args:
+      - "点击了知识:"
+      - "<% EVENT.detail %>"
+  knowledge.add:
+    action: console.log
+    args:
+      - "点击了添加知识"
 ```
 
 ### 无消息通知
 
+空间没有消息通知时的展示。
+
 ```yaml preview
 brick: ai-portal.space-workbench
 properties:

package/docs/space-workbench.react.md

@@ -0,0 +1,102 @@
+---
+tagName: ai-portal.space-workbench
+displayName: WrappedAiPortalSpaceWorkbench
+description: 协作空间工作台，集成顶部导航、侧边栏（知识库、业务实例）、聊天区域和服务流等核心功能的一体化工作台构件。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# WrappedAiPortalSpaceWorkbench
+
+> 协作空间工作台，集成顶部导航、侧边栏（知识库、业务实例）、聊天区域和服务流等核心功能的一体化工作台构件。
+
+## 导入
+
+```tsx
+import { WrappedAiPortalSpaceWorkbench } from "@easyops/wrapped-components";
+```
+
+## Props
+
+| 属性            | 类型              | 必填 | 默认值 | 说明                   |
+| --------------- | ----------------- | ---- | ------ | ---------------------- |
+| spaceDetail     | `SpaceDetail`     | 是   | -      | 空间详情信息，必填     |
+| notifyCenterUrl | `string`          | 是   | -      | 消息中心跳转链接，必填 |
+| notices         | `NoticeItem[]`    | 否   | -      | 消息通知列表           |
+| knowledges      | `KnowledgeItem[]` | 否   | -      | 知识库列表             |
+| uploadOptions   | `UploadOptions`   | 否   | -      | 文件上传配置选项       |
+
+## Events
+
+| 事件             | detail                                                                                     | 说明                   |
+| ---------------- | ------------------------------------------------------------------------------------------ | ---------------------- |
+| onGoBack         | `void`                                                                                     | 点击返回按钮时触发     |
+| onMembersClick   | `void`                                                                                     | 点击成员按钮时触发     |
+| onNoticeClick    | `NoticeItem` — { id: 消息ID, type: 消息类型, isRead: 是否已读, title: 标题, time: 时间戳 } | 点击消息通知项时触发   |
+| onMarkAllRead    | `void`                                                                                     | 点击全部已读按钮时触发 |
+| onSpaceEdit      | `void`                                                                                     | 点击编辑空间按钮时触发 |
+| onKnowledgeClick | `KnowledgeItem` — 知识条目数据                                                             | 点击知识条目时触发     |
+| onKnowledgeAdd   | `void`                                                                                     | 点击添加知识按钮时触发 |
+
+## Examples
+
+### 基础使用
+
+展示包含空间信息、消息通知的协作空间工作台。
+
+```tsx
+<WrappedAiPortalSpaceWorkbench
+  spaceDetail={{
+    name: "产品设计空间",
+    instanceId: "space-001",
+    description: "这是一个用于产品设计协作的空间",
+  }}
+  notifyCenterUrl="/notify-center"
+  notices={[
+    {
+      id: "msg-1",
+      isRead: false,
+      type: "project",
+      title: "协作流【研发设计】已完成",
+    },
+    {
+      id: "msg-2",
+      isRead: false,
+      type: "space",
+      title: "协作流【协作流名称】 - 【活动名称】需要人工确认",
+    },
+    {
+      id: "msg-3",
+      type: "account",
+      isRead: true,
+      title: "【项目协作功能】已发布",
+    },
+  ]}
+  onGoBack={(e) => console.log("点击了返回按钮")}
+  onMembersClick={(e) => console.log("点击了成员按钮")}
+  onNoticeClick={(e) => console.log("点击了消息：", e.detail)}
+  onMarkAllRead={(e) => console.log("点击了全部已读")}
+  onSpaceEdit={(e) => console.log("点击了编辑空间")}
+  onKnowledgeClick={(e) => console.log("点击了知识:", e.detail)}
+  onKnowledgeAdd={(e) => console.log("点击了添加知识")}
+/>
+```
+
+### 无消息通知
+
+空间没有消息通知时的展示。
+
+```tsx
+<WrappedAiPortalSpaceWorkbench
+  spaceDetail={{
+    name: "研发协作空间",
+    instanceId: "space-002",
+    description: "研发团队的协作空间",
+  }}
+  notifyCenterUrl="/notify-center"
+  notices={[]}
+  onGoBack={(e) => console.log("返回")}
+  onMembersClick={(e) => console.log("查看成员")}
+  onSpaceEdit={(e) => console.log("编辑空间")}
+/>
+```

package/docs/stage-flow.md

@@ -1,32 +1,128 @@
-构件 `ai-portal.stage-flow`
+---
+tagName: ai-portal.stage-flow
+displayName: WrappedAiPortalStageFlow
+description: 阶段流程编辑器构件，支持以泳道方式展示和编辑服务流的阶段与活动。
+category: ""
+source: "@next-bricks/ai-portal"
+---
+
+# ai-portal.stage-flow
+
+> 阶段流程编辑器构件，支持以泳道方式展示和编辑服务流的阶段与活动。
+
+## Props
+
+| 属性        | 类型           | 必填 | 默认值 | 说明                                             |
+| ----------- | -------------- | ---- | ------ | ------------------------------------------------ |
+| spec        | `Stage[]`      | 否   | -      | 阶段流程配置数据，每个阶段包含名称和活动列表     |
+| aiEmployees | `AIEmployee[]` | 否   | -      | AI 员工列表，用于在活动中显示分配的员工名称      |
+| readOnly    | `boolean`      | 否   | -      | 是否为只读模式，只读时不显示编辑、添加、删除操作 |
+
+## Events
+
+| 事件          | detail                                                                                  | 说明                       |
+| ------------- | --------------------------------------------------------------------------------------- | -------------------------- |
+| change        | `Stage[]` — 更新后的阶段列表                                                            | 流程阶段数据发生变化时触发 |
+| add.activity  | `{ stage: Stage }` — { stage: 所属阶段数据 }                                            | 点击添加活动按钮时触发     |
+| edit.activity | `EditActivityDetail` — { stage: 所属阶段, activity: 活动数据, activityIndex: 活动索引 } | 点击活动进行编辑时触发     |
+
+## Methods
+
+| 方法           | 参数                                                                    | 返回值 | 说明                     |
+| -------------- | ----------------------------------------------------------------------- | ------ | ------------------------ |
+| addActivity    | `(stage: Stage, activity: FlowActivity) => void`                        | `void` | 向指定阶段添加活动       |
+| editActivity   | `(stage: Stage, activity: FlowActivity, activityIndex: number) => void` | `void` | 编辑指定阶段中的某个活动 |
+| deleteActivity | `(stage: Stage, activityIndex: number) => void`                         | `void` | 删除指定阶段中的某个活动 |
 
 ## Examples
 
-### Basic
+### 基础使用
+
+以泳道方式展示服务流的阶段和活动，支持分配 AI 员工。
+
+```yaml preview
+brick: ai-portal.stage-flow
+properties:
+  spec:
+    - name: Requirement
+      serviceFlowActivities:
+        - name: Requirement collects
+          aiEmployeeId: "employee-001"
+        - name: Requirement documents
+          aiEmployeeId: "employee-001"
+    - name: Sprint Planning
+  aiEmployees:
+    - employeeId: "employee-001"
+      name: "Samuel"
+events:
+  change:
+    action: console.log
+    args:
+      - "流程变更:"
+      - "<% EVENT.detail %>"
+  add.activity:
+    action: console.log
+    args:
+      - "添加活动:"
+      - "<% EVENT.detail %>"
+  edit.activity:
+    action: console.log
+    args:
+      - "编辑活动:"
+      - "<% EVENT.detail %>"
+```
+
+### 只读模式
+
+设置 readOnly 后不显示编辑、添加、删除操作。
+
+```yaml preview
+brick: ai-portal.stage-flow
+properties:
+  readOnly: true
+  spec:
+    - name: 需求阶段
+      serviceFlowActivities:
+        - name: 需求收集
+          aiEmployeeId: "employee-001"
+        - name: 需求评审
+          aiEmployeeId: "employee-002"
+    - name: 开发阶段
+      serviceFlowActivities:
+        - name: 编码实现
+          aiEmployeeId: "employee-001"
+  aiEmployees:
+    - employeeId: "employee-001"
+      name: "Alice"
+    - employeeId: "employee-002"
+      name: "Bob"
+```
+
+### 使用方法调用
+
+通过方法调用动态添加、编辑、删除活动。
 
 ```yaml preview
-brick: ai-portal.home-container
-children:
-  - brick: ai-portal.flow-tabs
-    properties:
-      tabs:
-        - id: foo
-          label: Fooooo
-        - id: bar
-          label: Baaaaar
-        - id: baz
-          label: Baaaaaz
-      activeTab: foo
-    children:
-      - brick: ai-portal.stage-flow
-        properties:
-          spec:
-            - name: Requirement
-              serviceFlowActivities:
-                - name: Requirement collects
-                  aiEmployeeId: Samuel
-                - name: Requirement documents
-                  aiEmployeeId: Samuel
-            - name: Sprint Planning
-            # - name: Development
+- brick: ai-portal.stage-flow
+  ref: stageFlow
+  properties:
+    spec:
+      - name: 阶段一
+        serviceFlowActivities:
+          - name: 活动A
+  events:
+    change:
+      action: console.log
+      args:
+        - "<% EVENT.detail %>"
+- brick: eo-button
+  properties:
+    textContent: 添加活动
+  events:
+    click:
+      method: addActivity
+      ref: stageFlow
+      args:
+        - name: 阶段一
+        - name: 新活动B
 ```