@blueking/chat-x 2.4.0 → 3.0.0-beta.1

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/skills/blueking-chat-x/references/components/toolcall-render.md

@@ -101,20 +101,20 @@ isPending = !isSuccess && !isError; // 其余（含 pending / streaming / stop /
 
 ## 调用类型前缀
 
-非进行中态的前缀由 `function.type` 决定；进行中态工具 / MCP 显示「正在调用」，Skill 显示「正在读取」：
+非进行中态的前缀由 `function.function_type` 决定；进行中态工具 / MCP 显示「正在调用」，Skill 显示「正在读取」：
 
-| `function.type`          | 前缀        | 说明                                     |
+| `function.function_type` | 前缀        | 说明                                     |
 | ------------------------ | ----------- | ---------------------------------------- |
 | `'function'` / 不传      | 调用工具    | 普通函数调用                             |
 | `'mcp'`                  | 调用 MCP    | MCP 调用，通常同时带 `mcpName`           |
 | `'skill'`                | 读取 Skill  | Skill 读取                               |
 
 ```typescript
-const callType = fn?.type ?? (fn?.mcpName ? 'mcp' : 'function');
+const callType = fn?.function_type ?? (fn?.mcpName ? 'mcp' : 'function');
 ```
 
-- **旧数据兼容**：未下发 `type` 时，有 `mcpName` 仍按 MCP 判定，历史消息展示不变
-- **`type` 优先**：显式 `type: 'function'` 不会被 `mcpName` 覆盖回 MCP，但标题仍是 `{mcpName} / {name}`
+- **旧数据兼容**：未下发 `function_type` 时，有 `mcpName` 仍按 MCP 判定，历史消息展示不变
+- **`function_type` 优先**：显式 `function_type: 'function'` 不会被 `mcpName` 覆盖回 MCP，但标题仍是 `{mcpName} / {name}`
 
 **三种前缀对比**
 
@@ -191,14 +191,14 @@ const toolCallWithDuration: ToolCall = {
 
 ## MCP 调用
 
-`function.type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，前缀为「调用 MCP」，标题格式变为 `{mcpName} / {functionName}`：
+`function.function_type` 为 `'mcp'`（或旧数据仅有 `mcpName`）时，前缀为「调用 MCP」，标题格式变为 `{mcpName} / {functionName}`：
 
 ```typescript
 const mcpToolCall: ToolCall = {
   id: 'call_mcp_1',
   type: 'function',
   function: {
-    type: 'mcp', // ← 前缀显示「调用 MCP」；缺省时有 mcpName 也会兼容判定为 MCP
+    function_type: 'mcp', // ← 前缀显示「调用 MCP」；缺省时有 mcpName 也会兼容判定为 MCP
     name: 'query_table',
     arguments: JSON.stringify({ table: 'events', limit: 50 }),
     description: '通过 MCP 协议查询蓝鲸数据平台中的事件数据',
@@ -326,8 +326,8 @@ type FunctionCall = {
   name: string; // 函数名；为空时标题 fallback 为 toolCall.id
   arguments: string; // 调用参数（通常为 JSON 字符串）
   description?: string; // 工具描述；为空时"描述"区块保留但内容为空白
-  mcpName?: string; // MCP 服务名；有值时标题格式变为 "{mcpName} / {name}"，缺省 type 时兼容判定为 MCP
-  type?: FunctionCallType; // 调用类型，决定头部前缀；不传按 mcpName 兼容判定
+  mcpName?: string; // MCP 服务名；有值时标题格式变为 "{mcpName} / {name}"，缺省 function_type 时兼容判定为 MCP
+  function_type?: FunctionCallType; // 调用类型，决定头部前缀；不传按 mcpName 兼容判定
 };
 
 // ToolMessage —— 工具返回消息

package/skills/blueking-chat-x/references/types/messages.md

@@ -224,7 +224,7 @@ type FunctionCall = {
   description?: string;
   mcpName?: string;
   // 决定 ToolcallRender 头部前缀（调用工具 / 调用 MCP / 读取 Skill）
-  type?: FunctionCallType;
+  function_type?: FunctionCallType;
 };
 
 // 示例