@blueking/chat-x 0.0.36 → 0.0.38

package/dist/lang/lang.d.ts

@@ -96,5 +96,6 @@ export declare const lang: {
     readonly '\u4F60\u597D\uFF0C\u6211\u662F\u5C0F\u9CB8': "Hello, I am BlueKing AI Bot";
     readonly 清空搜索: "Clear Search";
     readonly 搜索结果为空: "Search Result is Empty";
+    readonly 有效证据: "Valid Evidence";
 };
-export declare const t: (key: keyof typeof lang) => "Send" | "Stop" | "Ask AI" | "Copy" | "Share" | "Like" | "Unsatisfied" | "Delete" | "Quote" | "Regenerate" | "Regenerating will clear the content below" | "Submit" | "Cancel" | "Preview Content" | "Jump to Detail" | "Call Tool:" | "Calling..." | "Call Success" | "Call Failed" | "Tell us your thoughts" | "What makes you satisfied?" | "What makes you dissatisfied?" | "Return Content" | "Edit" | "Deep Thinking" | "Loading image..." | "Failed to load image" | "Thinking..." | "Thinking Completed" | "Thinking Failed" | "Copy Success" | "Copy Failed" | "Return to bottom" | "Stop generating" | "Stopping" | "Duration" | "Parameters" | "Description" | "Execution Status" | "Running" | "Success" | "Failed" | "Pending" | "To Be Executed" | "Details" | "Node" | "Node Config" | "Node Output" | "Basic Info" | "Flow Template" | "Node Name" | "Step Name" | "Execution Plan" | "Optional" | "Failure Handler" | "Timeout Control" | "Yes" | "No" | "Input Params" | "Output Params" | "Param Name" | "Param Value" | "Name" | "Structured Output" | "Manual Skip" | "No Data" | "Call MCP:" | "More" | "Searching" | "Search Completed" | "Upload File" | "Requesting..." | "Cancel satisfied" | "Cancel dissatisfied" | "Confirm delete this answer?" | "This operation cannot be undone. Please proceed with caution!" | "Preview" | "Zoom Out" | "Zoom In" | "Rotate" | "Download" | "Sorry, image loading failed. Please try reloading." | "Reset" | "Reload" | "W" | "H" | "Upload Image" | "Search keyword" | "Select date" | "Locate in Chat" | "Select All" | "Confirm" | "Upload Image, up to 3 images supported, max 2.4MB each" | "Hello, I am BlueKing AI Bot" | "Clear Search" | "Search Result is Empty" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP：" | "更多" | "检索中" | "检索完成" | "上传文件" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传图片, 最多支持上传 3 个, 最大支持 2.4MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空";
+export declare const t: (key: keyof typeof lang) => "Send" | "Stop" | "Ask AI" | "Copy" | "Share" | "Like" | "Unsatisfied" | "Delete" | "Quote" | "Regenerate" | "Regenerating will clear the content below" | "Submit" | "Cancel" | "Preview Content" | "Jump to Detail" | "Call Tool:" | "Calling..." | "Call Success" | "Call Failed" | "Tell us your thoughts" | "What makes you satisfied?" | "What makes you dissatisfied?" | "Return Content" | "Edit" | "Deep Thinking" | "Loading image..." | "Failed to load image" | "Thinking..." | "Thinking Completed" | "Thinking Failed" | "Copy Success" | "Copy Failed" | "Return to bottom" | "Stop generating" | "Stopping" | "Duration" | "Parameters" | "Description" | "Execution Status" | "Running" | "Success" | "Failed" | "Pending" | "To Be Executed" | "Details" | "Node" | "Node Config" | "Node Output" | "Basic Info" | "Flow Template" | "Node Name" | "Step Name" | "Execution Plan" | "Optional" | "Failure Handler" | "Timeout Control" | "Yes" | "No" | "Input Params" | "Output Params" | "Param Name" | "Param Value" | "Name" | "Structured Output" | "Manual Skip" | "No Data" | "Call MCP:" | "More" | "Searching" | "Search Completed" | "Upload File" | "Requesting..." | "Cancel satisfied" | "Cancel dissatisfied" | "Confirm delete this answer?" | "This operation cannot be undone. Please proceed with caution!" | "Preview" | "Zoom Out" | "Zoom In" | "Rotate" | "Download" | "Sorry, image loading failed. Please try reloading." | "Reset" | "Reload" | "W" | "H" | "Upload Image" | "Search keyword" | "Select date" | "Locate in Chat" | "Select All" | "Confirm" | "Upload Image, up to 3 images supported, max 2.4MB each" | "Hello, I am BlueKing AI Bot" | "Clear Search" | "Search Result is Empty" | "Valid Evidence" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP：" | "更多" | "检索中" | "检索完成" | "上传文件" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传图片, 最多支持上传 3 个, 最大支持 2.4MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据";

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

@@ -156,11 +156,14 @@ ActivityMessage 展示活动类消息：知识检索（knowledge_rag）、引用
 ### 核心交互
 
 - **标题栏**：显示「执行情况」+ 所有任务聚合后的各状态计数（执行中 / 成功 / 失败 / 挂起），颜色区分
-- **任务组**：逐个展示任务行，带状态图标和总耗时
+- **任务组**：逐个展示任务行，带状态图标、总耗时；点击箭头图标可折叠/展开节点列表
+- **有效证据**：`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 时出现「详情」按钮
-- **节点详情**：点击「详情」按钮会通过 `useCustomTabConsumer` 在 `ChatContainer` 侧边栏新增自定义 Tab，展示节点配置（基础信息、输入参数、输出参数）
+- **节点详情**：点击「详情」会通过 `useCustomTabConsumer` 在 `ChatContainer` 侧边栏新增自定义 Tab，展示节点配置（基础信息、输入参数、输出参数）
 
-> `FlowAgentContent` 会读取 `ChatContainer` 注入的 `renderMode`。当 `renderMode === RenderMode.Share` 时，节点列表仅展示状态和名称，不展示节点耗时与「详情」按钮，避免分享预览中出现可交互的节点详情入口。独立使用 `ActivityMessage` 且没有上层 Provider 时，默认按 `Chat` 模式渲染。
+> `FlowAgentContent` 会读取 `ChatContainer` 注入的 `renderMode`。当 `renderMode === RenderMode.Share` 时，任务行不展示总耗时与「有效证据」，节点列表不展示耗时与「详情」按钮，避免分享预览中出现可交互入口。独立使用 `ActivityMessage` 且没有上层 Provider 时，默认按 `Chat` 模式渲染。
 
 ### 内部渲染结构
 
@@ -172,16 +175,16 @@ FlowAgentContent（activityType = 'flow_agent'）
 │       └── 执行情况：执行中 N / 成功 N / 失败 N / 挂起 N
 └── #default
     └── TaskGroup × N
-        ├── TaskHeader（可折叠/展开）
+        ├── TaskHeader（is-selected / has-confidence；箭头点击折叠）
         │   ├── 状态图标（running=Loading / success / failed / suspended）
         │   ├── task_name（HighlightKeyword 支持搜索高亮）
-        │   └── 总耗时
+        │   └── trailing：总耗时 + 「有效证据」（has_confidence 时）
         └── NodeList
-            └── NodeItem × N
+            └── NodeItem × N（is-selected 与侧栏 Tab 联动）
                 ├── 状态圆点（颜色对应状态）
                 ├── node.name（HighlightKeyword 支持搜索高亮）
                 ├── node.elapsed_time
-                └── 详情按钮（hover 显示）→ 打开自定义 Tab
+                └── 详情按钮（hover 显示）→ 打开节点详情 Tab
 ```
 
 ### 用法示例
@@ -294,9 +297,19 @@ const messages = [
 | `suspended` | SUSPENDED                                                                           | #F59500 |
 | `pending`   | PENDING                                                                             | #DCDEE5 |
 
+### 侧栏 Tab 命名规则
+
+| 场景       | `tab.name` 格式                          |
+| ---------- | ---------------------------------------- |
+| 任务详情   | `{task_id}`                              |
+| 有效证据   | `{task_id}`（与任务 Tab 同名，label 为「有效证据」） |
+| 节点详情   | `{task_id}\|{node.id}\|{node.name}`      |
+
+`CustomBkFlowTabData` 支持 `has_confidence?: boolean`，用于侧栏详情组件区分证据视图与节点视图。应用层可通过 `ChatContainer` 的 `getSideRenderComponent` 覆盖渲染组件。
+
 ### 节点详情 Tab
 
-点击节点的「详情」按钮，内部调用 `useCustomTabConsumer().addCustomTab()` 在 `ChatContainer` 侧边栏新开一个 Tab，渲染 `FlowAgentNodeDetail` 组件，该组件提供：
+点击节点的「详情」按钮，内部调用 `useCustomTabConsumer().addCustomTab()` 在 `ChatContainer` 侧边栏新开一个 Tab，渲染 `BkFlowNodeDetail`（或 `getSideRenderComponent` 返回的自定义组件），该组件提供：
 
 - **节点配置** Tab：基础信息表单（流程模板、节点名称、步骤名称、失败处理、超时控制）+ 输入参数表 + 输出参数表
 - **节点输出** Tab：结构化输出参数表
@@ -310,6 +323,8 @@ import { MessageContentType, type BkFlowMessageContent, type BkFlowNode, type Bk
 type BkFlowMessageContent = BkFlowTask[];
 
 type BkFlowTask = {
+  has_confidence?: boolean; // 是否展示「有效证据」入口；与 is_active 同时为 true 且在消息容器滚动上下文中时，挂载后自动打开「有效证据」侧栏 Tab
+  is_active?: boolean; // 是否默认激活；需配合 has_confidence 且存在滚动 Provider 才会自动打开侧栏「有效证据」Tab
   nodes: Record<string, BkFlowNode>;
   statistics: { state_counts: Record<string, number>; total: number };
   task_id: number;

package/dist/mcp/generated/docs/chat-container.md

@@ -21,7 +21,7 @@ ChatContainer 提供完整 AI 对话布局：分栏（ResizeLayout）、消息
 
 ## 核心能力
 
-- **分栏布局**：基于 `ResizeLayout` 的可拖拽分栏；**侧栏是否展示 Tab / 执行摘要、以及分栏是否进入折叠样式（`ai-is-collapse`）以 `executionGroups` 为准**（由 `useMessageGroup` 从消息中过滤出工具调用与 FlowAgent 执行记录），**不以原始 `messages.length` 判断**。因此仅有普通对话、尚无执行类消息时，侧栏内容与「执行情况」区域可能为空，布局上与无执行数据时一致
+- **分栏布局**：基于 `ResizeLayout` 的可拖拽分栏；**侧栏是否展示 Tab / 执行摘要、以及分栏是否进入折叠样式（`ai-is-collapse`）以 `executionGroups` 与执行情况搜索关键词 `keyword` 共同决定**（`executionGroups` 由 `useMessageGroup` 从消息中过滤工具调用与 FlowAgent 记录；`keyword` 来自 `ExecutionSummary` 的 `@update-keyword`）。当 `executionGroups` 为空且未输入搜索词时，侧栏 Tab 与执行摘要不展示；**用户正在搜索执行情况时（`keyword` 非空），即使暂无执行类消息也会保留侧栏**，避免搜索态被折叠
 - **消息分组**：内置 `useMessageGroup` 自动处理消息分组、Tool 合并、Loading 注入
 - **输入区状态推导**：传给 `MessageContainer` 与 `ChatInput` 的 `messageStatus` 为内部计算值 `inputStatus`：当分组中存在 id 为 `LOADING_MESSAGE_ID`（`'__loading__'`，由 `useMessageGroup` 注入的占位 Loading 消息）时，对内使用 `MessageStatus.Fetching`；否则使用外部传入的 `messageStatus`。用于在「已发用户消息、尚未流式」阶段与流式中一致地展示停止能力，并避免输入区重复发送
 - **执行摘要**：侧边栏展示工具调用 / FlowAgent 执行记录，支持关键词搜索和对话定位
@@ -39,9 +39,9 @@ ai-chat-container
     ├── aside（侧边栏）
     │   ├── Tab 标签页
     │   │   ├── 执行情况（默认 Tab）
-    │   │   └── 自定义 Tab × N（可关闭）
+    │   │   └── 自定义 Tab × N（可关闭；标签可由 `getSideTabRenderComponent` 自定义）
     │   ├── ExecutionSummary（执行情况 Tab 内容）
-    │   ├── 自定义 Tab 组件（通过 component :is 渲染，可向子组件注入 #locateButton）
+    │   ├── 自定义 Tab 组件（`getSideRenderComponent` 优先，否则 `data.component`；可向子组件注入 #locateButton）
     │   └── collapse-button（折叠按钮）
     └── main（主内容区）
         ├── MessageContainer（有消息时）
@@ -109,9 +109,9 @@ ai-chat-container
 
 侧边栏默认包含「执行情况」Tab，展示所有工具调用和 FlowAgent 类型的 Activity 消息。支持关键词搜索过滤和点击定位到对话中的消息位置。
 
-**展示条件**：当 `executionGroups` 为空时，不渲染侧栏 Tab 与 `ExecutionSummary`（折叠按钮亦隐藏）；主区域仍可正常展示 `messages` 中的对话内容。`renderMode === Share` 时侧栏隐藏，且分栏会应用与折叠一致的样式。
+**展示条件**：当 `executionGroups` 为空且 `keyword` 为空时，不渲染侧栏 Tab 与 `ExecutionSummary`（折叠按钮亦隐藏）；主区域仍可正常展示 `messages` 中的对话内容。用户在执行情况中输入搜索词后，侧栏会保持展示以显示「搜索结果为空」等状态。`renderMode === Share` 时侧栏隐藏，且分栏会应用与折叠一致的样式。
 
-**自定义 Tab 联动**：当 `executionGroups` 变为空（例如会话清空或仅剩无执行类消息）时，容器会**自动重置自定义 Tab**（`resetCustomTab`），避免残留节点详情等 Tab。
+**自定义 Tab 联动**：当 `executionGroups` 变为空且搜索词已清空时，容器会**自动重置自定义 Tab**（`resetCustomTab`），避免残留节点详情等 Tab；若用户仍在搜索（`keyword` 非空），不会触发重置。
 
 ```vue
 <template>
@@ -147,11 +147,51 @@ ai-chat-container
 
 ## 自定义 Tab
 
-通过 `ref` 获取组件实例后，使用 `addCustomTab` / `removeCustomTab` 动态管理侧边栏 Tab。若 **`executionGroups` 变为空**，容器会清空自定义 Tab 状态（与侧栏执行数据联动，见上文「侧边栏与执行摘要」）。
+通过 `ref` 获取组件实例后，使用 `addCustomTab` / `removeCustomTab` 动态管理侧边栏 Tab。若 **`executionGroups` 变为空且搜索词已清空**，容器会清空自定义 Tab 状态（与侧栏执行数据联动，见上文「侧边栏与执行摘要」）。
+
+### 侧栏渲染扩展
+
+应用层可通过以下 Props 覆盖默认 Tab 标签与侧栏内容区的渲染逻辑（例如 FlowAgent 节点详情使用业务自定义组件）：
+
+| Prop | 说明 |
+| ---- | ---- |
+| `getSideTabRenderComponent` | `(h, tab, { removeCustomTab }) => VNode \| undefined`。返回自定义 Tab 标签 VNode；未返回时使用默认图标 + `tab.label` + 关闭按钮 |
+| `getSideRenderComponent` | `(h, props) => VNode \| undefined`。返回侧栏内容区组件 VNode；未返回时使用 `selectedTab.data.component` |
+
+侧栏内容区实现上会以 **`selectedTab.name` 作为外层 `key`**，切换 Tab 时重建子树，避免插槽与局部状态残留；当前 Tab 的 `:is` 由内部 **`computed`** 根据 `getSideRenderComponent(h, selectedTab.data.props)` 与 `data.component` 解析，保证 Tab 切换或 `onCustomTabChange` 异步更新 props 后内容类型与数据一致。
+
+```vue
+<template>
+  <ChatContainer
+    :get-side-tab-render-component="renderSideTab"
+    :get-side-render-component="renderSidePanel"
+    ...
+  />
+</template>
+
+<script setup lang="ts">
+  import { h } from 'vue';
+  import type { CustomTab } from '@blueking/chat-x';
+
+  const renderSideTab = (createElement, tab, { removeCustomTab }) => {
+    if (tab.name.startsWith('custom-')) {
+      return createElement('span', {}, tab.label);
+    }
+    return undefined; // 走默认 Tab 标签
+  };
+
+  const renderSidePanel = (createElement, props) => {
+    if (props?.has_confidence) {
+      return createElement(MyConfidencePanel, props);
+    }
+    return undefined; // 走 tab.data.component
+  };
+</script>
+```
 
 ### 自定义 Tab 与「在对话中定位」
 
-`addCustomTab` 的 `data` 可携带 **`messageUid`**（与对应活动消息的 `message.uid` 一致）。`ChatContainer` 在侧栏用 `<component :is>` 渲染自定义 Tab 时，会向子组件提供 **`locateButton` 插槽**：默认渲染「在对话中定位」按钮，点击后调用内部 `handleLocateMessageGroup(messageUid)`，优先滚动到主区域 `document.getElementById(messageUid)`；若不存在该节点，则在当前 `messageGroups` 中查找包含 `message.uid === messageUid` 的消息组，并滚动到该组的容器（`MessageGroup.uid` 作为组级 `id`）。
+`addCustomTab` 的 `data` 可携带 **`messageUid`**（与对应活动消息的 `message.uid` 一致）。`ChatContainer` 在侧栏用 `<component :is="sideRenderComponent">`（内部计算属性，见上文「侧栏渲染扩展」）渲染自定义 Tab 时，会向子组件提供 **`locateButton` 插槽**：默认渲染「在对话中定位」按钮，点击后调用内部 `handleLocateMessageGroup(messageUid)`，优先滚动到主区域 `document.getElementById(messageUid)`；若不存在该节点，则在当前 `messageGroups` 中查找包含 `message.uid === messageUid` 的消息组，并滚动到该组的容器（`MessageGroup.uid` 作为组级 `id`）。
 
 子组件若需展示该按钮，请在模板中声明 `<slot name="locateButton" />`（例如 FlowAgent 节点详情标题栏）。`FlowAgentContent` 等会在打开节点详情 Tab 时将 `messageUid` 写入 `data`，与 `ActivityMessage` 下传给内容区的 `message-uid` 对齐。
 
@@ -339,9 +379,11 @@ ChatContainer 的 Props 继承自 `ChatInputProps` 和 `MessageContainerProps`
 
 | 属性名             | 类型                                                                         | 默认值   | 说明                                                                                                                                          |
 | ------------------ | ---------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| chatLoading        | `boolean`                                                                    | —        | 整体加载状态，`true` 时显示 Loading 遮罩                                                                                                      |
-| commonTippyOptions | `AITippyProps`                                                               | —        | 通用 Tippy 配置，传入的选项会注入到所有使用 `v-overflow-tips` 的子组件中                                                                      |
-| openingRemark      | `string`                                                                     | —        | 开场白，无消息时显示，支持 Markdown                                                                                                           |
+| chatLoading                 | `boolean`                                                                    | —        | 整体加载状态，`true` 时显示 Loading 遮罩                                                                                                      |
+| commonTippyOptions          | `AITippyProps`                                                               | —        | 通用 Tippy 配置（`appendTo` / `placement` / `zIndex`），传入的选项会注入到所有使用 `v-overflow-tips` 的子组件中                                 |
+| getSideRenderComponent      | `(h, props?) => VNode \| undefined`                                          | —        | 自定义侧栏内容区渲染；未返回时使用 `selectedTab.data.component`                                                                               |
+| getSideTabRenderComponent   | `(h, tab, { removeCustomTab }) => VNode \| undefined`                        | —        | 自定义侧栏 Tab 标签渲染；未返回时使用默认图标 + 文案 + 关闭按钮                                                                               |
+| openingRemark               | `string`                                                                     | —        | 开场白，无消息时显示，支持 Markdown                                                                                                           |
 | placement          | `'left' \| 'right'`                                                          | `'left'` | 侧边栏位置                                                                                                                                    |
 | resizeProps        | `{ disabled?: boolean; initialDivide?: number \| string; max?: number; min?: number }` | —        | 透传给内部 `ResizeLayout` 的可选配置，与默认 `collapsible: false`、`immediate: true`、`min: 400` 合并；`placement` 始终取自本组件 `placement`；`initialDivide` 可为像素数字或百分比等字符串（与 bkui ResizeLayout 一致） |
 | onCustomTabChange  | `(tab: CustomTab) => Promise<any>`                                           | —        | 自定义 Tab 切换回调，返回值作为 Tab 组件 props                                                                                                |

package/dist/mcp/generated/docs/file-upload-btn.md

@@ -149,7 +149,7 @@ FileUploadBtn 提供隐藏 file input 与图标按钮，选择后在按钮层过
 ```typescript
 import type { TippyOptions } from 'vue-tippy';
 
-type AITippyProps = Partial<Omit<TippyOptions, 'content' | 'getReferenceClientRect' | 'theme' | 'triggerTarget'>>;
+type AITippyProps = Partial<Pick<TippyOptions, 'appendTo' | 'placement' | 'zIndex'>>;
 ```
 
 ## 关联组件

package/dist/mcp/generated/docs/markdown-content.md

@@ -23,8 +23,8 @@ AI 消息内容渲染的核心原子组件，集成代码高亮、LaTeX 公式
 ## 组件结构与渲染流程
 
 ```
-props.content → completeMarkdownSyntax → md.parse（html: true）→ groupTokens → groupedTokens
-                                                                               │
+props.content → completeMarkdownSyntax → md.parse → groupTokens → groupedTokens
+                                                                          │
                           div.ai-markdown-content（contain: layout style）
                                         │
                         status === 'error' → CommonErrorContent（:content）
@@ -39,21 +39,12 @@ props.content → completeMarkdownSyntax → md.parse（html: true）→ groupTo
                     ↓             ↓                    ↓               ↓
            MermaidContent  LatexContent        CodeContent    VNodeRenderer
            @mounted         @mounted           @mounted       @vue:mounted
-                    │                                              │
-                    └──── handleTokenMounted（throttle 100ms）      │
-                         → containerScroll.toScrollBottom()        │
-                                                         sanitize（DOMPurify + sanitizeCSS）
-                                                         sanitizeHtmlFragment（流式片段净化）
+                    │
+                    └──── handleTokenMounted（throttle 100ms）→ containerScroll.toScrollBottom()
 ```
 
 `VNodeRenderer` 的 `options` 中包含与当前 `MarkdownIt` 实例一致的 `mditOptions`（即 `md.options`），以便 `tokensToVNodes` 调用 `renderer.rules` 时第三参与 markdown-it 原生规则签名一致。
 
-`MarkdownIt` 构造时开启 `html: true`，允许行内 HTML 标签（如 `<font>`、`<div>`）通过 markdown-it 解析为 `html_inline` / `html_block` token。
-
-两组净化函数各司其职：
-- `sanitize`：DOMPurify 全局过滤后，再对 `style` 属性值进行 CSS 属性白名单校验（`sanitizeCSS`），用于最终渲染的完整 HTML。
-- `sanitizeHtmlFragment`：轻量级片段净化，**不自动闭合标签**，专用于流式渲染中拆分到多个 token 的 HTML 标签场景。
-
 ### Token 分组（groupTokens）
 
 `groupTokens` 使用栈将扁平 Token 数组转为分组数组，每组对应一个顶层 DOM 节点（段落、标题、列表、代码块等）：
@@ -186,6 +177,7 @@ props.content → completeMarkdownSyntax → md.parse（html: true）→ groupTo
 
 | 插件                        | 语法                | 功能                 |
 | --------------------------- | ------------------- | -------------------- |
+| `markdownItBkInlineStyle`   | 见下文「蓝鲸行内样式」 | 安全行内颜色/字号/粗斜体（非 HTML） |
 | `markdown-it-footnote`      | `[^1]`              | 脚注                 |
 | `markdown-it-ins`           | `++text++`          | 下划线               |
 | `markdown-it-mark`          | `==text==`          | 高亮                 |
@@ -196,26 +188,39 @@ props.content → completeMarkdownSyntax → md.parse（html: true）→ groupTo
 | `markdownItLatex`           | `$...$` / `$$...$$` | KaTeX 数学公式 token |
 | `markdownItContainer`       | `::: hljs-left` 等  | 自定义对齐容器（class 与 highlight.js 命名对齐） |
 
+### 蓝鲸行内样式（`markdownItBkInlineStyle`）
+
+不开启 `html: true`，由专用语法生成带白名单 `style` 的 `<span class="bk-md-inline-style">`。
+
+**语法**：`::bk{` *属性* `}` *正文* `:/bk::`
+
+- 属性写在 `{}` 内，使用 `;` 分隔；每项为 `键=值` 或 `键:值`。
+- 正文支持行内 Markdown（如 `**粗体**`）。
+- 结束标记必须为字面量 `:/bk::`，请勿在正文中出现该序列。
+
+**支持的键**：`color` / `c`、`background-color`、`font-size`、`bold`、`italic`（详见 `plugins/markdown-bk-inline-style.ts` 内注释）。
+
+**示例**：
+
+```markdown
+::bk{color:#c00;font-size:18px}**重要**:/bk::
+::bk{background-color:yellow}高亮:/bk::
+::bk{bold;italic}强调:/bk::
+```
+
 ### 安全性
 
-HTML 渲染采用两层安全策略：
+`MarkdownIt` **不**开启 `html: true`，用户无法插入任意 HTML 标签；行内彩色/字号等请使用上文「蓝鲸行内样式」扩展。
 
-**第一层 — DOMPurify**：全局过滤，移除危险标签和属性，同时允许 KaTeX 和 `<font>` 标签所需的内容：
+`VNodeRenderer` 渲染的 HTML 统一经过 DOMPurify 过滤，并额外允许 KaTeX 所需标签：
 
 ```typescript
 const domPurifyConfig = {
-  ADD_TAGS: ['font', 'semantics', 'mrow', 'mi', 'mo', 'mn', 'msup', 'msub', 'mfrac', 'mtext', 'annotation'],
-  ADD_ATTR: ['xmlns', 'mathvariant', 'encoding', 'style', 'color', 'size', 'face'],
-  FORBID_TAGS: ['style'],
+  ADD_TAGS: ['semantics', 'mrow', 'mi', 'mo', 'mn', 'msup', 'msub', 'mfrac', 'mtext', 'annotation'],
+  ADD_ATTR: ['xmlns', 'mathvariant', 'encoding', 'style'],
 };
 ```
 
-> `FORBID_TAGS: ['style']` 防止 `<style>` 标签注入全局 CSS，样式属性通过 `style` 属性（attribute）而非 `<style>` 标签（tag）控制。
-
-**第二层 — CSS 属性白名单**（`sanitizeCSS`）：DOMPurify 处理后，对 `style` 属性值做二次过滤，仅保留白名单内的安全 CSS 属性，拦截 `url()`、`expression()`、`javascript:` 等危险模式。
-
-**流式场景 — `sanitizeHtmlFragment`**：流式渲染中 HTML 标签可能被拆分到多个 `html_inline` token（如 `<font color="red">` 和 `</font>` 分属不同 token），DOMPurify 会自动闭合未匹配标签导致样式丢失。`sanitizeHtmlFragment` 只做危险模式匹配不自动闭合，专用于此场景。
-
 > `CodeContent`、`MermaidContent`、`LatexContent` 各自内部处理安全性（KaTeX `errorColor`、highlight.js 转义等），不经过 DOMPurify。
 
 ## 关联组件

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

@@ -461,7 +461,7 @@ AI 回复状态为 `error` 时，消息以错误样式展示：
 | messageGroups            | `MessageGroup[]`                                                                             | —       | 预计算的消息分组；传入时跳过内部分组逻辑，由 `ChatContainer` 通过 `useMessageGroup` 提供                                                 |
 | messageStatus            | `MessageStatus`                                                                              | —       | 当前整体消息状态，控制底部「停止生成」按钮显示；`ChatContainer` 会结合末尾 Loading 占位推导 `fetching` 等再传入                                                                                                   |
 | messageToolsStatus       | `MessageToolsStatus`                                                                         | —       | 工具栏状态，透传给 `MessageTools` 和 `MessageRender`                                                                                     |
-| messageToolsTippyOptions | `AITippyProps`                                                                               | —       | 透传给 `MessageTools` 和 `MessageRender`（进而透传给 `UserMessage` 的工具栏）的 Tippy 配置，用于自定义 tooltip 挂载点（如 `appendTo`）等 |
+| messageToolsTippyOptions | `AITippyProps`                                                                               | —       | 透传给 `MessageTools` 和 `MessageRender`（进而透传给 `UserMessage` 的工具栏）的 Tippy 配置，用于自定义 tooltip 挂载点、位置等（如 `appendTo`、`placement`、`zIndex`） |
 | enableSelection          | `boolean`                                                                                    | `false` | 是否启用多选模式                                                                                                                         |
 | onAgentAction            | `(tool: IToolBtn, messages: Message[]) => Promise<string[] \| void>`                         | —       | AI 消息工具操作回调；`copy` 操作由内部处理，`like/unlike` 应返回反馈原因字符串数组                                                       |
 | onAgentFeedback          | `(tool: IToolBtn, messages: Message[], reasonList: string[], otherReason: string) => void`   | —       | AI 消息反馈提交回调（点赞/踩选完原因后触发）                                                                                             |

package/dist/mcp/generated/docs/shortcut-render.md

@@ -344,7 +344,7 @@ const components: ShortcutComponent[] = [
 | ------------- | ------------------------------------ | ---- | ------------------------------------------------------------------------------------------ |
 | type          | 见[表单类型](#表单组件类型)          | ✓    | 控件类型；未知类型返回 `null`，不渲染                                                      |
 | key           | `string`                             | ✓    | 表单字段名；`submit` 事件返回对象以此为 key；同时作为校验 property                         |
-| name          | `string`                             | —    | 表单项标签（`Form.FormItem` 的 `label`）                                                   |
+| name          | `string`                             | —    | 表单项标签；优先于 `formItemProps.label`，通过 `#label` 插槽渲染为 `.shortcut-render-form-label` |
 | default       | `string`                             | —    | 字段初始值；优先于 `formModel`，在 `watchEffect` 中覆盖写入                                |
 | fillBack      | `boolean`                            | —    | `true` 时映射为 `required: true`（必填校验），同时标记回填语义                             |
 | placeholder   | `string`                             | —    | 占位文本（`input` / `textarea` / `number` 可用）                                           |
@@ -413,7 +413,7 @@ interface BaseShortcutComponent {
 
 ## 样式说明
 
-组件内部使用 SCSS 变量 `$bk-prefix` 拼接 bkui-vue 组件类名（如 `Form`、`FormItem`、`Radio`、`Checkbox` 等），替代原先硬编码的 `.bk-*` 类名选择器，确保在不同构建环境下类名前缀的一致性。
+表单项与控件会附加类型化 class，便于样式覆盖：`shortcut-render-form-item_{type}`（如 `_radio`、`_checkbox`），单选/多选项子项为 `shortcut-render-form-item_radio` / `shortcut-render-form-item_checkbox`。表单项标签使用 BEM 风格类名 `shortcut-render-form-label`。
 
 ## 关联组件
 

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-05-14T09:46:52.773Z",
+  "generatedAt": "2026-05-26T07:50:36.876Z",
   "domains": {
     "message": {
       "label": "消息展示",

package/dist/plugins/index.d.ts

@@ -1,3 +1,4 @@
 export * from './markdown-animation-attrs';
+export * from './markdown-bk-inline-style';
 export * from './markdown-latex';
 export * from './markdown-mermaid';

package/dist/plugins/markdown-bk-inline-style.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 蓝鲸行内富文本（安全样式）扩展。
+ *
+ * 语法（与 HTML 无关，不开启 markdown-it `html`）：
+ *
+ *   ::bk{ 属性列表 } 正文内容 :/bk::
+ *
+ * - 属性列表：写在 `{}` 内，使用 `;` 分隔，每项为 `键=值` 或 `键:值`（等号与冒号等价）。
+ * - 正文：支持行内 Markdown（加粗、链接、行内代码等），由 markdown-it 再次 tokenize。
+ * - 结束标记固定为 `:/bk::`，请勿在正文中使用该字面量。
+ *
+ * 支持的键（仅生成固定白名单 style）：
+ * - `color` / `c`：颜色（#rgb / #rrggbb 或 CSS 命名色）
+ * - `background-color`：背景色，规则同 color
+ * - `font-size`：字号，如 `14px`（限制 1-72px）
+ * - `bold`：加粗
+ * - `italic`：斜体
+ */
+import type { PluginSimple } from '../markdown-it';
+export declare const markdownItBkInlineStyle: PluginSimple;

package/dist/types/custom.d.ts

@@ -2,6 +2,7 @@ import type { Component } from 'vue';
 export type CustomBkFlowTab = CustomTab<CustomBkFlowTabData>;
 export type CustomBkFlowTabData = CustomTabData<{
     data?: Partial<NodeDetailData>;
+    has_confidence?: boolean;
     loading?: boolean;
     node_id?: string;
     node_name?: string;

package/dist/types/input.d.ts

@@ -1,5 +1,5 @@
-import { type tagSchema } from '../components/chat-input/ai-slash-input/constants';
 import type { BinaryInputContent } from '../ag-ui/types/contents';
+import type { tagSchema } from '../components/chat-input/ai-slash-input/constants';
 import type { InferDoc } from '../edix';
 export declare const MessageState: {
     readonly ACTIVE: "active";

package/dist/types/tool.d.ts

@@ -1,10 +1,10 @@
-import { type ToolIconsMap } from '../icons/tools';
+import type { ToolIconsMap } from '../icons/tools';
 import type { TippyOptions } from 'vue-tippy';
 export declare enum MessageToolsStatus {
     Disabled = "disabled",// 禁用
     Hidden = "hidden"
 }
-export type AITippyProps = Partial<Pick<TippyOptions, 'appendTo' | 'zIndex'>>;
+export type AITippyProps = Partial<Pick<TippyOptions, 'appendTo' | 'placement' | 'zIndex'>>;
 export interface IToolBtn {
     description?: string;
     id: keyof typeof ToolIconsMap;

package/dist/utils/index.d.ts

@@ -1,5 +1,3 @@
-export * from './css-sanitizer';
 export * from './file';
-export * from './html-sanitizer';
 export * from './markdown-completer';
 export * from './utils';

package/dist/utils/tokens-to-vnodes.d.ts

@@ -17,12 +17,6 @@ export interface TokenToVNodeOptions {
      * HTML 净化函数，用于处理 innerHTML 的内容
      */
     sanitize?: (html: string) => string;
-    /**
-     * HTML 片段净化函数，用于流式场景下 html_inline/html_block token 的净化。
-     * 与 sanitize 不同，此函数不会自动闭合未匹配的标签，
-     * 因为流式渲染中 HTML 标签可能被拆分到不同的 token 中。
-     */
-    sanitizeHtmlFragment?: (html: string) => string;
 }
 type TokenAttrs = [string, string][];
 /**

package/dist/utils/utils.d.ts

@@ -6,3 +6,4 @@ export declare const getCookieByName: (name: string) => string | null;
  */
 export declare const formatDuration: (duration: number) => string;
 export declare const generateUUID: () => string;
+export declare const formatElapsedTime: (seconds: number) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "description": "蓝鲸智云 AI Chat 组件库 —— 遵循 AG-UI，为 AI Agent 和人类开发者共同设计的对话 UI 组件库。",
   "main": "index.js",
   "bin": {
@@ -78,7 +78,7 @@
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18",
     "vue-tsc": "^3.1.4",
-    "@blueking/chat-helper": "0.0.4"
+    "@blueking/chat-helper": "0.0.5"
   },
   "scripts": {
     "dev": "vite --config vite.config.ts",

package/dist/utils/css-sanitizer.d.ts

@@ -1,7 +0,0 @@
-/**
- * 过滤 CSS 属性值，仅保留白名单中的安全属性，
- * 并拦截 url()、expression()、javascript: 等危险模式。
- *
- * 注意：此函数是第二道防线。第一道由 DOMPurify 处理（过滤 script/event handler/javascript: URI 等）。
- */
-export declare const sanitizeCSS: (cssValue: string) => string;

package/dist/utils/html-sanitizer.d.ts

@@ -1,7 +0,0 @@
-/**
- * 轻量级 HTML 片段净化，不自动闭合标签。
- * 用于流式渲染中 html_inline / html_block token 的净化——
- * DOMPurify 会把孤立的 `<font color="red">` 补成 `<font color="red"></font>`，
- * 导致后续内容无法继承样式，因此流式场景需要使用此函数。
- */
-export declare const sanitizeHtmlFragment: (html: string) => string;