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

package/dist/mcp/generated/docs/messages.md

@@ -107,9 +107,6 @@ enum MessageRole {
   // 信息消息
   Info = 'info',
 
-  // human-in-the-loop 中断消息
-  Interrupt = 'interrupt',
-
   // 加载中消息
   Loading = 'loading',
 
@@ -141,32 +138,23 @@ enum MessageRole {
 
 ```typescript
 enum MessageStatus {
+  // 等待中
+  Pending = 'pending',
+
+  // 流式输出中
+  Streaming = 'streaming',
+
   // 已完成
   Complete = 'complete',
 
-  // 已禁用
-  Disabled = 'disabled',
-
   // 错误
   Error = 'error',
 
-  // 请求中
-  Fetching = 'fetching',
-
-  // 等待中
-  Pending = 'pending',
-
   // 已停止
   Stop = 'stop',
 
-  // 停止请求中
-  StopLoading = 'stop-loading',
-
-  // 流式输出中
-  Streaming = 'streaming',
-
-  // 成功
-  Success = 'success',
+  // 已禁用
+  Disabled = 'disabled',
 }
 ```
 
@@ -349,58 +337,6 @@ const knowledgeRagMessage: ActivityMessage = {
 | `url`        | `string` | 文档预览链接     |
 | `originFile` | `string` | 文档原始文件链接 |
 
-### InterruptMessage
-
-human-in-the-loop 中断消息，对应 AG-UI `RUN_FINISHED` 事件的 `outcome` 对象结构。`content.outcome.type === 'interrupt'` 时，[InterruptMessageRender](../components/agent/interrupt-message) 从 `interrupts` 渲染审批卡片或把 `UserQuestion` 交给输入区；`type: 'success'` 表示 resume 后的成功结果，`UserQuestion` 会根据 `result` 回显回答内容。类型详见 [中断类型 Interrupt](./interrupt.md)。
-
-```typescript
-type RunFinishedOutcome = { interrupts: Interrupt[]; type: 'interrupt' } | { type: 'success' };
-
-type InterruptMessage = BaseMessage<
-  MessageRole.Interrupt,
-  {
-    message?: string;
-    outcome?: RunFinishedOutcome;
-    result?: BaseResume<InterruptReason>;
-    runId?: string;
-    threadId?: string;
-  }
->;
-
-const interruptMessage: InterruptMessage = {
-  id: 'interrupt-message-1',
-  messageId: 'interrupt-message-1',
-  role: MessageRole.Interrupt,
-  status: MessageStatus.Pending,
-  content: {
-    message: '算法方案评审单需要您关注',
-    runId: 'run_ai_dev_tool_approval',
-    threadId: 'thread_ai_dev_tool_approval',
-    outcome: {
-      type: 'interrupt',
-      interrupts: [
-        {
-          id: 'interrupt_ai_dev_tool_approval',
-          reason: InterruptReason.AIDevToolApproval,
-          toolCallId: 'tool_call_review_ticket',
-          message: '算法方案评审单需要您关注',
-          metadata: {
-            ticket: {
-              approvers: ['张三', '李四'],
-              sn: 'REV-2026-04-24-001',
-              status: APPROVAL_STATUS.PENDING,
-              submit_time: '2026-04-24 14:30:15',
-              title: '算法方案评审单',
-              url: 'https://example.com/review-tickets/REV-2026-04-24-001',
-            },
-          },
-        },
-      ],
-    },
-  },
-};
-```
-
 ### InfoMessage
 
 信息消息：
@@ -537,6 +473,6 @@ interface CustomMessage extends BaseMessage<'custom-role'> {
 
 ## 关联组件
 
-- [MessageContainer](../components/setup/message-container) — 消息列表
-- [MessageRender](../components/message/message-render) — 单条消息渲染
-- [ChatContainer](../components/setup/chat-container) — 聊天容器
+- [MessageContainer](../components/molecular/message-container.md) — 消息列表
+- [MessageRender](../components/molecular/message-render.md) — 单条消息渲染
+- [ChatContainer](../components/molecular/chat-container.md) — 聊天容器

package/dist/mcp/generated/docs/overflow-tips.md

@@ -203,7 +203,7 @@ type OverflowTipsValue = Partial<TippyProps> & {
 
 ## 关联组件
 
-- [DescPanel](../components/rendering/desc-panel) — 描述区溢出
-- [ExecutionSummary](../components/agent/execution-summary) — 侧栏摘要标签
-- [ToolcallRender](../components/agent/toolcall-render) — 工具调用标题
-- [ChatInput](../components/input/chat-input) — `@` 菜单项（内部 AiSlashMenu）
+- [DescPanel](../components/atomic/desc-panel.md) — 描述区溢出
+- [ExecutionSummary](../components/molecular/execution-summary.md) — 侧栏摘要标签
+- [ToolcallRender](../components/molecular/toolcall-render.md) — 工具调用标题
+- [ChatInput](../components/molecular/chat-input.md) — `@` 菜单项（内部 AiSlashMenu）

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染推理过程，覆盖加载、错误与 Markdown 内容展示。 源码位置：src/components/chat-message/reasoning-message/reasoning-message.vue。
+ReasoningMessage 展示 AI 思维链（Chain-of-Thought）推理过程，含可折叠标题与 Markdown 内容区；可传入 duration 并在结束后自动折叠。 content 为字符串数组（或兼容字符串）。由 MessageRender 在 reasoning 角色下使用，常出现在用户消息与正式回答之间。
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 reasoning 时创建
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ReasoningMessage 推理消息
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/reasoning-message/reasoning-message.vue`
-- **能力域**：消息系统
-- **能力说明**：渲染推理过程，覆盖加载、错误与 Markdown 内容展示。
-
-> **能力域**：消息系统
+> **层级**：分子组件 · **功能域**：消息展示
 
 AI 思维链（Chain-of-Thought）推理过程展示组件。由**可点击标题栏**和**内容区域**组成，内容区支持 Markdown 渲染。`duration` 传入后自动折叠一次，用户可随时点击标题展开/收起。
 
@@ -233,6 +228,6 @@ enum MessageStatus {
 
 ## 关联组件
 
-- [MessageRender](/components/message/message-render) — reasoning 角色由其实例化
-- [AssistantMessage](/components/message/assistant-message) — 推理后常接正式回答
-- [MarkdownContent](/components/rendering/markdown-content) — 推理正文 Markdown 渲染
+- [MessageRender](./message-render.md) — reasoning 角色由其实例化
+- [AssistantMessage](./assistant-message.md) — 推理后常接正式回答
+- [MarkdownContent](../atomic/markdown-content.md) — 推理正文 Markdown 渲染

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染引用文档/来源列表。 源码位置：src/components/chat-content/reference-content/reference-content.vue。
+ReferenceContent 以列表形式展示 AI 回复引用的参考文档：图标、标题、摘要与外链跳转。 由 ContentRender、ActivityMessage 等按消息类型分发时挂载。
 
 ### 关联组件
 - **content-render** — ReferenceDocument 类型内容路由到本组件
@@ -11,15 +11,10 @@
 <!-- FULL DOC -->
 
 # ReferenceContent 引用文档内容
-## 源码事实
 
-- **源码位置**：`src/components/chat-content/reference-content/reference-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：渲染引用文档/来源列表。
+> **层级**：原子组件 · **功能域**：辅助组件
 
-> **能力域**：内容渲染
-
-引用文档列表渲染基础组件，用于展示 AI 回复中引用的参考文档，每项包含文档图标、标题、预览与跳转操作。
+引用文档列表渲染原子组件，用于展示 AI 回复中引用的参考文档，每项包含文档图标、标题、预览与跳转操作。
 
 主要由 `ActivityMessage`（知识库问答场景）和 `ContentRender`（`reference_document` 类型内容）内部使用。
 
@@ -133,5 +128,5 @@ h(ReferenceContent, { content: props.content as ReferenceDocumentContent[] });
 
 ## 关联组件
 
-- [ContentRender](/components/rendering/content-render) — 内容类型分发
-- [ActivityMessage](/components/message/activity-message) — 活动消息内引用
+- [ContentRender](../molecular/content-render.md) — 内容类型分发
+- [ActivityMessage](../molecular/activity-message.md) — 活动消息内引用

package/dist/mcp/generated/docs/scroll-btn.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-停止生成或返回底部等滚动/状态按钮。 源码位置：src/components/ai-buttons/scroll-btn/scroll-btn.vue。
+ScrollBtn 为底部浮动操作提供统一胶囊外壳（圆角、阴影），具体图标与行为由插槽与父级决定。 常由 MessageContainer 用于「返回底部」与「停止生成」等场景。
 
 ### 关联组件
 - **message-container** — 消息列表底部固定区挂载滚动与停止按钮
@@ -10,13 +10,8 @@
 <!-- FULL DOC -->
 
 # ScrollBtn 滚动按钮
-## 源码事实
 
-- **源码位置**：`src/components/ai-buttons/scroll-btn/scroll-btn.vue`
-- **能力域**：工具与反馈
-- **能力说明**：停止生成或返回底部等滚动/状态按钮。
-
-> **能力域**：工具与反馈
+> **层级**：原子组件 · **功能域**：辅助组件
 
 聊天容器底部浮动操作按钮的外壳组件，提供统一的胶囊样式（圆角 26px、高 24px、阴影），内容完全由插槽定制。
 
@@ -157,4 +152,4 @@ div.ai-scroll-btn（flex，gap: 4px，width: fit-content，min-width: 84px，hei
 
 ## 关联组件
 
-- [MessageContainer](/components/setup/message-container) — 底部固定区集成
+- [MessageContainer](../molecular/message-container.md) — 底部固定区集成

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-消息多选/分享模式下的底部操作栏。 源码位置：src/components/selection-footer/selection-footer.vue。
+SelectionFooter 为消息多选（如分享）提供底部操作栏：全选、取消与确认，并反映选中数量与 loading。 由 ChatContainer 在对应模式下自动挂载，业务一般无需单独引用。
 
 ### 关联组件
 - **chat-container** — 多选/分享模式由容器渲染底部栏
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # SelectionFooter 选择操作栏
-## 源码事实
 
-- **源码位置**：`src/components/selection-footer/selection-footer.vue`
-- **能力域**：输入交互
-- **能力说明**：消息多选/分享模式下的底部操作栏。
-
-> **能力域**：输入交互
+> **层级**：原子组件 · **功能域**：辅助组件
 
 消息多选模式下的底部操作栏，提供全选、取消和确认操作。由 `ChatContainer` 在分享模式下自动渲染，通常不需要单独使用。
 
@@ -76,5 +71,5 @@
 
 ## 关联组件
 
-- [ChatContainer](/components/setup/chat-container) — 分享模式挂载
-- [MessageContainer](/components/setup/message-container) — 多选与消息列表
+- [ChatContainer](../molecular/chat-container.md) — 分享模式挂载
+- [MessageContainer](../molecular/message-container.md) — 多选与消息列表

package/dist/mcp/generated/docs/shortcut-btn.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-单个快捷指令按钮，支持默认/append 插槽和 expose focus。 源码位置：src/components/ai-shortcut/shortcut-btn/shortcut-btn.vue。
+ShortcutBtn 渲染单个快捷指令入口，封装图标解析与「按钮 / 下拉菜单项」两种布局，并暴露根元素供父级测量。 由 ShortcutBtns、AiSelection、ChatInput 内部复用；含 components 的快捷指令可无默认图标。 通过 click 事件传出当前 Shortcut，append 槽常用于关闭按钮。
 
 ### 关联组件
 - **shortcut-btns** — 快捷指令横向列表中作为单项渲染
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ShortcutBtn 快捷指令按钮
-## 源码事实
 
-- **源码位置**：`src/components/ai-shortcut/shortcut-btn/shortcut-btn.vue`
-- **能力域**：输入交互
-- **能力说明**：单个快捷指令按钮，支持默认/append 插槽和 expose focus。
-
-> **能力域**：输入交互
+> **层级**：原子组件 · **功能域**：输入交互
 
 单个快捷指令的渲染单元，封装图标选择逻辑和两种布局模式（按钮 / 菜单项）。
 
@@ -202,6 +197,6 @@ interface Shortcut {
 
 ## 关联组件
 
-- [ShortcutBtns](/components/input/shortcut-btns) — 快捷指令列表容器
-- [AiSelection](/components/input/ai-selection) — 划词浮窗内使用
-- [ChatInput](/components/input/chat-input) — 已选快捷指令展示
+- [ShortcutBtns](./shortcut-btns.md) — 快捷指令列表容器
+- [AiSelection](../molecular/ai-selection.md) — 划词浮窗内使用
+- [ChatInput](../molecular/chat-input.md) — 已选快捷指令展示

package/dist/mcp/generated/docs/shortcut-btns.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-快捷指令列表入口，内部组合多个 ShortcutBtn。 源码位置：src/components/ai-shortcut/shortcut-btns/shortcut-btns.vue。
+ShortcutBtns 横向展示快捷指令按钮组，按容器宽度动态计算可见数量，溢出收入「更多」下拉。 默认由 ChatInput 嵌入附件槽；选中含 components 的指令后需配合 ShortcutRender 展示表单。 通过 selectShortcut 等与外层同步当前快捷指令。
 
 ### 关联组件
 - **shortcut-btn** — 列表中每一项由 ShortcutBtn 渲染
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ShortcutBtns 快捷指令按钮组
-## 源码事实
 
-- **源码位置**：`src/components/ai-shortcut/shortcut-btns/shortcut-btns.vue`
-- **能力域**：输入交互
-- **能力说明**：快捷指令列表入口，内部组合多个 ShortcutBtn。
-
-> **能力域**：输入交互
+> **层级**：原子组件 · **功能域**：输入交互
 
 快捷指令按钮列表，内置**响应式溢出收起**：根据容器实际宽度动态计算可见数量，超出部分自动收入"更多"下拉菜单。
 
@@ -264,6 +259,6 @@ interface BaseShortcutComponent<T> {
 
 ## 关联组件
 
-- [ShortcutBtn](/components/input/shortcut-btn) — 列表项基础组件
-- [ChatInput](/components/input/chat-input) — 默认嵌入输入框底部
-- [ShortcutRender](/components/input/shortcut-render) — 表单类快捷指令的表单渲染
+- [ShortcutBtn](./shortcut-btn.md) — 列表项原子组件
+- [ChatInput](../molecular/chat-input.md) — 默认嵌入输入框底部
+- [ShortcutRender](../molecular/shortcut-render.md) — 表单类快捷指令的表单渲染

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染快捷指令 components 表单并回传确认数据。 源码位置：src/components/ai-shortcut/shortcut-render/shortcut-render.vue。
+ShortcutRender 将 Shortcut.components 声明渲染为 bkui-vue Form，支持多种控件与两列网格、必填校验及提交/取消。 通常由 ChatContainer 等布局挂载在输入区旁，formModel 与快捷指令回填联动。 与 Shortcut、ShortcutBtn 等共享同一套快捷指令数据模型。
 
 ### 关联组件
 - **shortcut-btn** — 与快捷指令 Shortcut 元数据一致，表单提交前在列表中选中入口
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ShortcutRender 快捷指令渲染器
-## 源码事实
 
-- **源码位置**：`src/components/ai-shortcut/shortcut-render/shortcut-render.vue`
-- **能力域**：输入交互
-- **能力说明**：渲染快捷指令 components 表单并回传确认数据。
-
-> **能力域**：输入交互
+> **层级**：分子组件 · **功能域**：输入交互
 
 快捷指令表单渲染组件，将 `Shortcut.components` 配置自动渲染为可交互表单（基于 bkui-vue 的 `Form`），支持 8 种控件类型、两列网格布局、必填校验和内置提交/取消操作。
 
@@ -422,6 +417,6 @@ interface BaseShortcutComponent {
 
 ## 关联组件
 
-- [ShortcutBtn](/components/input/shortcut-btn) — 与 Shortcut 数据模型一致的入口按钮
-- [ChatInput](/components/input/chat-input) — 输入区与快捷指令流程联动
-- [ChatContainer](/components/setup/chat-container) — 顶层布局中挂载快捷表单
+- [ShortcutBtn](../atomic/shortcut-btn.md) — 与 Shortcut 数据模型一致的入口按钮
+- [ChatInput](./chat-input.md) — 输入区与快捷指令流程联动
+- [ChatContainer](./chat-container.md) — 顶层布局中挂载快捷表单

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染纯文本内容。 源码位置：src/components/chat-content/text-content/text-content.vue。
+TextContent 用 Vue 文本插值渲染纯文本气泡，不解析 HTML，适合简单提示与用户/助手纯文案。 需要 Markdown、代码块或公式时应改用 MarkdownContent 等富文本组件。
 
 ### 关联组件
 - **markdown-content** — 需要富文本时的替代方案
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # TextContent 文本内容
-## 源码事实
 
-- **源码位置**：`src/components/chat-content/text-content/text-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：渲染纯文本内容。
-
-> **能力域**：内容渲染
+> **层级**：原子组件 · **功能域**：辅助组件
 
 纯文本气泡组件，使用 Vue 文本插值渲染 `content`，天然防 XSS。
 
@@ -75,5 +70,5 @@ div.text-content
 
 ## 关联组件
 
-- [MarkdownContent](/components/rendering/markdown-content) — 富文本替代
-- [UserMessage](/components/message/user-message) — 用户消息气泡
+- [MarkdownContent](./markdown-content.md) — 富文本替代
+- [UserMessage](../molecular/user-message.md) — 用户消息气泡

package/dist/mcp/generated/docs/theme.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-说明通过 SCSS 变量（尺寸、颜色、z-index）、字号主题 CSS 变量（data-ai-size 切换 small/normal）与 CSS 类覆盖自定义主题。 ChatContainer.size 控制根节点 data-ai-size；浮层同步 document.body.dataset.aiSize。含渐变边框 mixin、骨架屏类 ai-skeleton-element 等。
+说明通过 SCSS 变量（尺寸、颜色、z-index）与 CSS 类覆盖（chat-input、用户/助手消息、shortcut-btns、ai-markdown-body、tool-btn 等）自定义主题。 含渐变边框 mixin、ai-markdown-fade-in 与弹窗过渡。暗色示例通过根 class 切换。组件随包引入样式，业务侧按需覆写。
 
 ### 关联组件
 - **chat-container** — 整体布局与侧栏
@@ -26,51 +26,6 @@
 import { ChatInput, MessageContainer } from '@blueking/chat-x';
 ```
 
-## 字号主题
-
-组件库通过根节点 `[data-ai-size]` 切换两档字号主题，内部组件统一引用 CSS 变量（均带兜底值，无 provider 时退回 `small`）。
-
-### 切换方式
-
-| 方式 | 说明 |
-| ---- | ---- |
-| `ChatContainer` 的 `size` prop | 推荐。根节点 `.ai-chat-container` 设置 `data-ai-size`；同时通过 `useGlobalConfig` 注入 `size` 供逻辑层读取 |
-| 手动设置 `data-ai-size` | 在任意祖先元素上设置 `data-ai-size="small"` 或 `data-ai-size="normal"`，后代继承 CSS 变量 |
-| `document.body.dataset.aiSize` | `ChatContainer` 会自动同步，供 Tippy / Teleport 等挂载到 `body` 的浮层继承字号变量；容器卸载时清理 |
-
-```vue
-<template>
-  <ChatContainer v-model="input" :messages="messages" size="normal" />
-</template>
-```
-
-### CSS 变量
-
-定义于 `src/styles/size-theme.scss`，随 `global.scss` 自动引入：
-
-| 变量名 | `small`（默认） | `normal` | 说明 |
-| ------ | --------------- | -------- | ---- |
-| `--ai-font-size` | `12px` | `14px` | 基准字号 |
-| `--ai-line-height` | `20px` | `24px` | 标准行高 |
-| `--ai-line-height-compact` | `20px` | `22px` | 紧凑行高 |
-| `--ai-spacing-comfortable` | `8px` | `12px` | 舒适间距（如消息气泡水平内边距） |
-| `--ai-icon-size` | `16px` | `20px` | 标准图标尺寸 |
-| `--ai-icon-size-sm` | `16px` | `18px` | 小号图标尺寸 |
-
-组件样式中统一使用 `var(--ai-font-size, 12px)` 等形式引用，保证无 `data-ai-size` 时仍退回 small 档位。
-
-```scss
-// 示例：在自定义样式中复用字号主题变量
-.my-custom-panel {
-  font-size: var(--ai-font-size, 12px);
-  line-height: var(--ai-line-height, 20px);
-}
-```
-
-### 骨架屏
-
-全局类 `.ai-skeleton-element` 用于加载占位（如 FlowAgent 节点详情、UserFeedback 原因列表）。可通过 `.skeleton-element-lg` 修饰尺寸。详见各业务组件文档中的加载态说明。
-
 ## SCSS 变量
 
 组件库使用以下 SCSS 变量，可以在项目中覆盖：
@@ -428,7 +383,6 @@ $selection-z-index: $shortcut-menu-z-index + 1;
 
 ## 关联组件
 
-- [ChatContainer](../components/setup/chat-container) — 布局与字号主题根节点（`size` prop）
-- [useGlobalConfig](../composables/use-global-config) — 注入 `size` 供后代读取
-- [ChatInput](../components/input/chat-input) — 输入区变量与类名
-- [MessageContainer](../components/setup/message-container) — 消息列表区域
+- [ChatContainer](../components/molecular/chat-container.md) — 布局与主题根节点
+- [ChatInput](../components/molecular/chat-input.md) — 输入区变量与类名
+- [MessageContainer](../components/molecular/message-container.md) — 消息列表区域

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-工具栏图标按钮。 源码位置：src/components/ai-buttons/tool-btn/tool-btn.vue。
+ToolBtn 为消息工具栏提供单个操作入口：内置常用 id 与 SVG 图标映射、Tippy 提示、激活与禁用态。 通常由 MessageTools 遍历配置渲染；DeleteTool 也可将其作为删除触发的视觉入口。
 
 ### 关联组件
 - **message-tools** — 父级组装多个工具按钮与交互
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # ToolBtn 工具按钮
-## 源码事实
 
-- **源码位置**：`src/components/ai-buttons/tool-btn/tool-btn.vue`
-- **能力域**：工具与反馈
-- **能力说明**：工具栏图标按钮。
-
-> **能力域**：工具与反馈
+> **层级**：原子组件 · **功能域**：工具与反馈
 
 消息工具栏中的单个操作按钮，内置 SVG 图标映射、Tippy 悬浮提示、激活态与禁用态，通常由 `MessageTools` 管理，一般不需要手动使用。
 
@@ -286,5 +281,5 @@ type ToolIcons =
 
 ## 关联组件
 
-- [MessageTools](/components/feedback/message-tools) — 工具栏容器
-- [DeleteTool](/components/feedback/delete-tool) — 删除确认内嵌触发
+- [MessageTools](../molecular/message-tools.md) — 工具栏容器
+- [DeleteTool](../molecular/delete-tool.md) — 删除确认内嵌触发

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染工具返回内容，JSON 场景交给 DescPanel 展示。 源码位置：src/components/chat-message/tool-message/tool-message.vue。
+ToolMessage 展示工具（Function Call）执行返回，内部用 DescPanel 将 JSON 解析为 key-value 或纯文本。通常不单独使用： ToolcallRender 在 toolCall.toolMessage 有值时内联渲染；独立 role 为 tool 的消息由 MessageRender 统一渲染。核心关注 content 与 error。
 
 ### 关联组件
 - **assistant-message** — 结果常作为 assistant 消息中 toolCall.toolMessage 内联展示
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ToolMessage 工具消息
-## 源码事实
 
-- **源码位置**：`src/components/chat-message/tool-message/tool-message.vue`
-- **能力域**：消息系统
-- **能力说明**：渲染工具返回内容，JSON 场景交给 DescPanel 展示。
-
-> **能力域**：消息系统
+> **层级**：分子组件 · **功能域**：消息展示
 
 工具（Function Call）执行结果展示组件。内部通过 `DescPanel` 渲染，标题固定为"返回内容"，支持将 JSON 自动解析为 key-value 列表。
 
@@ -217,6 +212,6 @@ interface ToolMessage {
 
 ## 关联组件
 
-- [AssistantMessage](/components/message/assistant-message) — toolCall.toolMessage 内联场景
-- [MessageRender](/components/message/message-render) — 独立 tool 消息派发
-- [DescPanel](/components/rendering/desc-panel) — 返回内容面板
+- [AssistantMessage](./assistant-message.md) — toolCall.toolMessage 内联场景
+- [MessageRender](./message-render.md) — 独立 tool 消息派发
+- [DescPanel](../atomic/desc-panel.md) — 返回内容面板

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染 assistant toolCalls，展示工具调用状态、参数和结果。 源码位置：src/components/tool-call/toolcall-render/toolcall-render.vue。
+ToolcallRender 折叠展示一次工具/MCP 调用：头部显示名称、状态色、耗时与 MCP 标识，展开区展示参数与返回。 内部组合 DescPanel 与 HighlightKeyword；可在详情底部内联 ToolMessage 结果。
 
 ### 关联组件
 - **desc-panel** — 详情区展示参数与描述文本
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ToolcallRender 工具调用渲染器
-## 源码事实
 
-- **源码位置**：`src/components/tool-call/toolcall-render/toolcall-render.vue`
-- **能力域**：Agent 能力
-- **能力说明**：渲染 assistant toolCalls，展示工具调用状态、参数和结果。
-
-> **能力域**：Agent 能力
+> **层级**：分子组件 · **功能域**：工具与反馈
 
 展示 AI 调用外部工具/函数过程与结果的渲染组件。由**可折叠头部**和**详情面板**组成，根据 `status` 自动切换颜色和状态文案，支持 MCP 调用识别和内联结果展示。
 
@@ -299,6 +294,6 @@ interface ToolMessage {
 
 ## 关联组件
 
-- [DescPanel](/components/rendering/desc-panel) — 描述与参数面板
-- [HighlightKeyword](/components/helper/highlight-keyword) — 标题高亮
-- [ToolMessage](/components/message/tool-message) — 内联工具返回
+- [DescPanel](../atomic/desc-panel.md) — 描述与参数面板
+- [HighlightKeyword](../atomic/highlight-keyword.md) — 标题高亮
+- [ToolMessage](./tool-message.md) — 内联工具返回

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-useAnimationText 接收 MaybeRef<string> 与可选 AnimationConfig（fadeDuration、easing），返回 chunks 与 animationStyle。 监听文本变化：前缀追加则增量拆分为新 chunk 并触发动画，否则重置为单 chunk，适合流式输出逐段淡入。 全局样式已含 ai-markdown-fade-in。AnimationText 组件内部封装同一逻辑。
+useAnimationText 接收 MaybeRef<string> 与可选 AnimationConfig（fadeDuration、easing），返回 chunks 与 animationStyle。 监听文本变化：前缀追加则增量拆分为新 chunk 并触发动画，否则重置为单 chunk，适合流式输出逐段淡入。 全局样式已含 ai-markdown-fade-in。AnimationText 原子组件内部封装同一逻辑。
 
 ### 关联组件
 - **animation-text** — 封装 chunks 与样式渲染
@@ -126,7 +126,7 @@ useAnimationText 接收 MaybeRef<string> 与可选 AnimationConfig（fadeDuratio
 </script>
 ```
 
-> 详见 [AnimationText 组件文档](/components/rendering/animation-text)。
+> 详见 [AnimationText 组件文档](/components/atomic/animation-text)。
 
 ## API
 
@@ -194,5 +194,5 @@ function useAnimationText(
 
 ## 关联组件
 
-- [AnimationText](../components/rendering/animation-text) — 默认封装组件
-- [MarkdownContent](../components/rendering/markdown-content) — 富文本流式展示场景。
+- [AnimationText](../components/atomic/animation-text.md) — 默认封装组件
+- [MarkdownContent](../components/atomic/markdown-content.md) — 富文本流式展示场景。

package/dist/mcp/generated/docs/use-clipboard.md

@@ -201,6 +201,6 @@ export const useClipboard = () => {
 
 ## 关联组件
 
-- [CodeContent](../components/rendering/code-content) — 代码块复制
-- [MessageContainer](../components/setup/message-container) — 助手消息复制
-- [UserMessage](../components/message/user-message) — 用户消息复制
+- [CodeContent](../components/atomic/code-content.md) — 代码块复制
+- [MessageContainer](../components/molecular/message-container.md) — 助手消息复制
+- [UserMessage](../components/molecular/user-message.md) — 用户消息复制

package/dist/mcp/generated/docs/use-command-selection.md

@@ -148,4 +148,4 @@ export const useCommandSelection = () => {
 
 ## 关联组件
 
-- [ChatInput](../components/input/chat-input) — AiSlashInput 子模块使用
+- [ChatInput](../components/molecular/chat-input.md) — AiSlashInput 子模块使用

package/dist/mcp/generated/docs/use-custom-tab.md

@@ -124,4 +124,4 @@ interface CustomTab<T = Record<string, unknown>> {
 
 ## 关联组件
 
-- [ChatContainer](../components/setup/chat-container) — 侧栏 Tab 与自定义面板
+- [ChatContainer](../components/molecular/chat-container.md) — 侧栏 Tab 与自定义面板

package/dist/mcp/generated/docs/use-full-screen.md

@@ -65,7 +65,7 @@ useFullScreen(target?)
 
 `ChatContainer` 将侧栏包裹在 `.ai-full-screen-wrapper` 中，通过 `useFullScreen(fullScreenRef)` 控制侧栏全屏；Tab 栏 `#setting` 插槽内的 `ToolBtn` 使用自定义插槽渲染 `FullScreenIcon` / `UnFullScreenIcon`。
 
-详见 [ChatContainer 侧栏全屏](../components/setup/chat-container.md#侧栏全屏)。
+详见 [ChatContainer 侧栏全屏](../components/molecular/chat-container.md#侧栏全屏)。
 
 ## API
 
@@ -110,5 +110,5 @@ declare function useFullScreen(target?: MaybeRef<HTMLElement | null>): UseFullSc
 
 ## 关联组件
 
-- [ChatContainer](../components/setup/chat-container.md) — 内置侧栏全屏按钮
-- [ToolBtn](../components/feedback/tool-btn.md) — 全屏按钮自定义插槽
+- [ChatContainer](../components/molecular/chat-container.md) — 内置侧栏全屏按钮
+- [ToolBtn](../components/atomic/tool-btn.md) — 全屏按钮自定义插槽