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

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

@@ -11,7 +11,7 @@
 ---
 <!-- FULL DOC -->
 
-# ToolcallRender 工具调用渲染器
+# ToolCallRender 工具调用渲染器
 ## 源码事实
 
 - **源码位置**：`src/components/tool-call/toolcall-render/toolcall-render.vue`
@@ -47,14 +47,14 @@
 
 ```vue
 <template>
-  <ToolcallRender
+  <ToolCallRender
     :tool-call="toolCall"
     :status="MessageStatus.Complete"
   />
 </template>
 
 <script setup lang="ts">
-  import { ToolcallRender, MessageStatus, MessageContentType, type ToolCall } from '@blueking/chat-x';
+  import { ToolCallRender, MessageStatus, MessageContentType, type ToolCall } from '@blueking/chat-x';
 
   const toolCall: ToolCall = {
     id: 'call_1',
@@ -171,10 +171,10 @@ durationDisplay = formatDuration(props.duration || toolCall?.toolMessage?.durati
 
 ```vue
 <!-- 方式一：直接传 duration prop（优先） -->
-<ToolcallRender :tool-call="toolCall" status="complete" :duration="1200" />
+<ToolCallRender :tool-call="toolCall" status="complete" :duration="1200" />
 
 <!-- 方式二（推荐）：duration 放在 toolMessage 中，无需额外 prop -->
-<ToolcallRender :tool-call="toolCallWithDuration" status="complete" />
+<ToolCallRender :tool-call="toolCallWithDuration" status="complete" />
 ```
 
 ```typescript
@@ -242,7 +242,7 @@ const failedToolCall: ToolCall = {
 
 ## 与 AssistantMessage 配合
 
-`ToolcallRender` 通常不需要单独使用，将 `toolCalls` 传给 `AssistantMessage`，会自动为每个工具调用渲染 `ToolcallRender`：
+`ToolCallRender` 通常不需要单独使用，将 `toolCalls` 传给 `AssistantMessage`，会自动为每个工具调用渲染 `ToolCallRender`：
 
 ```typescript
 const assistantMessage = {
@@ -274,7 +274,7 @@ const assistantMessage = {
 
 ```vue
 <template>
-  <ToolcallRender
+  <ToolCallRender
     v-for="toolCall in assistantMessage.toolCalls"
     :key="toolCall.id"
     :tool-call="toolCall"
@@ -338,7 +338,7 @@ interface ToolMessage {
   role: 'tool';
   content: string; // 返回内容（通常为 JSON 字符串）
   status: MessageStatus;
-  duration: number; // 调用耗时（毫秒），被 ToolcallRender 自动读取
+  duration: number; // 调用耗时（毫秒），被 ToolCallRender 自动读取
   error?: string; // 错误信息（仅当 content 为空时由 ToolMessage 展示）
   toolCallId: string; // 对应 ToolCall.id
 }

package/dist/mcp/generated/docs/use-animation-text.md

@@ -122,7 +122,8 @@ useAnimationText 接收 MaybeRef<string> 与可选 AnimationConfig（fadeDuratio
 </template>
 
 <script setup lang="ts">
-  import { AnimationText } from '@blueking/chat-x';
+  // AnimationText 未从包入口导出，见内部组件文档
+  // import { useAnimationText } from '@blueking/chat-x' 才是公开 API
 </script>
 ```
 

package/dist/mcp/generated/docs/use-artifact-preview.md

@@ -67,8 +67,8 @@ import {
   useCustomTabProvider,
   useMessageGroup,
   FILE_ARTIFACT_TAB_NAME,
+  t,
 } from '@blueking/chat-x';
-import { t } from '@blueking/chat-x/lang';
 
 const { addCustomTab, ensureCustomTab, removeCustomTab } = useCustomTabProvider({ /* ... */ });
 
@@ -157,6 +157,16 @@ const onArtifactClick = async (file: AIFileInfo) => {
 | `FILE_ARTIFACT_TAB_NAME`  | `'file-artifact'`  | 「文件产物」侧栏 Tab 的固定标识，不可关闭 |
 | `ARTIFACT_PREVIEW_TOKEN`  | `Symbol`           | provide/inject 注入 Token                 |
 
+## triggerArtifactDownload
+
+从包入口导出，用临时 `<a download>` 触发浏览器下载（面板下载按钮内部使用）：
+
+```typescript
+import { triggerArtifactDownload } from '@blueking/chat-x';
+
+triggerArtifactDownload(downloadUrl, file.name);
+```
+
 ## 返回值说明
 
 | 属性/方法名         | 类型                                      | 说明                                                                 |

package/dist/mcp/generated/docs/use-flow-node-actions.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-useFlowNodeActions 接收 onInterruptResume 与 openNodeDetail，返回 getNodeActions 与 isNodePending。 失败节点按 retryable/skippable 展示重试/跳过，详情恒在末尾；点击后进入 pending 防重复提交， 以 task_id:node_id:retry 为键自动收敛；点击 resume 时不传 interrupt。
+useFlowNodeActions 接收 onInterruptResume 与 openNodeDetail，返回 getNodeActions 与 isNodePending。 失败节点按 retryable/skippable 展示重试/跳过，详情恒在末尾；点击后进入 pending 防重复提交， 以 task_id:node_id:retry 为键自动收敛；点击 resume 时不传 interrupt。 hideResumeActions 为 true 时只返回详情，覆盖 Share 分享态与侧栏「执行情况」面板两类只读场景。
 
 ### 关联组件
 - **flow-agent-content** — FlowAgentContent 内部消费，驱动节点行尾按钮组渲染
@@ -11,6 +11,10 @@ useFlowNodeActions 接收 onInterruptResume 与 openNodeDetail，返回 getNodeA
 
 # useFlowNodeActions 节点行尾操作
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 实现位于 `src/components/chat-content/flow-agent-content/use-flow-node-actions.ts`，未进入 `src/composables/index.ts`。
+> 由 [FlowAgentContent](/components/agent/flow-agent-content) 内部消费。
+
 > **分类**：composable
 
 将 FlowAgent 节点行尾的「详情（打开侧栏）」与「重试 / 跳过（回传 Agent resume）」聚合为统一的声明式操作列表。`FlowAgentContent` 只需遍历 `getNodeActions` 返回值渲染按钮，显隐与点击行为均收敛于此 composable。
@@ -21,7 +25,7 @@ useFlowNodeActions 接收 onInterruptResume 与 openNodeDetail，返回 getNodeA
 
 ```typescript
 function useFlowNodeActions(options: {
-  /** 隐藏重试 / 跳过等交互式 resume 操作（分享态只读，仅保留「详情」查看入口） */
+  /** 隐藏重试 / 跳过等交互式 resume 操作（分享态、侧栏执行情况面板等只读场景，仅保留「详情」查看入口） */
   hideResumeActions?: Ref<boolean>;
   /** resume 回调（与第三方审批取消同一回调，按 payload.operation 分流） */
   onInterruptResume: Ref<OnInterruptResume | undefined>;
@@ -71,13 +75,16 @@ interface FlowNodeActionVM {
 
 | 操作 | `id`               | 显隐条件                                   | 点击行为                                      |
 | ---- | ------------------ | ------------------------------------------ | --------------------------------------------- |
-| 重试 | `flow_node_retry`  | `convergedState === 'failed'` 且 `retryable` | 调用 `onInterruptResume`，**不传** `interrupt` |
-| 跳过 | `flow_node_skip`   | `convergedState === 'failed'` 且 `skippable` | 同上                                          |
-| 详情 | `detail`           | 始终（含 Share 分享态）                     | 调用 `openNodeDetail(task.raw, node.raw)`     |
+| 重试 | `flow_node_retry`  | `convergedState === 'failed'` 且 `retryable`，且 `hideResumeActions` 为 `false` | 调用 `onInterruptResume`，**不传** `interrupt` |
+| 跳过 | `flow_node_skip`   | `convergedState === 'failed'` 且 `skippable`，且 `hideResumeActions` 为 `false` | 同上                                          |
+| 详情 | `detail`           | 始终（不受 `hideResumeActions` 影响）        | 调用 `openNodeDetail(task.raw, node.raw)`     |
 
 展示顺序：重试 → 跳过 → 详情。
 
-> **分享态过滤**：传入 `hideResumeActions`（`Ref<boolean>`，如 `RenderMode.Share`）为 `true` 时，`getNodeActions` 直接过滤掉重试 / 跳过，仅返回「详情」查看入口；用于只读分享场景放开查看、禁止交互。
+> **只读场景过滤**：`hideResumeActions` 为 `true` 时，`getNodeActions` 直接过滤掉重试 / 跳过，仅返回「详情」查看入口，用于放开查看、禁止交互的场景。`FlowAgentContent` 目前把两类只读场景并入该入参：
+>
+> - `RenderMode.Share` 分享态
+> - 侧栏「执行情况」面板内（`ExecutionSummary` 通过 `EXECUTION_PANEL_TOKEN` 提供上下文，组件用 `useExecutionPanelInject` 读取）
 
 ## pending 态与防重复提交
 
@@ -112,12 +119,15 @@ onInterruptResume?.({
 
 ```typescript
 import { toRef } from 'vue';
-import { useFlowNodeActions } from '@blueking/chat-x';
-// 或相对路径：'./use-flow-node-actions'
+import { useFlowNodeActions } from '../../src/components/chat-content/flow-agent-content/use-flow-node-actions';
+
+// 是否处于侧栏「执行情况」面板内；缺省 false，即对话流内渲染
+// useExecutionPanelInject 来自内部 src/composables/use-common.ts，未从包入口导出
+const isInExecutionPanel = useExecutionPanelInject();
 
 const { getNodeActions, isNodePending } = useFlowNodeActions({
-  // 分享态只读：过滤重试 / 跳过，仅保留详情
-  hideResumeActions: computed(() => renderMode.value === RenderMode.Share),
+  // 分享态与侧栏执行情况面板均只读：过滤重试 / 跳过，仅保留详情
+  hideResumeActions: computed(() => renderMode.value === RenderMode.Share || isInExecutionPanel),
   onInterruptResume: toRef(props, 'onInterruptResume'),
   openNodeDetail,
 });

package/dist/mcp/generated/docs/user-question-card.md

@@ -164,6 +164,37 @@ const payload = buildSkipResumePayload(interrupt);
 // }
 ```
 
+## useUserQuestion 与选项辅助
+
+以下符号经 interrupt 子 barrel 从 `@blueking/chat-x` 导出，实现在 `src/components/chat-message/interrupt-message/user-question/use-user-question.ts`（不在 `composables/index.ts`）。
+
+| 符号 | 说明 |
+| --- | --- |
+| `useUserQuestion` | 答题分页、完成态、`setAnswer` / `buildResolvePayload` / `buildSkipPayload` |
+| `buildSkipResumePayload` | 构造 skip resume（`status: 'cancelled'`，`answers: []`） |
+| `OTHERS_OPTION_LABEL` | Others 选项的固定 `label`（`'others'`） |
+| `toLetter` | 选项序号：0 → A，超过 26 回退数字 |
+| `NormalizedUserQuestionOption` | 选择题内部展示类型（含 `letter` / `isOthers`） |
+
+```typescript
+import {
+  OTHERS_OPTION_LABEL,
+  toLetter,
+  useUserQuestion,
+  type NormalizedUserQuestionOption,
+} from '@blueking/chat-x';
+
+const {
+  questions,
+  currentIndex,
+  completed,
+  setAnswer,
+  buildResolvePayload,
+} = useUserQuestion(() => pendingInterrupt);
+```
+
+自定义 `#question` 面板时，作答有效调用 slot 的 `setAnswer`（即 composable 的 `setAnswer`），无需自己拼 resume。
+
 ## 自定义题目渲染（#question slot）
 
 默认每道题由 [UserQuestionChoice](/components/agent/user-question-choice) 渲染；业务可覆盖 `#question` slot 接入自定义表单：

package/dist/mcp/generated/docs/vnode-renderer.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-将 Markdown token 转成 VNode 的内部渲染桥。 源码位置：src/components/chat-content/vnode-renderer.ts。
+将 Markdown token 转成 VNode；包入口已导出，通常经 MarkdownContent 使用。 源码位置：src/components/chat-content/vnode-renderer.ts。
 
 ### 关联组件
 - **markdown-content** — MarkdownContent 对普通 token 分组使用本组件渲染
@@ -41,8 +41,8 @@
 </template>
 
 <script setup lang="ts">
-  import MarkdownIt from '@blueking/chat-x/src/markdown-it/index';
-  import VNodeRenderer from '@blueking/chat-x/src/components/chat-content/vnode-renderer';
+  import { VNodeRenderer } from '@blueking/chat-x';
+  // MarkdownIt 未从包入口导出；文档站 demo 使用页面顶部相对路径
 
   const md = new MarkdownIt();
   const tokens = md.parse('这是一段 **加粗文本**。', {});