@blueking/chat-x 0.0.33 → 0.0.35

package/dist/mcp/generated/docs/activity-message.md

@@ -151,15 +151,17 @@ ActivityMessage 展示活动类消息：知识检索（knowledge_rag）、引用
 
 ## FlowAgent 执行情况模式
 
-`activityType` 设为 `MessageContentType.FlowAgent`（`'flow_agent'`），`content` 传入 `BkFlowMessageContent` 对象。用于展示蓝鲸标准运维（BkFlow）任务的执行状态、节点列表和统计信息。
+`activityType` 设为 `MessageContentType.FlowAgent`（`'flow_agent'`），`content` 传入 `BkFlowMessageContent` 任务数组。用于展示一个或多个蓝鲸标准运维（BkFlow）任务的执行状态、节点列表和统计信息。
 
 ### 核心交互
 
-- **标题栏**：显示「执行情况」+ 各状态计数（执行中 / 成功 / 失败 / 挂起），颜色区分
-- **任务组**：可折叠/展开的任务行，带状态图标和总耗时
+- **标题栏**：显示「执行情况」+ 所有任务聚合后的各状态计数（执行中 / 成功 / 失败 / 挂起），颜色区分
+- **任务组**：逐个展示任务行，带状态图标和总耗时
 - **节点列表**：每个节点显示状态圆点、名称和耗时；hover 时出现「详情」按钮
 - **节点详情**：点击「详情」按钮会通过 `useCustomTabConsumer` 在 `ChatContainer` 侧边栏新增自定义 Tab，展示节点配置（基础信息、输入参数、输出参数）
 
+> `FlowAgentContent` 会读取 `ChatContainer` 注入的 `renderMode`。当 `renderMode === RenderMode.Share` 时，节点列表仅展示状态和名称，不展示节点耗时与「详情」按钮，避免分享预览中出现可交互的节点详情入口。独立使用 `ActivityMessage` 且没有上层 Provider 时，默认按 `Chat` 模式渲染。
+
 ### 内部渲染结构
 
 ```
@@ -169,7 +171,7 @@ FlowAgentContent（activityType = 'flow_agent'）
 │       ├── Loading / ArrowIcon（随 status 切换）
 │       └── 执行情况：执行中 N / 成功 N / 失败 N / 挂起 N
 └── #default
-    └── TaskGroup
+    └── TaskGroup × N
         ├── TaskHeader（可折叠/展开）
         │   ├── 状态图标（running=Loading / success / failed / suspended）
         │   ├── task_name（HighlightKeyword 支持搜索高亮）
@@ -202,54 +204,56 @@ FlowAgentContent（activityType = 'flow_agent'）
   const collapsed = ref(false);
   const status = ref(MessageStatus.Complete);
 
-  const flowContent: BkFlowMessageContent = {
-    task_id: 100,
-    task_name: '数据清洗流程',
-    task_state: 'FINISHED',
-    task_outputs: [],
-    statistics: {
-      total: 3,
-      state_counts: { FINISHED: 2, FAILED: 1 },
-    },
-    nodes: {
-      node1: {
-        id: 'node1',
-        name: '数据拉取',
-        state: 'FINISHED',
-        elapsed_time: 12,
-        start_time: '2025-01-01 10:00:00',
-        finish_time: '2025-01-01 10:00:12',
-        loop: 1,
-        retry: 0,
-        skip: false,
-        type: 'ServiceActivity',
-      },
-      node2: {
-        id: 'node2',
-        name: '数据转换',
-        state: 'FINISHED',
-        elapsed_time: 45,
-        start_time: '2025-01-01 10:00:12',
-        finish_time: '2025-01-01 10:00:57',
-        loop: 1,
-        retry: 0,
-        skip: false,
-        type: 'ServiceActivity',
+  const flowContent: BkFlowMessageContent = [
+    {
+      task_id: 100,
+      task_name: '数据清洗流程',
+      task_state: 'FINISHED',
+      task_outputs: [],
+      statistics: {
+        total: 3,
+        state_counts: { FINISHED: 2, FAILED: 1 },
       },
-      node3: {
-        id: 'node3',
-        name: '结果写入',
-        state: 'FAILED',
-        elapsed_time: 3,
-        start_time: '2025-01-01 10:00:57',
-        finish_time: '2025-01-01 10:01:00',
-        loop: 1,
-        retry: 0,
-        skip: false,
-        type: 'ServiceActivity',
+      nodes: {
+        node1: {
+          id: 'node1',
+          name: '数据拉取',
+          state: 'FINISHED',
+          elapsed_time: 12,
+          start_time: '2025-01-01 10:00:00',
+          finish_time: '2025-01-01 10:00:12',
+          loop: 1,
+          retry: 0,
+          skip: false,
+          type: 'ServiceActivity',
+        },
+        node2: {
+          id: 'node2',
+          name: '数据转换',
+          state: 'FINISHED',
+          elapsed_time: 45,
+          start_time: '2025-01-01 10:00:12',
+          finish_time: '2025-01-01 10:00:57',
+          loop: 1,
+          retry: 0,
+          skip: false,
+          type: 'ServiceActivity',
+        },
+        node3: {
+          id: 'node3',
+          name: '结果写入',
+          state: 'FAILED',
+          elapsed_time: 3,
+          start_time: '2025-01-01 10:00:57',
+          finish_time: '2025-01-01 10:01:00',
+          loop: 1,
+          retry: 0,
+          skip: false,
+          type: 'ServiceActivity',
+        },
       },
     },
-  };
+  ];
 </script>
 ```
 
@@ -262,16 +266,18 @@ const messages = [
     role: 'activity',
     activityType: MessageContentType.FlowAgent, // 'flow_agent'
     status: MessageStatus.Streaming,
-    content: {
-      task_id: 100,
-      task_name: '数据清洗流程',
-      task_state: 'RUNNING',
-      task_outputs: [],
-      statistics: { total: 3, state_counts: { RUNNING: 1, FINISHED: 2 } },
-      nodes: {
-        /* ... */
+    content: [
+      {
+        task_id: 100,
+        task_name: '数据清洗流程',
+        task_state: 'RUNNING',
+        task_outputs: [],
+        statistics: { total: 3, state_counts: { RUNNING: 1, FINISHED: 2 } },
+        nodes: {
+          /* ... */
+        },
       },
-    },
+    ],
   },
 ];
 ```
@@ -286,6 +292,7 @@ const messages = [
 | `success`   | FINISHED                                                                            | #18B456 |
 | `failed`    | FAILED / REVOKED / ROLL_BACK_FAILED                                                 | #EA3636 |
 | `suspended` | SUSPENDED                                                                           | #F59500 |
+| `pending`   | PENDING                                                                             | #DCDEE5 |
 
 ### 节点详情 Tab
 
@@ -298,14 +305,16 @@ const messages = [
 ### 相关类型定义
 
 ```typescript
-import { MessageContentType, type BkFlowMessageContent, type BkFlowNode } from '@blueking/chat-x';
+import { MessageContentType, type BkFlowMessageContent, type BkFlowNode, type BkFlowTask } from '@blueking/chat-x';
+
+type BkFlowMessageContent = BkFlowTask[];
 
-type BkFlowMessageContent = {
+type BkFlowTask = {
   nodes: Record<string, BkFlowNode>;
   statistics: { state_counts: Record<string, number>; total: number };
   task_id: number;
   task_name: string;
-  task_outputs: unknown[];
+  task_outputs: unknown;
   task_state: string;
 };
 
@@ -377,7 +386,7 @@ enum MessageContentType {
 | ------------ | --------------------------------------------------------------------------- | ------ | --------------------------------------------------------- |
 | content      | `ReferenceDocumentContent[] \| KnowledgeRagContent \| BkFlowMessageContent` | -      | 内容数据，格式随 `activityType` 不同                      |
 | activityType | `'knowledge_rag' \| 'flow_agent' \| 'reference_document' \| string`         | -      | 活动类型，决定渲染模式（知识检索 / FlowAgent / 引用文档） |
-| status       | `MessageStatus`                                                             | -      | 消息状态，仅在 `knowledge_rag` 模式下影响标题和图标       |
+| status       | `MessageStatus`                                                             | -      | 消息状态；在 `knowledge_rag` 模式下影响标题和图标，在 `flow_agent` 模式下影响标题 Loading 状态 |
 | id           | `string \| number`                                                          | -      | 消息 ID                                                   |
 | messageId    | `string \| number`                                                          | -      | 消息唯一标识                                              |
 

package/dist/mcp/generated/docs/chat-container.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息列表（MessageContainer）、输入（ChatInput）、执行摘要（ExecutionSummary）、快捷表单（ShortcutRender）与多选栏（SelectionFooter）。 内置 useMessageGroup、分享与自定义 Tab 等能力；对 MessageContainer/ChatInput 下推 inputStatus（末尾 Loading 占位时推导 Fetching），适合一站式接入。 通过 props 传入 messages、shortcuts 等，事件与 ChatInput/MessageContainer 对齐。
+ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息列表（MessageContainer）、输入（ChatInput）、执行摘要（ExecutionSummary）、快捷表单（ShortcutRender）与多选栏（SelectionFooter）。 内置 useMessageGroup、分享与自定义 Tab 等能力；对 MessageContainer/ChatInput 下推 inputStatus（末尾 Loading 占位时推导 Fetching），适合一站式接入。 通过 props 传入 messages、shortcuts 等，事件与 ChatInput/MessageContainer 对齐；renderMode 会通过内部 provide 下传给子内容组件。
 
 ### 关联组件
 - **message-container** — 消息列表与滚动区域
@@ -27,6 +27,7 @@ ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息
 - **执行摘要**：侧边栏展示工具调用 / FlowAgent 执行记录，支持关键词搜索和对话定位
 - **自定义 Tab**：通过 `useCustomTabProvider` 支持动态添加自定义 Tab（如节点详情）
 - **分享模式**：内置消息多选分享流程，选中用户消息后确认分享
+- **渲染模式注入**：`renderMode` 会通过内部 Provider 下传给后代内容组件；例如 FlowAgent 节点在 `Share` 模式下隐藏耗时和「详情」入口
 - **空状态欢迎页**：无消息时展示欢迎语和开场白
 
 ## 组件结构
@@ -366,7 +367,7 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 | confirmShare   | `(messages: Message[])`                | 确认分享，携带选中的消息             |
 | collapseChange | `(isCollapse: boolean, width: number)` | 侧边栏折叠/展开状态变化              |
 | selectShortcut | `(shortcut: Shortcut)`                 | 选择快捷指令（继承自 ChatInput）     |
-| deleteShortcut | `(shortcut: Shortcut)`                 | 删除已选快捷指令（继承自 ChatInput） |
+| deleteShortcut | —                                      | 删除已选快捷指令（继承自 ChatInput） |
 
 ### Slots
 
@@ -385,15 +386,17 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 | addCustomTab    | `(tab: CustomTab) => void`  | 添加自定义 Tab |
 | removeCustomTab | `(tabName: string) => void` | 移除自定义 Tab |
 | selectCustomTab | `(tab: CustomTab) => void`  | 切换到指定 Tab |
+| enterShareMode  | `() => void`                | 手动进入分享多选模式 |
+| exitShareMode   | `() => void`                | 退出分享多选模式，并清空已选消息 |
 
 ## 渲染模式
 
-通过 `v-model:render-mode` 控制容器的渲染行为：
+通过 `v-model:render-mode` 控制容器的渲染行为。`ChatContainer` 会把当前 `renderMode` 注入给后代组件，供内容渲染根据场景收敛交互能力。
 
 | `renderMode` | 侧边栏 Tab / 折叠按钮 | 底部输入区域                      | MessageTools 工具栏   | 说明                             |
 | ------------ | ---------------------- | --------------------------------- | --------------------- | -------------------------------- |
 | `Chat`       | 正常显示               | 正常显示（ChatInput / ShortcutRender / SelectionFooter） | 全部工具按钮          | 默认对话模式                     |
-| `Share`      | **隐藏**               | **隐藏**                          | **隐藏**（多选模式）  | 分享预览模式，仅展示消息         |
+| `Share`      | **隐藏**               | **隐藏**                          | **隐藏**（多选模式）  | 分享预览模式，仅展示消息；FlowAgent 节点会隐藏耗时和「详情」入口 |
 | `Test`       | 正常显示               | 正常显示                          | 过滤掉「分享」按钮    | 测试/嵌入模式，隐藏分享入口     |
 
 ```vue

package/dist/mcp/generated/docs/use-message-group.md

@@ -111,7 +111,7 @@ const isExecutionMessage = (m: Message): boolean => {
 | 消息类型   | 搜索范围                                                     |
 | ---------- | ------------------------------------------------------------ |
 | toolCall   | `function.name`、`mcpName`、`description`、`arguments`、`id` |
-| flow_agent | `task_name`、各节点 `name`                                   |
+| flow_agent | 各任务 `task_name`、各节点 `name`                             |
 
 ## 分享模式
 

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-04-24T02:55:34.652Z",
+  "generatedAt": "2026-05-12T09:32:40.415Z",
   "domains": {
     "message": {
       "label": "消息展示",
@@ -538,7 +538,7 @@
       "slug": "chat-container",
       "category": "molecular",
       "description": "顶层聊天容器组件，整合了 `MessageContainer`（消息列表）、`ChatInput`（输入框）、`ExecutionSummary`（执行摘要面板）、`ShortcutRender`（快捷指令表单）和 `SelectionFooter`（多选操作栏）。提供完整的 AI 对话界面布局能力。",
-      "aiSummary": "ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息列表（MessageContainer）、输入（ChatInput）、执行摘要（ExecutionSummary）、快捷表单（ShortcutRender）与多选栏（SelectionFooter）。 内置 useMessageGroup、分享与自定义 Tab 等能力；对 MessageContainer/ChatInput 下推 inputStatus（末尾 Loading 占位时推导 Fetching），适合一站式接入。 通过 props 传入 messages、shortcuts 等，事件与 ChatInput/MessageContainer 对齐。",
+      "aiSummary": "ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息列表（MessageContainer）、输入（ChatInput）、执行摘要（ExecutionSummary）、快捷表单（ShortcutRender）与多选栏（SelectionFooter）。 内置 useMessageGroup、分享与自定义 Tab 等能力；对 MessageContainer/ChatInput 下推 inputStatus（末尾 Loading 占位时推导 Fetching），适合一站式接入。 通过 props 传入 messages、shortcuts 等，事件与 ChatInput/MessageContainer 对齐；renderMode 会通过内部 provide 下传给子内容组件。",
       "relatedComponents": [
         {
           "slug": "message-container",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "description": "蓝鲸智云 AI Chat 组件库 —— 遵循 AG-UI，为 AI Agent 和人类开发者共同设计的对话 UI 组件库。",
   "main": "index.js",
   "bin": {
@@ -78,7 +78,7 @@
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18",
     "vue-tsc": "^3.1.4",
-    "@blueking/chat-helper": "0.0.2"
+    "@blueking/chat-helper": "0.0.3"
   },
   "scripts": {
     "dev": "vite --config vite.config.ts",