@blueking/chat-x 0.0.48-beta.1 → 0.0.49-beta.2

package/dist/lang/lang.d.ts

@@ -145,8 +145,15 @@ export declare const lang: {
     readonly 单选: "Single";
     readonly 多选: "Multiple";
     readonly 其他: "Others";
+    readonly 已完成: "Completed";
+    readonly 题: "question(s)";
     readonly 回答内容: "Answers";
     readonly 已回复: "Replied";
     readonly '\u8BF7\u8F93\u5165...': "Please enter...";
+    readonly 文件产物: "File Artifacts";
+    readonly 文件列表: "File List";
+    readonly 搜索文件关键字: "Search file keyword";
+    readonly 预览加载失败: "Failed to load preview";
+    readonly 暂无可预览的文件: "No file to preview";
 };
-export declare const t: (key: keyof typeof lang) => "Send" | "Stop" | "Ask AI" | "Copy" | "Share" | "Like" | "Unsatisfied" | "Delete" | "Quote" | "Regenerate" | "Regenerating will clear the content below" | "Submit" | "Cancel" | "Preview Content" | "Jump to Detail" | "Call Tool:" | "Calling..." | "Call Success" | "Call Failed" | "Tell us your thoughts" | "What makes you satisfied?" | "What makes you dissatisfied?" | "Return Content" | "Edit" | "Deep Thinking" | "Quick Thinking" | "Image to Text" | "Loading image..." | "Failed to load image" | "Thinking..." | "Thinking Completed" | "Thinking Failed" | "Copy Success" | "Copy Failed" | "Return to bottom" | "Stop generating" | "Stopping" | "Duration" | "Parameters" | "Description" | "Execution Status" | "Running" | "Success" | "Failed" | "Pending" | "To Be Executed" | "Details" | "Retry" | "Retrying" | "Skipping" | "The task is retrying and cannot be skipped" | "The task is skipping and cannot be retried" | "Node" | "Node Config" | "Node Output" | "Basic Info" | "Flow Template" | "Node Name" | "Step Name" | "Execution Plan" | "Optional" | "Failure Handler" | "Timeout Control" | "Yes" | "No" | "Input Params" | "Output Params" | "Param Name" | "Param Value" | "Name" | "Structured Output" | "Manual Skip" | "No Data" | "Call MCP:" | "More" | "Algorithm Plan Review Ticket" | "Reviewing" | "Approving" | "Abandoned" | "Approved" | "Cancelled" | "Expired" | "Rejected" | "Revoked" | "Ticket No." | "Submitted At" | "Current Handler" | "None" | "View Ticket Detail" | "Copy Ticket" | "Copy Ticket Link" | "Cancel Approval" | "Approval Cancelled" | "Refresh Ticket Status" | "This ticket has been rejected and cannot be cancelled" | "This ticket has been approved and cannot be cancelled" | "This ticket has been cancelled, no need to click again" | "Approval cannot be cancelled in the current status" | "There are {count} pending approval tickets in the current conversation. To continue, cancel approval first." | "Unsupported interrupt message" | "Searching" | "Search Completed" | "Upload File" | "Select model" | "Search models" | "Requesting..." | "Cancel satisfied" | "Cancel dissatisfied" | "Confirm delete this answer?" | "This operation cannot be undone. Please proceed with caution!" | "Preview" | "Zoom Out" | "Zoom In" | "Rotate" | "Download" | "Sorry, image loading failed. Please try reloading." | "Reset" | "Reload" | "W" | "H" | "Upload Image" | "Search keyword" | "Select date" | "Locate in Chat" | "Select All" | "Confirm" | "Upload Image, up to 3 images supported, max 2.4MB each" | "Hello, I am BlueKing AI Bot" | "Clear Search" | "Search Result is Empty" | "Valid Evidence" | "Full Screen" | "Exit Full Screen" | "Please choose to continue" | "Continue" | "Received: " | "Done" | "Skip" | "Single" | "Multiple" | "Others" | "Answers" | "Replied" | "Please enter..." | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "快速思考" | "图生文" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "重试" | "重试中" | "跳过中" | "任务正在重试中，不可跳过" | "任务正在跳过中，不可重试" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP：" | "更多" | "算法方案评审单" | "评审中" | "审批中" | "已废弃" | "已批准" | "已通过" | "已取消" | "已过期" | "已拒绝" | "已撤销" | "单据编号" | "提交时间" | "当前处理人" | "无" | "查看单据详情" | "复制单据" | "复制单据链接" | "取消审批" | "已取消审批" | "刷新单据状态" | "单据已取消审批" | "该单据已被拒绝，无法取消" | "该单据已通过，无法取消" | "单据已取消，无需重复点击" | "当前状态无法取消审批" | "当前会话有 {count} 个待审批单，如需继续，请先取消审批" | "暂不支持的中断消息" | "检索中" | "检索完成" | "上传文件" | "选择模型" | "搜索模型关键字" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传图片, 最多支持上传 3 个, 最大支持 2.4MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏" | "请选择以继续" | "继续" | "收到信息：" | "待审批" | "已审批" | "完成" | "跳过" | "单选" | "多选" | "其他" | "回答内容" | "已回复" | "请输入...";
+export declare const t: (key: keyof typeof lang) => "Send" | "Stop" | "Ask AI" | "Copy" | "Share" | "Like" | "Unsatisfied" | "Delete" | "Quote" | "Regenerate" | "Regenerating will clear the content below" | "Submit" | "Cancel" | "Preview Content" | "Jump to Detail" | "Call Tool:" | "Calling..." | "Call Success" | "Call Failed" | "Tell us your thoughts" | "What makes you satisfied?" | "What makes you dissatisfied?" | "Return Content" | "Edit" | "Deep Thinking" | "Quick Thinking" | "Image to Text" | "Loading image..." | "Failed to load image" | "Thinking..." | "Thinking Completed" | "Thinking Failed" | "Copy Success" | "Copy Failed" | "Return to bottom" | "Stop generating" | "Stopping" | "Duration" | "Parameters" | "Description" | "Execution Status" | "Running" | "Success" | "Failed" | "Pending" | "To Be Executed" | "Details" | "Retry" | "Retrying" | "Skipping" | "The task is retrying and cannot be skipped" | "The task is skipping and cannot be retried" | "Node" | "Node Config" | "Node Output" | "Basic Info" | "Flow Template" | "Node Name" | "Step Name" | "Execution Plan" | "Optional" | "Failure Handler" | "Timeout Control" | "Yes" | "No" | "Input Params" | "Output Params" | "Param Name" | "Param Value" | "Name" | "Structured Output" | "Manual Skip" | "No Data" | "Call MCP:" | "More" | "Algorithm Plan Review Ticket" | "Reviewing" | "Approving" | "Abandoned" | "Approved" | "Cancelled" | "Expired" | "Rejected" | "Revoked" | "Ticket No." | "Submitted At" | "Current Handler" | "None" | "View Ticket Detail" | "Copy Ticket" | "Copy Ticket Link" | "Cancel Approval" | "Approval Cancelled" | "Refresh Ticket Status" | "This ticket has been rejected and cannot be cancelled" | "This ticket has been approved and cannot be cancelled" | "This ticket has been cancelled, no need to click again" | "Approval cannot be cancelled in the current status" | "There are {count} pending approval tickets in the current conversation. To continue, cancel approval first." | "Unsupported interrupt message" | "Searching" | "Search Completed" | "Upload File" | "Select model" | "Search models" | "Requesting..." | "Cancel satisfied" | "Cancel dissatisfied" | "Confirm delete this answer?" | "This operation cannot be undone. Please proceed with caution!" | "Preview" | "Zoom Out" | "Zoom In" | "Rotate" | "Download" | "Sorry, image loading failed. Please try reloading." | "Reset" | "Reload" | "W" | "H" | "Upload Image" | "Search keyword" | "Select date" | "Locate in Chat" | "Select All" | "Confirm" | "Upload Image, up to 3 images supported, max 2.4MB each" | "Hello, I am BlueKing AI Bot" | "Clear Search" | "Search Result is Empty" | "Valid Evidence" | "Full Screen" | "Exit Full Screen" | "Please choose to continue" | "Continue" | "Received: " | "Done" | "Skip" | "Single" | "Multiple" | "Others" | "Completed" | "question(s)" | "Answers" | "Replied" | "Please enter..." | "File Artifacts" | "File List" | "Search file keyword" | "Failed to load preview" | "No file to preview" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "快速思考" | "图生文" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "重试" | "重试中" | "跳过中" | "任务正在重试中，不可跳过" | "任务正在跳过中，不可重试" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP：" | "更多" | "算法方案评审单" | "评审中" | "审批中" | "已废弃" | "已批准" | "已通过" | "已取消" | "已过期" | "已拒绝" | "已撤销" | "单据编号" | "提交时间" | "当前处理人" | "无" | "查看单据详情" | "复制单据" | "复制单据链接" | "取消审批" | "已取消审批" | "刷新单据状态" | "单据已取消审批" | "该单据已被拒绝，无法取消" | "该单据已通过，无法取消" | "单据已取消，无需重复点击" | "当前状态无法取消审批" | "当前会话有 {count} 个待审批单，如需继续，请先取消审批" | "暂不支持的中断消息" | "检索中" | "检索完成" | "上传文件" | "选择模型" | "搜索模型关键字" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传图片, 最多支持上传 3 个, 最大支持 2.4MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏" | "请选择以继续" | "继续" | "收到信息：" | "待审批" | "已审批" | "完成" | "跳过" | "单选" | "多选" | "其他" | "已完成" | "题" | "回答内容" | "已回复" | "请输入..." | "文件产物" | "文件列表" | "搜索文件关键字" | "预览加载失败" | "暂无可预览的文件";

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

@@ -5,21 +5,25 @@
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 activity 时创建
-- **assistant-message** — 常与助手回复相邻，描述检索或执行背景
+- **flow-agent-content** — activityType 为 flow_agent 时渲染
+- **knowledge-rag-content** — activityType 为 knowledge_rag 时渲染
+- **reference-doc-content** — activityType 为 reference_document 时渲染
+- **chat-container** — uid / onInterruptResume / 侧栏 Tab 与 ChatContainer 联动
 
 ---
 <!-- FULL DOC -->
 
 # ActivityMessage 活动消息
+
 ## 源码事实
 
 - **源码位置**：`src/components/chat-message/activity-message/activity-message.vue`
 - **能力域**：消息系统
-- **能力说明**：按 activityType 分发 FlowAgent、知识召回、引用文档等活动内容。
+- **能力说明**：按 `activityType` 分发 FlowAgent、知识召回、引用文档等活动内容；未知类型不渲染。
 
-> **能力域**：消息系统
+> **导出说明**：`ActivityMessage` **未**从 `@blueking/chat-x` 包入口导出（入口同名导出是 TS interface）。消费方请通过 `MessageRender` / `MessageContainer` 渲染 `role: 'activity'`。下文带 `*Comp` 的 demo 为文档站内部相对路径示例。
 
-活动消息组件，用于展示 AI 的知识检索（Knowledge RAG）过程、参考文档引用列表和 FlowAgent 流程执行情况。通过 `activityType` 切换三种工作模式，点击标题栏可折叠/展开内容区域。
+活动消息组件，用于展示知识检索（Knowledge RAG）、参考文档引用与 FlowAgent 执行情况。通过 `activityType` 映射到对应子组件；点击标题栏可折叠/展开。
 
 组件会将父级传入消息上的 **`uid`** 以 **`message-uid`** 形式透传给各活动子组件（`FlowAgentContent` / `KnowledgeRagContent` / `ReferenceDocContent`），用于侧栏自定义 Tab、`addCustomTab` 的 `data.messageUid` 与主对话区「在对话中定位」联动（详见 [ChatContainer](/components/setup/chat-container)）。
 
@@ -29,45 +33,46 @@
 
 组件根据 `activityType` 的值决定渲染模式：
 
-| `activityType`    | 模式           | 标题文案                             | 图标             | 内容区                              |
-| ----------------- | -------------- | ------------------------------------ | ---------------- | ----------------------------------- |
-| `'knowledge_rag'` | 知识检索模式   | 检索中 / 检索完成（随 status 切换）  | Loading / 文档   | Markdown 检索摘要 + 引用列表        |
-| `'flow_agent'`    | FlowAgent 模式 | 执行情况: 成功 N / 失败 N / 执行中 N | Loading / 箭头   | 任务节点树 + 节点详情（自定义 Tab） |
-| 其他任意值        | 引用文档模式   | 引用 N 篇资料作为参考                | 文档图标（固定） | 引用文档列表                        |
+| `activityType`          | 模式           | 标题文案                             | 图标             | 内容区                              |
+| ----------------------- | -------------- | ------------------------------------ | ---------------- | ----------------------------------- |
+| `'knowledge_rag'`       | 知识检索模式   | 检索中 / 检索完成（随 status 切换）  | Loading / 文档   | Markdown 检索摘要 + 引用列表        |
+| `'flow_agent'`          | FlowAgent 模式 | 执行情况: 成功 N / 失败 N / 执行中 N | Loading / 箭头   | 任务节点树 + 节点详情（自定义 Tab） |
+| `'reference_document'`  | 引用文档模式   | 引用 N 篇资料作为参考                | 文档图标（固定） | 引用文档列表                        |
+| 其他未映射值            | —              | —                                    | —                | **不渲染**（`activityComponent` 为 falsy） |
 
-> **注意：** 只有值严格等于 `'knowledge_rag'` 才进入知识检索模式；严格等于 `'flow_agent'`（`MessageContentType.FlowAgent`）才进入 FlowAgent 模式；其他值均按引用文档模式处理。
+> **注意：** 源码仅映射上述三种 `MessageContentType`；`activityType` 缺失或未知时组件输出为空。
 
 ## 引用文档模式
 
-`activityType` 传入 `MessageContentType.ReferenceDocument`（`'reference_document'`）或任意非 `'knowledge_rag'` 的值，`content` 传入文档对象数组。
+`activityType` 必须为 `MessageContentType.ReferenceDocument`（`'reference_document'`），`content` 传入文档对象数组。
 
 标题自动显示文档数量，始终展示文档图标，`status` 不影响标题和图标。
 
 ```vue
+<!-- 消费方：经 MessageRender 渲染 -->
 <template>
-  <ActivityMessage
-    v-model:collapsed="collapsed"
-    :content="docs"
-    status="complete"
-    :activity-type="MessageContentType.ReferenceDocument"
-  />
+  <MessageRender :message="message" />
 </template>
 
 <script setup lang="ts">
-  import { ref } from 'vue';
-  import { ActivityMessage, MessageContentType, MessageStatus } from '@blueking/chat-x';
-
-  const collapsed = ref(false);
-
-  const docs = [
-    {
-      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' },
-    { name: '蓝鲸前端开发规范 v2.0', url: 'https://example.com/bk-standard', originFile: 'bk-standard.docx' },
-  ];
+  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>
 ```
 
@@ -86,28 +91,25 @@
 
 ```vue
 <template>
-  <ActivityMessage
-    v-model:collapsed="collapsed"
-    :content="ragContent"
-    :status="status"
-    :activity-type="MessageContentType.KnowledgeRag"
-  />
+  <MessageRender :message="message" />
 </template>
 
 <script setup lang="ts">
-  import { ref } from 'vue';
-  import { ActivityMessage, MessageContentType, MessageStatus } from '@blueking/chat-x';
-
-  const collapsed = ref(false);
-  const status = ref(MessageStatus.Complete);
-
-  const ragContent = {
-    // 检索摘要（支持 Markdown）
-    content: '根据知识库检索，Vue 3 引入了 Composition API...',
-    // 引用文档列表
-    referenceDocument: [
-      { name: '知识库文档：Composition API 详解', url: 'https://example.com/kb1', originFile: 'kb1.md' },
-    ],
+  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>
 ```
@@ -132,24 +134,20 @@
 
 通过 `v-model:collapsed` 控制内容区的折叠状态，点击整个标题栏均可切换。默认为 `false`（展开）。
 
-```vue
-<template>
-  <!-- 默认展开 -->
-  <ActivityMessage
-    v-model:collapsed="collapsed"
-    :content="docs"
-    status="complete"
-    activity-type="reference_document"
-  />
-</template>
+文档站内部示例（相对路径引入组件本体）可通过 `v-model:collapsed` 控制；消费方一般不直接绑定，折叠状态由活动子组件内部管理。
 
-<script setup lang="ts">
-  import { ref } from 'vue';
-  import { ActivityMessage } from '@blueking/chat-x';
+```vue
+<!-- 文档站内部示例 -->
+<ActivityMessageComp
+  v-model:collapsed="collapsed"
+  :content="docs"
+  status="complete"
+  activity-type="reference_document"
+/>
+```
 
-  const collapsed = ref(false); // false = 展开，true = 折叠
-  const docs = [{ name: '参考文档', url: 'https://example.com/doc', originFile: 'doc.pdf' }];
-</script>
+```ts
+const collapsed = ref(false); // false = 展开，true = 折叠
 ```
 
 **渲染效果（展开状态）**
@@ -202,21 +200,15 @@ FlowAgentContent（activityType = 'flow_agent'）
 
 ```vue
 <template>
-  <ActivityMessage
-    v-model:collapsed="collapsed"
-    :content="flowContent"
-    :status="status"
-    :activity-type="MessageContentType.FlowAgent"
+  <MessageRender
+    :message="message"
+    :on-interrupt-resume="handleInterruptResume"
   />
 </template>
 
 <script setup lang="ts">
-  import { ref } from 'vue';
-  import { ActivityMessage, MessageContentType, MessageStatus } from '@blueking/chat-x';
-  import type { BkFlowMessageContent } from '@blueking/chat-x';
-
-  const collapsed = ref(false);
-  const status = ref(MessageStatus.Complete);
+  import { MessageRender, MessageContentType, MessageRole, MessageStatus } from '@blueking/chat-x';
+  import type { BkFlowMessageContent, OnInterruptResume } from '@blueking/chat-x';
 
   const flowContent: BkFlowMessageContent = [
     {
@@ -241,18 +233,6 @@ FlowAgentContent（activityType = 'flow_agent'）
           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: '结果写入',
@@ -263,11 +243,51 @@ FlowAgentContent（activityType = 'flow_agent'）
           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>
 ```
 
@@ -410,14 +430,15 @@ enum MessageContentType {
 
 ### Props
 
-| 属性名       | 类型                                                                        | 默认值 | 说明                                                      |
-| ------------ | --------------------------------------------------------------------------- | ------ | --------------------------------------------------------- |
-| content      | `ReferenceDocumentContent[] \| KnowledgeRagContent \| BkFlowMessageContent` | -      | 内容数据，格式随 `activityType` 不同                      |
-| activityType | `'knowledge_rag' \| 'flow_agent' \| 'reference_document' \| string`         | -      | 活动类型，决定渲染模式（知识检索 / FlowAgent / 引用文档） |
-| status       | `MessageStatus`                                                             | -      | 消息状态；在 `knowledge_rag` 模式下影响标题和图标，在 `flow_agent` 模式下影响标题 Loading 状态 |
-| id           | `string \| number`                                                          | -      | 消息 ID                                                   |
-| messageId    | `string \| number`                                                          | -      | 消息唯一标识                                              |
-| onInterruptResume | `OnInterruptResume`                                                    | -      | 仅 `flow_agent` 子组件消费；失败节点「重试 / 跳过」回调，由 `MessageRender` 透传 |
+| 属性名            | 类型                                                                        | 默认值 | 说明                                                                                         |
+| ----------------- | --------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------- |
+| 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
 
@@ -425,6 +446,10 @@ enum MessageContentType {
 | --------- | --------- | ------- | --------------------------- |
 | collapsed | `boolean` | `false` | 内容折叠状态，`true` 为折叠 |
 
+### Events / Slots / Expose
+
+无。
+
 ## 类型定义
 
 ```typescript