@blueking/chat-x 0.0.52-dev.5 → 2.4.0

package/dist/lang/lang.d.ts

@@ -141,6 +141,8 @@ export declare const lang: {
     readonly 全选: "Select All";
     readonly 确定: "Confirm";
     readonly '\u4E0A\u4F20\u6587\u4EF6\uFF0C\u6700\u591A\u652F\u6301 {count} \u4E2A\uFF0C\u5355\u4E2A\u6700\u5927 {size}MB': "Upload file, up to {count} files, max {size}MB each";
+    readonly '\u652F\u6301\u683C\u5F0F\uFF1A{formats}': "Supported formats: {formats}";
+    readonly '\u6709 {count} \u4E2A\u6587\u4EF6\u56E0\u683C\u5F0F\u4E0D\u652F\u6301\u672A\u6DFB\u52A0': "{count} file(s) were not added because the format is not supported";
     readonly '\u4F60\u597D\uFF0C\u6211\u662F\u5C0F\u9CB8': "Hello, I am BlueKing AI Bot";
     readonly 清空搜索: "Clear Search";
     readonly 搜索结果为空: "Search Result is Empty";
@@ -170,6 +172,5 @@ export declare const lang: {
     readonly '\u6587\u4EF6\u4E0A\u4F20\u4E2D\uFF0C\u8BF7\u7A0D\u5019': "Uploading files, please wait";
     readonly '\u5B58\u5728\u4E0A\u4F20\u5931\u8D25\u7684\u6587\u4EF6\uFF0C\u8BF7\u5220\u9664\u540E\u91CD\u8BD5': "Remove failed uploads before sending";
     readonly 上传失败: "Upload failed";
-    readonly '\u6709 {count} \u4E2A\u6587\u4EF6\u56E0\u683C\u5F0F\u4E0D\u652F\u6301\u672A\u6DFB\u52A0': "{count} file(s) were not added because the format is not supported";
 };
-export declare const t: (key: keyof typeof lang) => "Send" | "Stop" | "Add" | "Skill" | "MCP" | "Prompt" | "File" | "Image" | "Tool" | "Knowledge Base" | "Conversation Files" | "Collapse" | "Show More" | "Ask AI" | "Copy" | "Share" | "Like" | "Unsatisfied" | "Delete" | "Quote" | "Regenerate" | "Regenerating will clear the content below" | "Submit" | "Cancel" | "Preview Content" | "Jump to Detail" | "Call Tool" | "Read Skill" | "Calling" | "Reading" | "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" | "Yesterday" | "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 file, up to {count} files, max {size}MB 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" | "Uploading files, please wait" | "Remove failed uploads before sending" | "Upload failed" | "{count} file(s) were not added because the format is not supported" | "发送" | "停止" | "添加" | "文件" | "图片" | "工具" | "知识库" | "会话产物" | "收起" | "显示更多" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具" | "读取 Skill" | "正在调用" | "正在读取" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "快速思考" | "图生文" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "昨天" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "重试" | "重试中" | "跳过中" | "任务正在重试中，不可跳过" | "任务正在跳过中，不可重试" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP" | "更多" | "算法方案评审单" | "评审中" | "审批中" | "已废弃" | "已批准" | "已通过" | "已取消" | "已过期" | "已拒绝" | "已撤销" | "单据编号" | "提交时间" | "当前处理人" | "无" | "查看单据详情" | "复制单据" | "复制单据链接" | "取消审批" | "已取消审批" | "刷新单据状态" | "单据已取消审批" | "该单据已被拒绝，无法取消" | "该单据已通过，无法取消" | "单据已取消，无需重复点击" | "当前状态无法取消审批" | "当前会话有 {count} 个待审批单，如需继续，请先取消审批" | "暂不支持的中断消息" | "检索中" | "检索完成" | "上传文件" | "选择模型" | "搜索模型关键字" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传文件，最多支持 {count} 个，单个最大 {size}MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏" | "请选择以继续" | "继续" | "收到信息：" | "待审批" | "已审批" | "完成" | "跳过" | "单选" | "多选" | "其他" | "已完成" | "题" | "回答内容" | "已回复" | "请输入..." | "文件产物" | "文件列表" | "搜索文件关键字" | "预览加载失败" | "暂无可预览的文件" | "文件上传中，请稍候" | "存在上传失败的文件，请删除后重试" | "上传失败" | "有 {count} 个文件因格式不支持未添加";
+export declare const t: (key: keyof typeof lang) => "Send" | "Stop" | "Add" | "Skill" | "MCP" | "Prompt" | "File" | "Image" | "Tool" | "Knowledge Base" | "Conversation Files" | "Collapse" | "Show More" | "Ask AI" | "Copy" | "Share" | "Like" | "Unsatisfied" | "Delete" | "Quote" | "Regenerate" | "Regenerating will clear the content below" | "Submit" | "Cancel" | "Preview Content" | "Jump to Detail" | "Call Tool" | "Read Skill" | "Calling" | "Reading" | "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" | "Yesterday" | "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 file, up to {count} files, max {size}MB each" | "Supported formats: {formats}" | "{count} file(s) were not added because the format is not supported" | "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" | "Uploading files, please wait" | "Remove failed uploads before sending" | "Upload failed" | "发送" | "停止" | "添加" | "文件" | "图片" | "工具" | "知识库" | "会话产物" | "收起" | "显示更多" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具" | "读取 Skill" | "正在调用" | "正在读取" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "快速思考" | "图生文" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "昨天" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "重试" | "重试中" | "跳过中" | "任务正在重试中，不可跳过" | "任务正在跳过中，不可重试" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP" | "更多" | "算法方案评审单" | "评审中" | "审批中" | "已废弃" | "已批准" | "已通过" | "已取消" | "已过期" | "已拒绝" | "已撤销" | "单据编号" | "提交时间" | "当前处理人" | "无" | "查看单据详情" | "复制单据" | "复制单据链接" | "取消审批" | "已取消审批" | "刷新单据状态" | "单据已取消审批" | "该单据已被拒绝，无法取消" | "该单据已通过，无法取消" | "单据已取消，无需重复点击" | "当前状态无法取消审批" | "当前会话有 {count} 个待审批单，如需继续，请先取消审批" | "暂不支持的中断消息" | "检索中" | "检索完成" | "上传文件" | "选择模型" | "搜索模型关键字" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传文件，最多支持 {count} 个，单个最大 {size}MB" | "支持格式：{formats}" | "有 {count} 个文件因格式不支持未添加" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏" | "请选择以继续" | "继续" | "收到信息：" | "待审批" | "已审批" | "完成" | "跳过" | "单选" | "多选" | "其他" | "已完成" | "题" | "回答内容" | "已回复" | "请输入..." | "文件产物" | "文件列表" | "搜索文件关键字" | "预览加载失败" | "暂无可预览的文件" | "文件上传中，请稍候" | "存在上传失败的文件，请删除后重试" | "上传失败";

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

@@ -14,6 +14,8 @@
 
 # ActivityLayout 活动布局
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+
 > **能力域**：辅助能力
 
 `ActivityLayout` 是活动消息的通用折叠布局容器，负责渲染标题栏、折叠箭头和内容区域。它不关心活动内容类型本身，标题和正文均通过插槽传入，因此常被 `KnowledgeRagContent`、`ReferenceDocContent`、`FlowAgentContent` 等活动组件复用。
@@ -55,8 +57,8 @@
 
 <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';
+  import { DocumentIcon } from '@blueking/chat-x';
+  // ActivityLayout 未从包入口导出；文档站 demo 使用页面顶部相对路径
 
   const collapsed = ref(false);
 </script>

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

@@ -166,7 +166,7 @@ const collapsed = ref(false); // false = 展开，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`）
+- **失败节点操作**：失败且 `retryable` / `skippable` 为 `true` 的节点，hover 时额外展示「重试」「跳过」按钮，点击后通过 `onInterruptResume` 回传 Agent（不传 `interrupt`）。仅在对话流内出现：侧栏「执行情况」面板（`ExecutionSummary`）内渲染的同一消息只保留「详情」
 - **节点详情**：点击「详情」会通过 `useCustomTabConsumer` 在 `ChatContainer` 侧边栏新增自定义 Tab，展示节点配置（基础信息、输入参数、输出参数）
 
 > `FlowAgentContent` 会读取 `ChatContainer` 注入的 `renderMode`。当 `renderMode === RenderMode.Share` 时，任务行不展示总耗时与「有效证据」，节点列表不展示耗时与「详情」按钮，避免分享预览中出现可交互入口。独立使用 `ActivityMessage` 且没有上层 Provider 时，默认按 `Chat` 模式渲染。
@@ -191,8 +191,8 @@ FlowAgentContent（activityType = 'flow_agent'）
                 ├── node.name（HighlightKeyword 支持搜索高亮）
                 ├── node.elapsed_time
                 └── 行尾操作按钮组（hover 显示）
-                    ├── 重试（失败 + retryable）→ onInterruptResume
-                    ├── 跳过（失败 + skippable）→ onInterruptResume
+                    ├── 重试（失败 + retryable；侧栏执行情况面板内隐藏）→ onInterruptResume
+                    ├── 跳过（失败 + skippable；侧栏执行情况面板内隐藏）→ onInterruptResume
                     └── 详情 → 打开节点详情 Tab
 ```
 
@@ -340,7 +340,7 @@ const messages = [
 
 ### 节点详情 Tab
 
-点击节点的「详情」按钮，内部调用 `useCustomTabConsumer().addCustomTab()` 在 `ChatContainer` 侧边栏新开一个 Tab，渲染 `BkFlowNodeDetail`（或 `getSideRenderComponent` 返回的自定义组件），该组件提供：
+点击节点的「详情」按钮，内部调用 `useCustomTabConsumer().addCustomTab()` 在 `ChatContainer` 侧边栏新开一个 Tab，渲染 `FlowAgentNodeDetail`（或 `getSideRenderComponent` 返回的自定义组件），该组件提供：
 
 - **节点配置** Tab：基础信息表单（流程模板、节点名称、步骤名称、失败处理、超时控制）+ 输入参数表 + 输出参数表
 - **节点输出** Tab：结构化输出参数表

package/dist/mcp/generated/docs/ai-selection.md

@@ -322,6 +322,8 @@ AI 划词选择组件，监听用户在页面中的文本选区，在选区附
 
 ## 与 ChatBot 联动
 
+`ChatBot` 属于 `@blueking/ai-blueking`，不是 chat-x 的导出。
+
 选中文本后触发快捷指令，自动将选中内容作为上下文发送到聊天窗口：
 
 ```vue
@@ -341,7 +343,8 @@ AI 划词选择组件，监听用户在页面中的文本选区，在选区附
 
 <script setup lang="ts">
   import { ref } from 'vue';
-  import { AiSelection, ChatBot, type Shortcut } from '@blueking/chat-x';
+  import { AiSelection, type Shortcut } from '@blueking/chat-x';
+  import { ChatBot } from '@blueking/ai-blueking';
 
   const selectionVisible = ref(false);
   const chatBotRef = ref();
@@ -378,7 +381,7 @@ v-model:visible="selectionVisible"
 | 属性名           | 类型         | 默认值              | 必填 | 说明                                                    |
 | ---------------- | ------------ | ------------------- | ---- | ------------------------------------------------------- |
 | visible          | `boolean`    | -                   | ✅   | 控制弹窗显示，必须使用 `v-model:visible`                |
-| shortcuts        | `Shortcut[]` | `DEFAULT_SHORTCUTS` | -    | 快捷指令列表，默认为内置「问问小鲸」                    |
+| shortcuts        | `Shortcut[]` | `DEFAULT_SHORTCUTS` | -    | 快捷指令列表；未传或空数组时回退内置「问问小鲸」        |
 | maxShortcutCount | `number`     | `3`                 | -    | 直接展示的最大指令数，超出收起到「更多」菜单            |
 | offset           | `number`     | `10`                | -    | 弹窗与选区的垂直间距（px）                              |
 | excludeSelectors | `string[]`   | `[]`                | -    | 排除的 CSS 选择器数组，选区在这些选择器内部时不显示弹窗 |

package/dist/mcp/generated/docs/ai-slash-input.md

@@ -13,6 +13,10 @@ ChatInput 内部富文本编辑区，基于 edix 编辑器渲染「文本 + 资
 
 # AiSlashInput 富文本命令输入
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ChatInput](/components/input/chat-input) 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { AiSlashInput } from '@blueking/chat-x'`。
+
 > **能力域**：输入交互
 
 ## 源码事实

package/dist/mcp/generated/docs/animation-text.md

@@ -11,6 +11,10 @@
 <!-- FULL DOC -->
 
 # AnimationText 动画文本
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 流式场景请使用公开的 [useAnimationText](/composables/use-animation-text)。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { AnimationText } from '@blueking/chat-x'`。
 ## 源码事实
 
 - **源码位置**：`src/components/animation-text/animation-text.vue`
@@ -52,7 +56,7 @@ animationStyle = {
 </template>
 
 <script setup lang="ts">
-  import { AnimationText } from '@blueking/chat-x';
+  // AnimationText 组件未导出；公开 API 是 useAnimationText
 </script>
 ```
 

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

@@ -6,7 +6,7 @@
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 assistant 时创建
 - **tool-message** — 工具结果通过 toolCall.toolMessage 内联或独立 tool 消息关联展示
-- **toolcall-render** — 多条工具调用由 ToolcallRender 统一渲染
+- **toolcall-render** — 多条工具调用由 ToolCallRender 统一渲染
 - **file-artifact-panel** — property.artifacts 文件产物点击后在侧栏预览
 
 ---

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

@@ -136,6 +136,8 @@ ai-chat-container（:data-ai-size="size"）
 
 侧边栏默认包含「执行情况」Tab，展示所有工具调用和 FlowAgent 类型的 Activity 消息。支持关键词搜索过滤和点击定位到对话中的消息位置。Tab 标签内 `.ai-execution-summary-icon` 固定 16×16px，避免被 flex 压缩。
 
+面板内的消息虽与对话流复用同一套渲染链路，但按**只读回看**呈现：`ExecutionSummary` 会 provide 面板上下文，FlowAgent 失败节点在面板内不展示「重试 / 跳过」，只保留「详情」；对话流内不受影响。详见 [ExecutionSummary](/components/agent/execution-summary)。
+
 **展示条件**：侧栏是否渲染只取决于折叠态与是否存在可见 Tab —— `asideCollapsed === false` 且 `displayTabs` 非空即展开，与 `executionGroups`、`keyword`、是否有文件产物均无关。无执行数据时 `ExecutionSummary` 展示自身空态，无文件产物时 `FileArtifactPanel` 展示整块空态。`renderMode === Share` 分享态同样按折叠态展示侧栏（开放只读查看流程智能体详情/证据/执行情况），仅底部输入区保持隐藏。
 
 **展开 / 折叠由外部判断（严格受控）**：只要传入了 `asideCollapsed`，折叠态就**一律以外部值为准**。容器内部的展开动作（点击文件卡片预览、`addCustomTab` 打开节点详情等）只发出 `update:asideCollapsed` 请求，外部不改值就不会展开 —— 所以务必用 `v-model:asideCollapsed` 绑定，只写 `:aside-collapsed` 会让这些内部入口失效。完全不传该 prop 时退化为组件内部状态（默认折叠），内部入口照常生效。容器不会因为数据变空而自动收起或重置自定义 Tab。
@@ -737,7 +739,7 @@ ai-chat-container（:data-ai-size="size"）
 
 ### Props
 
-ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`（排除 `enableSelection` 和 `messageGroups`），另外新增：
+ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`（排除 `enableSelection`、`messageGroups`、`messageToolsTippyOptions`），另外新增：
 
 | 属性名                    | 类型                                                                                     | 默认值    | 说明                                                                                                                                 |
 | ------------------------- | ---------------------------------------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------ |

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

@@ -538,6 +538,7 @@ const defaultFiles: UploadFile[] = [
 | focus              | `() => void`                      | 聚焦编辑器并把光标置于末尾                       |
 | insertMention      | `(item: IInputMenuItem) => void`  | 把条目以标签形式追加到文档末尾（不依赖当前光标） |
 | triggerSendMessage | `() => void`                      | 手动触发发送逻辑                                 |
+| uploadedArtifacts  | `AIFileInfo[]`                    | 已上传且带 `outputId` 的附件列表（只读）         |
 
 ## 键盘快捷键
 

package/dist/mcp/generated/docs/cite-content.md

@@ -10,6 +10,10 @@
 <!-- FULL DOC -->
 
 # CiteContent 引用内容
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ChatInput](/components/input/chat-input) 的 `v-model:cite` 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { CiteContent } from '@blueking/chat-x'`。
 ## 源码事实
 
 - **源码位置**：`src/components/chat-content/cite-content/cite-content.vue`
@@ -44,7 +48,7 @@
 </template>
 
 <script setup lang="ts">
-  import { CiteContent } from '@blueking/chat-x';
+  // CiteContent 未从包入口导出；文档站 demo 使用页面顶部相对路径
 </script>
 ```
 
@@ -62,7 +66,7 @@
 </template>
 
 <script setup lang="ts">
-  import { CiteContent } from '@blueking/chat-x';
+  // CiteContent 未从包入口导出；文档站 demo 使用页面顶部相对路径
 
   const handleClose = (content: string) => {
     // content 即当前引用文本，可用于日志或状态清除

package/dist/mcp/generated/docs/common-error-content.md

@@ -10,7 +10,13 @@
 ---
 <!-- FULL DOC -->
 
-# CommonErrorContent 通用错误内容
+# commonErrorContent 通用错误内容
+
+| 名称 | 种类 |
+| --- | --- |
+| `CommonErrorContent` | 源码 SFC / 模板别名 |
+| `commonErrorContent` | 包入口导出名 |
+
 ## 源码事实
 
 - **源码位置**：`src/components/chat-content/common-error-content/common-error-content.vue`
@@ -40,7 +46,7 @@
 </template>
 
 <script setup lang="ts">
-  import { CommonErrorContent } from '@blueking/chat-x';
+  import { commonErrorContent as CommonErrorContent } from '@blueking/chat-x';
 </script>
 ```
 

package/dist/mcp/generated/docs/delete-tool.md

@@ -11,6 +11,11 @@
 <!-- FULL DOC -->
 
 # DeleteTool 删除确认按钮
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [MessageTools](/components/feedback/message-tools)（`id === 'delete'`）使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { DeleteTool } from '@blueking/chat-x'`。
+
 ## 源码事实
 
 - **源码位置**：`src/components/message-tools/delete-tool/delete-tool.vue`
@@ -54,7 +59,7 @@ disabled=true 时：Tippy onShow 返回 false，弹窗不打开
 </template>
 
 <script setup lang="ts">
-  import { DeleteTool } from '@blueking/chat-x';
+  // DeleteTool 未从包入口导出；文档站 demo 使用页面顶部相对路径
 
   const handleConfirm = () => {
     console.log('用户确认删除，执行删除操作');

package/dist/mcp/generated/docs/desc-panel.md

@@ -12,6 +12,10 @@
 <!-- FULL DOC -->
 
 # DescPanel 描述面板
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ToolCallRender](/components/agent/toolcall-render) 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { DescPanel } from '@blueking/chat-x'`。
 ## 源码事实
 
 - **源码位置**：`src/components/tool-call/desc-panel/desc-panel.vue`
@@ -97,7 +101,7 @@ const data = computed(() => {
 </template>
 
 <script setup lang="ts">
-  import { DescPanel } from '@blueking/chat-x';
+  // DescPanel 未从包入口导出；文档站 demo 使用页面顶部相对路径
 </script>
 ```
 

package/dist/mcp/generated/docs/detail-section.md

@@ -12,6 +12,8 @@ FlowAgent 节点详情中的标题/内容分段容器。 源码位置：src/comp
 
 # DetailSection 详情分段
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+
 > **能力域**：Agent 能力
 
 `DetailSection` 是 FlowAgent 节点详情页中的轻量分段容器，用于给一组相关信息提供统一标题样式。组件自身只负责渲染标题和默认插槽，不处理数据格式、折叠、空态或表格逻辑。
@@ -39,7 +41,7 @@ FlowAgent 节点详情中的标题/内容分段容器。 源码位置：src/comp
 </template>
 
 <script setup lang="ts">
-  import DetailSection from '@blueking/chat-x/src/components/chat-content/flow-agent-content/detail-section.vue';
+  // DetailSection 未从包入口导出；文档站 demo 使用页面顶部相对路径
 </script>
 ```
 

package/dist/mcp/generated/docs/execution-summary.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-按消息流提取执行摘要，支持关键词定位和消息渲染。 源码位置：src/components/execution-summary/execution-summary.vue。
+按消息流提取执行摘要，支持关键词定位和消息渲染。 通过 useExecutionPanelProvider 提供 EXECUTION_PANEL_TOKEN，面板内消息按只读呈现， FlowAgent 失败节点在面板内不展示重试/跳过，只保留详情。 源码位置：src/components/execution-summary/execution-summary.vue。
 
 ### 关联组件
 - **message-render** — 摘要列表内渲染消息内容
@@ -30,6 +30,7 @@
 - **关键词搜索**：实时过滤匹配的执行记录
 - **对话定位**：hover 显示「在对话中定位」按钮，点击滚动到对应消息
 - **空状态处理**：无数据或搜索无结果时显示空状态提示
+- **面板上下文（只读呈现）**：组件 setup 时通过 `useExecutionPanelProvider()` 提供 `EXECUTION_PANEL_TOKEN`，供内部消息组件识别「当前处于侧栏面板内」并隐藏交互操作。目前 `FlowAgentContent` 据此不展示节点「重试 / 跳过」，只保留「详情」
 
 ## 基础用法
 
@@ -93,6 +94,27 @@ ai-execution-summary
 />
 ```
 
+## 面板内的消息按只读呈现
+
+面板与对话流复用同一套渲染链路（`MessageRender` → `ContentRender` → 具体内容组件），但面板定位是「回看执行过程」，不承载操作。为此组件在 setup 阶段 provide 面板上下文：
+
+```typescript
+// 源码：src/composables/use-common.ts（内部上下文，未从包入口导出）
+import { useExecutionPanelProvider } from '../../composables/use-common';
+
+// 面板身份在组件树中恒定，provide 常量 true 即可，无需响应式
+useExecutionPanelProvider();
+```
+
+内容组件用 `useExecutionPanelInject()` 读取（缺省 `false`，即对话流内）。当前的差异：
+
+| 内容 | 对话流内 | 侧栏「执行情况」面板内 |
+| ---- | -------- | ---------------------- |
+| FlowAgent 失败节点「重试 / 跳过」 | 展示（依赖 `retryable` / `skippable`） | **不展示** |
+| FlowAgent 节点「详情」 | 展示 | 展示 |
+
+新增内容组件若也需要区分这两种场景，同样注入 `useExecutionPanelInject()` 即可，不必扩展 props。`EXECUTION_PANEL_TOKEN` 与这两个函数同属 `use-common.ts` 的内部上下文，未从 `@blueking/chat-x` 包入口导出，仅供库内组件使用。详见 [FlowAgentContent](/components/agent/flow-agent-content)。
+
 ## API
 
 ### Props

package/dist/mcp/generated/docs/file-content.md

@@ -11,6 +11,10 @@
 <!-- FULL DOC -->
 
 # FileContent 文件内容展示
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ChatInput](/components/input/chat-input) / [UserMessage](/components/message/user-message) 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { FileContent } from '@blueking/chat-x'`。
 ## 源码事实
 
 - **源码位置**：`src/components/chat-content/file-content/file-content.vue`
@@ -62,7 +66,8 @@ MIME 类型非 `image/*` 的文件，渲染为固定宽 180px 的文件卡片（
 
 <script setup lang="ts">
   import { ref } from 'vue';
-  import { FileContent, type UploadFile } from '@blueking/chat-x';
+  import type { UploadFile } from '@blueking/chat-x';
+  // FileContent 未从包入口导出；文档站 demo 使用相对路径 FileContentComp
 
   const files = ref<Partial<UploadFile>[]>([
     { file: new File(['content'], 'report.pdf', { type: 'application/pdf' }) },
@@ -117,7 +122,8 @@ MIME 为 `image/*` 时渲染为图片缩略图（`cursor: zoom-in`）。点击
 
 <script setup lang="ts">
   import { ref } from 'vue';
-  import { FileContent, type UploadFile } from '@blueking/chat-x';
+  import type { UploadFile } from '@blueking/chat-x';
+  // FileContent 未从包入口导出；文档站 demo 使用相对路径 FileContentComp
 
   const imageFiles = ref<Partial<UploadFile>[]>([
     { url: 'https://example.com/cat.jpg', filename: 'cat.jpg', mimeType: 'image/jpeg' },

package/dist/mcp/generated/docs/file-upload-btn.md

@@ -112,6 +112,8 @@
 
 > `accept` 仅影响文件选择框的过滤 UI，不做服务端验证，请在 `upload` 回调中自行校验 MIME 类型。
 
+传入 `accept` 后，按钮 tooltip 会在「最多 N 个 / 单个最大 MB」下一行补格式说明：等于 `DEFAULT_UPLOAD_ACCEPT` 时用 `formatDefaultUploadAcceptTip`（分类文案），否则为 `支持格式：{accept}`。缺省 `accept` 时只有数量与大小，不写格式行。这两个工具函数与常量从 `@blueking/chat-x` 的 utils 导出。
+
 ## 自定义图标
 
 通过默认插槽替换上传图标：
@@ -130,7 +132,7 @@
 
 | 属性名       | 类型           | 默认值 | 说明                                                                       |
 | ------------ | -------------- | ------ | -------------------------------------------------------------------------- |
-| accept       | `string`       | —      | 文件选择框过滤类型，遵循 `<input accept>` 规范；缺省时不下发，不限制类型 |
+| accept       | `string`       | —      | 文件选择框过滤类型，遵循 `<input accept>` 规范；缺省时不下发、不限制类型，tooltip 也不展示格式行；有值时 tooltip 追加格式说明 |
 | multiple     | `boolean`      | `true` | 声明属性（当前版本未实际绑定到 input，始终多选）                           |
 | tippyOptions | `AITippyProps` | —      | 扩展 tooltip 配置，会与内置配置合并                                        |
 

package/dist/mcp/generated/docs/flow-agent-content.md

@@ -13,6 +13,10 @@
 
 # FlowAgentContent FlowAgent 执行内容
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [MessageRender](/components/message/message-render) 渲染 `role: 'activity'`（见本页「推荐入口」）。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { FlowAgentContent } from '@blueking/chat-x'`。
+
 > **能力域**：Agent 能力
 
 渲染 FlowAgent（标准运维 / 流程编排）执行过程的活动组件，以「任务 → 节点」两级结构展示执行状态、耗时统计与详情入口。组件内部消费 `useCustomTabConsumer`，点击节点「详情」会向侧栏的自定义 Tab 注入 `FlowAgentNodeDetail` 渲染节点输入输出。
@@ -33,6 +37,7 @@
 - **重试 / 跳过进行中态**：点击后节点行进入 `is-pending`，按钮组常驻显示（无需 hover）；进行中按钮切换为 loading +「重试中 / 跳过中」，重试与跳过互斥禁用；被阻塞按钮 hover 显示提示（如「任务正在重试中，不可跳过」）；详情不受影响。pending 以 `task_id:node_id:retry` 为键，后端 `retry` 计数变化后自动失效
 - **详情入口联动**：「详情」按钮点击后通过自定义 Tab 挂载 `FlowAgentNodeDetail`
 - **分享态只读查看**：`RenderMode.Share` 下保留耗时、「详情」「有效证据」等只读查看入口，仅隐藏「重试 / 跳过」等交互式 resume 操作
+- **侧栏执行情况面板只读**：侧栏「执行情况」Tab 内经 `ExecutionSummary` 渲染的同一组件同样只保留「详情」，不展示「重试 / 跳过」；面板身份由 `ExecutionSummary` 通过 `EXECUTION_PANEL_TOKEN` 提供，组件以 `useExecutionPanelInject` 读取。因此重试 / 跳过只出现在对话流内的执行情况
 
 ## 状态映射
 
@@ -61,8 +66,8 @@
 </template>
 
 <script setup lang="ts">
-  import { FlowAgentContent } from '@blueking/chat-x';
   import type { BkFlowMessageContent, OnInterruptResume } from '@blueking/chat-x';
+  // FlowAgentContent 未从包入口导出；文档站 demo 使用相对路径 FlowAgentContentComp
 
   const messageUid = 'flow-msg-1';
   const status = 'success';
@@ -94,7 +99,7 @@
 
 ## 失败节点重试 / 跳过
 
-失败节点（`convergedState === 'failed'`）且具备对应能力位时，hover 行尾展示「重试」或「跳过」按钮。点击后：
+失败节点（`convergedState === 'failed'`）且具备对应能力位时，在**对话流内**的执行情况 hover 行尾展示「重试」或「跳过」按钮（侧栏「执行情况」面板与 Share 分享态不展示，见下方显隐条件）。点击后：
 
 1. 节点行添加 `is-pending` class，按钮组常驻显示（设计稿：鼠标移出后仍可见进行中反馈）
 2. 被点击按钮进入 loading +「重试中 / 跳过中」，重试与跳过均禁用（`is-disabled`，置灰色 `#c4c6cc`）
@@ -125,11 +130,11 @@ onInterruptResume?.({
 
 | 按钮 | 显隐条件                              | 进行中表现                         | `operation`          |
 | ---- | ------------------------------------- | ---------------------------------- | ---------------------- |
-| 重试 | 失败态且 `node.retryable === true`    | loading +「重试中」，二者均禁用    | `flow_node_retry`      |
-| 跳过 | 失败态且 `node.skippable === true`    | loading +「跳过中」，二者均禁用    | `flow_node_skip`       |
-| 详情 | 始终展示（含 Share 分享态）           | 不受 pending 影响                  | —（打开侧栏 Tab，不走 resume） |
+| 重试 | 失败态且 `node.retryable === true`；且不在 Share 分享态、不在侧栏「执行情况」面板内 | loading +「重试中」，二者均禁用    | `flow_node_retry`      |
+| 跳过 | 失败态且 `node.skippable === true`；且不在 Share 分享态、不在侧栏「执行情况」面板内 | loading +「跳过中」，二者均禁用    | `flow_node_skip`       |
+| 详情 | 始终展示（含 Share 分享态与侧栏面板） | 不受 pending 影响                  | —（打开侧栏 Tab，不走 resume） |
 
-行尾操作由内部 composable [`useFlowNodeActions`](/composables/use-flow-node-actions) 聚合为声明式列表，组件层仅遍历渲染。
+行尾操作由内部 composable [`useFlowNodeActions`](/composables/use-flow-node-actions) 聚合为声明式列表，组件层仅遍历渲染；两类只读场景合并为它的 `hideResumeActions` 入参。
 
 ## 节点详情联动
 
@@ -140,7 +145,7 @@ addCustomTab?.({
   label: node.name,
   name: `${task.task_id}|${node.id}|${node.name}`,
   data: {
-    component: BkFlowNodeDetail,
+    component: FlowAgentNodeDetail,
     messageUid: props.messageUid,
     props: {
       loading: true,
@@ -176,9 +181,9 @@ ActivityLayout（activity-type=flow_agent，v-model:collapsed）
             └── node-trailing（含 Share 分享态）
                 ├── node-time（节点耗时，hover / pending 时隐藏）
                 └── node-actions（hover 或 `is-pending` 时显示，间距 12px）
-                    ├── node-action-btn「重试」（失败 + retryable；Share 态隐藏；进行中 loading + 禁用）
-                    ├── node-action-btn「跳过」（失败 + skippable；Share 态隐藏；进行中 loading + 禁用）
-                    └── node-action-btn「详情」（始终可用，含 Share 态，点击挂载详情 Tab）
+                    ├── node-action-btn「重试」（失败 + retryable；Share 态与侧栏面板隐藏；进行中 loading + 禁用）
+                    ├── node-action-btn「跳过」（失败 + skippable；Share 态与侧栏面板隐藏；进行中 loading + 禁用）
+                    └── node-action-btn「详情」（始终可用，含 Share 态与侧栏面板，点击挂载详情 Tab）
 ```
 
 ## API
@@ -187,14 +192,17 @@ ActivityLayout（activity-type=flow_agent，v-model:collapsed）
 
 | 属性名     | 类型                     | 必填 | 默认值      | 说明                                                                       |
 | ---------- | ------------------------ | ---- | ----------- | -------------------------------------------------------------------------- |
-| content    | `BkFlowMessageContent`   | 否   | `[{}]`      | 任务数组；传入单个 `BkFlowTask` 时自动包装为单元素数组                       |
+| content    | `BkFlowMessageContent`   | 否   | —           | 任务数组；传入单个 `BkFlowTask` 时自动包装为单元素数组                       |
+| collapsed  | `boolean`                | 否   | `false`     | `v-model:collapsed`，控制活动布局折叠                                       |
 | messageUid | `string`                 | 否   | —           | 所属消息唯一标识，注入到节点详情 Tab 的 `data.messageUid`，用于异步回填数据 |
 | onInterruptResume | `OnInterruptResume` | 否   | —           | 节点「重试 / 跳过」与第三方审批取消复用同一回调，按 `payload.operation` 分流；流程节点操作时不传 `interrupt` |
 | status     | `MessageStatus`          | 否   | —           | 消息状态；`pending` / `streaming` 时标题栏显示加载动画                       |
 
 ### Emits
 
-- 无。
+| 事件名 | 说明 |
+| --- | --- |
+| `update:collapsed` | `v-model:collapsed` 回写 |
 
 ### Slots
 
@@ -242,7 +250,7 @@ interface BkFlowNode {
 
 - `AiLoading` — 标题栏流式加载动画
 - `ActivityLayout` — 可折叠活动容器外壳
-- `BkFlowNodeDetail` — 节点详情面板（经自定义 Tab 挂载）
+- `FlowAgentNodeDetail` — 节点详情面板（经自定义 Tab 挂载）
 - `Loading`（bkui-vue） — 运行中状态的旋转指示
 - `HighlightKeyword` — 任务 / 节点名称的搜索关键词高亮
 
@@ -254,8 +262,9 @@ interface BkFlowNode {
 4. **`task_outputs` 暂不渲染**：模板中任务输出展示区块已注释，传入也不会显示。
 5. **未知状态兜底为 `running`**：`getConvergedState` 对未识别的原始状态统一归为运行中。
 6. **Share 模式只读查看**：`RenderMode.Share` 下保留节点/任务耗时与「详情」「有效证据」查看入口，仅过滤「重试 / 跳过」等交互式 resume 操作（由 `useFlowNodeActions` 的 `hideResumeActions` 收敛）。
-7. **`onInterruptResume` 透传链路**：`MessageRender` → `ActivityMessage` → `FlowAgentContent`；未传入时重试 / 跳过按钮仍展示但点击无回调。
-8. **pending 自动收敛**：`useFlowNodeActions` 以 `task_id:node_id:retry` 为 pending 键；节点重试再次失败（`retry` +1）后键变化，进行中态自动解除，无需手动清理。
+7. **侧栏「执行情况」面板同为只读**：面板内经 `ExecutionSummary` → `MessageRender` 渲染的本组件不展示「重试 / 跳过」，只保留「详情」；判定来自 `useExecutionPanelInject()`（内部上下文，未从包入口导出；缺省 `false`），与 Share 态一起并入 `hideResumeActions`。因此脱离 `ExecutionSummary` 独立使用组件时，行为与对话流内一致。
+8. **`onInterruptResume` 透传链路**：`MessageRender` → `ActivityMessage` → `FlowAgentContent`；未传入时重试 / 跳过按钮仍展示但点击无回调。
+9. **pending 自动收敛**：`useFlowNodeActions` 以 `task_id:node_id:retry` 为 pending 键；节点重试再次失败（`retry` +1）后键变化，进行中态自动解除，无需手动清理。
 
 ## 关联组件
 

package/dist/mcp/generated/docs/flow-agent-node-detail.md

@@ -14,6 +14,9 @@
 
 # FlowAgentNodeDetail FlowAgent 节点详情
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 由 [FlowAgentContent](/components/agent/flow-agent-content) 挂到自定义 Tab。
+
 > **能力域**：Agent 能力
 
 `FlowAgentNodeDetail` 用于展示 FlowAgent 单个节点的配置与输出详情。它通常被 `FlowAgentContent` 通过自定义 Tab 挂载到侧栏，应用层再根据 `messageUid`、`task_id`、`node_id` 拉取真实节点详情并回填到 `data`。
@@ -53,7 +56,7 @@
 </template>
 
 <script setup lang="ts">
-  import FlowAgentNodeDetail from '@blueking/chat-x/src/components/chat-content/flow-agent-content/flow-agent-node-detail.vue';
+  // FlowAgentNodeDetail 未从包入口导出；文档站 demo 使用页面顶部相对路径
   import type { NodeDetailData } from '@blueking/chat-x';
 
   const nodeDetailData: Partial<NodeDetailData> = {
@@ -127,7 +130,7 @@ addCustomTab?.({
   label: node.name,
   name: `${task.task_id}|${node.id}|${node.name}`,
   data: {
-    component: BkFlowNodeDetail,
+    component: FlowAgentNodeDetail,
     messageUid: props.messageUid,
     props: {
       loading: true,