@blueking/chat-x 0.0.51-beta.2 → 0.0.51-beta.3

package/skills/blueking-chat-x/references/components/activity-layout.md

@@ -1,134 +0,0 @@
-# ActivityLayout 活动布局
-
-> 能力域：辅助能力 ｜ 导入：`import { ActivityLayout } from '@blueking/chat-x'` ｜ since 1.0.0
-
-活动消息的折叠布局容器，提供 title/default 插槽。 源码位置：src/components/chat-content/activity-layout/activity-layout.vue。
-
-**关联**：activity-message（活动消息通过本组件承载标题栏与内容区）、knowledge-rag-content（知识召回活动复用本组件展示加载标题与正文）、reference-doc-content（引用文档活动复用本组件展示文档数量与引用列表）、flow-agent-content（FlowAgent 活动复用本组件，但隐藏默认折叠箭头）
-
----
-
-# ActivityLayout 活动布局
-
-> **能力域**：辅助能力
-
-`ActivityLayout` 是活动消息的通用折叠布局容器，负责渲染标题栏、折叠箭头和内容区域。它不关心活动内容类型本身，标题和正文均通过插槽传入，因此常被 `KnowledgeRagContent`、`ReferenceDocContent`、`FlowAgentContent` 等活动组件复用。
-
-通常不需要业务侧直接使用；如果要新增一种活动消息内容，可以用它作为标题/内容外壳。
-
-## 源码事实
-
-- **源码位置**：`src/components/chat-content/activity-layout/activity-layout.vue`
-- **能力说明**：活动消息的折叠布局容器，提供 `title` / `default` 插槽。
-
-## 核心能力
-
-- **标题栏点击折叠**：点击标题栏切换 `collapsed`，内容区通过 `v-show="!collapsed"` 显示或隐藏
-- **双向绑定**：通过 `v-model:collapsed` 让父组件控制展开/收起状态，默认展开
-- **标题插槽透传状态**：`title` 插槽会收到 `{ collapsed }`，可根据折叠状态调整标题内容
-- **默认折叠箭头**：非 FlowAgent 活动自动在标题右侧显示折叠箭头
-- **FlowAgent 特例**：`activityType === MessageContentType.FlowAgent` 时隐藏默认折叠箭头，由 FlowAgent 自己渲染标题交互
-
-## 基础用法
-
-```vue
-<template>
-  <ActivityLayout v-model:collapsed="collapsed">
-    <template #title="{ collapsed }">
-      <span class="ai-activity-message-title-icon">
-        <DocumentIcon style="font-size: 12px" />
-      </span>
-      <span class="ai-activity-message-title-text">
-        {{ collapsed ? '已折叠' : '引用 2 篇资料作为参考' }}
-      </span>
-    </template>
-
-    <div style="padding: 0 14px;">
-      活动内容
-    </div>
-  </ActivityLayout>
-</template>
-
-<script setup lang="ts">
-  import { ref } from 'vue';
-  import ActivityLayout from '@blueking/chat-x/src/components/chat-content/activity-layout/activity-layout.vue';
-  import { DocumentIcon } from '@blueking/chat-x/src/icons/content';
-
-  const collapsed = ref(false);
-</script>
-```
-
-**渲染效果**
-
-## 折叠状态
-
-`collapsed` 默认为 `false`。设置为 `true` 时只展示标题栏，正文内容保留在 DOM 中但通过 `v-show` 隐藏。
-
-## FlowAgent 活动
-
-传入 `activityType="flow_agent"` 时，`ActivityLayout` 不渲染右侧默认折叠箭头。该场景下标题栏通常由 `FlowAgentContent` 自己展示状态统计、加载图标和展开箭头。
-
-```vue
-<ActivityLayout
-  v-model:collapsed="collapsed"
-  :activity-type="MessageContentType.FlowAgent"
->
-  <template #title>
-    <span>执行情况: 成功 2 / 失败 1</span>
-  </template>
-  <div>FlowAgent 节点列表</div>
-</ActivityLayout>
-```
-
-## 组件结构
-
-```
-.ai-activity-message
-├── .ai-activity-message-title（点击切换 collapsed）
-│   ├── title slot（slot props: { collapsed }）
-│   └── CollapsedIcon（activityType !== flow_agent 时显示）
-└── .ai-activity-message-content（v-show="!collapsed"）
-    └── default slot
-```
-
-## API
-
-### Props
-
-| 属性名       | 类型                 | 必填 | 默认值 | 说明                                          |
-| ------------ | -------------------- | ---- | ------ | --------------------------------------------- |
-| activityType | `MessageContentType` | 否   | —      | 活动类型；为 `flow_agent` 时隐藏默认折叠箭头 |
-
-### Models
-
-| 名称      | 类型      | 默认值  | 说明             |
-| --------- | --------- | ------- | ---------------- |
-| collapsed | `boolean` | `false` | 活动内容是否折叠 |
-
-### Emits
-
-- 无显式 emits；`v-model:collapsed` 会产生 `update:collapsed`。
-
-### Slots
-
-| 插槽名  | 参数                    | 说明       |
-| ------- | ----------------------- | ---------- |
-| title   | `{ collapsed: boolean }` | 标题栏内容 |
-| default | —                       | 活动正文   |
-
-### Expose
-
-- 无。
-
-## 使用建议
-
-- 适合作为活动消息内部布局外壳，不建议替代通用卡片、面板或页面 Section。
-- 标题栏点击区域会整体触发折叠，标题插槽内如有按钮或链接，需要自行处理事件冒泡。
-- `default` 内容使用 `v-show` 控制可见性，折叠时不会卸载内部组件。
-
-## 关联组件
-
-- [ActivityMessage](../message/activity-message.md) — 活动消息分发入口。
-- [KnowledgeRagContent](../agent/knowledge-rag-content.md) — 知识召回活动。
-- [ReferenceDocContent](../agent/reference-doc-content.md) — 引用文档活动。
-- [FlowAgentContent](../agent/flow-agent-content.md) — FlowAgent 执行活动。

package/skills/blueking-chat-x/references/components/activity-message.md

@@ -1,486 +0,0 @@
-# ActivityMessage 活动消息
-
-> 能力域：消息系统 ｜ 导入：`import { ActivityMessage } from '@blueking/chat-x'` ｜ since 0.0.20
-
-按 activityType 分发 FlowAgent、知识召回、引用文档等活动内容。 源码位置：src/components/chat-message/activity-message/activity-message.vue。
-
-**关联**：message-render（由 MessageRender 在 role 为 activity 时创建）、flow-agent-content（activityType 为 flow_agent 时渲染）、knowledge-rag-content（activityType 为 knowledge_rag 时渲染）、reference-doc-content（activityType 为 reference_document 时渲染）、chat-container（uid / onInterruptResume / 侧栏 Tab 与 ChatContainer 联动）
-
----
-
-# ActivityMessage 活动消息
-
-## 源码事实
-
-- **源码位置**：`src/components/chat-message/activity-message/activity-message.vue`
-- **能力域**：消息系统
-- **能力说明**：按 `activityType` 分发 FlowAgent、知识召回、引用文档等活动内容；未知类型不渲染。
-
-> **导出说明**：`ActivityMessage` **未**从 `@blueking/chat-x` 包入口导出（入口同名导出是 TS interface）。消费方请通过 `MessageRender` / `MessageContainer` 渲染 `role: 'activity'`。下文带 `*Comp` 的 demo 为文档站内部相对路径示例。
-
-活动消息组件，用于展示知识检索（Knowledge RAG）、参考文档引用与 FlowAgent 执行情况。通过 `activityType` 映射到对应子组件；点击标题栏可折叠/展开。
-
-组件会将父级传入消息上的 **`uid`** 以 **`message-uid`** 形式透传给各活动子组件（`FlowAgentContent` / `KnowledgeRagContent` / `ReferenceDocContent`），用于侧栏自定义 Tab、`addCustomTab` 的 `data.messageUid` 与主对话区「在对话中定位」联动（详见 [ChatContainer](/components/setup/chat-container)）。
-
-`onInterruptResume` 仅由 `FlowAgentContent` 消费（失败节点「重试 / 跳过」），由 `MessageRender` 从 `ChatContainer` 透传；知识检索、引用文档等活动子组件忽略该 prop。
-
-## 三种工作模式
-
-组件根据 `activityType` 的值决定渲染模式：
-
-| `activityType`          | 模式           | 标题文案                             | 图标             | 内容区                              |
-| ----------------------- | -------------- | ------------------------------------ | ---------------- | ----------------------------------- |
-| `'knowledge_rag'`       | 知识检索模式   | 检索中 / 检索完成（随 status 切换）  | Loading / 文档   | Markdown 检索摘要 + 引用列表        |
-| `'flow_agent'`          | FlowAgent 模式 | 执行情况: 成功 N / 失败 N / 执行中 N | Loading / 箭头   | 任务节点树 + 节点详情（自定义 Tab） |
-| `'reference_document'`  | 引用文档模式   | 引用 N 篇资料作为参考                | 文档图标（固定） | 引用文档列表                        |
-| 其他未映射值            | —              | —                                    | —                | **不渲染**（`activityComponent` 为 falsy） |
-
-> **注意：** 源码仅映射上述三种 `MessageContentType`；`activityType` 缺失或未知时组件输出为空。
-
-## 引用文档模式
-
-`activityType` 必须为 `MessageContentType.ReferenceDocument`（`'reference_document'`），`content` 传入文档对象数组。
-
-标题自动显示文档数量，始终展示文档图标，`status` 不影响标题和图标。
-
-```vue
-<!-- 消费方：经 MessageRender 渲染 -->
-<template>
-  <MessageRender :message="message" />
-</template>
-
-<script setup lang="ts">
-  import { MessageRender, MessageContentType, MessageRole, MessageStatus } from '@blueking/chat-x';
-
-  const message = {
-    id: '2',
-    messageId: '2',
-    role: MessageRole.Activity,
-    activityType: MessageContentType.ReferenceDocument,
-    status: MessageStatus.Complete,
-    uid: 'activity-ref-1',
-    content: [
-      {
-        name: 'Vue 3 组合式 API 指南',
-        url: 'https://cn.vuejs.org/guide/extras/composition-api-faq.html',
-        originFile: 'composition-api.md',
-      },
-      { name: 'TypeScript 高级类型手册', url: 'https://www.typescriptlang.org/docs/', originFile: 'ts-advanced.pdf' },
-    ],
-  };
-</script>
-```
-
-**渲染效果**
-
-## 知识检索模式
-
-`activityType` 设为 `MessageContentType.KnowledgeRag`（`'knowledge_rag'`），`content` 传入包含 `content`（检索摘要）和 `referenceDocument`（引用文档列表）的对象。
-
-标题和图标随 `status` 动态变化：
-
-| `status`                | 图标     | 标题     |
-| ----------------------- | -------- | -------- |
-| `pending` / `streaming` | Loading  | 检索中   |
-| 其他（`complete` 等）   | 文档图标 | 检索完成 |
-
-```vue
-<template>
-  <MessageRender :message="message" />
-</template>
-
-<script setup lang="ts">
-  import { MessageRender, MessageContentType, MessageRole, MessageStatus } from '@blueking/chat-x';
-
-  const message = {
-    id: '1',
-    messageId: '1',
-    role: MessageRole.Activity,
-    activityType: MessageContentType.KnowledgeRag,
-    status: MessageStatus.Complete,
-    uid: 'activity-rag-1',
-    content: {
-      content: '根据知识库检索，Vue 3 引入了 Composition API...',
-      referenceDocument: [
-        { name: '知识库文档：Composition API 详解', url: 'https://example.com/kb1', originFile: 'kb1.md' },
-      ],
-    },
-  };
-</script>
-```
-
-**渲染效果（检索完成 + 单引用）**
-
-**渲染效果（检索完成 + 多引用 + Markdown 摘要）**
-
-## 状态变化（知识检索模式）
-
-`knowledge_rag` 模式下，`status` 决定图标和标题文案：
-
-**检索中（`pending`）**
-
-**检索中（`streaming`）**
-
-**检索完成（`complete`）**
-
-> **引用文档模式**不受 `status` 影响，始终显示文档图标和文档数量，不会出现 Loading 动画。
-
-## 折叠/展开
-
-通过 `v-model:collapsed` 控制内容区的折叠状态，点击整个标题栏均可切换。默认为 `false`（展开）。
-
-文档站内部示例（相对路径引入组件本体）可通过 `v-model:collapsed` 控制；消费方一般不直接绑定，折叠状态由活动子组件内部管理。
-
-```vue
-<!-- 文档站内部示例 -->
-<ActivityMessageComp
-  v-model:collapsed="collapsed"
-  :content="docs"
-  status="complete"
-  activity-type="reference_document"
-/>
-```
-
-```ts
-const collapsed = ref(false); // false = 展开，true = 折叠
-```
-
-**渲染效果（展开状态）**
-
-**渲染效果（折叠状态）**
-
-## FlowAgent 执行情况模式
-
-`activityType` 设为 `MessageContentType.FlowAgent`（`'flow_agent'`），`content` 传入 `BkFlowMessageContent` 任务数组。用于展示一个或多个蓝鲸标准运维（BkFlow）任务的执行状态、节点列表和统计信息。
-
-### 核心交互
-
-- **标题栏**：显示「执行情况」+ 所有任务聚合后的各状态计数（执行中 / 成功 / 失败 / 挂起），颜色区分
-- **任务组**：逐个展示任务行，带状态图标、总耗时；点击箭头图标可折叠/展开节点列表
-- **有效证据**：`task.has_confidence === true` 时，任务行右侧展示「有效证据」按钮，点击后在侧栏打开置信度/证据详情 Tab（`props.has_confidence: true`）
-- **默认激活**：当 `MessageContainer` 已注入滚动上下文（`useContainerScrollProvider`，供 `FlowAgentContent` 内 `useContainerScrollConsumer` 读取）时，组件挂载后若存在 `task.is_active === true` 且 `task.has_confidence === true` 的任务，会自动在侧栏打开该任务的「有效证据」Tab；无滚动 Provider（例如独立演示）时不做自动打开。用户手动切换 Tab 后不再沿用 `is_active` 默认高亮
-- **选中态**：当前侧栏 Tab 与任务行 / 节点行联动高亮（`is-selected`）；任务 Tab 与「有效证据」Tab 均视为该任务的选中态
-- **节点列表**：每个节点显示状态圆点、名称和耗时；hover 时出现行尾操作按钮组
-- **失败节点操作**：失败且 `retryable` / `skippable` 为 `true` 的节点，hover 时额外展示「重试」「跳过」按钮，点击后通过 `onInterruptResume` 回传 Agent（不传 `interrupt`）
-- **节点详情**：点击「详情」会通过 `useCustomTabConsumer` 在 `ChatContainer` 侧边栏新增自定义 Tab，展示节点配置（基础信息、输入参数、输出参数）
-
-> `FlowAgentContent` 会读取 `ChatContainer` 注入的 `renderMode`。当 `renderMode === RenderMode.Share` 时，任务行不展示总耗时与「有效证据」，节点列表不展示耗时与「详情」按钮，避免分享预览中出现可交互入口。独立使用 `ActivityMessage` 且没有上层 Provider 时，默认按 `Chat` 模式渲染。
-
-### 内部渲染结构
-
-```
-FlowAgentContent（activityType = 'flow_agent'）
-├── ActivityLayout（公共折叠布局容器）
-│   └── #title
-│       ├── Loading / ArrowIcon（随 status 切换）
-│       └── 执行情况：执行中 N / 成功 N / 失败 N / 挂起 N
-└── #default
-    └── TaskGroup × N
-        ├── TaskHeader（is-selected / has-confidence；箭头点击折叠）
-        │   ├── 状态图标（running=Loading / success / failed / suspended）
-        │   ├── task_name（HighlightKeyword 支持搜索高亮）
-        │   └── trailing：总耗时 + 「有效证据」（has_confidence 时）
-        └── NodeList
-            └── NodeItem × N（is-selected 与侧栏 Tab 联动）
-                ├── 状态圆点（颜色对应状态）
-                ├── node.name（HighlightKeyword 支持搜索高亮）
-                ├── node.elapsed_time
-                └── 行尾操作按钮组（hover 显示）
-                    ├── 重试（失败 + retryable）→ onInterruptResume
-                    ├── 跳过（失败 + skippable）→ onInterruptResume
-                    └── 详情 → 打开节点详情 Tab
-```
-
-### 用法示例
-
-```vue
-<template>
-  <MessageRender
-    :message="message"
-    :on-interrupt-resume="handleInterruptResume"
-  />
-</template>
-
-<script setup lang="ts">
-  import { MessageRender, MessageContentType, MessageRole, MessageStatus } from '@blueking/chat-x';
-  import type { BkFlowMessageContent, OnInterruptResume } from '@blueking/chat-x';
-
-  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',
-        },
-        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,
-          retryable: true,
-          skippable: true,
-          type: 'ServiceActivity',
-        },
-      },
-    },
-  ];
-
-  const message = {
-    id: '3',
-    messageId: '3',
-    role: MessageRole.Activity,
-    activityType: MessageContentType.FlowAgent,
-    status: MessageStatus.Complete,
-    uid: 'activity-flow-1',
-    content: flowContent,
-  };
-
-  const handleInterruptResume: OnInterruptResume = async payload => {
-    console.log('节点重试/跳过', payload);
-  };
-</script>
-```
-
-## 未知 activityType（不渲染）
-
-未映射的 `activityType` 不会回退到引用文档模式，组件直接不渲染：
-
-```vue
-<template>
-  <MessageRender :message="message" />
-  <!-- 页面上无任何活动内容输出 -->
-</template>
-
-<script setup lang="ts">
-  import { MessageRender, MessageRole, MessageStatus } from '@blueking/chat-x';
-
-  const message = {
-    id: 'x',
-    messageId: 'x',
-    role: MessageRole.Activity,
-    activityType: 'unknown_activity',
-    status: MessageStatus.Complete,
-    content: [{ name: '不会展示', url: '#', originFile: 'a.md' }],
-  };
-</script>
-```
-
-### 在 MessageContainer 中自动渲染
-
-```typescript
-const messages = [
-  {
-    id: '3',
-    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: {
-          /* ... */
-        },
-      },
-    ],
-  },
-];
-```
-
-### 节点状态映射
-
-组件内部将 BkFlow 原始状态归并为四种显示状态：
-
-| 归并状态    | 原始状态                                                                            | 颜色    |
-| ----------- | ----------------------------------------------------------------------------------- | ------- |
-| `running`   | CREATED / LOOP_READY / READY / RUNNING / BLOCKED / ROLLING_BACK / ROLL_BACK_SUCCESS | #3A84FF |
-| `success`   | FINISHED                                                                            | #18B456 |
-| `failed`    | FAILED / REVOKED / ROLL_BACK_FAILED                                                 | #EA3636 |
-| `suspended` | SUSPENDED                                                                           | #F59500 |
-| `pending`   | PENDING                                                                             | #DCDEE5 |
-
-### 侧栏 Tab 命名规则
-
-| 场景       | `tab.name` 格式                          |
-| ---------- | ---------------------------------------- |
-| 任务详情   | `{task_id}`                              |
-| 有效证据   | `{task_id}`（与任务 Tab 同名，label 为「有效证据」，`order: 10` 固定排在「执行情况」之后、节点详情之前） |
-| 节点详情   | `{task_id}\|{node.id}\|{node.name}`      |
-
-`CustomBkFlowTabData` 支持 `has_confidence?: boolean`，用于侧栏详情组件区分证据视图与节点视图。应用层可通过 `ChatContainer` 的 `getSideRenderComponent` 覆盖渲染组件。
-
-### 节点详情 Tab
-
-点击节点的「详情」按钮，内部调用 `useCustomTabConsumer().addCustomTab()` 在 `ChatContainer` 侧边栏新开一个 Tab，渲染 `BkFlowNodeDetail`（或 `getSideRenderComponent` 返回的自定义组件），该组件提供：
-
-- **节点配置** Tab：基础信息表单（流程模板、节点名称、步骤名称、失败处理、超时控制）+ 输入参数表 + 输出参数表
-- **节点输出** Tab：结构化输出参数表
-- **骨架屏**：`loading` 为 `true` 时展示骨架屏占位
-
-### 相关类型定义
-
-```typescript
-import { MessageContentType, type BkFlowMessageContent, type BkFlowNode, type BkFlowTask } from '@blueking/chat-x';
-
-type BkFlowMessageContent = BkFlowTask[];
-
-type BkFlowTask = {
-  has_confidence?: boolean; // 是否展示「有效证据」入口；与 is_active 同时为 true 且在消息容器滚动上下文中时，挂载后自动打开「有效证据」侧栏 Tab
-  is_active?: boolean; // 是否默认激活；需配合 has_confidence 且存在滚动 Provider 才会自动打开侧栏「有效证据」Tab
-  nodes: Record<string, BkFlowNode>;
-  statistics: { state_counts: Record<string, number>; total: number };
-  task_id: number;
-  task_name: string;
-  task_outputs: unknown;
-  task_state: string;
-};
-
-type BkFlowNode = {
-  elapsed_time: number;
-  finish_time: string;
-  id: string;
-  loop: number;
-  name: string;
-  retry: number;
-  retryable?: boolean;
-  skip: boolean;
-  skippable?: boolean;
-  start_time: string;
-  state: string;
-  type: string;
-};
-
-enum MessageContentType {
-  FlowAgent = 'flow_agent',
-  KnowledgeRag = 'knowledge_rag',
-  ReferenceDocument = 'reference_document',
-  // ...
-}
-```
-
-## 在 MessageContainer 中使用
-
-`ActivityMessage` 通常不需要单独使用，`MessageContainer` 会对 `role: 'activity'` 的消息自动渲染：
-
-```vue
-<template>
-  <MessageContainer :messages="messages" />
-</template>
-
-<script setup lang="ts">
-  import { MessageContainer, MessageContentType, MessageStatus } from '@blueking/chat-x';
-
-  const messages = [
-    // 知识检索消息
-    {
-      id: '1',
-      role: 'activity',
-      activityType: MessageContentType.KnowledgeRag, // 'knowledge_rag'
-      status: MessageStatus.Complete,
-      content: {
-        content: '根据知识库检索到以下相关信息...',
-        referenceDocument: [{ name: '文档A', url: 'https://example.com/a', originFile: 'a.md' }],
-      },
-    },
-    // 引用文档消息
-    {
-      id: '2',
-      role: 'activity',
-      activityType: MessageContentType.ReferenceDocument, // 'reference_document'
-      status: MessageStatus.Complete,
-      content: [
-        { name: '参考文档1', url: 'https://example.com/doc1', originFile: 'doc1.pdf' },
-        { name: '参考文档2', url: 'https://example.com/doc2', originFile: 'doc2.pdf' },
-      ],
-    },
-  ];
-</script>
-```
-
-## API
-
-### Props
-
-| 属性名            | 类型                                                                        | 默认值 | 说明                                                                                         |
-| ----------------- | --------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------- |
-| content           | `ReferenceDocumentContent[] \| KnowledgeRagContent \| BkFlowMessageContent` | -      | 内容数据，格式随 `activityType` 不同                                                         |
-| activityType      | `'knowledge_rag' \| 'flow_agent' \| 'reference_document' \| string`         | -      | 活动类型；仅三种已知值会渲染，其余不渲染                                                     |
-| status            | `MessageStatus`                                                             | -      | `knowledge_rag` 影响标题/图标；`flow_agent` 影响标题 Loading                                 |
-| id                | `string \| number`                                                          | -      | 消息 ID                                                                                      |
-| messageId         | `string \| number`                                                          | -      | 消息唯一标识                                                                                 |
-| uid               | `string`                                                                    | -      | 透传为子组件 `message-uid`，用于侧栏 Tab / 「在对话中定位」                                  |
-| onInterruptResume | `OnInterruptResume`                                                         | -      | 仅 `flow_agent` 子组件消费；失败节点「重试 / 跳过」，由 `MessageRender` 透传                 |
-
-### v-model
-
-| 属性名    | 类型      | 默认值  | 说明                        |
-| --------- | --------- | ------- | --------------------------- |
-| collapsed | `boolean` | `false` | 内容折叠状态，`true` 为折叠 |
-
-### Events / Slots / Expose
-
-无。
-
-## 类型定义
-
-```typescript
-import { MessageContentType } from '@blueking/chat-x';
-
-// 引用文档条目
-type ReferenceDocumentContent = {
-  name: string; // 文档名称（显示文本）
-  url: string; // 文档访问链接
-  originFile: string; // 原始文件名
-};
-
-// 知识检索内容（knowledge_rag 模式）
-interface KnowledgeRagContent {
-  content: string; // 检索摘要，支持 Markdown
-  referenceDocument: ReferenceDocumentContent[]; // 引用文档列表
-}
-
-// activityType 枚举值
-enum MessageContentType {
-  FlowAgent = 'flow_agent',
-  KnowledgeRag = 'knowledge_rag',
-  ReferenceDocument = 'reference_document',
-  // ...
-}
-```
-
-## 使用场景
-
-- **知识检索过程**：以 `knowledge_rag` 模式展示 RAG 检索全过程，从"检索中"到"检索完成"的状态流转
-- **参考资料引用**：以 `reference_document` 模式展示 AI 回复所引用的参考文档列表
-- **FlowAgent 执行监控**：以 `flow_agent` 模式展示 BkFlow 流程执行状态、节点列表和详情
-- **流式场景**：`pending` → `streaming` → `complete` 状态变化配合流式响应实时更新
-- **自动渲染**：通过 `MessageContainer` 或 `MessageRender` 自动处理 `role: 'activity'` 消息，无需手动引入
-
-## 关联组件
-
-- [MessageRender](/components/message/message-render) — activity 角色由其实例化
-- [AssistantMessage](/components/message/assistant-message) — 常与助手主回复配合出现