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

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

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

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

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

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

@@ -107,6 +107,9 @@ enum MessageRole {
   // 信息消息
   Info = 'info',
 
+  // human-in-the-loop 中断消息
+  Interrupt = 'interrupt',
+
   // 加载中消息
   Loading = 'loading',
 
@@ -138,23 +141,32 @@ enum MessageRole {
 
 ```typescript
 enum MessageStatus {
-  // 等待中
-  Pending = 'pending',
-
-  // 流式输出中
-  Streaming = 'streaming',
-
   // 已完成
   Complete = 'complete',
 
+  // 已禁用
+  Disabled = 'disabled',
+
   // 错误
   Error = 'error',
 
+  // 请求中
+  Fetching = 'fetching',
+
+  // 等待中
+  Pending = 'pending',
+
   // 已停止
   Stop = 'stop',
 
-  // 已禁用
-  Disabled = 'disabled',
+  // 停止请求中
+  StopLoading = 'stop-loading',
+
+  // 流式输出中
+  Streaming = 'streaming',
+
+  // 成功
+  Success = 'success',
 }
 ```
 
@@ -337,6 +349,58 @@ 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
 
 信息消息：
@@ -473,6 +537,6 @@ interface CustomMessage extends BaseMessage<'custom-role'> {
 
 ## 关联组件
 
-- [MessageContainer](../components/molecular/message-container.md) — 消息列表
-- [MessageRender](../components/molecular/message-render.md) — 单条消息渲染
-- [ChatContainer](../components/molecular/chat-container.md) — 聊天容器
+- [MessageContainer](../components/setup/message-container) — 消息列表
+- [MessageRender](../components/message/message-render) — 单条消息渲染
+- [ChatContainer](../components/setup/chat-container) — 聊天容器

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

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

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

@@ -0,0 +1,42 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+图片预览的缩放、旋转、下载等工具按钮。 源码位置：src/components/image-preview/preview-toolbar.vue。
+
+---
+<!-- FULL DOC -->
+
+# PreviewToolbar 图片预览工具栏
+
+> **能力域**：媒体文件
+
+## 源码事实
+
+- **源码位置**：`src/components/image-preview/preview-toolbar.vue`
+- **能力说明**：图片预览的缩放、旋转、下载等工具按钮。
+
+## API 摘要
+
+### Props
+
+- `{ activeIndex: number; currentImageInfo?: null | { resolution?: string; width?: number }; isMultiple: boolean; showInfo: boolean; total: number; }`
+
+### Emits
+
+- `{ (e: 'zoomIn'): void; (e: 'zoomOut'): void; (e: 'rotate'): void; (e: 'reset'): void; (e: 'download'): void; }`
+
+### Slots
+
+- `extra`
+
+### Expose
+
+- 无。
+
+## 组件依赖
+
+- 无组件依赖或仅依赖基础库。
+
+## 使用建议
+
+- 优先通过上层组合组件使用；直接使用前请确认 props 数据结构来自对应类型定义。

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

@@ -0,0 +1,88 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+源码为空文件，没有 props、emits、slots 或渲染能力；不建议作为功能组件使用。 源码位置：src/components/ai-questions/questions-container.vue。
+
+### 关联组件
+- **user-question-card** — 用户问题中断交互请使用实际可渲染的问题卡片组件
+- **user-question-option** — 用户问题选项行由实际中断组件承载
+- **interrupt-message** — HITL 中断消息由 InterruptMessage 分发到具体问题组件
+
+---
+<!-- FULL DOC -->
+
+# QuestionsContainer 问题容器占位
+
+> **能力域**：辅助能力
+
+`QuestionsContainer` 当前只是保留在源码目录中的空文件，占位路径为 `src/components/ai-questions/questions-container.vue`。它没有模板、脚本、样式、props、emits、slots 或任何渲染行为。
+
+本文档保留该条目，是为了在组件总览和 MCP 文档检索中明确说明：它不是当前可用能力。
+
+## 源码事实
+
+- **源码位置**：`src/components/ai-questions/questions-container.vue`
+- **文件大小**：`0` 字节
+- **能力说明**：源码为空文件，没有 props、emits、slots 或渲染能力；不建议作为功能组件使用。
+
+## 当前状态
+
+| 项目     | 状态 |
+| -------- | ---- |
+| 模板     | 无   |
+| 脚本逻辑 | 无   |
+| 样式     | 无   |
+| Props    | 无   |
+| Emits    | 无   |
+| Slots    | 无   |
+| Expose   | 无   |
+
+## 不可用示例
+
+下面的写法不会产生任何可见 UI，也不会承载问题列表逻辑：
+
+```vue
+<template>
+  <!-- 不建议使用：当前组件为空文件 -->
+  <QuestionsContainer />
+</template>
+```
+
+## 推荐替代
+
+如果要展示用户问题中断或选项交互，请使用已经实现的中断消息组件链路：
+
+```vue
+<template>
+  <InterruptMessage :message="message" />
+</template>
+```
+
+或在具体场景中使用：
+
+- [InterruptMessage](../agent/interrupt-message.md) — 中断消息分发入口。
+- [UserQuestionCard](../agent/user-question-card.md) — 用户问题中断交互面板。
+- [UserQuestionOption](../agent/user-question-option.md) — 用户问题选项行。
+
+## API
+
+### Props
+
+- 无。
+
+### Emits
+
+- 无。
+
+### Slots
+
+- 无。
+
+### Expose
+
+- 无。
+
+## 使用建议
+
+- 不建议在业务中使用该组件。
+- 如果后续补齐实现，需要同步更新本文档的能力说明、示例、API 与关联组件。

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

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

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

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

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

@@ -0,0 +1,112 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+渲染引用文档类活动内容，复用 ActivityLayout 与 ReferenceContent。 源码位置：src/components/chat-content/reference-doc-content/reference-doc-content.vue。
+
+### 关联组件
+- **activity-message** — 非 knowledge_rag / flow_agent 活动默认可分发为引用文档活动
+- **activity-layout** — 提供可折叠的活动容器外壳
+- **reference-content** — 渲染引用文档列表
+
+---
+<!-- FULL DOC -->
+
+# ReferenceDocContent 引用文档活动
+
+> **能力域**：Agent 能力
+
+`ReferenceDocContent` 用于渲染“引用 N 篇资料作为参考”这类活动消息。组件基于 `ActivityLayout` 提供折叠外壳，并将文档数组交给 `ReferenceContent` 展示。
+
+通常不需要直接使用，`ActivityMessage` 会在引用文档活动场景中分发到本组件。
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-content/reference-doc-content/reference-doc-content.vue`
+- **能力说明**：渲染引用文档类活动内容，复用 ActivityLayout 与 ReferenceContent。
+
+## 核心能力
+
+- **数量标题**：根据 `content.length` 生成标题，中文为“引用 N 篇资料作为参考”
+- **文档图标**：标题区域固定展示文档图标，不随消息状态变化
+- **可折叠内容**：通过 `v-model:collapsed` 控制引用列表展开/收起，默认展开
+- **引用列表复用**：文档展示、hover 操作图标、链接打开规则均由 `ReferenceContent` 负责
+
+## 基础用法
+
+```vue
+<template>
+  <ReferenceDocContent
+    v-model:collapsed="collapsed"
+    :content="docs"
+  />
+</template>
+
+<script setup lang="ts">
+  import { ref } from 'vue';
+  import ReferenceDocContent from '@blueking/chat-x/src/components/chat-content/reference-doc-content/reference-doc-content.vue';
+  import type { ReferenceDocumentContent } from '@blueking/chat-x';
+
+  const collapsed = ref(false);
+
+  const docs: ReferenceDocumentContent[] = [
+    { name: '蓝鲸 Agent 接入指南', url: 'https://example.com/agent', originFile: 'https://example.com/docs/agent' },
+    { name: '主机巡检操作手册', url: 'https://example.com/host-check', originFile: 'https://example.com/docs/host-check' },
+  ];
+</script>
+```
+
+**渲染效果**
+
+## 空引用
+
+当 `content` 为空或未传入时，标题数量显示为 `0`，引用列表为空。
+
+## 折叠状态
+
+## API
+
+### Props
+
+| 属性名     | 类型                         | 必填 | 默认值 | 说明                                   |
+| ---------- | ---------------------------- | ---- | ------ | -------------------------------------- |
+| content    | `ReferenceDocumentContent[]` | 否   | —      | 引用文档列表                           |
+| messageUid | `string`                     | 否   | —      | 所属消息唯一标识，当前组件暂未直接使用 |
+
+### Models
+
+| 名称      | 类型      | 默认值  | 说明             |
+| --------- | --------- | ------- | ---------------- |
+| collapsed | `boolean` | `false` | 活动内容是否折叠 |
+
+### Emits
+
+- 无显式 emits；`v-model:collapsed` 会产生 `update:collapsed`。
+
+### Slots
+
+- 无。
+
+### Expose
+
+- 无。
+
+## 类型定义
+
+```typescript
+export type ReferenceDocumentContent = {
+  name: string;       // 文档标题
+  originFile: string; // 原始文件链接，存在时 ReferenceContent 显示跳转操作
+  url: string;        // 预览链接或标题点击链接
+};
+```
+
+## 使用建议
+
+- 只负责引用文档活动外壳；如果只需要纯引用列表，请直接使用 [ReferenceContent](../rendering/reference-content.md)。
+- 文档条目的过滤与操作图标规则以 `ReferenceContent` 为准，`ReferenceDocContent` 不重复处理。
+
+## 关联组件
+
+- [ActivityMessage](../message/activity-message.md) — 活动消息分发入口。
+- [ActivityLayout](../helper/activity-layout.md) — 折叠活动外壳。
+- [ReferenceContent](../rendering/reference-content.md) — 引用来源列表。

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

@@ -0,0 +1,93 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+schema.ts 仍导出 UserSingleChoiceQuestionSchema、UserMultiChoiceQuestionSchema、UserQuestionSchema 及 FromSchema 推导类型； 新的 aidev:user_question 中断不再通过 BaseInterrupt.responseSchema 区分单选/多选，而是在 metadata.questions[].multiSelect 中描述题型。
+
+### 关联组件
+- **interrupt** — 新 UserQuestionInterrupt 与 UserQuestionResume 协议
+- **user-question-card** — 根据 metadata.questions 渲染单选、多选与 Others 输入
+
+---
+<!-- FULL DOC -->
+
+# 用户问题 Schema
+
+> **分类**：type
+
+`src/ag-ui/types/schema.ts` 保留了历史 JSON Schema 工具导出：
+
+- `UserSingleChoiceQuestionSchema`
+- `UserMultiChoiceQuestionSchema`
+- `UserQuestionSchema`
+- `UserSingleChoiceQuestion`
+- `UserMultiChoiceQuestion`
+- `UserQuestion`
+
+新的 `InterruptReason.UserQuestion`（`'aidev:user_question'`）协议不再依赖 `BaseInterrupt.responseSchema`，而是在 `UserQuestionInterrupt.metadata.questions[]` 中用 `multiSelect` 描述单选 / 多选题，并通过 `UserQuestionResume.payload.answers` 回传回答。
+
+## 新协议入口
+
+```typescript
+type UserQuestionItem = {
+  header: string;
+  multiSelect: boolean;
+  options?: UserQuestionOptionItem[];
+  question: string;
+};
+
+type UserQuestionResume = {
+  interruptId: string;
+  reason: InterruptReason.UserQuestion;
+  status: 'cancelled' | 'resolved';
+  payload: {
+    answers: UserQuestionAnswerItem[];
+  };
+};
+```
+
+完整结构见 [中断类型 Interrupt](./interrupt.md#userquestioninterrupt)。
+
+## 历史导出
+
+### UserSingleChoiceQuestionSchema
+
+```typescript
+const UserSingleChoiceQuestionSchema = {
+  properties: {
+    question: {
+      enum: [],
+      type: 'string',
+    },
+  },
+  required: ['question'],
+  type: 'object',
+} as const;
+```
+
+### UserMultiChoiceQuestionSchema
+
+```typescript
+const UserMultiChoiceQuestionSchema = {
+  properties: {
+    question: {
+      items: {
+        enum: [],
+        type: 'string',
+      },
+      uniqueItems: true,
+      type: 'array',
+    },
+  },
+  required: ['question'],
+  type: 'object',
+} as const;
+```
+
+### UserQuestionSchema
+
+`UserQuestionSchema` 与 `UserQuestion` 仍为 `UserMultiChoiceQuestionSchema` / `UserMultiChoiceQuestion` 的别名。
+
+## 关联文档
+
+- [中断类型 Interrupt](./interrupt.md)
+- [UserQuestionCard 用户问题中断](../components/agent/user-question-card)