@blueking/chat-x 0.0.45-beta.5 → 0.0.45-beta.6

package/dist/lang/lang.d.ts

@@ -43,8 +43,8 @@ export declare const lang: {
     readonly 失败: "Failed";
     readonly 挂起: "Pending";
     readonly 待执行: "To Be Executed";
+    readonly 跳过: "Skipped";
     readonly 详情: "Details";
-    readonly 重试: "Retry";
     readonly 节点: "Node";
     readonly 节点配置: "Node Config";
     readonly 节点输出: "Node Output";
@@ -69,25 +69,6 @@ export declare const lang: {
     readonly 暂无数据: "No Data";
     readonly '\u8C03\u7528 MCP\uFF1A': "Call MCP:";
     readonly 更多: "More";
-    readonly 算法方案评审单: "Algorithm Plan Review Ticket";
-    readonly 评审中: "Reviewing";
-    readonly 已废弃: "Abandoned";
-    readonly 已批准: "Approved";
-    readonly 已通过: "Approved";
-    readonly 已取消: "Cancelled";
-    readonly 已过期: "Expired";
-    readonly 已拒绝: "Rejected";
-    readonly 已撤销: "Revoked";
-    readonly 单据编号: "Ticket No.";
-    readonly 提交时间: "Submitted At";
-    readonly 当前处理人: "Current Handler";
-    readonly 无: "None";
-    readonly 查看单据详情: "View Ticket Detail";
-    readonly 复制单据: "Copy Ticket";
-    readonly 复制单据链接: "Copy Ticket Link";
-    readonly 取消审批: "Cancel Approval";
-    readonly '\u5F53\u524D\u4F1A\u8BDD\u6709 {count} \u4E2A\u5F85\u5BA1\u6279\u5355\uFF0C\u5982\u9700\u7EE7\u7EED\uFF0C\u8BF7\u5148\u53D6\u6D88\u5BA1\u6279': "There are {count} pending approval tickets in the current conversation. To continue, cancel approval first.";
-    readonly 暂不支持的中断消息: "Unsupported interrupt message";
     readonly 检索中: "Searching";
     readonly 检索完成: "Search Completed";
     readonly 上传文件: "Upload File";
@@ -119,18 +100,5 @@ export declare const lang: {
     readonly 有效证据: "Valid Evidence";
     readonly 全屏: "Full Screen";
     readonly 退出全屏: "Exit Full Screen";
-    readonly 请选择以继续: "Please choose to continue";
-    readonly 继续: "Continue";
-    readonly '\u6536\u5230\u4FE1\u606F\uFF1A': "Received: ";
-    readonly 待审批: "Pending";
-    readonly 已审批: "Approved";
-    readonly 完成: "Done";
-    readonly 跳过: "Skip";
-    readonly 单选: "Single";
-    readonly 多选: "Multiple";
-    readonly 其他: "Others";
-    readonly 回答内容: "Answers";
-    readonly 已回复: "Replied";
-    readonly '\u8BF7\u8F93\u5165...': "Please enter...";
 };
-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" | "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" | "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" | "Abandoned" | "Approved" | "Cancelled" | "Expired" | "Rejected" | "Revoked" | "Ticket No." | "Submitted At" | "Current Handler" | "None" | "View Ticket Detail" | "Copy Ticket" | "Copy Ticket Link" | "Cancel Approval" | "There are {count} pending approval tickets in the current conversation. To continue, cancel approval first." | "Unsupported interrupt message" | "Searching" | "Search Completed" | "Upload File" | "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" | "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" | "Skipped" | "Details" | "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" | "Searching" | "Search Completed" | "Upload File" | "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" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "跳过" | "详情" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP：" | "更多" | "检索中" | "检索完成" | "上传文件" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传图片, 最多支持上传 3 个, 最大支持 2.4MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏";

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-按 activityType 分发 FlowAgent、知识召回、引用文档等活动内容。 源码位置：src/components/chat-message/activity-message/activity-message.vue。
+ActivityMessage 展示活动类消息：知识检索（knowledge_rag）、引用文档列表、FlowAgent 执行（activityType 区分），标题可折叠。 content 结构随模式变化。由 MessageRender 在 activity 角色下渲染，用于 RAG/引用/流程执行过程可视化。
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 activity 时创建
@@ -11,19 +11,12 @@
 <!-- FULL DOC -->
 
 # ActivityMessage 活动消息
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/activity-message/activity-message.vue`
-- **能力域**：消息系统
-- **能力说明**：按 activityType 分发 FlowAgent、知识召回、引用文档等活动内容。
-
-> **能力域**：消息系统
+> **层级**：分子组件 · **功能域**：消息展示
 
 活动消息组件，用于展示 AI 的知识检索（Knowledge RAG）过程、参考文档引用列表和 FlowAgent 流程执行情况。通过 `activityType` 切换三种工作模式，点击标题栏可折叠/展开内容区域。
 
-组件会将父级传入消息上的 **`uid`** 以 **`message-uid`** 形式透传给各活动子组件（`FlowAgentContent` / `KnowledgeRagContent` / `ReferenceDocContent`），用于侧栏自定义 Tab、`addCustomTab` 的 `data.messageUid` 与主对话区「在对话中定位」联动（详见 [ChatContainer](/components/setup/chat-container)）。
-
-`onInterruptResume` 仅由 `FlowAgentContent` 消费（失败节点「重试 / 跳过」），由 `MessageRender` 从 `ChatContainer` 透传；知识检索、引用文档等活动子组件忽略该 prop。
+组件会将父级传入消息上的 **`uid`** 以 **`message-uid`** 形式透传给各活动子组件（`FlowAgentContent` / `KnowledgeRagContent` / `ReferenceDocContent`），用于侧栏自定义 Tab、`addCustomTab` 的 `data.messageUid` 与主对话区「在对话中定位」联动（详见 [ChatContainer](./chat-container.md)）。
 
 ## 三种工作模式
 
@@ -167,8 +160,7 @@
 - **有效证据**：`task.has_confidence === true` 时，任务行右侧展示「有效证据」按钮，点击后在侧栏打开置信度/证据详情 Tab（`props.has_confidence: true`）
 - **默认激活**：当 `MessageContainer` 已注入滚动上下文（`useContainerScrollProvider`，供 `FlowAgentContent` 内 `useContainerScrollConsumer` 读取）时，组件挂载后若存在 `task.is_active === true` 且 `task.has_confidence === true` 的任务，会自动在侧栏打开该任务的「有效证据」Tab；无滚动 Provider（例如独立演示）时不做自动打开。用户手动切换 Tab 后不再沿用 `is_active` 默认高亮
 - **选中态**：当前侧栏 Tab 与任务行 / 节点行联动高亮（`is-selected`）；任务 Tab 与「有效证据」Tab 均视为该任务的选中态
-- **节点列表**：每个节点显示状态圆点、名称和耗时；hover 时出现行尾操作按钮组
-- **失败节点操作**：失败且 `retryable` / `skippable` 为 `true` 的节点，hover 时额外展示「重试」「跳过」按钮，点击后通过 `onInterruptResume` 回传 Agent（不传 `interrupt`）
+- **节点列表**：每个节点显示状态圆点、名称和耗时；hover 时出现「详情」按钮
 - **节点详情**：点击「详情」会通过 `useCustomTabConsumer` 在 `ChatContainer` 侧边栏新增自定义 Tab，展示节点配置（基础信息、输入参数、输出参数）
 
 > `FlowAgentContent` 会读取 `ChatContainer` 注入的 `renderMode`。当 `renderMode === RenderMode.Share` 时，任务行不展示总耗时与「有效证据」，节点列表不展示耗时与「详情」按钮，避免分享预览中出现可交互入口。独立使用 `ActivityMessage` 且没有上层 Provider 时，默认按 `Chat` 模式渲染。
@@ -192,10 +184,7 @@ FlowAgentContent（activityType = 'flow_agent'）
                 ├── 状态圆点（颜色对应状态）
                 ├── node.name（HighlightKeyword 支持搜索高亮）
                 ├── node.elapsed_time
-                └── 行尾操作按钮组（hover 显示）
-                    ├── 重试（失败 + retryable）→ onInterruptResume
-                    ├── 跳过（失败 + skippable）→ onInterruptResume
-                    └── 详情 → 打开节点详情 Tab
+                └── 详情按钮（hover 显示）→ 打开节点详情 Tab
 ```
 
 ### 用法示例
@@ -351,9 +340,7 @@ type BkFlowNode = {
   loop: number;
   name: string;
   retry: number;
-  retryable?: boolean;
   skip: boolean;
-  skippable?: boolean;
   start_time: string;
   state: string;
   type: string;
@@ -417,7 +404,6 @@ enum MessageContentType {
 | status       | `MessageStatus`                                                             | -      | 消息状态；在 `knowledge_rag` 模式下影响标题和图标，在 `flow_agent` 模式下影响标题 Loading 状态 |
 | id           | `string \| number`                                                          | -      | 消息 ID                                                   |
 | messageId    | `string \| number`                                                          | -      | 消息唯一标识                                              |
-| onInterruptResume | `OnInterruptResume`                                                    | -      | 仅 `flow_agent` 子组件消费；失败节点「重试 / 跳过」回调，由 `MessageRender` 透传 |
 
 ### v-model
 
@@ -462,5 +448,5 @@ enum MessageContentType {
 
 ## 关联组件
 
-- [MessageRender](/components/message/message-render) — activity 角色由其实例化
-- [AssistantMessage](/components/message/assistant-message) — 常与助手主回复配合出现
+- [MessageRender](./message-render.md) — activity 角色由其实例化
+- [AssistantMessage](./assistant-message.md) — 常与助手主回复配合出现

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-图片展示组件，组合加载、错误、预览和 extra 插槽。 源码位置：src/components/image-preview/image.vue。
+AiImage 负责缩略图展示，并处理加载中、失败重试与懒加载；无 ImagePreviewGroup 上下文时可内嵌 ImagePreview 做全屏预览。 在 Group 内通过 inject 注册子图，点击时参与多图集合预览；支持自定义下载与 preview 事件。 与 ImagePreview、ImagePreviewGroup 共同构成对话内图片展示与预览链路。
 
 ### 关联组件
 - **image-preview** — 独立模式下内嵌全屏预览，单图预览入口
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # AiImage 图片展示
-## 源码事实
 
-- **源码位置**：`src/components/image-preview/image.vue`
-- **能力域**：媒体文件
-- **能力说明**：图片展示组件，组合加载、错误、预览和 extra 插槽。
-
-> **能力域**：媒体文件
+> **层级**：原子组件 · **功能域**：文件与图片
 
 图片展示组件，支持加载状态、加载失败重试、懒加载、点击预览等功能。可独立使用（单图预览），也可配合 `ImagePreviewGroup` 实现多图预览。
 
@@ -228,5 +223,5 @@ interface ImagePreviewConfig {
 
 ## 关联组件
 
-- [ImagePreview](/components/medias/image-preview) — 独立模式下的全屏预览
-- [ImagePreviewGroup](/components/medias/image-preview-group) — 多图注册与预览上下文
+- [ImagePreview](../molecular/image-preview.md) — 独立模式下的全屏预览
+- [ImagePreviewGroup](../molecular/image-preview-group.md) — 多图注册与预览上下文

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-小尺寸 AI 加载动效。 源码位置：src/components/ai-loading/ai-loading.vue。
+AiLoading 使用纯 CSS/SVG 动画（旋转环与脉冲星形）展示加载中，不依赖 bkui Loading。 多实例时需用 cloneVNode 等为渐变 id 加前缀避免冲突；支持 stopLoading 暂停动画。
 
 ### 关联组件
 - **loading-message** — 列表末尾加载占位
@@ -12,15 +12,10 @@
 <!-- FULL DOC -->
 
 # AiLoading AI 加载动画
-## 源码事实
 
-- **源码位置**：`src/components/ai-loading/ai-loading.vue`
-- **能力域**：辅助能力
-- **能力说明**：小尺寸 AI 加载动效。
+> **层级**：原子组件 · **功能域**：辅助组件
 
-> **能力域**：辅助能力
-
-AI 加载动画基础组件。由两层 SVG 叠加构成：外层旋转光环（带渐变弧线）+ 内层脉冲星形图标，两者共用同一套蓝→紫→粉渐变色。
+AI 加载动画原子组件。由两层 SVG 叠加构成：外层旋转光环（带渐变弧线）+ 内层脉冲星形图标，两者共用同一套蓝→紫→粉渐变色。
 
 ## 组件结构
 
@@ -129,6 +124,6 @@ ai-loading-star-{instanceId}
 
 ## 关联组件
 
-- [LoadingMessage](/components/message/loading-message) — 对话加载消息
-- [ReasoningMessage](/components/message/reasoning-message) — 推理加载态
-- [ActivityMessage](/components/message/activity-message) — 活动加载态
+- [LoadingMessage](../molecular/loading-message.md) — 对话加载消息
+- [ReasoningMessage](../molecular/reasoning-message.md) — 推理加载态
+- [ActivityMessage](../molecular/activity-message.md) — 活动加载态

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

@@ -1,23 +1,18 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-监听选中文本并展示快捷操作浮窗。 源码位置：src/components/ai-selection/ai-selection.vue。
+AiSelection 在 document 级监听文本选区，在选区附近弹出快捷操作菜单；每页建议只挂载一个实例。 通过 shortcuts、maxShortcutCount、offset 等配置菜单内容与布局，支持完全自定义 default 插槽与 Shadow DOM 场景。 常与 ChatInput 或业务侧联动，将选中文本作为追问上下文。
 
 ### 关联组件
-- **shortcut-btn** — 弹窗内快捷指令按钮/菜单项由该基础组件渲染
+- **shortcut-btn** — 弹窗内快捷指令按钮/菜单项由该原子组件渲染
 - **chat-input** — 划词结果常回填或触发与输入框联动的快捷指令
 
 ---
 <!-- FULL DOC -->
 
 # AiSelection AI 划词选择弹窗
-## 源码事实
 
-- **源码位置**：`src/components/ai-selection/ai-selection.vue`
-- **能力域**：输入交互
-- **能力说明**：监听选中文本并展示快捷操作浮窗。
-
-> **能力域**：输入交互
+> **层级**：分子组件 · **功能域**：输入交互
 
 AI 划词选择组件，监听用户在页面中的文本选区，在选区附近弹出快捷操作菜单。支持自定义快捷指令列表、数量限制、垂直偏移以及完全自定义插槽内容。
 
@@ -437,5 +432,5 @@ interface Shortcut {
 
 ## 关联组件
 
-- [ShortcutBtn](/components/input/shortcut-btn) — 弹窗内快捷指令按钮单元
-- [ChatInput](/components/input/chat-input) — 选区文本常回填到聊天输入框
+- [ShortcutBtn](../atomic/shortcut-btn.md) — 弹窗内快捷指令按钮单元
+- [ChatInput](./chat-input.md) — 选区文本常回填到聊天输入框

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-按文本增量播放流式动画。 源码位置：src/components/animation-text/animation-text.vue。
+AnimationText 将文本拆成 chunk 并以淡入 keyframes 逐段显示，适合短文案一次性展示。 props.text 仅在挂载时参与动画；持续流式场景应直接使用 useAnimationText 或自行 watch Ref。 与 Markdown 流式渐显等场景可组合使用。
 
 ### 关联组件
 - **use-animation-text** — 提供 chunk 拆分与 animationStyle 的 composable
@@ -11,15 +11,10 @@
 <!-- FULL DOC -->
 
 # AnimationText 动画文本
-## 源码事实
 
-- **源码位置**：`src/components/animation-text/animation-text.vue`
-- **能力域**：内容渲染
-- **能力说明**：按文本增量播放流式动画。
+> **层级**：原子组件 · **功能域**：内容渲染
 
-> **能力域**：内容渲染
-
-动画文本基础组件，将文本以**淡入（fade-in）**方式渐显。内部由 `useAnimationText` composable 驱动，核心能力是将增量文本拆分为独立 chunk，每个 chunk 单独触发一次淡入动画，适用于流式文本的逐段渐显效果。
+动画文本原子组件，将文本以**淡入（fade-in）**方式渐显。内部由 `useAnimationText` composable 驱动，核心能力是将增量文本拆分为独立 chunk，每个 chunk 单独触发一次淡入动画，适用于流式文本的逐段渐显效果。
 
 ## 组件结构
 
@@ -201,4 +196,4 @@ interface AnimationConfig {
 ## 关联组件
 
 - [useAnimationText](../../composables/use-animation-text.md) — chunk 与动画样式逻辑
-- [MarkdownContent](/components/rendering/markdown-content) — 流式正文渲染时可配合渐显
+- [MarkdownContent](./markdown-content.md) — 流式正文渲染时可配合渐显

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染助手消息主体、工具调用与文件内容，默认插槽可覆盖正文渲染。 源码位置：src/components/chat-message/assistant-message/assistant-message.vue。
+AssistantMessage 渲染 AI 助手回复：正文由 ContentRender（可被默认插槽替换）与 ToolCallRender 展示工具调用及 MCP 标记。 toolCalls[].toolMessage 可内联工具执行结果。用于 MessageRender 分发的 assistant 角色，流式场景配合 streaming 状态更新。
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 assistant 时创建
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # AssistantMessage AI 助手消息
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/assistant-message/assistant-message.vue`
-- **能力域**：消息系统
-- **能力说明**：渲染助手消息主体、工具调用与文件内容，默认插槽可覆盖正文渲染。
-
-> **能力域**：消息系统
+> **层级**：分子组件 · **功能域**：消息展示
 
 AI 助手消息展示组件，负责渲染 AI 回复的文本内容和工具调用（Tool Calls）结果。
 
@@ -424,6 +419,6 @@ interface ToolMessage extends BaseMessage<MessageRole.Tool, string> {
 
 ## 关联组件
 
-- [MessageRender](/components/message/message-render) — assistant 角色由其实例化
-- [ToolMessage](/components/message/tool-message) — 工具执行结果可通过 toolCall.toolMessage 内联
-- [ToolcallRender](/components/agent/toolcall-render) — 工具调用列表渲染
+- [MessageRender](./message-render.md) — assistant 角色由其实例化
+- [ToolMessage](./tool-message.md) — 工具执行结果可通过 toolCall.toolMessage 内联
+- [ToolcallRender](./toolcall-render.md) — 工具调用列表渲染

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-完整对话容器，组合消息列表、输入区、快捷指令、执行摘要、分享选择和自定义 Tab。 源码位置：src/components/chat-container/chat-container.vue。
+ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息列表（MessageContainer）、输入（ChatInput）、执行摘要（ExecutionSummary）、快捷表单（ShortcutRender）与多选栏（SelectionFooter）。 内置 useMessageGroup、分享与自定义 Tab 等能力；对 MessageContainer/ChatInput 下推 inputStatus（末尾 Loading 占位时推导 Fetching），适合一站式接入。 通过 props 传入 messages、shortcuts 等，事件与 ChatInput/MessageContainer 对齐；renderMode 会通过内部 provide 下传给子内容组件。
 
 ### 关联组件
 - **message-container** — 消息列表与滚动区域
@@ -14,13 +14,8 @@
 <!-- FULL DOC -->
 
 # ChatContainer 聊天容器
-## 源码事实
 
-- **源码位置**：`src/components/chat-container/chat-container.vue`
-- **能力域**：对话搭建
-- **能力说明**：完整对话容器，组合消息列表、输入区、快捷指令、执行摘要、分享选择和自定义 Tab。
-
-> **能力域**：对话搭建
+> **层级**：分子组件 · **功能域**：输入交互
 
 顶层聊天容器组件，整合了 `MessageContainer`（消息列表）、`ChatInput`（输入框）、`ExecutionSummary`（执行摘要面板）、`ShortcutRender`（快捷指令表单）和 `SelectionFooter`（多选操作栏）。提供完整的 AI 对话界面布局能力。
 
@@ -29,20 +24,17 @@
 - **分栏布局**：基于 `ResizeLayout` 的可拖拽分栏；**侧栏是否展示 Tab / 执行摘要、以及分栏是否进入折叠样式（`ai-is-collapse`）以 `executionGroups` 与执行情况搜索关键词 `keyword` 共同决定**（`executionGroups` 由 `useMessageGroup` 从消息中过滤工具调用与 FlowAgent 记录；`keyword` 来自 `ExecutionSummary` 的 `@update-keyword`）。当 `executionGroups` 为空且未输入搜索词时，侧栏 Tab 与执行摘要不展示；**用户正在搜索执行情况时（`keyword` 非空），即使暂无执行类消息也会保留侧栏**，避免搜索态被折叠
 - **消息分组**：内置 `useMessageGroup` 自动处理消息分组、Tool 合并、Loading 注入
 - **输入区状态推导**：传给 `MessageContainer` 与 `ChatInput` 的 `messageStatus` 为内部计算值 `inputStatus`：当分组中存在 id 为 `LOADING_MESSAGE_ID`（`'__loading__'`，由 `useMessageGroup` 注入的占位 Loading 消息）时，对内使用 `MessageStatus.Fetching`；否则使用外部传入的 `messageStatus`。用于在「已发用户消息、尚未流式」阶段与流式中一致地展示停止能力，并避免输入区重复发送
-- **待审批发送阻塞**：当消息中存在 `AIDevToolApproval` 且状态为 `pending` / `draft` 的中断项时，`useMessageGroup` 会返回待审批提示，容器在输入区上方展示提示并通过 `ChatInput.sendDisabledTip` 禁止继续发送
-- **用户问题中断**：当消息中存在待回答 `UserQuestion` 中断时，容器会在输入区上方挂载 `UserQuestionCard`；结构化作答走 `onInterruptResume`，用户在输入框直接发送时走 `onSendMessage` 并在第三参数附带 skip 用的 `payload`（`status: 'cancelled'`）与 `interrupt`，且不会自动清空输入框
 - **执行摘要**：侧边栏展示工具调用 / FlowAgent 执行记录，支持关键词搜索和对话定位
 - **侧栏全屏**：Tab 栏右侧提供全屏/退出全屏按钮，基于 `useFullScreen` 将侧栏区域（`.ai-full-screen-wrapper`）以浏览器原生全屏展示；全屏时 Tippy 的 `appendTo` 自动切换为全屏容器，避免 tooltip 被遮挡
 - **自定义 Tab**：通过 `useCustomTabProvider` 支持动态添加自定义 Tab（如节点详情）
 - **分享模式**：内置消息多选分享流程，选中用户消息后确认分享
 - **渲染模式注入**：`renderMode` 会通过内部 Provider 下传给后代内容组件；例如 FlowAgent 节点在 `Share` 模式下隐藏耗时和「详情」入口
-- **字号主题**：通过 `size` 控制 `small`（默认 12px）/ `normal`（14px）两档字号；根节点设置 `data-ai-size`，子组件通过 CSS 变量（`--ai-font-size` 等）响应式缩放；浮层（Tippy / Teleport）会同步 `document.body.dataset.aiSize`，卸载时自动清理
 - **空状态欢迎页**：无消息时展示欢迎语和开场白
 
 ## 组件结构
 
 ```
-ai-chat-container（:data-ai-size="size"）
+ai-chat-container
 ├── Loading（chatLoading 时）
 └── ResizeLayout
     ├── aside（侧边栏）
@@ -56,14 +48,12 @@ ai-chat-container（:data-ai-size="size"）
     │   └── collapse-button（折叠按钮，CollapsedIcon；折叠时图标旋转，hover 高亮 #3a84ff）
     └── main（主内容区）
         ├── MessageContainer（有消息时）
-        │   ├── #group 插槽（可选，自定义消息组内容）
-        │   ├── #message 插槽（可选，自定义单条消息）
         │   └── 消息列表 + 工具栏
         ├── 欢迎页（无消息时，容器 .ai-welcome-content）
         │   └── welcome 插槽（默认：Banner + 欢迎标题 + 开场白 ContentRender；自定义则整块替换）
         ├── SelectionFooter（分享模式时）
         ├── ShortcutRender（有快捷指令时）
-        └── ChatInput（默认状态，待审批时通过 interrupt slot 展示 InputInfoAlert）
+        └── ChatInput（默认状态）
 ```
 
 ## 基础用法
@@ -118,26 +108,6 @@ ai-chat-container（:data-ai-size="size"）
 
 **渲染效果**
 
-## 字号主题
-
-通过 `size` 切换两档字号主题。未传时默认为 `small`（12px 基准字号）；设为 `normal` 时使用 14px 基准字号，并联动行高、间距与图标尺寸。
-
-```vue
-<template>
-  <ChatContainer
-    v-model="inputValue"
-    :messages="messages"
-    message-status="complete"
-    size="normal"
-    :on-send-message="handleSendMessage"
-  />
-</template>
-```
-
-**渲染效果**（左右对比 `size="small"` 与 `size="normal"`）
-
-> CSS 变量与档位取值详见 [主题配置 — 字号主题](../../theme/theme#字号主题)。
-
 ## 侧边栏与执行摘要
 
 侧边栏默认包含「执行情况」Tab，展示所有工具调用和 FlowAgent 类型的 Activity 消息。支持关键词搜索过滤和点击定位到对话中的消息位置。
@@ -347,113 +317,6 @@ ai-chat-container（:data-ai-size="size"）
 
 `messageStatus` 为 `streaming` 时，底部固定区域显示「停止生成」按钮，点击后触发 `@stop-streaming` 事件：
 
-## 待审批阻塞发送
-
-当会话中存在待审批的 AI Dev 工具审批中断时，`ChatContainer` 会在输入框上方展示提示，并禁用发送按钮。用户需要在审批卡片中点击「取消审批」或等待状态变化后，才能继续发送新消息。
-
-```vue
-<template>
-  <ChatContainer
-    v-model="inputValue"
-    :messages="messages"
-    message-status="complete"
-    :on-interrupt-resume="handleInterruptResume"
-    :on-send-message="handleSendMessage"
-    :on-stop-sending="handleStopSending"
-  />
-</template>
-```
-
-**渲染效果**（待审批单存在时，输入区上方展示提示，发送按钮置灰）
-
-## 用户问题中断
-
-当会话中最近一条待处理 interrupt 包含 `InterruptReason.UserQuestion` 时，`ChatContainer` 会在 `ChatInput` 上方显示 [UserQuestionCard](/components/agent/user-question-card)。
-
-- **结构化作答**：用户在卡片内完成选择或点击「跳过」后，通过 `onInterruptResume(payload, interrupt)` 回传 `UserQuestionResume`。
-- **输入框发送**：用户也可在输入框直接点击发送；容器会调用 `onSendMessage(content, docSchema, options)`，其中 `options.interrupt` 为当前激活的 UserQuestion，`options.payload` 为 `buildSkipResumePayload` 生成的 skip resume（`status: 'cancelled'`，`answers: []`）。此时**不会自动清空**输入框，由业务侧在 `onSendMessage` 内决定如何处理 `content` 与中断恢复。
-
-```vue
-<template>
-  <ChatContainer
-    v-model="inputValue"
-    :messages="messages"
-    message-status="complete"
-    :on-interrupt-resume="handleInterruptResume"
-    :on-send-message="handleSendMessage"
-  />
-</template>
-
-<script setup lang="ts">
-  import {
-    type OnInterruptResume,
-    type UserMessage,
-    type TagSchema,
-    type Interrupt,
-    type InterruptResume,
-  } from '@blueking/chat-x';
-
-  const handleInterruptResume: OnInterruptResume = async (payload, interrupt) => {
-    // UserQuestionCard 完成 / 跳过时 payload 为 UserQuestionResume
-    await resumeAgent({ interruptId: interrupt.id, resume: payload });
-  };
-
-  const handleSendMessage = async (
-    content: UserMessage['content'],
-    docSchema: TagSchema,
-    options?: { interrupt?: Interrupt; payload?: InterruptResume },
-  ) => {
-    if (options?.interrupt && options?.payload) {
-      // 存在 UserQuestion 时发送：附带 skip resume，content 仍为输入框文本
-      await resumeAgent({ interruptId: options.interrupt.id, resume: options.payload });
-      // 业务侧自行决定是否将 content 作为新用户消息继续发送
-      return;
-    }
-    await sendMessage(content, docSchema);
-  };
-</script>
-```
-
-## 自定义消息组渲染
-
-通过 `#group` 插槽可替换单个消息组的默认内容，透传至内部 `MessageContainer`。外层消息组容器（`id`、hover、选中背景）仍由 `MessageContainer` 管理。
-
-> **注意**：提供 `#group` 后需自行编排组内全部 UI（Checkbox、消息列表、`MessageTools`）；若只需替换单条消息，请使用 `#message` 插槽。详见 [MessageContainer 自定义消息组渲染](/components/setup/message-container#自定义消息组渲染)。
-
-```vue
-<ChatContainer
-  v-model="inputValue"
-  :messages="messages"
-  message-status="complete"
-  :on-send-message="handleSendMessage"
->
-  <template #group="{ group }">
-    <MyCustomGroup :group="group" />
-  </template>
-</ChatContainer>
-```
-
-### 自定义题目渲染
-
-通过 `#interruptQuestion` slot 可覆盖输入区上方 `UserQuestionCard` 的默认选择题渲染，参数与 [UserQuestionCard](/components/agent/user-question-card) 的 `#question` 一致：
-
-```vue
-<ChatContainer
-  v-model="inputValue"
-  :messages="messages"
-  :on-interrupt-resume="handleInterruptResume"
-  :on-send-message="handleSendMessage"
->
-  <template #interruptQuestion="{ question, qIndex, answer, setAnswer, confirm }">
-    <MyCustomForm
-      :model="question"
-      @change="setAnswer"
-      @submit="confirm"
-    />
-  </template>
-</ChatContainer>
-```
-
 ## 分享模式
 
 点击消息工具栏的「分享」按钮后进入分享模式，底部出现 `SelectionFooter` 操作栏：
@@ -537,11 +400,10 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 | getSideTabRenderComponent   | `(h, tab, { removeCustomTab }) => VNode \| undefined`                        | —        | 自定义侧栏 Tab 标签渲染；未返回时使用默认图标 + 文案 + 关闭按钮                                                                               |
 | openingRemark               | `string`                                                                     | —        | 开场白，无消息时显示，支持 Markdown                                                                                                           |
 | placement          | `'left' \| 'right'`                                                          | `'left'` | 侧边栏位置                                                                                                                                    |
-| size               | `'normal' \| 'small'`                                                        | `'small'` | 字号主题档位：`small` 为 12px 基准，`normal` 为 14px 基准；根节点设置 `data-ai-size` 并注入 `useGlobalConfig`                                |
 | resizeProps        | `{ disabled?: boolean; initialDivide?: number \| string; max?: number; min?: number }` | —        | 透传给内部 `ResizeLayout` 的可选配置，与默认 `collapsible: false`、`immediate: true`、`min: 400` 合并；`placement` 始终取自本组件 `placement`；`initialDivide` 可为像素数字或百分比等字符串（与 bkui ResizeLayout 一致） |
 | onCustomTabChange  | `(tab: CustomTab) => Promise<any>`                                           | —        | 自定义 Tab 切换回调，返回值作为 Tab 组件 props                                                                                                |
 
-> 完整 Props 列表请参考 [ChatInput](/components/input/chat-input) 和 [MessageContainer](/components/setup/message-container) 文档。
+> 完整 Props 列表请参考 [ChatInput](./chat-input.md) 和 [MessageContainer](./message-container.md) 文档。
 
 ### v-model
 
@@ -566,14 +428,12 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 
 ### Slots
 
-| 插槽名            | 参数                                                                                                              | 说明                                                                                           |
-| ----------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
-| codeHeader        | `{ language: string; token: Token[] }`                                                                            | 代码块头部自定义操作区域，透传给 MessageRender → ContentRender → MarkdownContent → CodeContent |
-| default           | 消息列表相关绑定（messages 等）                                                                                   | 自定义消息列表区域                                                                             |
-| group             | `{ group: MessageGroup }`                                                                                         | 自定义单个消息组内容，透传至 MessageContainer 的 `#group`；替换默认 Checkbox、消息列表与工具栏   |
-| interruptQuestion | `{ question, qIndex, answer, setAnswer, confirm }`                                                                  | 自定义 UserQuestion 单题渲染，透传至输入区上方 UserQuestionCard 的 `#question`                 |
-| message           | `{ message, messageToolsStatus, onInterruptResume }`                                                              | 自定义单条消息渲染；自定义渲染中断消息时需继续透传 `onInterruptResume`                         |
-| welcome           | `{ openingRemark: string }`                                                                                       | 无消息时自定义欢迎页；传入则替换默认 Banner、标题与开场白区域（整块替换）                      |
+| 插槽名     | 参数                                   | 说明                                                                                           |
+| ---------- | -------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| codeHeader | `{ language: string; token: Token[] }` | 代码块头部自定义操作区域，透传给 MessageRender → ContentRender → MarkdownContent → CodeContent |
+| default    | 消息列表相关绑定（messages 等）        | 自定义消息列表区域                                                                             |
+| message    | `{ message, messageToolsStatus }`      | 自定义单条消息渲染                                                                             |
+| welcome    | `{ openingRemark: string }`            | 无消息时自定义欢迎页；传入则替换默认 Banner、标题与开场白区域（整块替换）                      |
 
 ### Expose
 
@@ -618,19 +478,7 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 ## 类型定义
 
 ```typescript
-import { ChatContainer, RenderMode, MessageRole, type CustomTab, type MessageGroup, type Shortcut, type Message } from '@blueking/chat-x';
-
-// 消息组（由 useMessageGroup 生成）
-interface MessageGroup {
-  checked: boolean;
-  isHover: boolean;
-  messages: Message[];
-  pause?: boolean;
-  startTime?: number;
-  type: MessageRole;
-  uid: string;
-  userMessageTitle?: number | string;
-}
+import { ChatContainer, RenderMode, type CustomTab, type Shortcut, type Message } from '@blueking/chat-x';
 
 // 自定义 Tab（data 可与 messageUid 组合，供侧栏定位主对话）
 interface CustomTab<T = Record<string, unknown>> {
@@ -649,12 +497,10 @@ interface Shortcut {
 
 ## 关联组件
 
-- [MessageContainer](/components/setup/message-container) — 消息列表区域
-- [ChatInput](/components/input/chat-input) — 输入与快捷指令
-- [ShortcutRender](/components/input/shortcut-render) — 快捷指令表单
-- [ExecutionSummary](/components/agent/execution-summary) — 执行摘要侧栏
-- [SelectionFooter](/components/input/selection-footer) — 多选操作栏
-- [ToolBtn](/components/feedback/tool-btn) — 侧栏全屏按钮（自定义插槽）
-- [useFullScreen](/composables/use-full-screen) — 侧栏全屏控制
-- [useGlobalConfig](/composables/use-global-config) — 注入 `size` 与 `supportUpload`
-- [主题配置](/theme/theme) — 字号主题 CSS 变量
+- [MessageContainer](./message-container.md) — 消息列表区域
+- [ChatInput](./chat-input.md) — 输入与快捷指令
+- [ShortcutRender](./shortcut-render.md) — 快捷指令表单
+- [ExecutionSummary](./execution-summary.md) — 执行摘要侧栏
+- [SelectionFooter](../atomic/selection-footer.md) — 多选操作栏
+- [ToolBtn](../atomic/tool-btn.md) — 侧栏全屏按钮（自定义插槽）
+- [useFullScreen](../../composables/use-full-screen.md) — 侧栏全屏控制