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

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-聊天输入区，组合富文本输入、快捷指令、附件、引用、发送/停止等交互。 源码位置：src/components/chat-input/chat-input.vue。
+ChatInput 是聊天主输入区，集成富文本编辑（/ 提示词模板、@ 资源引用）、消息引用、附件上传与快捷指令入口。 通过 prompts、resources、shortcuts 等 props 配置能力，配合 messageStatus 控制发送、流式与停止。 内部组合 ShortcutBtns、FileUploadBtn 等，与 ShortcutRender 联动完成含表单的快捷指令流程。
 
 ### 关联组件
 - **shortcut-btns** — 底部附件区默认展示的快捷指令列表
@@ -14,13 +14,8 @@
 <!-- FULL DOC -->
 
 # ChatInput 聊天输入框
-## 源码事实
 
-- **源码位置**：`src/components/chat-input/chat-input.vue`
-- **能力域**：输入交互
-- **能力说明**：聊天输入区，组合富文本输入、快捷指令、附件、引用、发送/停止等交互。
-
-> **能力域**：输入交互
+> **层级**：分子组件 · **功能域**：输入交互
 
 聊天消息输入框组件，支持快捷指令选择、资源 `@` 引用、Prompt `/` 模板、消息引用、文件上传（拖拽/粘贴/点击）等功能。
 
@@ -29,7 +24,6 @@
 ```
 chat-input-container
 ├── slot#top（容器顶部，在输入框框体外侧）
-├── slot#interrupt（容器顶部，在输入框框体外侧，通常展示中断/审批提示）
 └── chat-input（框体，受 inputMaxHeight 控制）
     ├── slot#input-header（默认：cite 不为空时渲染引用区）
     ├── slot#files（默认：有上传文件时渲染文件预览区）
@@ -93,53 +87,6 @@ chat-input-container
 
 > **实现细节**：组件内部用 `messageState` 计算属性决定实际按钮状态：当 `messageStatus` 为 `pending`、`streaming` 或 `fetching` 时直接使用该状态（确保停止按钮始终可用）；否则当输入为空或仅含空白字符时强制为 `disabled`，其余情况使用 `messageStatus` 的值。`fetching` 时按 Enter **不会**触发发送（避免请求中与 Loading 占位阶段重复提交）。
 
-### onSendMessage 第三参数 options（UserQuestion 上下文）
-
-`ChatInput` 自身调用 `onSendMessage` 时只传前两个参数。当组件被 [ChatContainer](/components/setup/chat-container) 包裹且存在待回答 `UserQuestion` 中断时，容器会在用户点击发送时注入第三个参数：
-
-| 字段        | 类型               | 说明                                                                 |
-| ----------- | ------------------ | -------------------------------------------------------------------- |
-| `interrupt` | `Interrupt`        | 当前激活的 `UserQuestionInterrupt`                                   |
-| `payload`   | `InterruptResume`  | skip resume（`status: 'cancelled'`，`payload.answers` 为空数组）     |
-
-此场景下容器**不会**自动清空 `modelValue`，业务侧需在 `onSendMessage` 内自行处理消息发送与 `resumeAgent` 的先后顺序。结构化作答仍通过 `UserQuestionCard` → `onInterruptResume` 完成。
-
-```typescript
-const handleSendMessage = async (
-  content: UserMessage['content'],
-  docSchema: TagSchema,
-  options?: { interrupt?: Interrupt; payload?: InterruptResume },
-) => {
-  if (options?.interrupt && options?.payload) {
-    await resumeAgent({ interruptId: options.interrupt.id, resume: options.payload });
-    return;
-  }
-  await sendMessage(content, docSchema);
-};
-```
-
-### sendDisabledTip（业务阻塞发送）
-
-当业务侧需要临时阻止发送但仍允许用户输入时，可传入 `sendDisabledTip`。组件会置灰发送按钮，按钮 tooltip 展示该文案，并拦截点击发送、按 Enter 发送和 `triggerSendMessage()`：
-
-```vue
-<template>
-  <ChatInput
-    v-model="inputValue"
-    message-status="complete"
-    :send-disabled-tip="interruptTip"
-    :on-send-message="handleSendMessage"
-    :on-stop-sending="handleStopSending"
-  >
-    <template #interrupt>
-      <div class="input-alert">{{ interruptTip }}</div>
-    </template>
-  </ChatInput>
-</template>
-```
-
-**渲染效果**
-
 ### Complete（可发送）
 
 ### Streaming（流式输出中，显示停止按钮）
@@ -423,12 +370,11 @@ const handleSendMessage = async (
 
 ## 自定义插槽
 
-组件提供 6 个插槽用于自定义各区域内容：
+组件提供 5 个插槽用于自定义各区域内容：
 
 | 插槽名         | 位置                                       | 默认行为                                   |
 | -------------- | ------------------------------------------ | ------------------------------------------ |
 | `top`          | 框体外部顶部（`.chat-input` 上方）         | 无                                         |
-| `interrupt`    | 框体外部顶部，位于 `top` 之后              | 无，通常用于展示审批/中断提示              |
 | `input-header` | 框体内部顶部（编辑器上方）                 | `cite` 不为空时渲染引用区（`CiteContent`） |
 | `files`        | 文件预览区                                 | 有上传文件时渲染 `FileContent`             |
 | `attachment`   | 底部工具栏快捷指令区（FileUploadBtn 右侧） | 快捷指令按钮列表 / 已选快捷指令            |
@@ -447,11 +393,6 @@ const handleSendMessage = async (
       <div class="input-tips">当前模型: GPT-4 · 剩余 Token: 12,800</div>
     </template>
 
-    <!-- 框体外顶部，适合展示中断、审批等业务提示 -->
-    <template #interrupt>
-      <div class="input-alert">当前会话有待审批单，暂时不能继续发送</div>
-    </template>
-
     <!-- 替换引用区，可自定义引用样式 -->
     <template #input-header>
       <div class="custom-header">自定义头部内容</div>
@@ -481,7 +422,7 @@ const handleSendMessage = async (
 </template>
 ```
 
-**渲染效果**（顶部自定义模型信息与中断提示）
+**渲染效果**（顶部自定义模型信息提示）
 
 ## Expose（模板引用）
 
@@ -526,10 +467,9 @@ const handleSendMessage = async (
 | placeholder        | `string`                                                                   | 见默认值 | -    | 编辑器占位符，支持多行                                  |
 | inputMaxHeight     | `number`                                                                   | `200`    | -    | 框体最大高度（px），有文件时自动加上文件预览区高度      |
 | defaultUploadFiles | `UploadFile[]`                                                             | -        | -    | 预设已上传的文件列表                                    |
-| sendDisabledTip    | `string`                                                                   | -        | -    | 业务阻塞发送时的 tooltip 提示；传入后发送按钮置灰，点击、Enter 与 `triggerSendMessage()` 均不会发送 |
 | supportUpload      | `boolean`                                                                  | `true`   | -    | 是否显示文件上传按钮                                    |
 | 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` |
+| onSendMessage      | `(content: UserMessage['content'], docSchema: TagSchema) => Promise<void>` | -        | -    | 发送消息回调，无文件时 content 为字符串，有文件时为数组 |
 | onStopSending      | `() => Promise<void>`                                                      | -        | -    | 停止发送回调，点击停止按钮时触发                        |
 | onUpload           | `(file: File) => Promise<{ download_url?: string }>`                       | -        | -    | 文件上传回调（每次单文件）                              |
 
@@ -554,7 +494,6 @@ const handleSendMessage = async (
 | 插槽名       | 参数                               | 说明                                                       |
 | ------------ | ---------------------------------- | ---------------------------------------------------------- |
 | top          | -                                  | 框体（`.chat-input`）外部顶部，适合展示模型/Token 信息     |
-| interrupt    | -                                  | 框体外部顶部，位于 `top` 后，适合展示审批/中断提示         |
 | input-header | -                                  | 框体内顶部，替换引用区（`CiteContent`）                    |
 | files        | `{ files: Partial<UploadFile>[] }` | 文件预览区                                                 |
 | attachment   | -                                  | 底部快捷指令区，`FileUploadBtn` 在其左侧，不受此 slot 影响 |
@@ -625,13 +564,6 @@ type SendContent =
       // 有文件时：数组
       { type: 'binary'; url?: string; mimeType: string; filename: string } | { type: 'text'; text: string }
     >;
-
-// onSendMessage 完整签名（第三参数由 ChatContainer 在 UserQuestion 场景注入）
-type OnSendMessage = (
-  content: SendContent,
-  docSchema: TagSchema,
-  options?: { interrupt?: Interrupt; payload?: InterruptResume },
-) => Promise<void>;
 ```
 
 ## 完整集成示例
@@ -696,8 +628,8 @@ type OnSendMessage = (
 
 ## 关联组件
 
-- [ShortcutBtns](/components/input/shortcut-btns) — 底部附件区默认快捷指令列表
-- [ShortcutBtn](/components/input/shortcut-btn) — 已选快捷指令单按钮展示
-- [ShortcutRender](/components/input/shortcut-render) — 含表单的快捷指令表单渲染
-- [ChatContainer](/components/setup/chat-container) — 顶层布局中包裹输入区
-- [CiteContent](/components/rendering/cite-content) — 消息引用区内容展示
+- [ShortcutBtns](../atomic/shortcut-btns.md) — 底部附件区默认快捷指令列表
+- [ShortcutBtn](../atomic/shortcut-btn.md) — 已选快捷指令单按钮展示
+- [ShortcutRender](./shortcut-render.md) — 含表单的快捷指令表单渲染
+- [ChatContainer](./chat-container.md) — 顶层布局中包裹输入区
+- [CiteContent](../atomic/cite-content.md) — 消息引用区内容展示

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染输入或消息中的引用片段。 源码位置：src/components/chat-content/cite-content/cite-content.vue。
+CiteContent 在输入区上方以紧凑条带展示被引用文本片段，单行截断并可选关闭按钮移除引用。 常与 ChatInput 的引用预览区配合，不执行 HTML 渲染。
 
 ### 关联组件
 - **chat-input** — 输入区展示待发送引用内容
@@ -10,13 +10,8 @@
 <!-- FULL DOC -->
 
 # CiteContent 引用内容
-## 源码事实
 
-- **源码位置**：`src/components/chat-content/cite-content/cite-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：渲染输入或消息中的引用片段。
-
-> **能力域**：内容渲染
+> **层级**：原子组件 · **功能域**：辅助组件
 
 展示被引用文本片段的紧凑条带组件。固定高度 28px，左侧引用图标 + 单行截断文本 + 可选关闭图标，背景灰色（`#f5f7fa`）。
 
@@ -140,4 +135,4 @@ const message = {
 
 ## 关联组件
 
-- [ChatInput](/components/input/chat-input) — 引用区常见挂载位置
+- [ChatInput](../molecular/chat-input.md) — 引用区常见挂载位置

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染 Markdown 代码块，支持高亮、复制和 header 插槽。 源码位置：src/components/markdown-token/code-content/code-content.vue。
+CodeContent 接收 markdown-it 的 fence/code_block token，按行 highlight.js 高亮并带语言标签与复制。 必填 props 为 token 数组；mounted 事件用于滚动联动等。 由 MarkdownContent 在解析代码块时挂载，面向流式增量更新。
 
 ### 关联组件
 - **markdown-content** — 解析 Markdown 后生成 fence token 并渲染本组件
@@ -10,15 +10,10 @@
 <!-- FULL DOC -->
 
 # CodeContent 代码块渲染
-## 源码事实
 
-- **源码位置**：`src/components/markdown-token/code-content/code-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：渲染 Markdown 代码块，支持高亮、复制和 header 插槽。
+> **层级**：原子组件 · **功能域**：内容渲染
 
-> **能力域**：内容渲染
-
-代码块渲染基础组件，专为 **Markdown 流式输出**设计。接收 `markdown-it` token 数组，基于 `highlight.js`（github-dark 主题）实现逐行语法高亮，顶部固定深色头部展示语言名和复制按钮。
+代码块渲染原子组件，专为 **Markdown 流式输出**设计。接收 `markdown-it` token 数组，基于 `highlight.js`（github-dark 主题）实现逐行语法高亮，顶部固定深色头部展示语言名和复制按钮。
 
 ## 组件结构
 
@@ -209,4 +204,4 @@ import type { Token } from 'markdown-it';
 
 ## 关联组件
 
-- [MarkdownContent](/components/rendering/markdown-content) — 解析并传入 code fence token
+- [MarkdownContent](./markdown-content.md) — 解析并传入 code fence token

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-展示统一错误提示内容。 源码位置：src/components/chat-content/common-error-content/common-error-content.vue。
+CommonErrorContent 以红色错误图标加文案展示失败态，布局为 flex 横排，文本为纯文本插值。 在 MarkdownContent、ReasoningMessage 等链路上当 status 为 error 时自动替换内容区。
 
 ### 关联组件
 - **markdown-content** — Markdown 渲染错误态展示
@@ -11,15 +11,10 @@
 <!-- FULL DOC -->
 
 # CommonErrorContent 通用错误内容
-## 源码事实
 
-- **源码位置**：`src/components/chat-content/common-error-content/common-error-content.vue`
-- **能力域**：内容渲染
-- **能力说明**：展示统一错误提示内容。
+> **层级**：原子组件 · **功能域**：辅助组件
 
-> **能力域**：内容渲染
-
-错误状态消息渲染基础组件。红色 `ErrorIcon`（14×14px，绝对定位）+ 文本区域，`display: flex` 水平排列。
+错误状态消息渲染原子组件。红色 `ErrorIcon`（14×14px，绝对定位）+ 文本区域，`display: flex` 水平排列。
 
 通常由上层组件在 `status === 'error'` 时自动渲染，无需手动使用。
 
@@ -71,5 +66,5 @@
 
 ## 关联组件
 
-- [MarkdownContent](/components/rendering/markdown-content) — Markdown 错误态
-- [ReasoningMessage](/components/message/reasoning-message) — 推理错误态
+- [MarkdownContent](./markdown-content.md) — Markdown 错误态
+- [ReasoningMessage](../molecular/reasoning-message.md) — 推理错误态

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

@@ -36,7 +36,6 @@ enum MessageRole {
   HiddenSystem = 'hidden-system',
   HiddenUser = 'hidden-user',
   Info = 'info',
-  Interrupt = 'interrupt',
   Loading = 'loading',
   Pause = 'pause',
   Placeholder = 'placeholder',
@@ -73,70 +72,6 @@ enum MessageStatus {
 | --------------- | ---- |
 | `Fetching`      | 请求中：与 `useMessageGroup` 在末尾用户消息后注入的 Loading 占位（`LOADING_MESSAGE_ID`）配合时，`ChatContainer` 会将传入输入区与列表底部的状态推导为该值，便于展示「停止」与禁止重复发送。 |
 
-### InterruptReason
-
-human-in-the-loop 中断原因枚举，用于 `Interrupt.reason` 区分中断类型并选择对应的 UI 渲染器。
-
-```typescript
-enum InterruptReason {
-  AIDevToolApproval = 'aidev:tool_approval',
-  UserQuestion = 'aidev:user_question',
-}
-```
-
-### APPROVAL_STATUS
-
-AI Dev 工具审批单状态枚举，`AIDevToolApprovalInterrupt.metadata.ticket.status` 使用该类型。
-
-```typescript
-enum APPROVAL_STATUS {
-  ABANDONED = 'abandoned',
-  APPROVED = 'approved',
-  CANCELLED = 'cancelled',
-  DRAFT = 'draft',
-  EXPIRED = 'expired',
-  PENDING = 'pending',
-  REJECTED = 'rejected',
-  REVOKED = 'revoked',
-}
-```
-
-### APPROVAL_STATUS_MAP
-
-审批单状态到展示文案的映射，供 `ToolApprovalCard` 等组件使用：
-
-```typescript
-const APPROVAL_STATUS_MAP: Record<APPROVAL_STATUS, string> = {
-  [APPROVAL_STATUS.ABANDONED]: '已废弃',
-  [APPROVAL_STATUS.APPROVED]: '已通过',
-  [APPROVAL_STATUS.CANCELLED]: '已取消',
-  [APPROVAL_STATUS.DRAFT]: '待审批',
-  [APPROVAL_STATUS.EXPIRED]: '已过期',
-  [APPROVAL_STATUS.PENDING]: '待审批',
-  [APPROVAL_STATUS.REJECTED]: '已拒绝',
-  [APPROVAL_STATUS.REVOKED]: '已撤销',
-};
-```
-
-| 状态值      | 展示文案 |
-| ----------- | -------- |
-| `pending`   | 待审批   |
-| `draft`     | 待审批   |
-| `approved`  | 已通过   |
-| `rejected`  | 已拒绝   |
-| `cancelled` | 已取消   |
-| `expired`   | 已过期   |
-| `abandoned` | 已废弃   |
-| `revoked`   | 已撤销   |
-
-### RunFinishedOutcome
-
-AG-UI `RUN_FINISHED` 事件的结束结果类型。中断结果不再是字符串枚举，而是对象联合类型；`type: 'interrupt'` 时，中断列表放在 `interrupts` 字段中。
-
-```typescript
-type RunFinishedOutcome = { interrupts: Interrupt[]; type: 'interrupt' } | { type: 'success' };
-```
-
 ### MessageContentType
 
 消息内容类型枚举：
@@ -303,6 +238,6 @@ console.log(
 
 ## 关联组件
 
-- [MessageTools](../components/feedback/message-tools) — 消息工具栏
-- [ChatInput](../components/input/chat-input) — 输入与状态
-- [MessageContainer](../components/setup/message-container) — 工具与消息展示
+- [MessageTools](../components/molecular/message-tools.md) — 消息工具栏
+- [ChatInput](../components/molecular/chat-input.md) — 输入与状态
+- [MessageContainer](../components/molecular/message-container.md) — 工具与消息展示

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-按 MessageContentType 分发 Markdown、文本、引用、键值、图片等内容。 源码位置：src/components/chat-content/content-render/content-render.vue。
+ContentRender 按消息 content 类型分发：字符串走 Markdown 管线，数组可走引用文档等；可扩展自定义 slot。 主要 props 为 content、status，与 MessageRender、AssistantMessage 等配合使用。 内置与 MarkdownContent、ReferenceContent 等原子/分子组件衔接。
 
 ### 关联组件
 - **markdown-content** — 文本类 Markdown 正文的默认渲染实现
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ContentRender 内容渲染器
-## 源码事实
 
-- **源码位置**：`src/components/chat-content/content-render/content-render.vue`
-- **能力域**：内容渲染
-- **能力说明**：按 MessageContentType 分发 Markdown、文本、引用、键值、图片等内容。
-
-> **能力域**：内容渲染
+> **层级**：分子组件 · **功能域**：内容渲染
 
 消息内容渲染分发组件，根据 `content` 的 JavaScript 类型自动选择渲染方式：字符串 → `MarkdownContent`（Markdown 渲染），数组 → `ReferenceContent`（引用列表）。
 
@@ -239,6 +234,6 @@ enum MessageStatus {
 
 ## 关联组件
 
-- [MarkdownContent](/components/rendering/markdown-content) — 字符串 Markdown 正文
-- [ReferenceContent](/components/rendering/reference-content) — 引用文档数组
-- [AssistantMessage](/components/message/assistant-message) — assistant 消息中默认使用
+- [MarkdownContent](../atomic/markdown-content.md) — 字符串 Markdown 正文
+- [ReferenceContent](../atomic/reference-content.md) — 引用文档数组
+- [AssistantMessage](./assistant-message.md) — assistant 消息中默认使用

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-消息删除二次确认工具。 源码位置：src/components/message-tools/delete-tool/delete-tool.vue。
+DeleteTool 在点击删除图标后弹出 Tippy 确认层，需再次点击「删除」才 emit confirm，避免误删。 触发器为 ToolBtn；MessageTools 在工具 id 为 delete 时用本组件替换普通 ToolBtn。
 
 ### 关联组件
 - **tool-btn** — 删除图标与触发入口
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # DeleteTool 删除确认按钮
-## 源码事实
 
-- **源码位置**：`src/components/message-tools/delete-tool/delete-tool.vue`
-- **能力域**：工具与反馈
-- **能力说明**：消息删除二次确认工具。
-
-> **能力域**：工具与反馈
+> **层级**：分子组件 · **功能域**：工具与反馈
 
 删除操作的二次确认组件。点击删除图标后弹出确认弹窗，用户需再次点击"删除"按钮才会触发 `confirm` 事件，防止误删。内部由 `ToolBtn`（触发按钮）+ `Tippy`（确认弹窗）组合实现。
 
@@ -189,5 +184,5 @@ export type DeleteToolProps = IToolBtn & {
 
 ## 关联组件
 
-- [ToolBtn](/components/feedback/tool-btn) — 触发按钮
-- [MessageTools](/components/feedback/message-tools) — 工具栏中 delete 替换入口
+- [ToolBtn](../atomic/tool-btn.md) — 触发按钮
+- [MessageTools](./message-tools.md) — 工具栏中 delete 替换入口

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-将文本或 JSON 内容降级为可读描述面板。 源码位置：src/components/tool-call/desc-panel/desc-panel.vue。
+DescPanel 将描述字符串尝试 JSON 解析为键值列表展示，否则按纯文本输出，用于工具调用详情折叠区。 内部对键与值使用 HighlightKeyword 支持搜索高亮。
 
 ### 关联组件
 - **toolcall-render** — 工具调用详情中渲染描述与参数
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # DescPanel 描述面板
-## 源码事实
 
-- **源码位置**：`src/components/tool-call/desc-panel/desc-panel.vue`
-- **能力域**：内容渲染
-- **能力说明**：将文本或 JSON 内容降级为可读描述面板。
-
-> **能力域**：内容渲染
+> **层级**：原子组件 · **功能域**：辅助组件
 
 工具调用（ToolCall）详情面板的描述区域组件，主要用于 `ToolcallRender` 内部的折叠面板中。
 
@@ -139,5 +134,5 @@ JSON 数组同样被视为 `object`，以数组索引（`0:`、`1:`…）作为
 
 ## 关联组件
 
-- [ToolcallRender](/components/agent/toolcall-render) — 主要使用场景
-- [HighlightKeyword](/components/helper/highlight-keyword) — 键值高亮
+- [ToolcallRender](../molecular/toolcall-render.md) — 主要使用场景
+- [HighlightKeyword](./highlight-keyword.md) — 键值高亮

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-按消息流提取执行摘要，支持关键词定位和消息渲染。 源码位置：src/components/execution-summary/execution-summary.vue。
+ExecutionSummary 以时间线汇总工具调用与 FlowAgent 等活动记录，支持关键词过滤与 HighlightKeyword 高亮。 点击可 emit 定位到会话中对应消息；内部用 MessageRender 渲染摘要条目中的消息片段。
 
 ### 关联组件
 - **message-render** — 摘要列表内渲染消息内容
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # ExecutionSummary 执行摘要
-## 源码事实
 
-- **源码位置**：`src/components/execution-summary/execution-summary.vue`
-- **能力域**：Agent 能力
-- **能力说明**：按消息流提取执行摘要，支持关键词定位和消息渲染。
-
-> **能力域**：Agent 能力
+> **层级**：分子组件 · **功能域**：辅助组件
 
 执行摘要面板组件，以时间线形式展示对话中的工具调用和 FlowAgent 活动记录。支持关键词搜索过滤和点击定位到对话中的消息位置。
 
@@ -126,6 +121,6 @@ interface MessageGroup {
 
 ## 关联组件
 
-- [MessageRender](/components/message/message-render) — 摘要内消息渲染
-- [HighlightKeyword](/components/helper/highlight-keyword) — 搜索高亮
-- [ChatContainer](/components/setup/chat-container) — 侧栏挂载场景
+- [MessageRender](./message-render.md) — 摘要内消息渲染
+- [HighlightKeyword](../atomic/highlight-keyword.md) — 搜索高亮
+- [ChatContainer](./chat-container.md) — 侧栏挂载场景

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染文件附件，支持图片预览和下载事件。 源码位置：src/components/chat-content/file-content/file-content.vue。
+FileContent 展示消息或输入区附件列表：图片显示缩略图并可进入 ImagePreview，文档以卡片展示文件名、类型与大小。 支持删除、图片加载失败占位及仅有远端文件名的降级展示。
 
 ### 关联组件
 - **image-preview** — 点击图片缩略图打开全屏预览
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # FileContent 文件内容展示
-## 源码事实
 
-- **源码位置**：`src/components/chat-content/file-content/file-content.vue`
-- **能力域**：媒体文件
-- **能力说明**：渲染文件附件，支持图片预览和下载事件。
-
-> **能力域**：媒体文件
+> **层级**：分子组件 · **功能域**：文件与图片
 
 文件列表展示组件，支持图片缩略图预览、点击图片全屏预览（`ImagePreview`）、文档卡片展示（文件名/扩展名/文件大小）、图片加载失败占位和删除操作。
 
@@ -301,5 +296,5 @@ const formatFileSize = (file?: File): string => {
 
 ## 关联组件
 
-- [ImagePreview](/components/medias/image-preview) — 图片全屏预览
-- [UserMessage](/components/message/user-message) — 用户消息内附件展示
+- [ImagePreview](./image-preview.md) — 图片全屏预览
+- [UserMessage](./user-message.md) — 用户消息内附件展示

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-文件选择按钮，封装 input[type=file] 并输出选择事件。 源码位置：src/components/ai-buttons/file-upload-btn/file-upload-btn.vue。
+FileUploadBtn 提供隐藏 file input 与图标按钮，选择后在按钮层过滤空文件与超大单文件并 emit upload； 个数上限不在此截断，由 ChatInput 等与 FileContent 配合完成「选择 → 展示 → 发送」链路。
 
 ### 关联组件
 - **chat-input** — 输入区附件上传按钮常见挂载位置
@@ -11,13 +11,8 @@
 <!-- FULL DOC -->
 
 # FileUploadBtn 文件上传按钮
-## 源码事实
 
-- **源码位置**：`src/components/ai-buttons/file-upload-btn/file-upload-btn.vue`
-- **能力域**：输入交互
-- **能力说明**：文件选择按钮，封装 input[type=file] 并输出选择事件。
-
-> **能力域**：输入交互
+> **层级**：原子组件 · **功能域**：文件与图片
 
 聊天输入框内置的文件上传触发按钮，点击后弹出系统文件选择框。内部包含隐藏的 `<input type="file">` 与可见的图标按钮；在按钮层对**单文件**做大小与空文件过滤，**已选文件个数上限**由上层（如 `ChatInput`）统一校验并提示，避免按钮与输入区各弹一条错误提示。
 
@@ -61,7 +56,7 @@
 
 > `multiple` prop 声明存在但当前模板中 `input` 的 `multiple` 属性为**硬编码**（非 `:multiple="multiple"` 绑定），始终允许多选，该 prop 暂时无实际效果。
 
-> **`maxFiles` prop**：当前版本在按钮内**不参与截断或计数校验**，仅作类型与文档预留；列表最多几个文件由上层（如 `ChatInput` 的 `MAX_UPLOAD_FILES`）控制。详见 [ChatInput 文件上传](/components/input/chat-input#file-upload)。
+> **`maxFiles` prop**：当前版本在按钮内**不参与截断或计数校验**，仅作类型与文档预留；列表最多几个文件由上层（如 `ChatInput` 的 `MAX_UPLOAD_FILES`）控制。详见 [ChatInput 文件上传](../molecular/chat-input.md#file-upload)。
 
 ## 基础用法
 
@@ -159,5 +154,5 @@ type AITippyProps = Partial<Pick<TippyOptions, 'appendTo' | 'placement' | 'zInde
 
 ## 关联组件
 
-- [ChatInput](/components/input/chat-input) — 默认内置上传入口
-- [FileContent](/components/medias/file-content) — 选中文件列表展示
+- [ChatInput](../molecular/chat-input.md) — 默认内置上传入口
+- [FileContent](../molecular/file-content.md) — 选中文件列表展示

package/dist/mcp/generated/docs/highlight-keyword.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-根据注入关键词高亮文本片段。 源码位置：src/components/highlight-keyword/highlight-keyword.ts。
+HighlightKeyword 为函数式组件，从 inject 读取关键词并将匹配片段包在带样式 span 中，用于对话内搜索与列表过滤高亮。 ToolcallRender、DescPanel、FlowAgent 等场景组合使用。
 
 ### 关联组件
 - **toolcall-render** — 工具调用标题与状态文案高亮
@@ -12,13 +12,8 @@
 <!-- FULL DOC -->
 
 # HighlightKeyword 关键词高亮
-## 源码事实
 
-- **源码位置**：`src/components/highlight-keyword/highlight-keyword.ts`
-- **能力域**：辅助能力
-- **能力说明**：根据注入关键词高亮文本片段。
-
-> **能力域**：辅助能力
+> **层级**：原子组件 · **功能域**：辅助组件
 
 函数式组件，用于在文本中高亮匹配的搜索关键词。通过 `useKeywordInject` 从上层注入关键词，自动将匹配部分包裹在带高亮样式的 `<span>` 中。
 
@@ -144,6 +139,6 @@ const { keywordMatched } = useKeywordMatch(() => [props.title, props.description
 
 ## 关联组件
 
-- [ToolcallRender](/components/agent/toolcall-render) — 工具调用头部高亮
-- [DescPanel](/components/rendering/desc-panel) — 详情面板键值高亮
-- [ExecutionSummary](/components/agent/execution-summary) — 执行摘要搜索
+- [ToolcallRender](../molecular/toolcall-render.md) — 工具调用头部高亮
+- [DescPanel](./desc-panel.md) — 详情面板键值高亮
+- [ExecutionSummary](../molecular/execution-summary.md) — 执行摘要搜索

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-渲染 Markdown 图片 token。 源码位置：src/components/markdown-token/image-content/image-content.vue。
+ImageContent 在 Markdown 解析到图片 token 时渲染，对流式拼接中的 URL 做防抖与预加载，并用模块级缓存避免重复闪烁。 三态展示加载中、成功与失败，通常由 MarkdownContent 自动挂载而非业务直接引用。
 
 ### 关联组件
 - **markdown-content** — 解析图片 token 后挂载本组件
@@ -10,15 +10,10 @@
 <!-- FULL DOC -->
 
 # ImageContent 图片渲染
-## 源码事实
 
-- **源码位置**：`src/components/markdown-token/image-content/image-content.vue`
-- **能力域**：媒体文件
-- **能力说明**：渲染 Markdown 图片 token。
+> **层级**：原子组件 · **功能域**：文件与图片
 
-> **能力域**：媒体文件
-
-Markdown Token 层的图片渲染基础组件，被 `MarkdownContent` 在解析到图片 token 时自动调用，通常无需手动引入。
+Markdown Token 层的图片渲染原子组件，被 `MarkdownContent` 在解析到图片 token 时自动调用，通常无需手动引入。
 
 核心能力：**流式 URL 防闪烁**（debounce 稳定判断 + throttle 预加载）、**全局缓存**（模块级 `Set` 跨实例共享）、**三态渲染**（加载中 / 成功 / 失败）。
 
@@ -180,4 +175,4 @@ URL = 完整 URL       → isValidUrl=true   → throttle 触发 preloadImage
 
 ## 关联组件
 
-- [MarkdownContent](/components/rendering/markdown-content) — 图片 token 渲染入口
+- [MarkdownContent](./markdown-content.md) — 图片 token 渲染入口