@blueking/chat-x 0.0.45-beta.5 → 0.0.45-beta.7

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

@@ -1,120 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-带品牌图标和逐字渐变动画的加载组件。 源码位置：src/components/message-loading/message-loading.vue。
-
-### 关联组件
-- **loading-message** — 消息列表加载占位可选择使用品牌加载动效
-- **ai-loading** — 更轻量的三点加载动画
-
----
-<!-- FULL DOC -->
-
-# MessageLoading 品牌加载
-
-> **能力域**：辅助能力
-
-`MessageLoading` 是带蓝鲸品牌图标和逐字渐变动画的加载组件，用于展示 AI 正在思考、生成或执行任务的等待状态。组件默认显示品牌图标和“加载中...”文案，也支持通过插槽替换图标或文本。
-
-与 [AiLoading](./ai-loading.md) 相比，它更偏品牌化、文案化；适合较明显的等待区域，不适合嵌入很紧凑的按钮或状态点。
-
-## 源码事实
-
-- **源码位置**：`src/components/message-loading/message-loading.vue`
-- **能力说明**：带品牌图标和逐字渐变动画的加载组件。
-
-## 核心能力
-
-- **品牌图标动画**：默认使用 `AIBluekingIcon`，图标随 `duration` 做透明度和滤镜动画
-- **逐字渐变文本**：未传 `#text` 插槽时，将 `text` 拆成字符逐个渲染，并按 `stagger` 延迟播放
-- **可调尺寸和节奏**：通过 `iconSize`、`gap`、`duration`、`stagger` 控制图标尺寸、间距和动画速度
-- **插槽覆盖**：`#icon` 可替换图标，`#text` 可替换整段文本渲染
-- **无障碍降级**：遵循 `prefers-reduced-motion: reduce`，减少动画效果
-
-## 基础用法
-
-```vue
-<template>
-  <MessageLoading />
-</template>
-
-<script setup lang="ts">
-  import { MessageLoading } from '@blueking/chat-x';
-</script>
-```
-
-**渲染效果**
-
-## 自定义文案和尺寸
-
-```vue
-<template>
-  <MessageLoading
-    text="正在思考中..."
-    :icon-size="28"
-    :gap="10"
-    :duration="2"
-    :stagger="0.12"
-  />
-</template>
-```
-
-## 自定义插槽
-
-传入 `#text` 后，组件不再按字符拆分 `text` prop，而是直接渲染插槽内容；传入 `#icon` 可替换默认品牌图标。
-
-```vue
-<template>
-  <MessageLoading>
-    <template #icon>
-      <span class="custom-icon">AI</span>
-    </template>
-    <template #text>
-      正在生成巡检结论
-    </template>
-  </MessageLoading>
-</template>
-```
-
-## API
-
-### Props
-
-| 属性名   | 类型     | 必填 | 默认值      | 说明                               |
-| -------- | -------- | ---- | ----------- | ---------------------------------- |
-| text     | `string` | 否   | `'加载中...'` | 逐字动画文案；使用 `#text` 时可不传 |
-| iconSize | `number` | 否   | `32`        | 默认图标边长，单位 px              |
-| gap      | `number` | 否   | `8`         | 图标与文字间距，单位 px            |
-| duration | `number` | 否   | `1.8`       | 单次动画循环时长，单位秒           |
-| stagger  | `number` | 否   | `0.135`     | 相邻字符动画延迟，单位秒           |
-
-### Emits
-
-- 无。
-
-### Slots
-
-| 插槽名 | 说明                     |
-| ------ | ------------------------ |
-| icon   | 自定义图标区域           |
-| text   | 自定义文本区域，覆盖逐字渲染 |
-
-### Expose
-
-- 无。
-
-## 样式与 attrs
-
-- 组件设置 `inheritAttrs: false`，会将外部 `class` 合并到根节点，并将除 `class` / `style` 外的 attrs 透传到根节点。
-- 外部对象形式的 `style` 会与 CSS 变量合并；字符串形式 `style` 不会参与合并。
-- 根节点使用 CSS 变量控制动画：`--ai-message-loading-duration`、`--ai-message-loading-stagger`、`--ai-message-loading-gap`。
-
-## 使用建议
-
-- 页面级或消息级等待态优先使用 `MessageLoading`；紧凑状态点优先使用 [AiLoading](./ai-loading.md)。
-- 需要自定义文本样式时优先使用 `#text` 插槽，避免只依赖全局覆盖内部 class。
-
-## 关联组件
-
-- [LoadingMessage](../message/loading-message.md) — 消息列表中的加载占位。
-- [AiLoading](./ai-loading.md) — 三点加载动画。

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

@@ -1,42 +0,0 @@
-<!-- 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

@@ -1,88 +0,0 @@
-<!-- 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/reference-doc-content.md

@@ -1,112 +0,0 @@
-<!-- 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

@@ -1,93 +0,0 @@
-<!-- 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/selection-question.md

@@ -1,91 +0,0 @@
-<!-- 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/simple-table.md

@@ -1,103 +0,0 @@
-<!-- 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) — 表格常放置在详情分段内。