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

package/dist/lang/lang.d.ts

@@ -156,5 +156,8 @@ export declare const lang: {
     readonly 搜索文件关键字: "Search file keyword";
     readonly 预览加载失败: "Failed to load preview";
     readonly 暂无可预览的文件: "No file to preview";
+    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";
 };
-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" | "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" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具" | "读取 Skill" | "正在调用" | "正在读取" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "快速思考" | "图生文" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "昨天" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "重试" | "重试中" | "跳过中" | "任务正在重试中，不可跳过" | "任务正在跳过中，不可重试" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP" | "更多" | "算法方案评审单" | "评审中" | "审批中" | "已废弃" | "已批准" | "已通过" | "已取消" | "已过期" | "已拒绝" | "已撤销" | "单据编号" | "提交时间" | "当前处理人" | "无" | "查看单据详情" | "复制单据" | "复制单据链接" | "取消审批" | "已取消审批" | "刷新单据状态" | "单据已取消审批" | "该单据已被拒绝，无法取消" | "该单据已通过，无法取消" | "单据已取消，无需重复点击" | "当前状态无法取消审批" | "当前会话有 {count} 个待审批单，如需继续，请先取消审批" | "暂不支持的中断消息" | "检索中" | "检索完成" | "上传文件" | "选择模型" | "搜索模型关键字" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传文件，最多支持 {count} 个，单个最大 {size}MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏" | "请选择以继续" | "继续" | "收到信息：" | "待审批" | "已审批" | "完成" | "跳过" | "单选" | "多选" | "其他" | "已完成" | "题" | "回答内容" | "已回复" | "请输入..." | "文件产物" | "文件列表" | "搜索文件关键字" | "预览加载失败" | "暂无可预览的文件";
+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" | "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" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具" | "读取 Skill" | "正在调用" | "正在读取" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "快速思考" | "图生文" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "昨天" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "重试" | "重试中" | "跳过中" | "任务正在重试中，不可跳过" | "任务正在跳过中，不可重试" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP" | "更多" | "算法方案评审单" | "评审中" | "审批中" | "已废弃" | "已批准" | "已通过" | "已取消" | "已过期" | "已拒绝" | "已撤销" | "单据编号" | "提交时间" | "当前处理人" | "无" | "查看单据详情" | "复制单据" | "复制单据链接" | "取消审批" | "已取消审批" | "刷新单据状态" | "单据已取消审批" | "该单据已被拒绝，无法取消" | "该单据已通过，无法取消" | "单据已取消，无需重复点击" | "当前状态无法取消审批" | "当前会话有 {count} 个待审批单，如需继续，请先取消审批" | "暂不支持的中断消息" | "检索中" | "检索完成" | "上传文件" | "选择模型" | "搜索模型关键字" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传文件，最多支持 {count} 个，单个最大 {size}MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏" | "请选择以继续" | "继续" | "收到信息：" | "待审批" | "已审批" | "完成" | "跳过" | "单选" | "多选" | "其他" | "已完成" | "题" | "回答内容" | "已回复" | "请输入..." | "文件产物" | "文件列表" | "搜索文件关键字" | "预览加载失败" | "暂无可预览的文件" | "文件上传中，请稍候" | "存在上传失败的文件，请删除后重试" | "上传失败";

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

@@ -703,7 +703,7 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 | 属性名                    | 类型                                                                                     | 默认值    | 说明                                                                                                                                 |
 | ------------------------- | ---------------------------------------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | chatLoading               | `boolean`                                                                                | —         | 整体加载状态，`true` 时显示 Loading 遮罩                                                                                             |
-| commonTippyOptions        | `AITippyProps`                                                                           | —         | 通用 Tippy 配置，注入到所有使用 `v-overflow-tips` 的子组件                                                                           |
+| commonTippyOptions        | `AITippyProps`                                                                           | —         | 通用 Tippy 配置，注入到所有使用 `v-overflow-tips` 的子组件。原样透传，仅全屏态强制把 `appendTo` 改为全屏容器；未传 `appendTo` 时不注入该字段，各浮层沿用自身默认挂载点 |
 | executionTabVisible       | `boolean`                                                                                | `true`    | 「执行情况」Tab 是否展示；为 `false` 时从 Tab 栏隐藏，若正被选中则切到首个可见 Tab                                                   |
 | getSideRenderComponent    | `(h, props?) => VNode \| undefined`                                                      | —         | 自定义侧栏内容区渲染；未返回时使用 `selectedTab.data.component`                                                                      |
 | getSideTabRenderComponent | `(h, tab, { removeCustomTab }) => VNode \| undefined`                                    | —         | 自定义侧栏 Tab 标签渲染；未返回时使用默认图标 + 文案 + 关闭按钮                                                                      |

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

@@ -325,8 +325,9 @@ const handleSendMessage = async (
 
 - 底部工具栏出现文件上传按钮（在快捷指令左侧）
 - 支持**点击选择**、**拖拽上传**、**粘贴上传**（Ctrl+V）
-- `onUpload` 每次传入**单个** `File`，返回 `{ download_url?: string }`
+- `onUpload` 每次传入**单个** `File`，返回 `{ download_url?: string; id?: string; status?: 'failed' | 'success' }`
 - 文件自动去重（基于 `name + size + lastModified` 复合键），不会重复上传
+- **上传中或存在失败附件时禁止发送**（点击、Enter、`triggerSendMessage` 均拦截）。失败附件需用户删除后才能再发；不要把附件 Pending 映射成 `MessageStatus.Pending`
 - 发送成功后，`uploadFiles` 自动清空
 
 **个数与大小校验（与 `FileUploadBtn` 分工）**：
@@ -604,7 +605,7 @@ const handleSendMessage = async (
 | tippyOptions       | `AITippyProps`                                                             | —        | -    | 透传给 FileUploadBtn 和 InputAttachment 的 tooltip 配置 |
 | onSendMessage      | `(content: UserMessage['content'], docSchema: TagSchema, options?: { interrupt?: Interrupt; payload?: InterruptResume }) => Promise<void>` | -        | -    | 发送消息回调，无文件时 content 为字符串，有文件时为数组；经 [ChatContainer](/components/setup/chat-container) 使用时，存在待回答 UserQuestion 会传入第三参数 `options` |
 | onStopSending      | `() => Promise<void>`                                                      | -        | -    | 停止发送回调，点击停止按钮时触发                        |
-| onUpload           | `(file: File) => Promise<{ download_url?: string }>`                       | -        | -    | 文件上传回调（每次单文件）                              |
+| onUpload           | `(file: File) => Promise<{ download_url?: string; error?: string; id?: string; status?: 'failed' \| 'success' }>` | -        | -    | 文件上传回调（每次单文件）；上传中/失败附件会阻塞发送 |
 
 ### 默认占位符
 

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染文件附件，支持图片预览和下载事件。 源码位置：src/components/chat-content/file-content/file-content.vue。
+渲染文件附件，支持图片预览、上传中/失败态和下载事件。 源码位置：src/components/chat-content/file-content/file-content.vue。
 
 ### 关联组件
 - **image-preview** — 点击图片缩略图打开全屏预览
@@ -15,18 +15,19 @@
 
 - **源码位置**：`src/components/chat-content/file-content/file-content.vue`
 - **能力域**：媒体文件
-- **能力说明**：渲染文件附件，支持图片预览和下载事件。
+- **能力说明**：渲染文件附件，支持图片预览、上传中/失败态和下载事件。
 
 > **能力域**：媒体文件
 
-文件列表展示组件，支持图片缩略图预览、点击图片全屏预览（`ImagePreview`）、文件卡片展示（类型图标 / 文件名 / 文件大小）、图片加载失败占位和删除操作。
+文件列表展示组件，支持图片缩略图预览、点击图片全屏预览（`ImagePreview`）、文件卡片展示（类型图标 / 文件名 / 文件大小）、上传中/失败态、图片加载失败占位和删除操作。
 
-内部由两个子组件承载单项渲染：
+内部由三个子组件承载单项渲染：
 
 | 子组件             | 源码位置                                                            | 职责                                          |
 | ------------------ | ------------------------------------------------------------------- | --------------------------------------------- |
-| `UploadImageItem`  | `src/components/chat-content/file-content/upload-image-item.vue`  | 图片缩略图、加载失败占位、hover 删除徽标      |
-| `UploadFileItem`   | `src/components/chat-content/file-content/upload-file-item.vue`   | 180px 文件卡片（`FileIcon` + 文件名 + 大小） |
+| `UploadImageItem`  | `src/components/chat-content/file-content/upload-image-item.vue`  | 图片缩略图、上传中遮罩、失败占位、hover 删除徽标 |
+| `UploadFileItem`   | `src/components/chat-content/file-content/upload-file-item.vue`   | 180px 文件卡片（`FileIcon` + 文件名 + 大小 / 失败文案） |
+| `UploadSpinner`    | `src/components/chat-content/file-content/upload-spinner.vue`     | 16px 白色环形 loading，文件与图片共用         |
 
 ## 渲染决策逻辑
 
@@ -37,9 +38,12 @@ splitUploadFiles(files)  // 单次遍历
 ├── 图片组（.ai-files-content-row.is-images）
 │     判定依据：mimeType 或 file.file?.type 以 'image/' 开头
 │     src：file.url 优先，否则用本地 File 的 blob URL（按 key 缓存，移除 / 卸载时 revoke）
-│     加载失败 → 错误占位（粉色背景 + 红色边框 + 灰色图标），且不进入预览列表
+│     加载失败或 status=error → 错误占位（粉色背景 + 红色边框 + 灰色图标），且不进入预览列表
+│     status=pending → 半透明遮罩 + 16px 环形 loading，禁止点击预览
 └── 文件组（.ai-files-content-row.is-files）
       文件卡片：类型图标（FileIcon，按文件名解析扩展名）+ 文件名 + 文件大小
+      status=pending → 半透明遮罩 + 16px 环形 loading
+      status=error → 浅红底 + 红边框，第二行展示「上传失败」
 ```
 
 > **是否为图片只看 MIME，不看 `url`。** 解除上传类型限制后，任意文件上传成功都会拿到 `url`，若按 `url` 判断会把 PDF / DOC 渲染成破图。因此 `url` 只决定 `<img src>` 从哪里来，不参与图片判定。
@@ -124,9 +128,21 @@ MIME 为 `image/*` 时渲染为图片缩略图（`cursor: zoom-in`）。点击
 
 > **预览行为**：组件内部自动维护 `ImagePreview` 实例，无需外部管理预览状态。只有加载成功的图片才会进入预览列表，加载失败的图片被自动过滤。
 
+## 上传中 / 上传失败
+
+`FileContent` 消费每项的 `status`（`UploadStatus`）。尺寸不变：文件卡片仍是 180×48，图片仍是定高 48、宽 48~120。loading 用共享的 `UploadSpinner`（16px 白环），不要用 `AiLoading`。删除徽标始终叠在遮罩之上。
+
+| status    | 文件卡片 | 图片缩略图 |
+| --------- | -------- | ---------- |
+| `pending` | `rgba(0,0,0,0.3)` 遮罩 + spinner | 保留预览图 + `rgba(0,0,0,0.5)` 遮罩 + spinner，点击不打开预览 |
+| `error`   | 背景 `#fff0f0`、边框 `#ea3636`，第二行「上传失败」 | 与加载失败相同的破图占位（18px `ImageErrorIcon`） |
+| `success` / 未设置 | 正常卡片 | 正常缩略图，可预览 |
+
+上传中与上传失败的图片都不会进入 `ImagePreview` 列表。`ChatInput` 在存在 `pending` / `error` 附件时会拦截发送（见 [ChatInput](/components/input/chat-input)）。
+
 ## 图片加载失败
 
-`<img>` 触发 `onerror` 时，切换为粉色背景 + 红色边框的错误占位：
+`<img>` 触发 `onerror` 时，切换为粉色背景 + 红色边框的错误占位（与 `status=error` 同一套 UI）：
 
 ## 混合文件（图片 + 文件）
 
@@ -238,6 +254,7 @@ MIME 为 `image/*` 时渲染为图片缩略图（`cursor: zoom-in`）。点击
 | `file.url` 有值     | `file.url`                                        | 打开全屏预览   |
 | 无 url、有 `File`   | `URL.createObjectURL(file.file)`（按 key 缓存）  | 打开全屏预览   |
 | 图片加载失败        | 错误占位                                          | 不进入预览列表 |
+| `status` 为 pending / error | 遮罩 loading 或错误占位                    | 不进入预览列表 |
 
 blob URL 按附件 key 缓存，同一文件重复渲染不会重复创建；文件被移除或组件卸载时统一 `revokeObjectURL`。
 
@@ -254,7 +271,7 @@ blob URL 按附件 key 缓存，同一文件重复渲染不会重复创建；文
 ```typescript
 import type { UploadFile, BinaryInputContent } from '@blueking/chat-x';
 
-// 上传状态（ChatInput 内部使用，FileContent 不使用此字段）
+// 上传状态：ChatInput 写入，FileContent 消费以渲染 pending / error
 enum UploadStatus {
   Pending = 'pending', // 上传中
   Success = 'success', // 上传成功
@@ -264,7 +281,7 @@ enum UploadStatus {
 // 上传文件（FileContent 的 files 数组中每一项）
 type UploadFile = BinaryInputContent & {
   file?: File; // 原始 File 对象，无则文件大小不显示
-  status?: UploadStatus; // 上传状态（ChatInput 使用，FileContent 不消费）
+  status?: UploadStatus; // 上传状态（pending 遮罩 loading，error 失败样式）
 };
 
 // 二进制内容基础类型

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-09-01T04:30:33.042Z",
+  "generatedAt": "2026-09-02T02:31:02.404Z",
   "domains": {
     "setup": {
       "label": "对话搭建",
@@ -1018,8 +1018,8 @@
       "name": "FileContent 文件内容",
       "slug": "file-content",
       "kind": "component",
-      "description": "渲染文件附件，支持图片预览和下载事件。",
-      "aiSummary": "渲染文件附件，支持图片预览和下载事件。 源码位置：src/components/chat-content/file-content/file-content.vue。",
+      "description": "渲染文件附件，支持图片预览、上传中/失败态和下载事件。",
+      "aiSummary": "渲染文件附件，支持图片预览、上传中/失败态和下载事件。 源码位置：src/components/chat-content/file-content/file-content.vue。",
       "relatedComponents": [
         {
           "slug": "image-preview",

package/package.json

@@ -1,26 +1,8 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.51-beta.2",
+  "version": "0.0.51-beta.3",
   "description": "蓝鲸智云 AI Chat 组件库 —— 遵循 AG-UI，为 AI Agent 和人类开发者共同设计的对话 UI 组件库。",
   "main": "index.js",
-  "scripts": {
-    "prepublishOnly": "vite --config vite.config.ts build && pnpm dts && pnpm mcp:build",
-    "dev": "vite --config vite.config.ts",
-    "dts": "vue-tsc --project tsconfig.dts.json",
-    "build": "vitest && vite --config vite.config.ts build && pnpm dts",
-    "preview": "vite --config vite.config.ts build --mode preview && pnpm dts",
-    "lint:script": "eslint . --ext .vue,.ts --fix",
-    "lint:style": "stylelint \"**/*.{scss,css,vue}\" --fix",
-    "lint:all": "pnpm lint:script && pnpm lint:style",
-    "test": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "wiki:dev": "vitepress dev wikis",
-    "wiki:build": "vitepress build wikis",
-    "mcp:build:index": "tsx mcp/scripts/build-index.ts",
-    "mcp:build": "tsc -p mcp/tsconfig.json && pnpm mcp:build:index",
-    "mcp:start": "node dist/mcp/index.js",
-    "mcp:dev": "tsx mcp/src/index.ts"
-  },
   "bin": {
     "chat-x-mcp": "dist/mcp/index.js"
   },
@@ -38,8 +20,7 @@
   "types": "dist/index.d.ts",
   "files": [
     "dist",
-    "README.md",
-    "skills"
+    "README.md"
   ],
   "keywords": [],
   "author": "Tencent BlueKing",
@@ -69,7 +50,6 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@blueking/chat-helper": "workspace:*",
     "@types/katex": "^0.16.7",
     "@types/lodash": "^4.17.23",
     "@types/markdown-it": "^14.1.2",
@@ -98,6 +78,24 @@
     "vite-bundle-analyzer": "^1.3.2",
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18",
-    "vue-tsc": "^3.1.4"
+    "vue-tsc": "^3.1.4",
+    "@blueking/chat-helper": "0.0.12-beta.29"
+  },
+  "scripts": {
+    "dev": "vite --config vite.config.ts",
+    "dts": "vue-tsc --project tsconfig.dts.json",
+    "build": "vitest && vite --config vite.config.ts build && pnpm dts",
+    "preview": "vite --config vite.config.ts build --mode preview && pnpm dts",
+    "lint:script": "eslint . --ext .vue,.ts --fix",
+    "lint:style": "stylelint \"**/*.{scss,css,vue}\" --fix",
+    "lint:all": "pnpm lint:script && pnpm lint:style",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "wiki:dev": "vitepress dev wikis",
+    "wiki:build": "vitepress build wikis",
+    "mcp:build:index": "tsx mcp/scripts/build-index.ts",
+    "mcp:build": "tsc -p mcp/tsconfig.json && pnpm mcp:build:index",
+    "mcp:start": "node dist/mcp/index.js",
+    "mcp:dev": "tsx mcp/src/index.ts"
   }
 }

package/skills/blueking-chat-x/SKILL.md

@@ -1,139 +0,0 @@
----
-name: blueking-chat-x
-description: >-
-  Use when 在消费方项目中接入 / 使用 @blueking/chat-x 对话组件库（已 npm 安装、非改库源码），
-  涉及「某组件怎么用、有哪些 props / events / slots / expose / v-model、怎么搭 AI 对话界面、
-  流式输出、停止生成、工具调用 ToolCall、快捷指令、文件上传、@ 资源、自定义消息或侧栏 Tab、
-  分享多选、HITL 中断审批、Markdown / 代码 / 公式 / 图表渲染、字号与主题 CSS 变量、
-  消息时间 MessageTime / timezone」等问题时优先使用。
-  若是在 packages/chat-x/src 内改库源码（写组件 / composable / 样式 / 测试），改用 chat-x-dev skill。
----
-
-# 使用 @blueking/chat-x
-
-帮助**消费方项目**（已 `npm i @blueking/chat-x`）快速理解组件库、查清每个组件的用法与 API，并写出正确的接入代码。
-
-本 skill 的组件资料在 `references/` 下，由 `scripts/generate-references.mjs` 从库的 `wikis/` 文档自动生成（剥离演示噪音、保留完整 API 与示例）。**它就是组件 API 的真相源**——不要凭记忆臆测 props/事件/插槽名。
-
-## 信息源优先级（先查再写）
-
-| 想知道什么 | 去哪里查（按优先级） |
-| --- | --- |
-| 某组件的 Props / Events / Slots / Expose / v-model / 用法 | ① `references/_index.md` 定位 slug → ② `references/components/<slug>.md`；③ 若项目装了 chat-x MCP，可用 `get_component_doc` / `search_docs` 交叉验证 |
-| 有哪些组件、按能力域怎么选 | `references/_index.md`（能力地图） |
-| composable / 类型 / 主题（字号、CSS 变量） | `references/composables/*`、`references/types/*`、`references/theme/*` |
-| 最小接入怎么写 | 本文「快速接入」一节 |
-
-> references 缺失或过期时，按本文「再生成 references」一节重新生成。
-
-## 心智模型（一句话）
-
-**消息驱动 + 角色分发**：业务维护一份 `Message[]` → `ChatContainer`（或 `useMessageGroup`）分组 → `MessageRender` 按 `message.role` 分发到具体消息组件 → `ContentRender` 按内容类型分发 → `MarkdownContent` 按 token 分发。
-
-接入心智：**你只负责维护 `messages` 数组和实现 `onSendMessage` 等回调**，组件负责渲染与交互。
-
-## 快速接入（ChatContainer 一站式，推荐入口）
-
-```vue
-<template>
-  <ChatContainer
-    v-model="input"
-    :messages="messages"
-    :message-status="messageStatus"
-    :on-send-message="handleSendMessage"
-    :on-stop-sending="handleStopSending"
-    @stop-streaming="handleStopStreaming"
-  />
-</template>
-
-<script setup lang="ts">
-  import { ref } from 'vue';
-  import { ChatContainer, MessageRole, MessageStatus, type Message, type TagSchema, type UserMessage } from '@blueking/chat-x';
-
-  const input = ref('');
-  const messages = ref<Message[]>([]);
-  const messageStatus = ref(MessageStatus.Complete);
-
-  const handleSendMessage = async (content: UserMessage['content'], docSchema: TagSchema) => {
-    messages.value.push({ id: `u_${Date.now()}`, messageId: `u_${Date.now()}`, role: MessageRole.User, content, status: MessageStatus.Complete });
-    const ai: Message = { id: `a_${Date.now()}`, messageId: `a_${Date.now()}`, role: MessageRole.Assistant, content: '', status: MessageStatus.Streaming };
-    messages.value.push(ai);
-    messageStatus.value = MessageStatus.Streaming;
-    // 接你的 SSE / WebSocket，把增量写入 ai.content
-    ai.status = MessageStatus.Complete;
-    messageStatus.value = MessageStatus.Complete;
-  };
-  const handleStopSending = async () => { messageStatus.value = MessageStatus.Stop; };
-  const handleStopStreaming = () => { messageStatus.value = MessageStatus.Stop; };
-</script>
-```
-
-前置依赖：`vue >= 3.5`、`bkui-vue 2.x`；样式随导入自动加载，无需手动引入。
-需要完全控制布局时改用「`MessageContainer` + `ChatInput` + `useMessageGroup`」组合——细节查 `references/components/message-container.md` 与 `chat-input.md`。
-
-## 怎么查一个组件（标准流程）
-
-1. 在 `references/_index.md` 里按名称/能力域找到组件，拿到它的 `path`。
-2. 读 `references/components/<slug>.md`：顶部是能力域 + 导入符号 + 概述 + 关联组件，正文含「核心能力 / 基础用法 / API（Props/Events/Slots/Expose/v-model）/ 类型定义」。
-3. 按 API 表格落地代码，需要的类型与常量从 `@blueking/chat-x` 具名导入。
-
-> 接入逻辑常跨多个组件（如 `ChatContainer` 透传 `ChatInput` / `MessageContainer` 的 props，自定义 `#message` 插槽需透传 `onAction` 等回调）。遇到「透传到底要带哪些参数」时，连同关联组件文档一起读。
-
-## 常见坑（消费方高频，先看再调）
-
-| 症状 | 原因 / 修法 |
-| --- | --- |
-| 自定义 `#message` 插槽后，用户消息的工具（删除/编辑/复制/引用）全失效，但 AI 消息工具正常 | 自定义 `#message` 渲染 `MessageRender` 时漏透传 `on-action` / `on-input-confirm` / `on-shortcut-confirm` / `tippy-options`；AI 消息工具在 `MessageContainer` 内部渲染不经过该插槽，故不受影响 |
-| 用户消息编辑态的 `ChatInput` 上传配置与主输入区不一致 | `supportUpload` 需全链路透传 `ChatContainer → MessageContainer → MessageRender → UserMessage`，否则回退默认 `true` |
-| 想自定义代码块头部动作（插入/应用代码）无从下手 | 用 `codeHeader` 插槽，参数为 `{ language, token }`（`AIBlueking/ChatBot` 已支持透传） |
-| `requestOptions.data` 不知道进 body 还是 query | POST/PUT/PATCH/DELETE 合并进 body；GET/HEAD/OPTIONS 合并进 query（params） |
-
-## 常见任务 → 入口
-
-| 任务 | 入口组件 / 文档 |
-| --- | --- |
-| 搭完整对话界面 | `components/chat-container.md` |
-| 自定义布局（自己拼消息列表 + 输入框） | `components/message-container.md` + `components/chat-input.md` + `composables/use-message-group.md` |
-| `/` Prompt、`@` 资源、文件上传 | `components/chat-input.md` |
-| 流式输出 / 停止生成 | `components/chat-container.md`（`messageStatus` + `@stop-streaming`） |
-| 工具调用 / ToolCall 渲染 | `components/toolcall-render.md`、`components/tool-message.md` |
-| HITL 中断 / 工具审批 / 用户提问 | `components/interrupt-message.md`、`components/tool-approval-card.md`、`components/user-question-card.md` |
-| FlowAgent 执行 / 知识召回展示 | `components/flow-agent-content.md`、`components/knowledge-rag-content.md` |
-| 渲染 Markdown / 代码 / 公式 / 图表 | `components/content-render.md`、`components/markdown-content.md`、`components/code-content.md` |
-| 图片预览 / 文件展示 | `components/ai-image.md`、`components/image-preview-group.md`、`components/file-content.md` |
-| 快捷指令表单 | `components/shortcut-render.md`、`components/chat-input.md` |
-| 分享 / 多选 | `components/chat-container.md`、`components/selection-footer.md` |
-| 自定义消息类型 / 侧栏 Tab | `composables/use-custom-tab.md` + `components/chat-container.md` |
-| 字号 / 主题 CSS 变量 | `theme/theme.md` |
-| 消息时间 / 时区 | `ChatContainer` 的 `timezone` prop；组件 `MessageTime`（wikis `components/feedback/message-time.md`）。四档：今天 `12:00` / 昨天 / 今年内 `3-12 12:00` / 跨年；无 `createdAt` 不渲染 |
-
-## 类型与常量速查
-
-```typescript
-// 类型按需具名导入
-import type { Message, UserMessage, AssistantMessage, ToolMessage, IToolBtn, Shortcut, TagSchema } from '@blueking/chat-x';
-
-// 枚举 / 预置工具
-import {
-  MessageRole, MessageStatus, MessageContentType,
-  CONST_MESSAGE_TOOLS,       // AI 消息默认工具：复制 / 引用 / 重新生成 / 分享
-  CONST_USER_MESSAGE_TOOLS,  // 用户消息默认工具：复制 / 引用 / 编辑 / 删除
-} from '@blueking/chat-x';
-```
-
-更全的类型/常量定义查 `references/types/*`。
-
-## 再生成 references
-
-references 由脚本从 `wikis/` 生成。当库升级、wikis 更新，或 references 缺失/过期时重新生成（**运行脚本前需经用户同意**）：
-
-```bash
-# 在 packages/chat-x 下执行（依赖 glob / gray-matter 已在 devDependencies）
-node skills/blueking-chat-x/scripts/generate-references.mjs
-```
-
-脚本会全量重建 `references/`：`glob wikis` → `gray-matter` 解析 frontmatter → 清洗正文（去 VitePress demo `<script>` / `<div class="demo">` / 内联 style，保留代码围栏与 API 表格）→ 按组件能力域 + composables/types/theme 写出 + 生成 `_index.md`。
-
-## 通用项目规则
-
-中文回复、不擅自处理 eslint/格式、运行脚本需先经同意、git 提交禁用 `--no-verify`、不确定先问——见仓库 `AGENTS.md` 与 `.cursor/rules/project.mdc`。

package/skills/blueking-chat-x/references/_index.md

@@ -1,131 +0,0 @@
-# @blueking/chat-x 能力地图（自动生成）
-
-> 由 `scripts/generate-references.mjs` 从 `wikis/` 生成，请勿手改。
-> 查某个能力时：先在本索引定位 slug，再读对应 `path` 的 reference 文档。
-
-> 生成时间：2026-09-01T03:51:31.378Z
-
-## 组件（按能力域）
-
-### 对话搭建
-
-- **ChatContainer 聊天容器** — 完整对话容器，组合消息列表、输入区、模型选择、快捷指令、执行摘要、分享选择和自定义 Tab。 → `components/chat-container.md`
-- **MessageContainer 消息列表容器** — 负责消息分组渲染、滚动控制、工具栏和消息插槽透传。 → `components/message-container.md`
-
-### 消息系统
-
-- **ActivityMessage 活动消息** — 按 activityType 分发 FlowAgent、知识召回、引用文档等活动内容。 → `components/activity-message.md`
-- **AssistantMessage AI 助手消息** — 渲染助手消息主体、工具调用与文件产物，默认插槽可覆盖正文渲染。 → `components/assistant-message.md`
-- **FileArtifactPanel 文件产物预览** — 汇总当前会话全部文件产物，支持搜索、选中与分类型预览，挂载在 ChatContainer 侧栏「文件产物」Tab。 → `components/file-artifact-panel.md`
-- **InfoMessage 信息消息** — 渲染居中的系统信息提示。 → `components/info-message.md`
-- **LoadingMessage 加载消息** — 消息列表中的加载占位，默认使用 AiLoading，也支持默认插槽覆盖。 → `components/loading-message.md`
-- **MessageRender 消息渲染器** — 按 message.role 分发到用户、助手、工具、推理、活动、中断等消息组件。 → `components/message-render.md`
-- **ReasoningMessage 推理消息** — 渲染推理过程，覆盖加载、错误与 Markdown 内容展示。 → `components/reasoning-message.md`
-- **ToolMessage 工具消息** — 渲染工具返回内容，JSON 场景交给 DescPanel + HighlightKeyword 展示。 → `components/tool-message.md`
-- **UserMessage 用户消息** — 渲染用户消息，支持纯文本、键值引用、文件附件和编辑态输入。 → `components/user-message.md`
-
-### 内容渲染
-
-- **AnimationText 动画文本** — 按文本增量播放流式动画。 → `components/animation-text.md`
-- **CiteContent 引用内容** — 渲染输入或消息中的引用片段。 → `components/cite-content.md`
-- **CodeContent 代码块** — 渲染 Markdown 代码块，支持高亮、复制和 header 插槽。 → `components/code-content.md`
-- **CommonErrorContent 错误内容** — 展示统一错误提示内容。 → `components/common-error-content.md`
-- **ContentRender 内容渲染器** — 按 MessageContentType 分发 Markdown、文本、引用、键值、图片等内容。 → `components/content-render.md`
-- **DescPanel 描述面板** — 将文本或 JSON 内容降级为可读描述面板。 → `components/desc-panel.md`
-- **KeyValueContent 键值内容** — 以键值列表展示结构化内容。 → `components/key-value-content.md`
-- **LatexContent LaTeX 公式** — 使用 KaTeX 渲染 LaTeX 公式内容。 → `components/latex-content.md`
-- **MarkdownContent Markdown 内容渲染** — Markdown 主渲染器，集成代码块、公式、错误降级和 codeHeader 插槽。 → `components/markdown-content.md`
-- **MermaidContent Mermaid 图表** — 渲染 Mermaid 图表并处理渲染事件。 → `components/mermaid-content.md`
-- **ReferenceContent 引用来源** — 渲染引用文档/来源列表。 → `components/reference-content.md`
-- **TextContent 文本内容** — 渲染纯文本内容。 → `components/text-content.md`
-
-### 媒体文件
-
-- **AiImage 图片展示** — 图片展示组件，组合加载、错误、预览和 extra 插槽。 → `components/ai-image.md`
-- **FileContent 文件内容** — 渲染文件附件，支持图片预览和下载事件。 → `components/file-content.md`
-- **ImageContent 图片内容** — 渲染 Markdown 图片 token。 → `components/image-content.md`
-- **ImagePreview 图片预览** — 图片全屏预览容器，支持缩放、旋转、下载工具栏。 → `components/image-preview.md`
-- **ImagePreviewGroup 图片预览组** — 通过 provide/inject 管理同组图片预览。 → `components/image-preview-group.md`
-- **PreviewToolbar 图片预览工具栏** — 图片预览的缩放、旋转、下载等工具按钮。 → `components/preview-toolbar.md`
-
-### 输入交互
-
-- **AiPromptList Prompt 列表** — \ Prompt 选择列表，供 AiSlashInput 插入模板文本。 → `components/ai-prompt-list.md`
-- **AiSelection 划词选择** — 监听选中文本并展示快捷操作浮窗。 → `components/ai-selection.md`
-- **AiSkillList Skill 列表** — / Skill 选择列表，供 AiSlashInput 插入 Skill 标签。 → `components/ai-skill-list.md`
-- **AiSlashEditor 富文本编辑器** — 旧版富文本编辑器实现，封装 command selection 与提示菜单。 → `components/ai-slash-editor.md`
-- **AiSlashInput 富文本命令输入** — ChatInput 内部富文本输入，支持 / Skill、\ Prompt 与 @ 资源标签。 → `components/ai-slash-input.md`
-- **AiSlashMenu 资源菜单** — @ 资源选择菜单，展示资源项供 AiSlashInput 插入标签。 → `components/ai-slash-menu.md`
-- **ChatInput 聊天输入框** — 聊天输入区，组合富文本输入、快捷指令、附件、引用、发送/停止等交互。 → `components/chat-input.md`
-- **FileUploadBtn 文件上传按钮** — 文件选择按钮，封装 input[type=file] 并输出选择事件。 → `components/file-upload-btn.md`
-- **InputAttachment 输入附件区** — ChatInput 底部附件区布局，承载快捷按钮、文件与发送图标。 → `components/input-attachment.md`
-- **InputInfoAlert 输入提示条** — ChatInput 上方的信息提示条。 → `components/input-info-alert.md`
-- **ModelSelector 模型选择器** — 聊天输入区的模型下拉选择器，支持搜索过滤、能力标签与键盘导航。 → `components/model-selector.md`
-- **SelectionFooter 多选操作栏** — 消息多选/分享模式下的底部操作栏。 → `components/selection-footer.md`
-- **ShortcutBtn 快捷指令按钮** — 单个快捷指令按钮，支持默认/append 插槽和 expose focus。 → `components/shortcut-btn.md`
-- **ShortcutBtns 快捷指令按钮组** — 快捷指令列表入口，内部组合多个 ShortcutBtn。 → `components/shortcut-btns.md`
-- **ShortcutRender 快捷指令表单** — 渲染快捷指令 components 表单并回传确认数据。 → `components/shortcut-render.md`
-
-### Agent 能力
-
-- **DetailSection 详情分段** — FlowAgent 节点详情中的标题/内容分段容器。 → `components/detail-section.md`
-- **ExecutionSummary 执行摘要** — 按消息流提取执行摘要，支持关键词定位和消息渲染。 → `components/execution-summary.md`
-- **FlowAgentContent FlowAgent 执行内容** — 渲染 FlowAgent 任务/节点执行状态、耗时、详情入口和自定义 Tab 联动。 → `components/flow-agent-content.md`
-- **FlowAgentNodeDetail FlowAgent 节点详情** — 展示 FlowAgent 节点输入、输出、异常、耗时等详情。 → `components/flow-agent-node-detail.md`
-- **InterruptMessage 中断消息** — 渲染 human-in-the-loop 中断消息，分发工具审批，并按 reason 回显 resume 结果。 → `components/interrupt-message.md`
-- **KnowledgeRagContent 知识召回内容** — 渲染知识召回活动，包含加载态、Markdown 内容与引用来源。 → `components/knowledge-rag-content.md`
-- **ReferenceDocContent 引用文档活动** — 渲染引用文档类活动内容，复用 ActivityLayout 与 ReferenceContent。 → `components/reference-doc-content.md`
-- **SimpleTable 简易表格** — FlowAgent 节点详情中的轻量表格展示组件。 → `components/simple-table.md`
-- **ToolApprovalCard 工具审批卡片** — 渲染 AIDevToolApproval 中断的审批信息与取消/刷新操作，readonly prop 支持纯只读展示。 → `components/tool-approval-card.md`
-- **ToolcallRender 工具调用渲染器** — 渲染 assistant toolCalls，展示工具调用状态、参数和结果。 → `components/toolcall-render.md`
-- **UserQuestionAnsweredCard 用户问题回答回显** — 在 UserQuestion resume 成功后回显用户回答或取消状态。 → `components/user-question-answered-card.md`
-- **UserQuestionCard 用户问题中断** — 渲染 UserQuestion 中断的待回答面板；一次一题分页切换，支持单选/多选、Others、跳过与已完成进度。 → `components/user-question-card.md`
-- **UserQuestionChoice 用户问题选择题** — UserQuestionCard 默认的选择题渲染组件，封装单选/多选、Others 输入与答案组装。 → `components/user-question-choice.md`
-- **UserQuestionOption 用户问题选项** — UserQuestionChoice 内部选项行，处理单选/多选状态和 Others 输入。 → `components/user-question-option.md`
-
-### 工具与反馈
-
-- **DeleteTool 删除确认按钮** — 消息删除二次确认工具。 → `components/delete-tool.md`
-- **MessageTime 消息时间** — 按「今天 / 昨天 / 今年内 / 跨年」四档格式展示消息创建时间。 → `components/message-time.md`
-- **MessageTools 消息工具栏** — 消息悬浮工具栏，组合复制、删除、反馈等工具按钮。 → `components/message-tools.md`
-- **ScrollBtn 滚动按钮** — 停止生成或返回底部等滚动/状态按钮。 → `components/scroll-btn.md`
-- **ToolBtn 工具按钮** — 工具栏图标按钮。 → `components/tool-btn.md`
-- **UserFeedback 用户反馈** — 用户反馈弹层，提交踩/反馈原因。 → `components/user-feedback.md`
-
-### 辅助能力
-
-- **ActivityLayout 活动布局** — 活动消息的折叠布局容器，提供 title/default 插槽。 → `components/activity-layout.md`
-- **AiLoading 三点加载** — 小尺寸 AI 加载动效。 → `components/ai-loading.md`
-- **FileIcon 文件类型图标** — 按文件扩展名渲染对应类型图标，尺寸随外层 font-size 自适应。 → `components/file-icon.md`
-- **HighlightKeyword 关键词高亮** — 根据注入关键词高亮文本片段。 → `components/highlight-keyword.md`
-- **MessageLoading 品牌加载** — 带品牌图标和逐字渐变动画的加载组件。 → `components/message-loading.md`
-- **QuestionsContainer 问题容器占位** — 源码为空文件，没有 props、emits、slots 或渲染能力；不建议作为功能组件使用。 → `components/questions-container.md`
-- **SelectionQuestion 选择问题占位** — 源码为空文件，没有 props、emits、slots 或渲染能力；不建议作为功能组件使用。 → `components/selection-question.md`
-- **VNodeRenderer VNode 渲染器** — 将 Markdown token 转成 VNode 的内部渲染桥。 → `components/vnode-renderer.md`
-
-## Composables 组合式函数
-
-- **useAnimationText** — 文本淡入动画的组合式函数。将响应式文本按**增量**拆分为独立 chunk，每个新增 chunk 对应一次淡入动画，适用于 AI 流式输出的逐段渐显效果。 → `composables/use-animation-text.md`
-- **useArtifactPreview** — Provider/Consumer 模式的文件产物预览状态管理，用于 ChatContainer 侧栏「文件产物」Tab 的命中与切换。 Provider 在 ChatContainer 中创建，Consumer 在深层文件卡片中注入使用。 → `composables/use-artifact-preview.md`
-- **useClipboard** — 复制文本到剪贴板的组合式函数。内置两级降级策略，并自动通过 bkui-vue `Message` 提示复制结果，调用方无需关心成功/失败处理。 → `composables/use-clipboard.md`
-- **useCommandSelection** — 为 `edix` 富文本编辑器提供光标位置追踪能力的组合式函数。内部封装一个 `EditorCommand`，由编辑器调用后将光标的行列信息存入响应式变量，供后续编辑命令（如插入 tag、删除关键词）精确定位。 → `composables/use-command-selection.md`
-- **useContainerScroll** — 为消息容器提供滚动控制的组合式函数对，通过 **Provider/Consumer** 模式在父子组件间共享滚动状态。 → `composables/use-container-scroll.md`
-- **useCustomTab** — Provider/Consumer 模式的自定义 Tab 管理，用于 `ChatContainer` 侧边栏的 Tab 动态管理。Provider 在 `ChatContainer` 中创建，Consumer 在任意后代组件中注入使用。 → `composables/use-custom-tab.md`
-- **useFlowNodeActions** — 聚合 FlowAgent 节点行尾操作（详情 / 重试 / 跳过）为声明式视图模型列表，显隐与 resume 回调收敛于此。 → `composables/use-flow-node-actions.md`
-- **useFullScreen** — 基于浏览器原生 Fullscreen API 的全屏控制组合式函数，自动嗅探标准与 WebKit 前缀，状态与 ESC 退出保持同步。 → `composables/use-full-screen.md`
-- **useGlobalConfig** — 在聊天根容器与子组件之间通过 provide/inject 共享全局展示配置（字号主题档位、是否支持上传、消息时间时区等）。 → `composables/use-global-config.md`
-- **useMenuKeydown** — 为弹出菜单提供键盘导航能力的组合式函数。在 `onMounted` 时于 **`window` 捕获阶段**注册 `keydown` 监听，在 `onScopeDispose` 时自动移除，通过 `menuRef.offsetParent` 检测菜单可见性来决定是否响应按键。 → `composables/use-menu-keydown.md`
-- **useMessageGroup** — 核心消息分组逻辑，将原始 `Message[]` 数组转换为结构化的 `MessageGroup[]`。处理 Tool 消息合并、Loading 自动注入、执行摘要过滤和消息多选/分享等逻辑。 → `composables/use-message-group.md`
-- **useObserverVisibleList** — 基于 `ResizeObserver` 的容器宽度感知组合式函数：遍历列表项的实际 `offsetWidth`，使用贪心算法计算在容器中能完整显示的项目子集，并为"更多"按钮动态预留空间。 → `composables/use-observer-visible-list.md`
-- **useParentScrolling** — 向上递归查找**最近可滚动祖先**，监听其 `scroll` / `scrollend` 事件，提供 `isScrolling` 状态。常用于滚动时自动关闭浮层、禁用交互等场景。 → `composables/use-parent-scrolling.md`
-
-## 类型定义
-
-- **常量枚举** — `@blueking/chat-x` 导出的常量和枚举类型。 → `types/constants.md`
-- **中断类型 Interrupt** — AG-UI human-in-the-loop 中断相关类型，含 Interrupt、UserQuestion、InterruptMessage 与 resume 回调。 → `types/interrupt.md`
-- **消息类型** — `@blueking/chat-x` 提供了完整的消息类型定义，用于构建 AI 对话消息。 → `types/messages.md`
-- **用户问题 Schema** — 历史 human-in-the-loop 用户问题 JSON Schema 工具；新 UserQuestion 中断协议以 Interrupt 文档为准。 → `types/schema.md`
-
-## 主题
-
-- **主题配置** — `@blueking/chat-x` 使用 SCSS 变量和 CSS 类来控制样式，支持通过覆盖变量或样式来自定义主题。 → `theme/theme.md`