@blueking/chat-x 0.0.52-dev.6 → 2.4.1

package/skills/blueking-chat-x/references/components/activity-message.md

@@ -155,12 +155,12 @@ const collapsed = ref(false); // false = 展开，true = 折叠
 
 ### 核心交互
 
-- **标题栏**：显示「执行情况」+ 所有任务聚合后的各状态计数（执行中 / 成功 / 失败 / 挂起），颜色区分
+- **标题栏**：显示「执行情况」+ 所有任务聚合后的各状态计数（执行中 / 成功 / 失败 / 挂起 / 已终止 / 待执行 / 跳过），颜色区分。任一任务 `task_state === REVOKED` 时前置橙红色「已终止」并用括号包裹统计
 - **任务组**：逐个展示任务行，带状态图标、总耗时；点击箭头图标可折叠/展开节点列表
 - **有效证据**：`task.has_confidence === true` 时，任务行右侧展示「有效证据」按钮，点击后在侧栏打开置信度/证据详情 Tab（`props.has_confidence: true`）
 - **默认激活**：当 `MessageContainer` 已注入滚动上下文（`useContainerScrollProvider`，供 `FlowAgentContent` 内 `useContainerScrollConsumer` 读取）时，组件挂载后若存在 `task.is_active === true` 且 `task.has_confidence === true` 的任务，会自动在侧栏打开该任务的「有效证据」Tab；无滚动 Provider（例如独立演示）时不做自动打开。用户手动切换 Tab 后不再沿用 `is_active` 默认高亮
 - **选中态**：当前侧栏 Tab 与任务行 / 节点行联动高亮（`is-selected`）；任务 Tab 与「有效证据」Tab 均视为该任务的选中态
-- **节点列表**：每个节点显示状态圆点、名称和耗时；hover 时出现行尾操作按钮组
+- **节点列表**：每个节点显示状态圆点、名称和耗时；`REVOKED` 叶子节点使用已终止圆点（`#F55B0E` 描边 / `#FEE8DD` 浅底）；hover 时出现行尾操作按钮组
 - **失败节点操作**：失败且 `retryable` / `skippable` 为 `true` 的节点，hover 时额外展示「重试」「跳过」按钮，点击后通过 `onInterruptResume` 回传 Agent（不传 `interrupt`）。仅在对话流内出现：侧栏「执行情况」面板（`ExecutionSummary`）内渲染的同一消息只保留「详情」
 - **节点详情**：点击「详情」会通过 `useCustomTabConsumer` 在 `ChatContainer` 侧边栏新增自定义 Tab，展示节点配置（基础信息、输入参数、输出参数）
 
@@ -173,11 +173,11 @@ FlowAgentContent（activityType = 'flow_agent'）
 ├── ActivityLayout（公共折叠布局容器）
 │   └── #title
 │       ├── Loading / ArrowIcon（随 status 切换）
-│       └── 执行情况：执行中 N / 成功 N / 失败 N / 挂起 N
+│       └── 执行情况：[已终止（] 执行中 N / 成功 N / 失败 N / 挂起 N / 已终止 N [）]
 └── #default
     └── TaskGroup × N
         ├── TaskHeader（is-selected / has-confidence；箭头点击折叠）
-        │   ├── 状态图标（running=Loading / success / failed / suspended）
+        │   ├── 状态图标（running=Loading / success / failed / terminated / suspended）
         │   ├── task_name（HighlightKeyword 支持搜索高亮）
         │   └── trailing：总耗时 + 「有效证据」（has_confidence 时）
         └── NodeList
@@ -313,15 +313,17 @@ const messages = [
 
 ### 节点状态映射
 
-组件内部将 BkFlow 原始状态归并为四种显示状态：
-
-| 归并状态    | 原始状态                                                                            | 颜色    |
-| ----------- | ----------------------------------------------------------------------------------- | ------- |
-| `running`   | CREATED / LOOP_READY / READY / RUNNING / BLOCKED / ROLLING_BACK / ROLL_BACK_SUCCESS | #3A84FF |
-| `success`   | FINISHED                                                                            | #18B456 |
-| `failed`    | FAILED / REVOKED / ROLL_BACK_FAILED                                                 | #EA3636 |
-| `suspended` | SUSPENDED                                                                           | #F59500 |
-| `pending`   | PENDING                                                                             | #DCDEE5 |
+组件内部将 BkFlow 原始状态归并为收敛显示状态：
+
+| 归并状态     | 原始状态                                                                            | 颜色      | 统计 | 整体 header |
+| ------------ | ----------------------------------------------------------------------------------- | --------- | ---- | ----------- |
+| `running`    | CREATED / LOOP_READY / READY / RUNNING / BLOCKED / ROLLING_BACK / ROLL_BACK_SUCCESS | #3A84FF   | 是   | 否          |
+| `success`    | FINISHED                                                                            | #65C389   | 是   | 否          |
+| `failed`     | FAILED / ROLL_BACK_FAILED                                                           | #EA3636   | 是   | 否          |
+| `suspended`  | SUSPENDED                                                                           | #F59500   | 是   | 否          |
+| `terminated` | REVOKED                                                                             | #F55B0E   | 是   | 是          |
+| `pending`    | PENDING                                                                             | #4D4F56   | 是   | 否          |
+| `skipped`    | SKIPPED                                                                             | #5B7290   | 是   | 否          |
 
 ### 侧栏 Tab 命名规则
 

package/skills/blueking-chat-x/references/components/ai-selection.md

@@ -376,7 +376,7 @@ v-model:visible="selectionVisible"
 | 属性名           | 类型         | 默认值              | 必填 | 说明                                                    |
 | ---------------- | ------------ | ------------------- | ---- | ------------------------------------------------------- |
 | visible          | `boolean`    | -                   | ✅   | 控制弹窗显示，必须使用 `v-model:visible`                |
-| shortcuts        | `Shortcut[]` | `DEFAULT_SHORTCUTS` | -    | 快捷指令列表，默认为内置「问问小鲸」                    |
+| shortcuts        | `Shortcut[]` | `DEFAULT_SHORTCUTS` | -    | 快捷指令列表；未传或空数组时回退内置「问问小鲸」        |
 | maxShortcutCount | `number`     | `3`                 | -    | 直接展示的最大指令数，超出收起到「更多」菜单            |
 | offset           | `number`     | `10`                | -    | 弹窗与选区的垂直间距（px）                              |
 | excludeSelectors | `string[]`   | `[]`                | -    | 排除的 CSS 选择器数组，选区在这些选择器内部时不显示弹窗 |

package/skills/blueking-chat-x/references/components/flow-agent-content.md

@@ -23,7 +23,8 @@
 
 ## 核心能力
 
-- **状态聚合统计**：汇总所有任务的 `statistics.state_counts`，在标题栏按「执行中 / 成功 / 失败 / 挂起 / 待执行」分类展示带颜色的计数（超过 99 显示 `99+`）
+- **状态聚合统计**：汇总所有任务的 `statistics.state_counts`，在标题栏按「执行中 / 成功 / 失败 / 挂起 / 已终止 / 待执行 / 跳过」分类展示带颜色的计数（超过 99 显示 `99+`）
+- **已终止整体覆盖**：任一任务 `task_state === REVOKED` 时，标题栏在统计前展示橙红色「已终止」，并用括号包裹统计：`执行情况：已终止（…）`；任务行使用终止图标，叶子节点使用已终止圆点（`#F55B0E` 描边 / `#FEE8DD` 浅底）
 - **两级折叠**：任务整体由 `ActivityLayout` 折叠；每个任务节点列表可单独展开/收起
 - **耗时格式化**：节点耗时与任务总耗时按 `d/h/m/s` 紧凑展示，小于 1 秒显示 `<1s`
 - **节点行尾操作**：hover 失败节点行显示「重试 / 跳过 / 详情」按钮组（间距 12px）；成功 / 运行中等非失败节点仅显示「详情」。重试 / 跳过依赖节点 `retryable` / `skippable` 能力位，通过 `onInterruptResume` 回传 Agent
@@ -34,15 +35,17 @@
 
 ## 状态映射
 
-组件将后端原始 `state` / `task_state` 归一为 5 类收敛状态（`getConvergedState`），用于图标、颜色与统计分类：
+组件将后端原始 `state` / `task_state` 归一为收敛状态（`getConvergedState`），用于图标、颜色与统计分类。配置源为 `STATE_DEFS`：
 
-| 收敛状态    | 颜色        | 原始状态                                                                          |
-| ----------- | ----------- | --------------------------------------------------------------------------------- |
-| `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` 及未知状态（兜底） |
+| 收敛状态      | 颜色        | 原始状态                                                                          | 统计 | 整体 header |
+| ------------- | ----------- | --------------------------------------------------------------------------------- | ---- | ----------- |
+| `running`     | `#3A84FF`   | `CREATED`、`LOOP_READY`、`READY`、`RUNNING`、`BLOCKED`、`ROLLING_BACK`、`ROLL_BACK_SUCCESS` 及未知状态（兜底） | 是   | 否          |
+| `success`     | `#65C389`   | `FINISHED`                                                                        | 是   | 否          |
+| `failed`      | `#EA3636`   | `FAILED`、`ROLL_BACK_FAILED`                                                      | 是   | 否          |
+| `suspended`   | `#F59500`   | `SUSPENDED`                                                                       | 是   | 否          |
+| `terminated`  | `#F55B0E`   | `REVOKED`                                                                         | 是   | 是          |
+| `pending`     | `#4D4F56`   | `PENDING`                                                                         | 是   | 否          |
+| `skipped`     | `#5B7290`   | `SKIPPED`                                                                         | 是   | 否          |
 
 ## 基础用法
 
@@ -160,7 +163,8 @@ addCustomTab?.({
 ActivityLayout（activity-type=flow_agent，v-model:collapsed）
 ├── #title（执行情况统计栏）
 │   ├── AiLoading / ArrowRightIcon（加载态 / 折叠箭头）
-│   └── flow-agent-stat-item × N（按收敛状态分类的计数）
+│   ├── flow-agent-flow-header（任一任务 REVOKED 时展示「已终止」）
+│   └── flow-agent-stat-item × N（按收敛状态分类的计数，含 terminated）
 └── flow-agent-task-group × N（任务）
     ├── flow-agent-task-header（点击折叠当前任务）
     │   ├── task-arrow（任务展开箭头）

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/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 与关联组件。