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

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)

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

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

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

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

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

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

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

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

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

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

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-ShortcutRender 将 Shortcut.components 声明渲染为 bkui-vue Form，支持多种控件与两列网格、必填校验及提交/取消。 通常由 ChatContainer 等布局挂载在输入区旁，formModel 与快捷指令回填联动。 与 Shortcut、ShortcutBtn 等共享同一套快捷指令数据模型。
+渲染快捷指令 components 表单并回传确认数据。 源码位置：src/components/ai-shortcut/shortcut-render/shortcut-render.vue。
 
 ### 关联组件
 - **shortcut-btn** — 与快捷指令 Shortcut 元数据一致，表单提交前在列表中选中入口
@@ -12,8 +12,13 @@ ShortcutRender 将 Shortcut.components 声明渲染为 bkui-vue Form，支持多
 <!-- FULL DOC -->
 
 # ShortcutRender 快捷指令渲染器
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：输入交互
+- **源码位置**：`src/components/ai-shortcut/shortcut-render/shortcut-render.vue`
+- **能力域**：输入交互
+- **能力说明**：渲染快捷指令 components 表单并回传确认数据。
+
+> **能力域**：输入交互
 
 快捷指令表单渲染组件，将 `Shortcut.components` 配置自动渲染为可交互表单（基于 bkui-vue 的 `Form`），支持 8 种控件类型、两列网格布局、必填校验和内置提交/取消操作。
 
@@ -344,7 +349,7 @@ const components: ShortcutComponent[] = [
 | ------------- | ------------------------------------ | ---- | ------------------------------------------------------------------------------------------ |
 | type          | 见[表单类型](#表单组件类型)          | ✓    | 控件类型；未知类型返回 `null`，不渲染                                                      |
 | key           | `string`                             | ✓    | 表单字段名；`submit` 事件返回对象以此为 key；同时作为校验 property                         |
-| name          | `string`                             | —    | 表单项标签；优先于 `formItemProps.label`，通过 `#label` 插槽渲染为 `.shortcut-render-form-label` |
+| name          | `string`                             | —    | 表单项标签（`Form.FormItem` 的 `label`）                                                   |
 | default       | `string`                             | —    | 字段初始值；优先于 `formModel`，在 `watchEffect` 中覆盖写入                                |
 | fillBack      | `boolean`                            | —    | `true` 时映射为 `required: true`（必填校验），同时标记回填语义                             |
 | placeholder   | `string`                             | —    | 占位文本（`input` / `textarea` / `number` 可用）                                           |
@@ -411,12 +416,8 @@ interface BaseShortcutComponent {
 }
 ```
 
-## 样式说明
-
-表单项与控件会附加类型化 class，便于样式覆盖：`shortcut-render-form-item_{type}`（如 `_radio`、`_checkbox`），单选/多选项子项为 `shortcut-render-form-item_radio` / `shortcut-render-form-item_checkbox`。表单项标签使用 BEM 风格类名 `shortcut-render-form-label`。
-
 ## 关联组件
 
-- [ShortcutBtn](../atomic/shortcut-btn.md) — 与 Shortcut 数据模型一致的入口按钮
-- [ChatInput](./chat-input.md) — 输入区与快捷指令流程联动
-- [ChatContainer](./chat-container.md) — 顶层布局中挂载快捷表单
+- [ShortcutBtn](/components/input/shortcut-btn) — 与 Shortcut 数据模型一致的入口按钮
+- [ChatInput](/components/input/chat-input) — 输入区与快捷指令流程联动
+- [ChatContainer](/components/setup/chat-container) — 顶层布局中挂载快捷表单

package/dist/mcp/generated/docs/simple-table.md

@@ -0,0 +1,103 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+FlowAgent 节点详情中的轻量表格展示组件。 源码位置：src/components/chat-content/flow-agent-content/simple-table.vue。
+
+### 关联组件
+- **flow-agent-node-detail** — 节点详情中用于展示输入参数、插件输出定义和结构化输出
+- **detail-section** — 通常放在详情分段容器内使用
+
+---
+<!-- FULL DOC -->
+
+# SimpleTable 简易表格
+
+> **能力域**：Agent 能力
+
+`SimpleTable` 是 FlowAgent 节点详情中的轻量只读表格，用于展示参数名、参数值、插件输出定义等结构化信息。组件只根据 `columns` 和 `data` 渲染表格，不提供排序、筛选、分页或编辑能力。
+
+通常不需要单独使用，主要由 `FlowAgentNodeDetail` 内部组合。
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-content/flow-agent-content/simple-table.vue`
+- **能力说明**：FlowAgent 节点详情中的轻量表格展示组件。
+
+## 核心能力
+
+- **列驱动渲染**：通过 `columns` 决定表头、字段读取 key 和单元格换行策略
+- **空值兜底**：单元格值为 `null` 或 `undefined` 时显示 `--`，`0` 会正常显示为 `0`
+- **空数据占位**：`data` 为空数组时渲染一行 `--`，`colspan` 等于列数
+- **长文本换行**：列配置 `breakAll: true` 后，该列单元格添加 `is-break-all` 样式，适合展示 JSON 或长字符串
+
+## 基础用法
+
+```vue
+<template>
+  <SimpleTable
+    :columns="columns"
+    :data="data"
+  />
+</template>
+
+<script setup lang="ts">
+  import SimpleTable from '@blueking/chat-x/src/components/chat-content/flow-agent-content/simple-table.vue';
+
+  const columns = [
+    { key: 'key', label: '参数名' },
+    { breakAll: true, key: 'value', label: '参数值' },
+  ];
+
+  const data = [
+    { key: 'bk_host_id', value: '10001' },
+    { key: 'metadata', value: '{"source":"cmdb","scope":"production"}' },
+  ];
+</script>
+```
+
+**渲染效果**
+
+## 空数据
+
+当 `data.length === 0` 时，组件渲染一行居中的 `--`，用于表示当前分段没有可展示数据。
+
+## API
+
+### Props
+
+| 属性名  | 类型                     | 必填 | 默认值 | 说明                         |
+| ------- | ------------------------ | ---- | ------ | ---------------------------- |
+| columns | `SimpleTableColumn[]`    | 是   | —      | 表格列配置                   |
+| data    | `Record<string, unknown>[]` | 是 | —      | 表格行数据，按列 `key` 取值 |
+
+### Emits
+
+- 无。
+
+### Slots
+
+- 无。
+
+### Expose
+
+- 无。
+
+## 类型定义
+
+```typescript
+export interface SimpleTableColumn {
+  breakAll?: boolean; // 是否对该列单元格启用 word-break: break-all
+  key: string;        // 从 data 行对象中读取的字段名
+  label: string;      // 表头文案
+}
+```
+
+## 使用建议
+
+- 适合详情面板中的短表格，不适合承载复杂数据表能力。
+- 需要展示对象值时，建议在传入前先序列化为字符串；`FlowAgentNodeDetail` 内部会对对象值执行 `JSON.stringify`。
+
+## 关联组件
+
+- [FlowAgentNodeDetail](./flow-agent-node-detail.md) — 节点详情主体。
+- [DetailSection](./detail-section.md) — 表格常放置在详情分段内。