@blueking/chat-x 0.0.45-beta.6 → 0.0.45-dev.1

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息列表（MessageContainer）、输入（ChatInput）、执行摘要（ExecutionSummary）、快捷表单（ShortcutRender）与多选栏（SelectionFooter）。 内置 useMessageGroup、分享与自定义 Tab 等能力；对 MessageContainer/ChatInput 下推 inputStatus（末尾 Loading 占位时推导 Fetching），适合一站式接入。 通过 props 传入 messages、shortcuts 等，事件与 ChatInput/MessageContainer 对齐；renderMode 会通过内部 provide 下传给子内容组件。
+完整对话容器，组合消息列表、输入区、快捷指令、执行摘要、分享选择和自定义 Tab。 源码位置：src/components/chat-container/chat-container.vue。
 
 ### 关联组件
 - **message-container** — 消息列表与滚动区域
@@ -14,8 +14,13 @@ ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息
 <!-- FULL DOC -->
 
 # ChatContainer 聊天容器
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：输入交互
+- **源码位置**：`src/components/chat-container/chat-container.vue`
+- **能力域**：对话搭建
+- **能力说明**：完整对话容器，组合消息列表、输入区、快捷指令、执行摘要、分享选择和自定义 Tab。
+
+> **能力域**：对话搭建
 
 顶层聊天容器组件，整合了 `MessageContainer`（消息列表）、`ChatInput`（输入框）、`ExecutionSummary`（执行摘要面板）、`ShortcutRender`（快捷指令表单）和 `SelectionFooter`（多选操作栏）。提供完整的 AI 对话界面布局能力。
 
@@ -24,17 +29,20 @@ ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息
 - **分栏布局**：基于 `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
+ai-chat-container（:data-ai-size="size"）
 ├── Loading（chatLoading 时）
 └── ResizeLayout
     ├── aside（侧边栏）
@@ -48,12 +56,14 @@ ai-chat-container
     │   └── collapse-button（折叠按钮，CollapsedIcon；折叠时图标旋转，hover 高亮 #3a84ff）
     └── main（主内容区）
         ├── MessageContainer（有消息时）
+        │   ├── #group 插槽（可选，自定义消息组内容）
+        │   ├── #message 插槽（可选，自定义单条消息）
         │   └── 消息列表 + 工具栏
         ├── 欢迎页（无消息时，容器 .ai-welcome-content）
         │   └── welcome 插槽（默认：Banner + 欢迎标题 + 开场白 ContentRender；自定义则整块替换）
         ├── SelectionFooter（分享模式时）
         ├── ShortcutRender（有快捷指令时）
-        └── ChatInput（默认状态）
+        └── ChatInput（默认状态，待审批时通过 interrupt slot 展示 InputInfoAlert）
 ```
 
 ## 基础用法
@@ -108,6 +118,26 @@ ai-chat-container
 
 **渲染效果**
 
+## 字号主题
+
+通过 `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 消息。支持关键词搜索过滤和点击定位到对话中的消息位置。
@@ -317,6 +347,113 @@ ai-chat-container
 
 `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` 操作栏：
@@ -400,10 +537,11 @@ 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](./chat-input.md) 和 [MessageContainer](./message-container.md) 文档。
+> 完整 Props 列表请参考 [ChatInput](/components/input/chat-input) 和 [MessageContainer](/components/setup/message-container) 文档。
 
 ### v-model
 
@@ -428,12 +566,14 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 
 ### Slots
 
-| 插槽名     | 参数                                   | 说明                                                                                           |
-| ---------- | -------------------------------------- | ---------------------------------------------------------------------------------------------- |
-| codeHeader | `{ language: string; token: Token[] }` | 代码块头部自定义操作区域，透传给 MessageRender → ContentRender → MarkdownContent → CodeContent |
-| default    | 消息列表相关绑定（messages 等）        | 自定义消息列表区域                                                                             |
-| message    | `{ message, messageToolsStatus }`      | 自定义单条消息渲染                                                                             |
-| welcome    | `{ openingRemark: string }`            | 无消息时自定义欢迎页；传入则替换默认 Banner、标题与开场白区域（整块替换）                      |
+| 插槽名            | 参数                                                                                                              | 说明                                                                                           |
+| ----------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| 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、标题与开场白区域（整块替换）                      |
 
 ### Expose
 
@@ -478,7 +618,19 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 ## 类型定义
 
 ```typescript
-import { ChatContainer, RenderMode, type CustomTab, type Shortcut, type Message } from '@blueking/chat-x';
+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;
+}
 
 // 自定义 Tab（data 可与 messageUid 组合，供侧栏定位主对话）
 interface CustomTab<T = Record<string, unknown>> {
@@ -497,10 +649,12 @@ interface Shortcut {
 
 ## 关联组件
 
-- [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) — 侧栏全屏控制
+- [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 变量

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-ChatInput 是聊天主输入区，集成富文本编辑（/ 提示词模板、@ 资源引用）、消息引用、附件上传与快捷指令入口。 通过 prompts、resources、shortcuts 等 props 配置能力，配合 messageStatus 控制发送、流式与停止。 内部组合 ShortcutBtns、FileUploadBtn 等，与 ShortcutRender 联动完成含表单的快捷指令流程。
+聊天输入区，组合富文本输入、快捷指令、附件、引用、发送/停止等交互。 源码位置：src/components/chat-input/chat-input.vue。
 
 ### 关联组件
 - **shortcut-btns** — 底部附件区默认展示的快捷指令列表
@@ -14,8 +14,13 @@ ChatInput 是聊天主输入区，集成富文本编辑（/ 提示词模板、@
 <!-- FULL DOC -->
 
 # ChatInput 聊天输入框
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：输入交互
+- **源码位置**：`src/components/chat-input/chat-input.vue`
+- **能力域**：输入交互
+- **能力说明**：聊天输入区，组合富文本输入、快捷指令、附件、引用、发送/停止等交互。
+
+> **能力域**：输入交互
 
 聊天消息输入框组件，支持快捷指令选择、资源 `@` 引用、Prompt `/` 模板、消息引用、文件上传（拖拽/粘贴/点击）等功能。
 
@@ -24,6 +29,7 @@ ChatInput 是聊天主输入区，集成富文本编辑（/ 提示词模板、@
 ```
 chat-input-container
 ├── slot#top（容器顶部，在输入框框体外侧）
+├── slot#interrupt（容器顶部，在输入框框体外侧，通常展示中断/审批提示）
 └── chat-input（框体，受 inputMaxHeight 控制）
     ├── slot#input-header（默认：cite 不为空时渲染引用区）
     ├── slot#files（默认：有上传文件时渲染文件预览区）
@@ -87,6 +93,53 @@ 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（流式输出中，显示停止按钮）
@@ -370,11 +423,12 @@ chat-input-container
 
 ## 自定义插槽
 
-组件提供 5 个插槽用于自定义各区域内容：
+组件提供 6 个插槽用于自定义各区域内容：
 
 | 插槽名         | 位置                                       | 默认行为                                   |
 | -------------- | ------------------------------------------ | ------------------------------------------ |
 | `top`          | 框体外部顶部（`.chat-input` 上方）         | 无                                         |
+| `interrupt`    | 框体外部顶部，位于 `top` 之后              | 无，通常用于展示审批/中断提示              |
 | `input-header` | 框体内部顶部（编辑器上方）                 | `cite` 不为空时渲染引用区（`CiteContent`） |
 | `files`        | 文件预览区                                 | 有上传文件时渲染 `FileContent`             |
 | `attachment`   | 底部工具栏快捷指令区（FileUploadBtn 右侧） | 快捷指令按钮列表 / 已选快捷指令            |
@@ -393,6 +447,11 @@ chat-input-container
       <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>
@@ -422,7 +481,7 @@ chat-input-container
 </template>
 ```
 
-**渲染效果**（顶部自定义模型信息提示）
+**渲染效果**（顶部自定义模型信息与中断提示）
 
 ## Expose（模板引用）
 
@@ -467,9 +526,10 @@ chat-input-container
 | 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) => Promise<void>` | -        | -    | 发送消息回调，无文件时 content 为字符串，有文件时为数组 |
+| onSendMessage      | `(content: UserMessage['content'], docSchema: TagSchema, options?: { interrupt?: Interrupt; payload?: InterruptResume }) => Promise<void>` | -        | -    | 发送消息回调，无文件时 content 为字符串，有文件时为数组；经 [ChatContainer](/components/setup/chat-container) 使用时，存在待回答 UserQuestion 会传入第三参数 `options` |
 | onStopSending      | `() => Promise<void>`                                                      | -        | -    | 停止发送回调，点击停止按钮时触发                        |
 | onUpload           | `(file: File) => Promise<{ download_url?: string }>`                       | -        | -    | 文件上传回调（每次单文件）                              |
 
@@ -494,6 +554,7 @@ chat-input-container
 | 插槽名       | 参数                               | 说明                                                       |
 | ------------ | ---------------------------------- | ---------------------------------------------------------- |
 | top          | -                                  | 框体（`.chat-input`）外部顶部，适合展示模型/Token 信息     |
+| interrupt    | -                                  | 框体外部顶部，位于 `top` 后，适合展示审批/中断提示         |
 | input-header | -                                  | 框体内顶部，替换引用区（`CiteContent`）                    |
 | files        | `{ files: Partial<UploadFile>[] }` | 文件预览区                                                 |
 | attachment   | -                                  | 底部快捷指令区，`FileUploadBtn` 在其左侧，不受此 slot 影响 |
@@ -564,6 +625,13 @@ 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>;
 ```
 
 ## 完整集成示例
@@ -628,8 +696,8 @@ type SendContent =
 
 ## 关联组件
 
-- [ShortcutBtns](../atomic/shortcut-btns.md) — 底部附件区默认快捷指令列表
-- [ShortcutBtn](../atomic/shortcut-btn.md) — 已选快捷指令单按钮展示
-- [ShortcutRender](./shortcut-render.md) — 含表单的快捷指令表单渲染
-- [ChatContainer](./chat-container.md) — 顶层布局中包裹输入区
-- [CiteContent](../atomic/cite-content.md) — 消息引用区内容展示
+- [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) — 消息引用区内容展示

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

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

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

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

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-CommonErrorContent 以红色错误图标加文案展示失败态，布局为 flex 横排，文本为纯文本插值。 在 MarkdownContent、ReasoningMessage 等链路上当 status 为 error 时自动替换内容区。
+展示统一错误提示内容。 源码位置：src/components/chat-content/common-error-content/common-error-content.vue。
 
 ### 关联组件
 - **markdown-content** — Markdown 渲染错误态展示
@@ -11,10 +11,15 @@ CommonErrorContent 以红色错误图标加文案展示失败态，布局为 fle
 <!-- 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'` 时自动渲染，无需手动使用。
 
@@ -66,5 +71,5 @@ CommonErrorContent 以红色错误图标加文案展示失败态，布局为 fle
 
 ## 关联组件
 
-- [MarkdownContent](./markdown-content.md) — Markdown 错误态
-- [ReasoningMessage](../molecular/reasoning-message.md) — 推理错误态
+- [MarkdownContent](/components/rendering/markdown-content) — Markdown 错误态
+- [ReasoningMessage](/components/message/reasoning-message) — 推理错误态

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

@@ -36,6 +36,7 @@ enum MessageRole {
   HiddenSystem = 'hidden-system',
   HiddenUser = 'hidden-user',
   Info = 'info',
+  Interrupt = 'interrupt',
   Loading = 'loading',
   Pause = 'pause',
   Placeholder = 'placeholder',
@@ -72,6 +73,70 @@ 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
 
 消息内容类型枚举：
@@ -238,6 +303,6 @@ console.log(
 
 ## 关联组件
 
-- [MessageTools](../components/molecular/message-tools.md) — 消息工具栏
-- [ChatInput](../components/molecular/chat-input.md) — 输入与状态
-- [MessageContainer](../components/molecular/message-container.md) — 工具与消息展示
+- [MessageTools](../components/feedback/message-tools) — 消息工具栏
+- [ChatInput](../components/input/chat-input) — 输入与状态
+- [MessageContainer](../components/setup/message-container) — 工具与消息展示