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

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) — 表格常放置在详情分段内。

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` 管理，一般不需要手动使用。
 
@@ -25,9 +30,8 @@ div.ai-tool-btn（v-tippy，flex，min-width: 20px，height: 20px，border-radiu
   disabled=true → .is-disabled（color: #979ba5; cursor: not-allowed）
   :not(.is-disabled):hover → color: #4d4f56; background: #eaebf0
   │
-  └── <slot>（默认内容，可完全自定义）
-        ├── [id && id in ToolIconsMap] → <component :is="ToolIconsMap[id]" />（SVG 图标）
-        └── [其他] → <div>{{ name }}</div>（文本回退，XSS 安全）
+  ├── [id in ToolIconsMap] → <component :is="ToolIconsMap[id]" />（SVG 图标，font-size: 16px 控制大小）
+  └── [id not in ToolIconsMap] → <div>{{ name }}</div>（文本回退，XSS 安全）
 
 Tippy：content=description, theme='ai-chat-box', disabled=true 时 onShow 返回 false 不显示
 click 事件：disabled=true 时被 JS 拦截，不触发 emit
@@ -52,7 +56,7 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 | `activeLike`   | 点赞（实心）   | 激活态填充图标           |
 | `activeUnLike` | 不满意（实心） | 激活态填充图标           |
 
-> 未传入 `id`、或 `id` 不在上表时，组件渲染 `<div>{{ name }}</div>` 作为文本回退。也可通过默认插槽完全自定义按钮内容（如全屏图标），此时可不传 `id`。
+> `id` 不在上表时，组件渲染 `<div>{{ name }}</div>` 作为文本回退。此时 `id` 的 TypeScript 类型会报错（`keyof typeof ToolIconsMap`），建议优先使用预置 ID。
 
 ## 基础用法
 
@@ -188,31 +192,7 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 
 ## 未知 ID 的文本回退
 
-`id` 不在 `ToolIconsMap` 时渲染 `name` 文本，适用于自定义扩展场景：
-
-## 自定义插槽内容
-
-通过默认插槽可完全替换内置图标/文本，适用于预置 `ToolIconsMap` 未覆盖的图标场景（如侧栏全屏按钮）：
-
-```vue
-<template>
-  <ToolBtn
-    description="全屏"
-    :tippy-options="{ content: '全屏' }"
-    @click="handleFullScreen"
-  >
-    <FullScreenIcon />
-  </ToolBtn>
-</template>
-
-<script setup lang="ts">
-  import { ToolBtn, FullScreenIcon } from '@blueking/chat-x';
-
-  const handleFullScreen = () => {
-    // 进入全屏逻辑
-  };
-</script>
-```
+`id` 不在 `ToolIconsMap` 时渲染 `name` 文本，适用于自定义扩展场景（注意 TypeScript 会报类型错误）：
 
 ## API
 
@@ -220,7 +200,7 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 
 | 属性名       | 类型                                                                       | 必填 | 默认值 | 说明                                                                                                               |
 | ------------ | -------------------------------------------------------------------------- | ---- | ------ | ------------------------------------------------------------------------------------------------------------------ |
-| id           | `keyof typeof ToolIconsMap`                                                | 否   | —      | 按钮标识；在 `ToolIconsMap` 中时渲染对应 SVG 图标，否则渲染 `name` 文本；使用插槽自定义内容时可省略                  |
+| id           | `keyof typeof ToolIconsMap`                                                | 是   | —      | 按钮标识；在 `ToolIconsMap` 中时渲染对应 SVG 图标，否则渲染 `name` 文本                                            |
 | name         | `string`                                                                   | 否   | —      | 按钮名称；`id` 无对应图标时作为文本内容渲染                                                                        |
 | description  | `string`                                                                   | 否   | —      | Tippy tooltip 内容；`disabled=true` 时不显示 tooltip                                                               |
 | active       | `boolean`                                                                  | 否   | —      | 激活态；`true` 时追加 `.is-active`（字色由 `id` 决定：`like`/`activeLike` 为蓝色 `#3a84ff`，其他为红色 `#E71818`） |
@@ -233,18 +213,12 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 | ------ | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
 | click  | `(data: IToolBtn & { active?: boolean; disabled?: boolean }, event: MouseEvent)` | 点击时触发；`data` 为组件当前全量 props（含 `active`/`disabled`）；`disabled=true` 时不触发 |
 
-### Slots
-
-| 插槽名  | 说明                                                                                       |
-| ------- | ------------------------------------------------------------------------------------------ |
-| default | 按钮内容；传入时替换默认的图标/文本渲染逻辑，常用于自定义 SVG 图标（如全屏、退出全屏按钮） |
-
 ## 类型定义
 
 ```typescript
 // 来自 @blueking/chat-x 导出
 interface IToolBtn {
-  id?: keyof typeof ToolIconsMap; // 预置 ID；省略时走 name 文本或插槽
+  id: keyof typeof ToolIconsMap; // 限定为预置 ID
   name?: string;
   description?: string;
 }
@@ -281,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) — 点赞/踩入口与反馈联动