@blueking/chat-x 0.0.45-beta.4 → 0.0.45-beta.6

package/dist/mcp/generated/docs/flow-agent-content.md

@@ -1,252 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-渲染 FlowAgent 任务/节点执行状态、耗时、详情入口和自定义 Tab 联动。 源码位置：src/components/chat-content/flow-agent-content/flow-agent-content.vue。
-
-### 关联组件
-- **flow-agent-node-detail** — 详情入口点击后挂载到自定义 Tab 渲染
-- **activity-layout** — 提供可折叠的活动容器外壳
-- **chat-container** — 通过自定义 Tab 在侧栏展示节点详情
-
----
-<!-- FULL DOC -->
-
-# FlowAgentContent FlowAgent 执行内容
-
-> **能力域**：Agent 能力
-
-渲染 FlowAgent（标准运维 / 流程编排）执行过程的活动组件，以「任务 → 节点」两级结构展示执行状态、耗时统计与详情入口。组件内部消费 `useCustomTabConsumer`，点击节点「详情」会向侧栏的自定义 Tab 注入 `FlowAgentNodeDetail` 渲染节点输入输出。
-
-通常不需要直接使用，`MessageRender` 会根据消息 `content.type === flow_agent` 自动渲染。
-
-## 源码事实
-
-- **源码位置**：`src/components/chat-content/flow-agent-content/flow-agent-content.vue`
-- **能力说明**：渲染 FlowAgent 任务/节点执行状态、耗时、详情入口和自定义 Tab 联动。
-
-## 核心能力
-
-- **状态聚合统计**：汇总所有任务的 `statistics.state_counts`，在标题栏按「执行中 / 成功 / 失败 / 挂起 / 待执行」分类展示带颜色的计数（超过 99 显示 `99+`）
-- **两级折叠**：任务整体由 `ActivityLayout` 折叠；每个任务节点列表可单独展开/收起
-- **耗时格式化**：节点耗时与任务总耗时按 `d/h/m/s` 紧凑展示，小于 1 秒显示 `<1s`
-- **节点行尾操作**：hover 失败节点行显示「重试 / 跳过 / 详情」按钮组（间距 12px）；成功 / 运行中等非失败节点仅显示「详情」。重试 / 跳过依赖节点 `retryable` / `skippable` 能力位，通过 `onInterruptResume` 回传 Agent
-- **详情入口联动**：「详情」按钮点击后通过自定义 Tab 挂载 `FlowAgentNodeDetail`
-- **分享态降级**：`RenderMode.Share` 下隐藏耗时与行尾操作按钮，仅保留只读的执行状态
-
-## 状态映射
-
-组件将后端原始 `state` / `task_state` 归一为 5 类收敛状态（`getConvergedState`），用于图标、颜色与统计分类：
-
-| 收敛状态    | 颜色        | 原始状态                                                                          |
-| ----------- | ----------- | --------------------------------------------------------------------------------- |
-| `success`   | `#18B456`   | `FINISHED`                                                                        |
-| `failed`    | `#EA3636`   | `FAILED`、`REVOKED`、`ROLL_BACK_FAILED`                                            |
-| `suspended` | `#F59500`   | `SUSPENDED`                                                                       |
-| `pending`   | `#4D4F56`   | `PENDING`                                                                         |
-| `running`   | `#3A84FF`   | `CREATED`、`LOOP_READY`、`READY`、`RUNNING`、`BLOCKED`、`ROLLING_BACK`、`ROLL_BACK_SUCCESS` 及未知状态（兜底） |
-
-## 基础用法
-
-`content` 为任务数组 `BkFlowTask[]`；传入单个对象时组件会自动包装为单元素数组。
-
-```vue
-<template>
-  <FlowAgentContent
-    :content="flowContent"
-    :message-uid="messageUid"
-    :on-interrupt-resume="handleInterruptResume"
-    :status="status"
-  />
-</template>
-
-<script setup lang="ts">
-  import { FlowAgentContent } from '@blueking/chat-x';
-  import type { BkFlowMessageContent, OnInterruptResume } from '@blueking/chat-x';
-
-  const messageUid = 'flow-msg-1';
-  const status = 'success';
-  const handleInterruptResume: OnInterruptResume = async payload => {
-    console.log('flow node resume:', payload);
-  };
-  const flowContent: BkFlowMessageContent = [
-    {
-      task_id: 100,
-      task_name: '主机巡检流程',
-      task_state: 'FINISHED',
-      task_outputs: { result: 'ok' },
-      statistics: { state_counts: { FINISHED: 2, FAILED: 1 }, total: 3 },
-      nodes: {
-        n1: { id: 'n1', name: '采集主机指标', state: 'FINISHED', elapsed_time: 12, type: 'task', loop: 0, retry: 0, skip: false, start_time: '', finish_time: '' },
-        n2: { id: 'n2', name: '分析异常项', state: 'FINISHED', elapsed_time: 65, type: 'task', loop: 0, retry: 0, skip: false, start_time: '', finish_time: '' },
-        n3: { id: 'n3', name: '推送告警', state: 'FAILED', elapsed_time: 3, type: 'task', loop: 0, retry: 1, skip: false, retryable: true, skippable: true, start_time: '', finish_time: '' },
-      },
-    },
-  ];
-</script>
-```
-
-**渲染效果**（hover 失败节点行可看到「重试 / 跳过 / 详情」按钮组；点击「详情」会向侧栏自定义 Tab 注入节点详情）
-
-## 执行中状态
-
-`status` 为 `pending` / `streaming` 时，标题栏图标显示为加载动画；运行中的节点显示旋转 Loading，待执行 / 挂起节点显示对应颜色的状态点。
-
-## 失败节点重试 / 跳过
-
-失败节点（`convergedState === 'failed'`）且具备对应能力位时，hover 行尾展示「重试」或「跳过」按钮。点击后调用 `onInterruptResume`，**不传** `interrupt` 参数：
-
-```typescript
-// 重试
-onInterruptResume?.({
-  operation: InterruptResumeOperation.FlowNodeRetry,
-  payload: { node_id: node.id, task_id: task.task_id },
-});
-
-// 跳过
-onInterruptResume?.({
-  operation: InterruptResumeOperation.FlowNodeSkip,
-  payload: { node_id: node.id, task_id: task.task_id },
-});
-```
-
-| 按钮 | 显隐条件                              | `operation`          |
-| ---- | ------------------------------------- | ---------------------- |
-| 重试 | 失败态且 `node.retryable === true`    | `flow_node_retry`      |
-| 跳过 | 失败态且 `node.skippable === true`    | `flow_node_skip`       |
-| 详情 | 始终展示（Share 模式除外）            | —（打开侧栏 Tab，不走 resume） |
-
-行尾操作由内部 composable [`useFlowNodeActions`](/composables/use-flow-node-actions) 聚合为声明式列表，组件层仅遍历渲染。
-
-## 节点详情联动
-
-点击节点「详情」按钮时，组件调用 `addCustomTab` 注入一个以 `${task_id}|${node.id}|${node.name}` 为唯一 `name` 的 Tab，渲染组件为 `FlowAgentNodeDetail`：
-
-```ts
-addCustomTab?.({
-  label: node.name,
-  name: `${task.task_id}|${node.id}|${node.name}`,
-  data: {
-    component: BkFlowNodeDetail,
-    messageUid: props.messageUid,
-    props: {
-      loading: true,
-      node_id: node.id,
-      node_name: node.name,
-      task_id: task.task_id,
-      task_name: task.task_name,
-      data: {},
-    },
-  },
-});
-```
-
-> 实际节点详情数据由应用层在 `ChatContainer` 的 `onCustomTabChange` 中异步拉取后回填，组件本身只负责挂载占位与传参。组件卸载时（在消息容器滚动上下文中）会自动调用 `removeCustomTab` 清理对应 Tab。
-
-## 组件结构
-
-```
-ActivityLayout（activity-type=flow_agent，v-model:collapsed）
-├── #title（执行情况统计栏）
-│   ├── AiLoading / ArrowRightIcon（加载态 / 折叠箭头）
-│   └── flow-agent-stat-item × N（按收敛状态分类的计数）
-└── flow-agent-task-group × N（任务）
-    ├── flow-agent-task-header（点击折叠当前任务）
-    │   ├── task-arrow（任务展开箭头）
-    │   ├── task-state-icon（Loading / 状态图标）
-    │   ├── task-name（HighlightKeyword + 溢出提示）
-    │   └── task-time（任务总耗时 = 各节点耗时累加）
-    └── flow-agent-task-nodes（v-show 折叠）
-        └── flow-agent-node-item × N（节点）
-            ├── node-status（Loading / 状态圆点）
-            ├── node-name（HighlightKeyword + 溢出提示）
-            └── node-trailing（非 Share 态）
-                ├── node-time（节点耗时，hover 时隐藏）
-                └── node-actions（hover 时显示按钮组，间距 12px）
-                    ├── node-action-btn「重试」（失败 + retryable）
-                    ├── node-action-btn「跳过」（失败 + skippable）
-                    └── node-action-btn「详情」（始终，点击挂载详情 Tab）
-```
-
-## API
-
-### Props
-
-| 属性名     | 类型                     | 必填 | 默认值      | 说明                                                                       |
-| ---------- | ------------------------ | ---- | ----------- | -------------------------------------------------------------------------- |
-| content    | `BkFlowMessageContent`   | 否   | `[{}]`      | 任务数组；传入单个 `BkFlowTask` 时自动包装为单元素数组                       |
-| messageUid | `string`                 | 否   | —           | 所属消息唯一标识，注入到节点详情 Tab 的 `data.messageUid`，用于异步回填数据 |
-| onInterruptResume | `OnInterruptResume` | 否   | —           | 节点「重试 / 跳过」与第三方审批取消复用同一回调，按 `payload.operation` 分流；流程节点操作时不传 `interrupt` |
-| status     | `MessageStatus`          | 否   | —           | 消息状态；`pending` / `streaming` 时标题栏显示加载动画                       |
-
-### Emits
-
-- 无。
-
-### Slots
-
-- 无。
-
-### Expose
-
-- 无。
-
-## 类型定义
-
-```typescript
-// 来自 @blueking/chat-x 导出
-type BkFlowMessageContent = BkFlowTask[];
-
-interface BkFlowTask {
-  task_id: number;
-  task_name: string;
-  task_state: string;          // 原始任务状态，经 getConvergedState 归一
-  task_outputs: unknown;       // 任务输出（当前展示区块已注释，不渲染）
-  statistics: {
-    state_counts: Record<string, number>; // 原始状态 → 数量，用于标题统计聚合
-    total: number;
-  };
-  nodes: Record<string, BkFlowNode>;       // key 为节点 id
-}
-
-interface BkFlowNode {
-  id: string;
-  name: string;
-  state: string;        // 原始节点状态
-  elapsed_time: number; // 耗时（秒）
-  type: string;
-  loop: number;
-  retry: number;
-  retryable?: boolean; // 是否可重试（失败节点「重试」按钮显隐）
-  skip: boolean;
-  skippable?: boolean; // 是否可跳过（失败节点「跳过」按钮显隐）
-  start_time: string;
-  finish_time: string;
-}
-```
-
-## 组件依赖
-
-- `AiLoading` — 标题栏流式加载动画
-- `ActivityLayout` — 可折叠活动容器外壳
-- `BkFlowNodeDetail` — 节点详情面板（经自定义 Tab 挂载）
-- `Loading`（bkui-vue） — 运行中状态的旋转指示
-- `HighlightKeyword` — 任务 / 节点名称的搜索关键词高亮
-
-## 注意事项
-
-1. **依赖自定义 Tab 上下文**：组件内部使用 `useCustomTabConsumer()!`，必须存在 `useCustomTabProvider` 提供者（`ChatContainer` 已内置）。脱离上下文直接使用需自行提供，否则详情入口会报错。
-2. **统计来自 `statistics.state_counts` 而非节点遍历**：标题栏计数直接读取后端下发的统计，不会实时统计 `nodes`；两者不一致时以 `state_counts` 为准。
-3. **任务总耗时为节点累加**：`task-time` 由各节点 `elapsed_time` 求和得到，并非任务级独立字段。
-4. **`task_outputs` 暂不渲染**：模板中任务输出展示区块已注释，传入也不会显示。
-5. **未知状态兜底为 `running`**：`getConvergedState` 对未识别的原始状态统一归为运行中。
-6. **Share 模式降级**：`RenderMode.Share` 下不渲染节点耗时与行尾操作按钮（重试 / 跳过 / 详情），仅保留只读执行状态。
-7. **`onInterruptResume` 透传链路**：`MessageRender` → `ActivityMessage` → `FlowAgentContent`；未传入时重试 / 跳过按钮仍展示但点击无回调。
-
-## 关联组件
-
-- [FlowAgentNodeDetail](/components/agent/flow-agent-node-detail) — 节点详情面板
-- [ActivityLayout](/components/helper/activity-layout) — 可折叠活动容器
-- [ChatContainer](/components/setup/chat-container) — 侧栏自定义 Tab 挂载场景
-- [useFlowNodeActions](/composables/use-flow-node-actions) — 节点行尾操作聚合 composable
-- [中断类型 Interrupt](/types/interrupt) — `InterruptResumeOperation`、`FlowNodeResume`、`OnInterruptResume`
-- [使用建议] 优先通过上层组合组件（`MessageRender`）使用；直接使用前请确认 `content` 数据结构来自对应类型定义。

package/dist/mcp/generated/docs/flow-agent-node-detail.md

@@ -1,240 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-展示 FlowAgent 节点输入、输出、异常、耗时等详情。 源码位置：src/components/chat-content/flow-agent-content/flow-agent-node-detail.vue。
-
-### 关联组件
-- **flow-agent-content** — 节点详情入口由 FlowAgentContent 挂载到自定义 Tab
-- **detail-section** — 详情页内部分段容器
-- **simple-table** — 展示输入参数、插件输出定义与结构化输出
-- **chat-container** — 应用层通过 onCustomTabChange 拉取节点详情并回填
-
----
-<!-- FULL DOC -->
-
-# FlowAgentNodeDetail FlowAgent 节点详情
-
-> **能力域**：Agent 能力
-
-`FlowAgentNodeDetail` 用于展示 FlowAgent 单个节点的配置与输出详情。它通常被 `FlowAgentContent` 通过自定义 Tab 挂载到侧栏，应用层再根据 `messageUid`、`task_id`、`node_id` 拉取真实节点详情并回填到 `data`。
-
-组件自身只负责详情展示，不负责接口请求、Tab 生命周期或消息定位逻辑。
-
-## 源码事实
-
-- **源码位置**：`src/components/chat-content/flow-agent-content/flow-agent-node-detail.vue`
-- **能力说明**：展示 FlowAgent 节点输入、输出、异常、耗时等详情。
-
-## 核心能力
-
-- **双 Tab 展示**：内置“节点配置”和“节点输出”两个页签，默认展示“节点配置”
-- **配置详情**：展示流程模板、节点名称、步骤名称、是否可选、失败处理和超时控制
-- **参数表格**：使用 `SimpleTable` 展示输入参数、插件输出定义和结构化输出
-- **加载骨架屏**：`loading` 为 `true` 时展示标题和内容骨架，不渲染真实数据
-- **定位插槽**：提供 `locateButton` 插槽，允许侧栏注入“在对话中定位”等操作按钮
-- **值格式化**：`null` / `undefined` 显示为 `--`，对象值通过 `JSON.stringify` 转为字符串
-
-## 基础用法
-
-```vue
-<template>
-  <FlowAgentNodeDetail
-    :data="nodeDetailData"
-    :loading="false"
-    node_id="n1"
-    node_name="采集主机指标"
-    :task_id="100"
-    task_name="主机巡检流程"
-  >
-    <template #locateButton>
-      <button type="button">定位</button>
-    </template>
-  </FlowAgentNodeDetail>
-</template>
-
-<script setup lang="ts">
-  import FlowAgentNodeDetail from '@blueking/chat-x/src/components/chat-content/flow-agent-content/flow-agent-node-detail.vue';
-  import type { NodeDetailData } from '@blueking/chat-x';
-
-  const nodeDetailData: Partial<NodeDetailData> = {
-    basic_info: {
-      node_name: '采集主机指标',
-      template_name: '主机巡检流程',
-      stage_name: '巡检准备',
-      optional: false,
-      skippable: true,
-      retryable: true,
-      error_ignorable: false,
-      auto_retry: { enable: true, interval: 30, times: 2 },
-      timeout_config: { enable: true, seconds: 300, action: 'forced_fail' },
-    },
-    inputs: {
-      bk_host_id: 10001,
-      collect_items: ['cpu', 'memory', 'disk'],
-    },
-    plugin_output: [
-      {
-        key: '${cpu_usage}',
-        name: 'CPU 使用率',
-        type: 'number',
-        schema: { description: '当前主机 CPU 使用率', enum: [], type: 'number' },
-      },
-    ],
-    outputs: [{ key: 'cpu_usage', preset: false, value: 23.5 }],
-  };
-</script>
-```
-
-**渲染效果**
-
-## 加载态
-
-`loading` 为 `true` 时，组件展示骨架屏，标题中的节点名和内容区均不会读取 `data` 展示。
-
-## 空数据
-
-当输入参数、插件输出定义或结构化输出为空时，对应 `SimpleTable` 渲染 `--` 占位行。
-
-## Tab 内容
-
-| Tab        | 内容                                                         |
-| ---------- | ------------------------------------------------------------ |
-| 节点配置   | 基础信息、失败处理、超时控制、输入参数、插件输出定义         |
-| 节点输出   | 结构化输出，来自 `data.outputs`                              |
-
-`activeTab` 是组件内部状态，不通过 prop 或 expose 暴露。
-
-## 字段展示规则
-
-| 区域         | 数据来源                         | 展示规则                                      |
-| ------------ | -------------------------------- | --------------------------------------------- |
-| 流程模板     | `data.basic_info.template_name`   | 空值显示 `--`                                 |
-| 节点名称     | `data.basic_info.node_name`       | 空值显示 `--`                                 |
-| 步骤名称     | `data.basic_info.stage_name`      | 空值显示 `--`                                 |
-| 是否可选     | `data.basic_info.optional`        | `true` 显示“是”，否则显示“否”                 |
-| 失败处理     | `skippable` / `auto_retry.enable` | 支持“手动跳过”和“自动重试”；均无时显示 `--`  |
-| 超时控制     | `timeout_config`                  | 未启用时显示 `--`；`forced_fail` 显示“强制失败” |
-| 输入参数     | `data.inputs`                     | 对象条目转为 `{ key, value }` 表格            |
-| 插件输出定义 | `data.plugin_output`              | 展示名称、变量说明和 KEY                     |
-| 结构化输出   | `data.outputs`                    | 展示输出 key 与格式化后的 value              |
-
-## 自定义 Tab 联动
-
-`FlowAgentContent` 点击节点“详情”时，会将本组件挂载到自定义 Tab，并先传入 `loading: true` 和节点定位参数：
-
-```typescript
-addCustomTab?.({
-  label: node.name,
-  name: `${task.task_id}|${node.id}|${node.name}`,
-  data: {
-    component: BkFlowNodeDetail,
-    messageUid: props.messageUid,
-    props: {
-      loading: true,
-      node_id: node.id,
-      node_name: node.name,
-      task_id: task.task_id,
-      task_name: task.task_name,
-      data: {},
-    },
-  },
-});
-```
-
-应用层通常在 `ChatContainer` 的 `onCustomTabChange` 中读取这些参数，请求节点详情后返回新的 `props.data` 和 `props.loading`。
-
-## API
-
-### Props
-
-| 属性名    | 类型                       | 必填 | 默认值 | 说明                         |
-| --------- | -------------------------- | ---- | ------ | ---------------------------- |
-| data      | `Partial<NodeDetailData>`  | 是   | —      | 节点详情数据                 |
-| loading   | `boolean`                  | 否   | —      | 是否显示骨架屏               |
-| node_id   | `string`                   | 否   | —      | 节点 ID，来自自定义 Tab 参数 |
-| node_name | `string`                   | 否   | —      | 节点名称                     |
-| task_id   | `number`                   | 否   | —      | 任务 ID                      |
-| task_name | `string`                   | 否   | —      | 任务名称                     |
-
-> Props 类型来自 `CustomBkFlowTabData['props'] & { data: Partial<NodeDetailData> }`。
-
-### Emits
-
-- 无。
-
-### Slots
-
-| 插槽名       | 说明                         |
-| ------------ | ---------------------------- |
-| locateButton | 标题栏右侧操作区，如定位按钮 |
-
-### Expose
-
-- 无。
-
-## 类型定义
-
-```typescript
-export type CustomBkFlowTabData = CustomTabData<{
-  data?: Partial<NodeDetailData>;
-  loading?: boolean;
-  node_id?: string;
-  node_name?: string;
-  task_id?: number;
-  task_name?: string;
-}>;
-
-export interface NodeDetailData {
-  inputs: Record<string, unknown>;
-  node_id: string;
-  task_id: number;
-  basic_info: {
-    auto_retry: {
-      enable: boolean;
-      interval: number;
-      times: number;
-    };
-    error_ignorable: boolean;
-    node_name: string;
-    optional: boolean;
-    retryable: boolean;
-    skippable: boolean;
-    stage_name: string;
-    template_name: string;
-    timeout_config: {
-      action: string;
-      enable: boolean;
-      seconds: number;
-    };
-  };
-  outputs: Array<{
-    key: string;
-    preset: boolean;
-    value: unknown;
-  }>;
-  plugin_output: Array<{
-    key: string;
-    name: string;
-    schema: {
-      description: string;
-      enum: unknown[];
-      properties?: Record<string, unknown>;
-      type: string;
-    };
-    type: string;
-  }>;
-}
-```
-
-## 使用建议
-
-- 优先由 [FlowAgentContent](./flow-agent-content.md) 通过自定义 Tab 挂载，不建议业务组件手动拼装 Tab 生命周期。
-- 接口请求与数据回填应放在应用层 `ChatContainer` 的 `onCustomTabChange` 链路中处理。
-- `data` 可传 `Partial<NodeDetailData>`，但真实展示依赖 `basic_info`、`inputs`、`plugin_output`、`outputs` 等字段；缺字段时对应区域会降级为空表格或 `--`。
-
-## 关联组件
-
-- [FlowAgentContent](./flow-agent-content.md) — 节点详情入口。
-- [DetailSection](./detail-section.md) — 详情分段容器。
-- [SimpleTable](./simple-table.md) — 详情表格。
-- [ChatContainer](../setup/chat-container.md) — 自定义 Tab 数据回填入口。

package/dist/mcp/generated/docs/input-attachment.md

@@ -1,43 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-ChatInput 底部附件区布局，承载快捷按钮、文件与发送图标。 源码位置：src/components/chat-input/input-attachment/input-attachment.vue。
-
----
-<!-- FULL DOC -->
-
-# InputAttachment 输入附件区
-
-> **能力域**：输入交互
-
-## 源码事实
-
-- **源码位置**：`src/components/chat-input/input-attachment/input-attachment.vue`
-- **能力说明**：ChatInput 底部附件区布局，承载快捷按钮、文件与发送图标。
-
-## API 摘要
-
-### Props
-
-- `{ messageState?: MessageStatus; sendDisabledTip?: string; tippyOptions?: AITippyProps; }`
-
-### Emits
-
-- `{ (e: 'sendMessage'): void; (e: 'stopSending'): void; }`
-
-### Slots
-
-- `default`
-- `send-icon`
-
-### Expose
-
-- 无。
-
-## 组件依赖
-
-- 无组件依赖或仅依赖基础库。
-
-## 使用建议
-
-- 优先通过上层组合组件使用；直接使用前请确认 props 数据结构来自对应类型定义。

package/dist/mcp/generated/docs/input-info-alert.md

@@ -1,42 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-ChatInput 上方的信息提示条。 源码位置：src/components/chat-input/input-info-alert.vue。
-
----
-<!-- FULL DOC -->
-
-# InputInfoAlert 输入提示条
-
-> **能力域**：输入交互
-
-## 源码事实
-
-- **源码位置**：`src/components/chat-input/input-info-alert.vue`
-- **能力说明**：ChatInput 上方的信息提示条。
-
-## API 摘要
-
-### Props
-
-- `{ content: string; }`
-
-### Emits
-
-- 无。
-
-### Slots
-
-- 无。
-
-### Expose
-
-- 无。
-
-## 组件依赖
-
-- 无组件依赖或仅依赖基础库。
-
-## 使用建议
-
-- 优先通过上层组合组件使用；直接使用前请确认 props 数据结构来自对应类型定义。