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

package/dist/mcp/generated/docs/image-preview-group.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-通过 provide/inject 管理同组图片预览。 源码位置：src/components/image-preview/image-preview-group.vue。
+ImagePreviewGroup 通过 provide/inject 与子级 symbol 注册表管理多个 AiImage，点击任一子图时聚合已注册图片并打开内置全屏预览。 解决同屏多缩略图统一多图浏览与索引切换的需求。
 
 ### 关联组件
 - **ai-image** — 子级注册并参与多图预览集合
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # ImagePreviewGroup 图片预览组
-## 源码事实
 
-- **源码位置**：`src/components/image-preview/image-preview-group.vue`
-- **能力域**：媒体文件
-- **能力说明**：通过 provide/inject 管理同组图片预览。
-
-> **能力域**：媒体文件
+> **层级**：分子组件 · **功能域**：文件与图片
 
 多图预览管理容器。通过 `provide/inject` + `Map<symbol>` 模式管理子级 `AiImage` 的注册与预览状态，点击任意子图片时自动收集所有已注册图片并打开多图预览。
 
@@ -182,5 +177,5 @@ const IMAGE_PREVIEW_GROUP_KEY: InjectionKey<ImagePreviewGroupContext>;
 
 ## 关联组件
 
-- [AiImage](/components/medias/ai-image) — 子级缩略图与注册
-- [ImagePreview](/components/medias/image-preview) — 内置全屏预览
+- [AiImage](../atomic/ai-image.md) — 子级缩略图与注册
+- [ImagePreview](./image-preview.md) — 内置全屏预览

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-图片全屏预览容器，支持缩放、旋转、下载工具栏。 源码位置：src/components/image-preview/image-preview.vue。
+ImagePreview 通过 Teleport 提供全屏图片预览，支持缩放、旋转、拖拽、下载、键盘与多图切换。 数据源可为 URL 字符串、ImageItem 或 File（自动 ObjectURL 并在关闭时回收）。 通常由 AiImage、ImagePreviewGroup、FileContent 等触发，业务较少直接单独挂载。
 
 ### 关联组件
 - **ai-image** — 独立模式下由 AiImage 打开预览
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ImagePreview 图片预览
-## 源码事实
 
-- **源码位置**：`src/components/image-preview/image-preview.vue`
-- **能力域**：媒体文件
-- **能力说明**：图片全屏预览容器，支持缩放、旋转、下载工具栏。
-
-> **能力域**：媒体文件
+> **层级**：分子组件 · **功能域**：文件与图片
 
 全屏图片预览组件，通过 `Teleport` 渲染到 `body`，支持缩放、旋转、拖拽、下载、键盘导航等功能。`images` 支持传入 URL 字符串、`ImageItem` 对象或 `File` 对象，File 对象会自动通过 `URL.createObjectURL` 生成预览并在关闭/卸载时回收。通常不直接使用，而是配合 `AiImage`、`ImagePreviewGroup` 或 `FileContent` 自动触发。
 
@@ -224,6 +219,6 @@ type ImageLoadingStatus = 'loading' | 'loaded' | 'error';
 
 ## 关联组件
 
-- [AiImage](/components/medias/ai-image) — 独立模式触发预览
-- [ImagePreviewGroup](/components/medias/image-preview-group) — 多图预览容器
-- [FileContent](/components/medias/file-content) — 附件列表点击预览
+- [AiImage](../atomic/ai-image.md) — 独立模式触发预览
+- [ImagePreviewGroup](./image-preview-group.md) — 多图预览容器
+- [FileContent](./file-content.md) — 附件列表点击预览

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染居中的系统信息提示。 源码位置：src/components/chat-message/info-message/info-message.vue。
+InfoMessage 以居中虚线分隔条展示系统提示、会话重置、时间戳等非对话信息；content 可为字符串或字符串数组。 由 MessageRender 在 info 角色下渲染，不承载用户与助手轮次内容。
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 info 时创建
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # InfoMessage 信息消息
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/info-message/info-message.vue`
-- **能力域**：消息系统
-- **能力说明**：渲染居中的系统信息提示。
-
-> **能力域**：消息系统
+> **层级**：分子组件 · **功能域**：消息展示
 
 系统信息分隔组件，在聊天消息列表中以**居中虚线分隔条**的形式展示非对话类信息（会话重置、时间节点、状态变更等）。
 

package/dist/mcp/generated/docs/key-value-content.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-以键值列表展示结构化内容。 源码位置：src/components/chat-content/key-value-content/key-value-content.vue。
+KeyValueContent 以多行 key : value 形式展示结构化数据，可选标题栏与 ThinkingIcon。 常见于用户消息等需要表格化键值的气泡展示。
 
 ### 关联组件
 - **user-message** — 用户消息内展示结构化附加信息
@@ -10,15 +10,10 @@
 <!-- FULL DOC -->
 
 # KeyValueContent 键值对内容
-## 源码事实
 
-- **源码位置**：`src/components/chat-content/key-value-content/key-value-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：以键值列表展示结构化内容。
+> **层级**：原子组件 · **功能域**：辅助组件
 
-> **能力域**：内容渲染
-
-键值对列表展示基础组件，每行以 `key : value` 格式渲染一条数据，支持可选标题栏（带 `ThinkingIcon`）。
+键值对列表展示原子组件，每行以 `key : value` 格式渲染一条数据，支持可选标题栏（带 `ThinkingIcon`）。
 
 主要被 `UserMessage` 内部用于渲染结构化引用内容（`property.extra.cite.data`），通常不需要手动引入。
 
@@ -126,4 +121,4 @@ const message = {
 
 ## 关联组件
 
-- [UserMessage](/components/message/user-message) — 键值气泡展示
+- [UserMessage](../molecular/user-message.md) — 键值气泡展示

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-使用 KaTeX 渲染 LaTeX 公式内容。 源码位置：src/components/markdown-token/latex-content/latex-content.vue。
+LatexContent 使用 KaTeX 渲染 math_block / math_inline 等 token，支持行内块级混排与流式防抖。 必填 props 为 token 数组；失败时静默降级展示原始 LaTeX 文本。 由 MarkdownContent 在数学插件解析后自动调用。
 
 ### 关联组件
 - **markdown-content** — 插件解析 $...$ / $$...$$ 后生成数学 token 并挂载本组件
@@ -10,15 +10,10 @@
 <!-- FULL DOC -->
 
 # LatexContent LaTeX 公式渲染
-## 源码事实
 
-- **源码位置**：`src/components/markdown-token/latex-content/latex-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：使用 KaTeX 渲染 LaTeX 公式内容。
+> **层级**：原子组件 · **功能域**：内容渲染
 
-> **能力域**：内容渲染
-
-Markdown Token 层的 LaTeX 公式渲染基础组件，基于 **KaTeX** 实现。被 `MarkdownContent` 在解析到数学公式 token 时自动调用，通常无需手动引入。
+Markdown Token 层的 LaTeX 公式渲染原子组件，基于 **KaTeX** 实现。被 `MarkdownContent` 在解析到数学公式 token 时自动调用，通常无需手动引入。
 
 核心能力：**流式防抖渲染**（throttle 100ms）、**语法自动补全**（`completeLatexContent`）、**渐进式降级重试**（最多 5 次）、**错误静默**（错误文本白色不可见）。
 
@@ -198,4 +193,4 @@ const displayMode = token.type === 'math_block' || token.meta?.displayMode === t
 
 ## 关联组件
 
-- [MarkdownContent](/components/rendering/markdown-content) — 数学公式 token 的来源与挂载
+- [MarkdownContent](./markdown-content.md) — 数学公式 token 的来源与挂载

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

@@ -1,24 +1,19 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-消息列表中的加载占位，默认使用 AiLoading，也支持默认插槽覆盖。 源码位置：src/components/chat-message/loading-message/loading-message.vue。
+LoadingMessage 展示等待 AI 响应的加载动画（内部 AiLoading），无必填 Props，默认插槽可自定义「请求中」文案。 典型用法是由 MessageContainer 在末尾为用户消息时自动注入 Loading 组；也可在自定义布局中手动放置。
 
 ### 关联组件
 - **message-container** — 在消息列表末尾自动追加 Loading 消息组
 - **message-render** — role 为 loading 时由 MessageRender 渲染
-- **ai-loading** — 内部使用 AiLoading 基础组件
+- **ai-loading** — 内部使用 AiLoading 原子组件
 
 ---
 <!-- FULL DOC -->
 
 # LoadingMessage 加载中消息
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/loading-message/loading-message.vue`
-- **能力域**：消息系统
-- **能力说明**：消息列表中的加载占位，默认使用 AiLoading，也支持默认插槽覆盖。
-
-> **能力域**：消息系统
+> **层级**：分子组件 · **功能域**：消息展示
 
 加载等待状态组件，展示 AI 正在处理请求时的过渡动画。由旋转渐变环 + 脉冲星形图标（蓝→紫→粉渐变）和"请求中..."文案组成。支持通过默认插槽自定义加载文案。
 
@@ -171,6 +166,6 @@ enum MessageRole {
 
 ## 关联组件
 
-- [MessageContainer](/components/setup/message-container) — 自动注入加载组
-- [MessageRender](/components/message/message-render) — loading 角色派发
-- [AiLoading](/components/helper/ai-loading) — 内部动画组件
+- [MessageContainer](./message-container.md) — 自动注入加载组
+- [MessageRender](./message-render.md) — loading 角色派发
+- [AiLoading](../atomic/ai-loading.md) — 内部动画组件

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

@@ -53,4 +53,4 @@ const md = new MarkdownIt({ html: true }).use(markdownItContainer, /^hljs-(left|
 
 ## 关联
 
-- [MarkdownContent](../components/rendering/markdown-content) — 实际接入与样式
+- [MarkdownContent](../components/atomic/markdown-content.md) — 实际接入与样式

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-Markdown 主渲染器，集成代码块、公式、错误降级和 codeHeader 插槽。 源码位置：src/components/chat-content/markdown-content/markdown-content.vue。
+MarkdownContent 将 Markdown 字符串解析为 token 并渲染，集成代码块、公式、Mermaid 等子渲染器。 核心 props 为 content 与 status；内置流式节流、语法补全与 DOMPurify 安全策略。 通常由 ContentRender、AssistantMessage 等间接使用，无需业务直接挂载。
 
 ### 关联组件
 - **code-content** — fence 代码块语法高亮与复制
@@ -13,17 +13,12 @@ Markdown 主渲染器，集成代码块、公式、错误降级和 codeHeader
 <!-- FULL DOC -->
 
 # MarkdownContent Markdown 内容渲染
-## 源码事实
 
-- **源码位置**：`src/components/chat-content/markdown-content/markdown-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：Markdown 主渲染器，集成代码块、公式、错误降级和 codeHeader 插槽。
+> **层级**：原子组件 · **功能域**：内容渲染
 
-> **能力域**：内容渲染
+AI 消息内容渲染的核心原子组件，集成代码高亮、LaTeX 公式、Mermaid 图表等能力，内置流式渲染优化（5ms throttle + 语法补全 + 防闪烁）。
 
-AI 消息内容渲染的核心基础组件，集成代码高亮、LaTeX 公式、Mermaid 图表等能力，内置流式渲染优化（5ms throttle + 语法补全 + 防闪烁）。
-
-由 `AssistantMessage`、`ReasoningMessage` 等组合组件内部自动使用，通常不需要手动引入。
+由 `AssistantMessage`、`ReasoningMessage` 等分子组件内部自动使用，通常不需要手动引入。
 
 ## 组件结构与渲染流程
 
@@ -230,7 +225,7 @@ const domPurifyConfig = {
 
 ## 关联组件
 
-- [CodeContent](/components/rendering/code-content) — 代码 fence 高亮
-- [LatexContent](/components/rendering/latex-content) — 公式渲染
-- [MermaidContent](/components/rendering/mermaid-content) — Mermaid 图表
-- [ContentRender](/components/rendering/content-render) — 内容类型分发入口
+- [CodeContent](./code-content.md) — 代码 fence 高亮
+- [LatexContent](./latex-content.md) — 公式渲染
+- [MermaidContent](./mermaid-content.md) — Mermaid 图表
+- [ContentRender](../molecular/content-render.md) — 内容类型分发入口

package/dist/mcp/generated/docs/markdown-latex.md

@@ -203,6 +203,6 @@ KaTeX 限制：
 
 ## 关联组件
 
-- [LatexContent](../components/rendering/latex-content) — KaTeX 渲染
-- [MarkdownContent](../components/rendering/markdown-content) — Markdown 内容
-- [ContentRender](../components/rendering/content-render) — 内容渲染
+- [LatexContent](../components/atomic/latex-content.md) — KaTeX 渲染
+- [MarkdownContent](../components/atomic/markdown-content.md) — Markdown 内容
+- [ContentRender](../components/molecular/content-render.md) — 内容渲染

package/dist/mcp/generated/docs/markdown-mermaid.md

@@ -245,6 +245,6 @@ erDiagram
 
 ## 关联组件
 
-- [MermaidContent](../components/rendering/mermaid-content) — Mermaid 渲染
-- [MarkdownContent](../components/rendering/markdown-content) — Markdown 内容
-- [ContentRender](../components/rendering/content-render) — 内容渲染
+- [MermaidContent](../components/atomic/mermaid-content.md) — Mermaid 渲染
+- [MarkdownContent](../components/atomic/markdown-content.md) — Markdown 内容
+- [ContentRender](../components/molecular/content-render.md) — 内容渲染

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染 Mermaid 图表并处理渲染事件。 源码位置：src/components/markdown-token/mermaid-content/mermaid-content.vue。
+MermaidContent 将 info 为 mermaid 的 fence token 渲染为 SVG，模块级懒加载单例 Mermaid。 具备流式 throttle、错误静默与 SVG ID 随机化，避免多实例冲突。 由 MarkdownContent 在解析 mermaid 代码块时调用。
 
 ### 关联组件
 - **markdown-content** — 解析 mermaid 类型 fence 代码块后传入 token
@@ -10,15 +10,10 @@
 <!-- FULL DOC -->
 
 # MermaidContent Mermaid 图表渲染
-## 源码事实
 
-- **源码位置**：`src/components/markdown-token/mermaid-content/mermaid-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：渲染 Mermaid 图表并处理渲染事件。
+> **层级**：原子组件 · **功能域**：内容渲染
 
-> **能力域**：内容渲染
-
-Markdown Token 层的 Mermaid 图表渲染基础组件，被 `MarkdownContent` 在检测到 mermaid fence token 时自动调用，通常无需手动引入。
+Markdown Token 层的 Mermaid 图表渲染原子组件，被 `MarkdownContent` 在检测到 mermaid fence token 时自动调用，通常无需手动引入。
 
 核心能力：**按需懒加载 Mermaid**（动态 import 单例）、**三级去重跳过**（代码比对 → 语法校验 → SVG 比对）、**100ms throttle** 流式防抖、**错误静默**（parse 失败时保持上一次 SVG）。
 
@@ -187,4 +182,4 @@ mermaid.default.render('mermaid-content-' + Math.random().toString(36).substring
 
 ## 关联组件
 
-- [MarkdownContent](/components/rendering/markdown-content) — mermaid fence token 的来源与挂载
+- [MarkdownContent](./markdown-content.md) — mermaid fence token 的来源与挂载

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

@@ -1,25 +1,19 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-负责消息分组渲染、滚动控制、工具栏和消息插槽透传。 源码位置：src/components/chat-message/message-container/message-container.vue。
+MessageContainer 是消息列表的核心容器。接收父组件用 useMessageGroup 生成的 messageGroups 与 messageStatus， 内部通过 MessageRender 按组渲染消息。支持流式停止、自动滚动与返回底部、多选与工具栏，需配置 onAgentAction 处理复制/重试等；点赞点踩通过 onAgentFeedback 回传原因。通常与 ChatInput 组合成完整对话区。
 
 ### 关联组件
 - **message-render** — 按组渲染每条消息时委托 MessageRender
 - **chat-input** — 常与 ChatInput 组合构成完整对话界面
 - **loading-message** — 末尾为用户消息时自动追加 Loading 消息组
-- **interrupt-message** — 透传 onInterruptResume；末条 interrupt 消息不触发组 hover
 
 ---
 <!-- FULL DOC -->
 
 # MessageContainer 消息容器
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/message-container/message-container.vue`
-- **能力域**：对话搭建
-- **能力说明**：负责消息分组渲染、滚动控制、工具栏和消息插槽透传。
-
-> **能力域**：对话搭建
+> **层级**：分子组件 · **功能域**：消息展示
 
 消息列表容器组件，负责将原始的 `Message[]` 数组渲染为结构化的对话界面。核心能力：
 
@@ -119,7 +113,6 @@
 - 每个消息组外层 DOM 的 `id` 为 **`MessageGroup.uid`**（由 `useMessageGroup` 生成），供执行摘要「在对话中定位」、侧栏自定义 Tab 等场景滚动锚定
 - `role: 'tool'` 消息**不会独立渲染**，而是被注入到对应 AssistantMessage 的 `toolCall.toolMessage` 字段
 - 若 `toolMessage.error` 存在，AssistantMessage 的 `status` 会被强制设为 `MessageStatus.Error`
-- 当消息组**最后一条**消息的 `role === 'interrupt'` 时，`mouseenter` **不会**设置 `isHover`，避免 AI 工具栏在审批卡片上误显
 - `MessageTools` 工具栏只在 `type === 'assistant'` 的消息组底部渲染（不依赖鼠标悬停，始终可见），且满足以下条件时**不渲染**：
   - `renderMode === RenderMode.Share`（分享预览模式）
   - 消息组的 `pause` 为 `true`（来源于 `message.property?.extra?.pause`）
@@ -363,42 +356,9 @@ AI 回复状态为 `error` 时，消息以错误样式展示：
 
 **渲染效果**（点击 Checkbox 体验多选）
 
-## 自定义消息组渲染
-
-使用 `#group` 插槽可替换单个消息组的默认内容（Checkbox、消息列表、`MessageTools`）。外层 `.message-group` 容器（含 `id`、hover 状态、选中背景色）仍由 `MessageContainer` 管理。
-
-> **注意**：提供 `#group` 后需自行编排组内全部 UI；若只需替换单条消息，请使用 `#default` 插槽。
-
-```vue
-<template>
-  <MessageContainer
-    :messages="messages"
-    :message-groups="messageGroups"
-    message-status="complete"
-    :on-agent-action="handleAgentAction"
-    @stop-streaming="handleStopStreaming"
-  >
-    <template #group="{ group }">
-      <div class="custom-group">
-        <span class="custom-group-label">{{ group.type }}</span>
-        <div
-          v-for="message in group.messages"
-          :key="message.id"
-          class="custom-group-message"
-        >
-          {{ typeof message.content === 'string' ? message.content : JSON.stringify(message.content) }}
-        </div>
-      </div>
-    </template>
-  </MessageContainer>
-</template>
-```
-
-**渲染效果**（简化自定义组布局，不含默认 Checkbox 与工具栏）
-
 ## 自定义消息渲染
 
-使用默认插槽替换单条消息的渲染，插槽参数包含 `message`、`messageToolsStatus` 和 `onInterruptResume`：
+使用默认插槽替换单条消息的渲染，插槽参数包含 `message` 和 `messageToolsStatus`：
 
 ```vue
 <template>
@@ -409,11 +369,10 @@ AI 回复状态为 `error` 时，消息以错误样式展示：
     :on-user-action="handleUserAction"
     @stop-streaming="handleStopStreaming"
   >
-    <template #default="{ message, messageToolsStatus, onInterruptResume }">
+    <template #default="{ message, messageToolsStatus }">
       <MyCustomMessage
         :message="message"
         :message-tools-status="messageToolsStatus"
-        :on-interrupt-resume="onInterruptResume"
       />
     </template>
   </MessageContainer>
@@ -509,7 +468,6 @@ AI 回复状态为 `error` 时，消息以错误样式展示：
 | onUserAction             | `(tool: IToolBtn, message: Message) => Promise<string[] \| void>`                            | —       | 用户消息工具操作回调                                                                                                                     |
 | onUserInputConfirm       | `(message: Message, content: UserMessage['content'], docSchema: TagSchema) => Promise<void>` | —       | 用户编辑消息确认回调                                                                                                                     |
 | onUserShortcutConfirm    | `(message: Message, formModel: Record<string, unknown>) => Promise<void>`                    | —       | 用户快捷指令表单提交回调                                                                                                                 |
-| onInterruptResume        | `OnInterruptResume`                                                                          | —       | AG-UI human-in-the-loop 中断响应回调，透传给 `MessageRender` → `InterruptMessageRender`                                                  |
 | renderMode               | `RenderMode`                                                                                 | —       | 渲染模式。`Share` 模式下启用多选样式并隐藏工具栏；`Test` 模式下过滤掉「分享」按钮；不传或 `Chat` 为默认行为                              |
 
 ### v-model
@@ -526,28 +484,14 @@ AI 回复状态为 `error` 时，消息以错误样式展示：
 
 ### Slots
 
-| 插槽名           | 参数                                                                                                        | 说明                                                                                     |
-| ---------------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
-| answeredQuestion | `{ item, index, status }`                                                                                   | 自定义 UserQuestion 已回答回显，透传给 MessageRender → InterruptMessageRender            |
-| default          | `{ message: Message, messageToolsStatus?: MessageToolsStatus, onInterruptResume?: OnInterruptResume }`     | 自定义单条消息渲染；消息分组外层容器与 `#group` 未覆盖时的工具栏仍由容器管理             |
-| group            | `{ group: MessageGroup }`                                                                                   | 自定义单个消息组内容，替换默认 Checkbox、消息列表与 `MessageTools`；外层组容器仍由组件管理 |
+| 插槽名  | 参数                                                                        | 说明                                             |
+| ------- | --------------------------------------------------------------------------- | ------------------------------------------------ |
+| default | `{ message: Message, messageToolsStatus: MessageToolsStatus \| undefined }` | 自定义单条消息渲染，消息分组和工具栏仍由容器管理 |
 
 ## 类型定义
 
 ```typescript
-import { MessageRole, MessageStatus, MessageToolsStatus, type Message, type MessageGroup, type IToolBtn } from '@blueking/chat-x';
-
-// 消息组（由 useMessageGroup 生成，也可手动传入 messageGroups）
-interface MessageGroup {
-  checked: boolean;
-  isHover: boolean;
-  messages: Message[];
-  pause?: boolean;
-  startTime?: number;
-  type: MessageRole;
-  uid: string;
-  userMessageTitle?: number | string;
-}
+import { MessageRole, MessageStatus, MessageToolsStatus, type Message, type IToolBtn } from '@blueking/chat-x';
 
 // onAgentAction 回调类型
 // messages 为当前消息组全部消息（可含 reasoning / activity 等）
@@ -574,7 +518,6 @@ enum MessageRole {
   Reasoning = 'reasoning',
   Activity = 'activity',
   Info = 'info',
-  Interrupt = 'interrupt',
   Loading = 'loading',
 }
 
@@ -591,7 +534,6 @@ enum MessageStatus {
 
 ## 关联组件
 
-- [MessageRender](/components/message/message-render) — 按组渲染每条消息时委托使用
-- [InterruptMessage 中断消息](/components/agent/interrupt-message) — `role: 'interrupt'` 的渲染与 `onInterruptResume` 透传
-- [ChatInput](/components/input/chat-input) — 常与输入区组合构成完整对话界面
-- [LoadingMessage](/components/message/loading-message) — 末尾为用户消息时自动追加加载组
+- [MessageRender](./message-render.md) — 按组渲染每条消息时委托使用
+- [ChatInput](./chat-input.md) — 常与输入区组合构成完整对话界面
+- [LoadingMessage](./loading-message.md) — 末尾为用户消息时自动追加加载组

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

@@ -1,25 +1,19 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-按 message.role 分发到用户、助手、工具、推理、活动、中断等消息组件。 源码位置：src/components/chat-message/message-render/message-render.vue。
+MessageRender 是单条消息的渲染入口，根据 message.role 派发到 UserMessage、AssistantMessage、ReasoningMessage、 ToolMessage、ActivityMessage、InfoMessage、LoadingMessage 等。Assistant 默认通过插槽用 ContentRender 渲染正文，可被默认插槽覆盖。 无独立状态，通常由 MessageContainer 内部调用而非业务直接挂载。
 
 ### 关联组件
 - **message-container** — 在 MessageContainer 中按组调用以渲染每条消息
 - **assistant-message** — role 为 assistant 时渲染 AI 回复与工具调用
 - **user-message** — role 为 user 时渲染用户消息
-- **interrupt-message** — role 为 interrupt 时渲染 InterruptMessageRender
 
 ---
 <!-- FULL DOC -->
 
 # MessageRender 消息渲染器
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/message-render/message-render.vue`
-- **能力域**：消息系统
-- **能力说明**：按 message.role 分发到用户、助手、工具、推理、活动、中断等消息组件。
-
-> **能力域**：消息系统
+> **层级**：分子组件 · **功能域**：消息展示
 
 统一的消息渲染入口，通过 `message.role` 字段自动派发到对应的子组件。整个渲染过程由一个 `computed` 属性完成，无额外状态。
 
@@ -39,9 +33,8 @@ MessageRender
 │     ├── 'info'       → InfoMessage（转发 message）
 │     ├── 'reasoning'  → ReasoningMessage（转发 message）
 │     ├── 'tool'       → ToolMessage（转发 message）
-│     ├── 'activity'   → ActivityMessage（转发 message + onInterruptResume）
+│     ├── 'activity'   → ActivityMessage（转发 message）
 │     ├── 'loading'    → LoadingMessage（转发 message）
-│     ├── 'interrupt'  → InterruptMessageRender（转发 message + onInterruptResume）
 │     │
 │     └── 其他 / 未知   → null（不渲染任何内容）
 ```
@@ -274,17 +267,15 @@ slot 参数类型与 `AssistantMessage` 的 slot 保持一致（`Partial<Assista
 | messageToolsStatus | `MessageToolsStatus`                                                       | —      | 工具按钮状态；**仅转发给 `UserMessage`**          |
 | onAction           | `(tool: IToolBtn) => Promise<string[] \| void>`                            | —      | 工具操作回调；**仅转发给 `UserMessage`**          |
 | onInputConfirm     | `(content: UserMessage['content'], docSchema: TagSchema) => Promise<void>` | —      | 用户编辑确认回调；**仅转发给 `UserMessage`**      |
-| onInterruptResume  | `(payload: InterruptResume, interrupt?: Interrupt) => Promise<void>`         | —      | 中断 / FlowAgent 节点操作回调；转发给 `InterruptMessageRender` 与 `ActivityMessage`（后者仅 `flow_agent` 子组件消费） |
 | onShortcutConfirm  | `(formModel: Record<string, unknown>) => Promise<void>`                    | —      | 用户快捷指令提交回调；**仅转发给 `UserMessage`**  |
 | tippyOptions       | `Partial<Omit<TippyOptions, 'getReferenceClientRect' \| 'triggerTarget'>>` | —      | 自定义 Tippy 配置；**仅转发给 `UserMessage`**     |
 
 ### Slots
 
-| 插槽名           | 参数                                         | 说明                                                                                                    |
-| ---------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
-| answeredQuestion | `{ item, index, status }`                    | 自定义 UserQuestion 已回答回显，透传给 InterruptMessageRender → UserQuestionAnsweredCard 的 `#answer`   |
-| codeHeader       | `{ language: string; token: Token[] }`       | 代码块头部自定义操作区域，透传给 ContentRender → MarkdownContent → CodeContent；**仅对 assistant 生效** |
-| default          | `{ content: string, status: MessageStatus }` | 替换 AssistantMessage 的内容区域渲染；**仅对 `role: 'assistant'` 生效**                                 |
+| 插槽名     | 参数                                         | 说明                                                                                                    |
+| ---------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| codeHeader | `{ language: string; token: Token[] }`       | 代码块头部自定义操作区域，透传给 ContentRender → MarkdownContent → CodeContent；**仅对 assistant 生效** |
+| default    | `{ content: string, status: MessageStatus }` | 替换 AssistantMessage 的内容区域渲染；**仅对 `role: 'assistant'` 生效**                                 |
 
 ## 消息类型映射
 
@@ -295,9 +286,8 @@ slot 参数类型与 `AssistantMessage` 的 slot 保持一致（`Partial<Assista
 | `info`        | `InfoMessage`      | `message`                                                                                               | 系统信息 / 会话分隔符 |
 | `reasoning`   | `ReasoningMessage` | `message`                                                                                               | AI 思考过程（可折叠） |
 | `tool`        | `ToolMessage`      | `message`                                                                                               | 工具调用返回结果      |
-| `activity`    | `ActivityMessage`  | `message` + `onInterruptResume`                                                                         | 知识检索 / 引用文档 / FlowAgent 执行（节点重试 / 跳过） |
+| `activity`    | `ActivityMessage`  | `message`                                                                                               | 知识检索 / 引用文档   |
 | `loading`     | `LoadingMessage`   | `message`（字段被忽略，组件无 Props）                                                                   | 等待响应的加载占位    |
-| `interrupt`   | `InterruptMessageRender` | `message` + `onInterruptResume`                                                                         | human-in-the-loop 中断 |
 | 其他 / 未知   | —                  | —                                                                                                       | 返回 `null`，不渲染   |
 
 ## 类型定义
@@ -335,8 +325,6 @@ enum MessageToolsStatus {
 
 ## 关联组件
 
-- [MessageContainer](/components/setup/message-container) — 内部按组调用以渲染每条消息
-- [AssistantMessage](/components/message/assistant-message) — assistant 角色派发目标
-- [UserMessage](/components/message/user-message) — user 角色派发目标
-- [InterruptMessage 中断消息](/components/agent/interrupt-message) — interrupt 角色派发目标
-- [ToolApprovalCard 审批卡片](/components/agent/tool-approval-card) — AI Dev 审批中断子卡片
+- [MessageContainer](./message-container.md) — 内部按组调用以渲染每条消息
+- [AssistantMessage](./assistant-message.md) — assistant 角色派发目标
+- [UserMessage](./user-message.md) — user 角色派发目标

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-消息悬浮工具栏，组合复制、删除、反馈等工具按钮。 源码位置：src/components/message-tools/message-tools.vue。
+MessageTools 渲染 AI 消息底部工具区：左侧消息工具（复制、引用、重建等），右侧更新工具；点赞/踩会弹出 UserFeedback 收集原因。 工具 id 为 delete 时用 DeleteTool 替代普通 ToolBtn 做二次确认；其余操作通过 onAction 异步解析或直出。
 
 ### 关联组件
 - **tool-btn** — 普通工具项由 ToolBtn 渲染
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # MessageTools 消息工具栏
-## 源码事实
 
-- **源码位置**：`src/components/message-tools/message-tools.vue`
-- **能力域**：工具与反馈
-- **能力说明**：消息悬浮工具栏，组合复制、删除、反馈等工具按钮。
-
-> **能力域**：工具与反馈
+> **层级**：分子组件 · **功能域**：工具与反馈
 
 AI 消息的操作工具栏组件，由**左侧消息工具区**和**右侧更新工具区**两部分组成，中间以分隔线分隔。仅 `like` / `unlike` 按钮会弹出反馈表单（`UserFeedback`），其余按钮直接触发 `onAction`。
 
@@ -376,6 +371,6 @@ enum MessageToolsStatus {
 
 ## 关联组件
 
-- [ToolBtn](/components/feedback/tool-btn) — 单项工具按钮
-- [UserFeedback](/components/feedback/user-feedback) — 点赞/踩反馈面板
-- [DeleteTool](/components/feedback/delete-tool) — 删除二次确认
+- [ToolBtn](../atomic/tool-btn.md) — 单项工具按钮
+- [UserFeedback](./user-feedback.md) — 点赞/踩反馈面板
+- [DeleteTool](./delete-tool.md) — 删除二次确认