@blueking/chat-x 0.0.42 → 0.0.45-beta.1

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

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

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

@@ -383,6 +383,6 @@ $selection-z-index: $shortcut-menu-z-index + 1;
 
 ## 关联组件
 
-- [ChatContainer](../components/molecular/chat-container.md) — 布局与主题根节点
-- [ChatInput](../components/molecular/chat-input.md) — 输入区变量与类名
-- [MessageContainer](../components/molecular/message-container.md) — 消息列表区域
+- [ChatContainer](../components/setup/chat-container) — 布局与主题根节点
+- [ChatInput](../components/input/chat-input) — 输入区变量与类名
+- [MessageContainer](../components/setup/message-container) — 消息列表区域

package/dist/mcp/generated/docs/tool-approval-card.md

@@ -0,0 +1,148 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+渲染 AIDevToolApproval 中断的审批信息与取消操作。 源码位置：src/components/chat-message/interrupt-message/tool-approval-card.vue。
+
+### 关联组件
+- **interrupt-message** — InterruptMessageRender 按 reason 派发渲染
+
+---
+<!-- FULL DOC -->
+
+# ToolApprovalCard 审批卡片
+## 源码事实
+
+- **源码位置**：`src/components/chat-message/interrupt-message/tool-approval-card.vue`
+- **能力域**：Agent 能力
+- **能力说明**：渲染 AIDevToolApproval 中断的审批信息与取消操作。
+
+> **能力域**：Agent 能力
+
+AI Dev 第三方工具审批（`InterruptReason.AIDevToolApproval`）专用卡片，由 [InterruptMessageRender](/components/agent/interrupt-message) 按 `reason` 动态挂载。
+
+> **通常不需要单独引入**；仅在需要独立预览卡片样式时使用。
+
+## 渲染结构
+
+```
+ToolApprovalCard
+├── 标题栏：左侧色条 + 单据标题 + 复制图标 + 状态徽章（评审中/已通过/已拒绝/已撤销等）
+├── 字段区：单据编号、提交时间
+├── 处理人：当前处理人（overflow-tips 省略）
+└── 操作区：查看单据详情（新窗口打开 url）、取消审批（仅 pending / draft）
+```
+
+状态徽章样式：
+
+| `ticket.status`                         | 视觉     |
+| --------------------------------------- | -------- |
+| `pending`、`draft`                      | 蓝色评审中 |
+| `approved`                              | 绿色通过 |
+| `rejected`、`cancelled`、`expired`、`abandoned` | 红色终态 |
+| `revoked`                               | 橙色已撤销 |
+
+## 基础用法（待审批）
+
+> `ToolApprovalCard` 为 `InterruptMessageRender` 内部子组件，**未从 `@blueking/chat-x` 包入口导出**。业务侧通过构造 `InterruptMessage` 触发渲染即可；下方为类型与数据结构参考。
+
+```vue
+<template>
+  <!-- 业务侧推荐：由 MessageRender / MessageContainer 自动渲染 -->
+  <InterruptMessageRender
+    :content="interruptMessage.content"
+    role="interrupt"
+    :status="interruptMessage.status"
+    :on-interrupt-resume="handleInterruptResume"
+  />
+</template>
+
+<script setup lang="ts">
+  import {
+    InterruptMessageRender,
+    APPROVAL_STATUS,
+    InterruptReason,
+    MessageRole,
+    MessageStatus,
+    type InterruptMessage,
+    type AIDevToolApprovalInterrupt,
+  } from '@blueking/chat-x';
+
+  const interrupt: AIDevToolApprovalInterrupt = {
+    id: 'interrupt_1',
+    reason: InterruptReason.AIDevToolApproval,
+    toolCallId: 'tool_call_1',
+    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/tickets/001',
+      },
+    },
+  };
+
+  const interruptMessage: InterruptMessage = {
+    id: 'msg_1',
+    messageId: 'msg_1',
+    role: MessageRole.Interrupt,
+    status: MessageStatus.Pending,
+    content: {
+      outcome: { type: 'interrupt', interrupts: [interrupt] },
+    },
+  };
+
+  const handleInterruptResume = async (payload, interrupt) => {
+    console.log(payload, interrupt.id);
+  };
+</script>
+```
+
+**渲染效果**（文档站直接挂载 `ToolApprovalCard` 预览卡片 UI）
+
+## 已通过 / 已拒绝 / 已撤销
+
+```vue
+<div>
+  <InterruptMessageRender
+    :content="{ outcome: { type: 'interrupt', interrupts: [approvedInterrupt] } }"
+    role="interrupt"
+  />
+  <InterruptMessageRender
+    :content="{ outcome: { type: 'interrupt', interrupts: [rejectedInterrupt] } }"
+    role="interrupt"
+  />
+  <InterruptMessageRender
+    :content="{ outcome: { type: 'interrupt', interrupts: [revokedInterrupt] } }"
+    role="interrupt"
+  />
+</div>
+```
+
+**渲染效果**
+
+## API
+
+### Props
+
+| 属性名            | 类型                         | 默认值 | 说明                                         |
+| ----------------- | ---------------------------- | ------ | -------------------------------------------- |
+| interrupt         | `AIDevToolApprovalInterrupt` | —      | **必填**，含 `metadata.ticket`               |
+| onInterruptResume | `OnInterruptResume`          | —      | 取消审批时触发，签名为 `(payload, interrupt)`，payload 为 `{ action: 'cancel' }` |
+
+### Events / Slots / Expose
+
+无。打开链接、复制剪贴板在组件内部完成；取消审批通过 `onInterruptResume({ action: 'cancel' }, interrupt)` 通知业务侧处理。
+
+## 依赖
+
+- `bkui-vue`：`Button`、`Loading`
+- `useClipboard` — 复制单据
+- `v-overflow-tips` — 处理人超长省略
+
+## 关联组件
+
+- [InterruptMessage 中断消息](/components/agent/interrupt-message)
+- [中断类型 Interrupt](../../types/interrupt.md)
+- [常量枚举 Constants](../../types/constants.md) — `APPROVAL_STATUS`、`APPROVAL_STATUS_MAP`

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

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

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

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

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

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

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/atomic/animation-text)。
+> 详见 [AnimationText 组件文档](/components/rendering/animation-text)。
 
 ## API
 
@@ -194,5 +194,5 @@ function useAnimationText(
 
 ## 关联组件
 
-- [AnimationText](../components/atomic/animation-text.md) — 默认封装组件
-- [MarkdownContent](../components/atomic/markdown-content.md) — 富文本流式展示场景。
+- [AnimationText](../components/rendering/animation-text) — 默认封装组件
+- [MarkdownContent](../components/rendering/markdown-content) — 富文本流式展示场景。

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

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

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

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

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

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

package/dist/mcp/generated/docs/use-global-config.md

@@ -122,4 +122,4 @@ export function injectGlobalConfig(): GlobalConfig | undefined;
 
 ## 关联组件
 
-- [ChatContainer](../components/molecular/chat-container.md) — 调用 `useGlobalConfig` 注入 `supportUpload`
+- [ChatContainer](../components/setup/chat-container) — 调用 `useGlobalConfig` 注入 `supportUpload`

package/dist/mcp/generated/docs/use-menu-keydown.md

@@ -161,4 +161,4 @@ useMenuKeydown<T>(props: {
 
 ## 关联组件
 
-- [ChatInput](../components/molecular/chat-input.md) — `@` 菜单与 `/` 提示词列表
+- [ChatInput](../components/input/chat-input) — `@` 菜单与 `/` 提示词列表

package/dist/mcp/generated/docs/use-message-group.md

@@ -27,6 +27,8 @@ function useMessageGroup(options: {
 }): {
   messageGroups: Ref<MessageGroup[]>;
   executionGroups: ComputedRef<MessageGroup[]>;
+  pendingApprovalCount: ComputedRef<number>;
+  pendingApprovalTipText: ComputedRef<string>;
   isShareMode: ShallowRef<boolean>;
   isAllSelected: ComputedRef<boolean>;
   onToggleShareAll: (isAllSelected: boolean) => void;
@@ -113,6 +115,24 @@ const isExecutionMessage = (m: Message): boolean => {
 | toolCall   | `function.name`、`mcpName`、`description`、`arguments`、`id` |
 | flow_agent | 各任务 `task_name`、各节点 `name`                             |
 
+## 待审批统计
+
+`useMessageGroup` 会统计消息列表中处于待审批状态的 AI Dev 审批中断：
+
+```typescript
+const pendingApprovalStatusSet = new Set([APPROVAL_STATUS.PENDING, APPROVAL_STATUS.DRAFT]);
+```
+
+当 `MessageRole.Interrupt` 消息的 `content.outcome.type === 'interrupt'`，且其中断项满足 `reason === InterruptReason.AIDevToolApproval`、`metadata.ticket.status` 为 `pending` 或 `draft` 时，计入 `pendingApprovalCount`。
+
+`pendingApprovalTipText` 根据数量生成输入区提示文案：
+
+```typescript
+'当前会话有 {count} 个待审批单，如需继续，请先取消审批'
+```
+
+`ChatContainer` 会消费该返回值，向 `ChatInput` 传入 `sendDisabledTip` 并在输入区上方展示提示，从而阻止继续发送。
+
 ## 分享模式
 
 `useMessageGroup` 提供完整的分享模式支持：
@@ -142,12 +162,21 @@ const keyword = shallowRef('');
 const messages = computed(() => props.messages);
 const selectedUserMessages = deepRef<Message[]>([]);
 
-const { messageGroups, executionGroups, isShareMode, isAllSelected, onToggleShareAll, onCancelShare, onConfirmShare } =
-  useMessageGroup({
-    keyword,
-    messages,
-    selectedUserMessages,
-  });
+const {
+  messageGroups,
+  executionGroups,
+  pendingApprovalCount,
+  pendingApprovalTipText,
+  isShareMode,
+  isAllSelected,
+  onToggleShareAll,
+  onCancelShare,
+  onConfirmShare,
+} = useMessageGroup({
+  keyword,
+  messages,
+  selectedUserMessages,
+});
 ```
 
 ## 返回值说明
@@ -156,6 +185,8 @@ const { messageGroups, executionGroups, isShareMode, isAllSelected, onToggleShar
 | ---------------- | ----------------------------- | --------------------------------------------------------------------------- |
 | messageGroups    | `Ref<MessageGroup[]>`         | 完整消息分组列表                                                            |
 | executionGroups  | `ComputedRef<MessageGroup[]>` | 仅包含执行类消息的分组（工具调用 + FlowAgent），自动提取 `userMessageTitle` |
+| pendingApprovalCount | `ComputedRef<number>`      | 当前消息中待审批 AI Dev 审批中断的数量                                      |
+| pendingApprovalTipText | `ComputedRef<string>`    | 待审批阻塞发送提示文案；无待审批时为空字符串                                |
 | isShareMode      | `ShallowRef<boolean>`         | 是否处于分享模式                                                            |
 | isAllSelected    | `ComputedRef<boolean>`        | 所有用户消息组是否全部选中                                                  |
 | onToggleShareAll | `(checked: boolean) => void`  | 切换全选                                                                    |
@@ -181,6 +212,6 @@ interface MessageGroup {
 
 ## 关联组件
 
-- [ChatContainer](../components/molecular/chat-container.md) — 调用 useMessageGroup 并下传分组
-- [MessageContainer](../components/molecular/message-container.md) — 渲染 messageGroups
-- [ExecutionSummary](../components/molecular/execution-summary.md) — 消费 executionGroups
+- [ChatContainer](../components/setup/chat-container) — 调用 useMessageGroup 并下传分组
+- [MessageContainer](../components/setup/message-container) — 渲染 messageGroups
+- [ExecutionSummary](../components/agent/execution-summary) — 消费 executionGroups

package/dist/mcp/generated/docs/use-observer-visible-list.md

@@ -186,4 +186,4 @@ function useObserverVisibleList<T>(
 
 ## 关联组件
 
-- [ShortcutBtns](../components/atomic/shortcut-btns.md) — 快捷指令条与「更多」
+- [ShortcutBtns](../components/input/shortcut-btns.md) — 快捷指令条与「更多」

package/dist/mcp/generated/docs/user-feedback.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-UserFeedback 在点赞或踩之后展示原因收集面板：多选预设标签、补充说明与异步加载原因列表（骨架屏）。 由 MessageTools 在 like/unlike 流程中挂载，提交后向父级回传原因列表与备注。
+用户反馈弹层，提交踩/反馈原因。 源码位置：src/components/message-tools/user-feedback/user-feedback.vue。
 
 ### 关联组件
 - **message-tools** — 点赞/踩操作触发并收集反馈
@@ -10,8 +10,13 @@ UserFeedback 在点赞或踩之后展示原因收集面板：多选预设标签
 <!-- FULL DOC -->
 
 # MessageUserFeedback 用户反馈
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：工具与反馈
+- **源码位置**：`src/components/message-tools/user-feedback/user-feedback.vue`
+- **能力域**：工具与反馈
+- **能力说明**：用户反馈弹层，提交踩/反馈原因。
+
+> **能力域**：工具与反馈
 
 AI 消息点赞/踩后收集用户具体反馈原因的弹出面板。支持多选预设原因标签、补充文字说明（textarea）、异步加载原因列表（骨架屏）。
 
@@ -226,4 +231,4 @@ loading=false，展示原因标签列表
 
 ## 关联组件
 
-- [MessageTools](./message-tools.md) — 点赞/踩入口与反馈联动
+- [MessageTools](/components/feedback/message-tools) — 点赞/踩入口与反馈联动

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-UserMessage 渲染右对齐用户消息，支持文本、附件、文本/结构化引用、快捷指令与内联编辑。需处理 onAction、onInputConfirm、 onShortcutConfirm 等回调；messageToolsStatus 控制工具栏。由 MessageRender 在 user 角色下使用，常与多选联动。
+渲染用户消息，支持文本、键值、Markdown、引用、文件和编辑态输入。 源码位置：src/components/chat-message/user-message/user-message.vue。
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 user 时创建
@@ -12,8 +12,13 @@ UserMessage 渲染右对齐用户消息，支持文本、附件、文本/结构
 <!-- FULL DOC -->
 
 # UserMessage 用户消息
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：消息展示
+- **源码位置**：`src/components/chat-message/user-message/user-message.vue`
+- **能力域**：消息系统
+- **能力说明**：渲染用户消息，支持文本、键值、Markdown、引用、文件和编辑态输入。
+
+> **能力域**：消息系统
 
 用户消息展示组件，右对齐显示用户发送的消息内容。支持纯文本、多媒体（图片/文件）、文本引用、结构化引用、快捷指令等多种内容形式，以及消息的内联编辑功能。
 
@@ -346,6 +351,6 @@ interface MessageExtra {
 
 ## 关联组件
 
-- [MessageRender](./message-render.md) — user 角色由其实例化
-- [MessageTools](./message-tools.md) — 工具栏交互
-- [MessageContainer](./message-container.md) — 列表与多选容器
+- [MessageRender](/components/message/message-render) — user 角色由其实例化
+- [MessageTools](/components/feedback/message-tools) — 工具栏交互
+- [MessageContainer](/components/setup/message-container) — 列表与多选容器

package/dist/mcp/generated/docs/user-question-answered-card.md

@@ -0,0 +1,106 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+在 UserQuestion resume 成功后回显用户回答或取消状态。 源码位置：src/components/chat-message/interrupt-message/user-question/user-question-answered-card.vue。
+
+### 关联组件
+- **interrupt-message** — outcome.success 且 reason 为 UserQuestion 时挂载本组件
+- **user-question-card** — 待回答面板，与本组件成对出现
+
+---
+<!-- FULL DOC -->
+
+# UserQuestionAnsweredCard 用户问题回答回显
+
+> **能力域**：Agent 能力
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-message/interrupt-message/user-question/user-question-answered-card.vue`
+- **能力说明**：在 UserQuestion resume 成功后回显用户回答或取消状态。
+
+由 [InterruptMessageRender](/components/agent/interrupt-message) 在 `content.outcome.type === 'success'` 且 `result.reason === InterruptReason.UserQuestion` 时渲染。默认逐条展示选择题答案；业务可通过 `#answer` slot 自定义回显形态（如自定义表单字段）。
+
+## 基础用法
+
+```vue
+<template>
+  <UserQuestionAnsweredCard
+    :answers="answers"
+    status="resolved"
+  />
+</template>
+
+<script setup lang="ts">
+  import { UserQuestionAnsweredCard, type UserQuestionAnswerItem } from '@blueking/chat-x';
+
+  const answers: UserQuestionAnswerItem[] = [
+    {
+      question: '你希望采用哪种实现？',
+      multiSelect: false,
+      answer: [{ label: 'optimized', description: '优化版' }],
+    },
+  ];
+</script>
+```
+
+**渲染效果**
+
+## 已取消（跳过）
+
+```vue
+<UserQuestionAnsweredCard
+  :answers="[]"
+  status="cancelled"
+/>
+```
+
+**渲染效果**
+
+## 自定义回显（#answer slot）
+
+当待回答阶段使用了自定义 `#question` 表单时，可通过 `#answer` slot 自定义回显：
+
+```vue
+<UserQuestionAnsweredCard
+  :answers="answers"
+  status="resolved"
+>
+  <template #answer="{ item, index, status }">
+    <MyCustomAnswerView :data="item" :index="index" :status="status" />
+  </template>
+</UserQuestionAnsweredCard>
+```
+
+`InterruptMessageRender`、`MessageRender`、`MessageContainer` 提供 `#answeredQuestion` slot，参数与 `#answer` 一致，逐层透传至本组件。使用 `ChatContainer` 时若覆盖了 `#message` 插槽，需在自定义 `MessageRender` 中继续透传 `#answeredQuestion`。
+
+## API
+
+### Props
+
+| 属性名  | 类型                         | 默认值       | 说明                                   |
+| ------- | ---------------------------- | ------------ | -------------------------------------- |
+| answers | `UserQuestionAnswerItem[]`   | —            | **必填**，已回答内容列表               |
+| status  | `'resolved' \| 'cancelled'` | `'resolved'` | resume 状态：`resolved` 已回复，`cancelled` 已取消（跳过） |
+
+### Slots
+
+| 插槽名 | 参数                                              | 说明                                                         |
+| ------ | ------------------------------------------------- | ------------------------------------------------------------ |
+| answer | `{ item, index, status }`                         | 自定义单题回答回显；未覆盖时默认渲染 `answer[].description \|\| label` |
+
+| 参数   | 类型                              | 说明                     |
+| ------ | --------------------------------- | ------------------------ |
+| item   | `UserQuestionAnswerItem`          | 当前题的回答数据         |
+| index  | `number`                          | 题目序号（从 0 开始）    |
+| status | `'resolved' \| 'cancelled'`      | 与 Props.status 一致     |
+
+### Events / Expose
+
+无。
+
+## 关联文档
+
+- [InterruptMessage 中断消息](/components/agent/interrupt-message)
+- [UserQuestionCard 用户问题中断](/components/agent/user-question-card)
+- [中断类型 Interrupt](../../types/interrupt.md)