@blueking/chat-x 0.0.52-dev.5 → 2.4.0

package/dist/mcp/generated/docs/highlight-keyword.md

@@ -74,42 +74,20 @@ ExecutionSummary
             └── HighlightKeyword(:text)  ← inject(keyword)
 ```
 
-## 配套 Composables
+## 配套 Composables（内部，未从包入口导出）
 
-### useKeywordProvider
+`useKeywordProvider` / `useKeywordInject` / `useKeywordMatch` 在 `src/composables/use-common.ts`，**不能** `from '@blueking/chat-x'`。业务侧把 `HighlightKeyword` 放在 [ChatContainer](/components/setup/chat-container) / [ExecutionSummary](/components/agent/execution-summary) 子树即可，库已注入关键词。
 
-在上层组件中创建关键词并 `provide`，后代组件通过 `useKeywordInject` 消费：
+库内或文档站高级用法用相对路径：
 
 ```typescript
-import { useKeywordProvider } from '@blueking/chat-x';
+import { useKeywordProvider, useKeywordInject, useKeywordMatch } from '../../../src/composables/use-common';
 
 const { keyword } = useKeywordProvider();
 keyword.value = '搜索词';
-```
-
-### useKeywordInject
-
-在后代组件中注入关键词，返回 `ComputedRef<string> | undefined`：
-
-```typescript
-import { useKeywordInject } from '@blueking/chat-x';
-
-const keyword = useKeywordInject();
-console.log(keyword?.value); // 当前搜索关键词
-```
-
-### useKeywordMatch
-
-用于判断组件的可搜索文本是否与当前关键词匹配。内部调用 `useKeywordInject` 获取关键词，根据传入的文本提取函数判断是否命中：
-
-```typescript
-import { useKeywordMatch } from '@blueking/chat-x';
 
+const injected = useKeywordInject();
 const { keywordMatched } = useKeywordMatch(() => [props.title, props.description, props.content]);
-
-// keywordMatched.value === true 表示命中搜索
-// keywordMatched.value === false 表示未命中（可据此隐藏组件）
-// keyword 为空时始终返回 true
 ```
 
 `useKeywordMatch` 的典型用途是在 `ExecutionSummary` 的搜索过滤中，让组件自行判断是否匹配搜索词，与 `HighlightKeyword` 配合实现搜索 + 高亮。
@@ -132,9 +110,9 @@ const { keywordMatched } = useKeywordMatch(() => [props.title, props.description
 
 | 函数名               | 参数                                            | 返回值                                     | 说明                                          |
 | -------------------- | ----------------------------------------------- | ------------------------------------------ | --------------------------------------------- |
-| `useKeywordProvider` | —                                               | `{ keyword: ShallowRef<string> }`          | 创建并 `provide` 关键词，用于上层组件         |
-| `useKeywordInject`   | —                                               | `ComputedRef<string> \| undefined`         | 注入关键词，用于后代组件                      |
-| `useKeywordMatch`    | `getSearchTexts: () => (string \| undefined)[]` | `{ keywordMatched: ComputedRef<boolean> }` | 判断组件文本是否匹配关键词，空关键词返回 true |
+| `useKeywordProvider` | —                                               | `{ keyword: ShallowRef<string> }`          | 内部 API，见 `src/composables/use-common.ts` |
+| `useKeywordInject`   | —                                               | `ComputedRef<string> \| undefined`         | 内部 API，见 `src/composables/use-common.ts` |
+| `useKeywordMatch`    | `getSearchTexts: () => (string \| undefined)[]` | `{ keywordMatched: ComputedRef<boolean> }` | 内部 API；空关键词返回 true |
 
 ### CSS 类名
 
@@ -144,6 +122,6 @@ const { keywordMatched } = useKeywordMatch(() => [props.title, props.description
 
 ## 关联组件
 
-- [ToolcallRender](/components/agent/toolcall-render) — 工具调用头部高亮
+- [ToolCallRender](/components/agent/toolcall-render) — 工具调用头部高亮
 - [DescPanel](/components/rendering/desc-panel) — 详情面板键值高亮
 - [ExecutionSummary](/components/agent/execution-summary) — 执行摘要搜索

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

@@ -8,6 +8,9 @@ ChatInput 底部附件区布局，承载快捷按钮、文件与发送图标。
 
 # InputAttachment 输入附件区
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ChatInput](/components/input/chat-input) 使用。
+
 > **能力域**：输入交互
 
 ## 源码事实

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

@@ -8,6 +8,9 @@ ChatInput 上方的信息提示条。 源码位置：src/components/chat-input/i
 
 # InputInfoAlert 输入提示条
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ChatInput](/components/input/chat-input) 使用。
+
 > **能力域**：输入交互
 
 ## 源码事实

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

@@ -12,7 +12,12 @@
 ---
 <!-- FULL DOC -->
 
-# InterruptMessage 中断消息
+# InterruptMessageRender 中断消息
+
+| 名称 | 种类 |
+| --- | --- |
+| `InterruptMessage` | TS 消息类型 |
+| `InterruptMessageRender` | 包入口 Vue 组件 |
 ## 源码事实
 
 - **源码位置**：`src/components/chat-message/interrupt-message/interrupt-message.vue`

package/dist/mcp/generated/docs/key-value-content.md

@@ -10,6 +10,11 @@
 <!-- FULL DOC -->
 
 # KeyValueContent 键值对内容
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [UserMessage](/components/message/user-message) / [MessageRender](/components/message/message-render) 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { KeyValueContent } from '@blueking/chat-x'`。
+
 ## 源码事实
 
 - **源码位置**：`src/components/chat-content/key-value-content/key-value-content.vue`
@@ -48,7 +53,7 @@ div.ai-key-value-content（flex column，gap: 8px，font-size: 12px，color: #4d
 </template>
 
 <script setup lang="ts">
-  import { KeyValueContent } from '@blueking/chat-x';
+  // KeyValueContent 未从包入口导出；文档站 demo 使用页面顶部相对路径
 
   const data = [
     { key: '名称', value: '蓝鲸智云' },

package/dist/mcp/generated/docs/knowledge-rag-content.md

@@ -14,6 +14,9 @@
 
 # KnowledgeRagContent 知识召回内容
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [MessageRender](/components/message/message-render) 渲染 `role: 'activity'`。
+
 > **能力域**：Agent 能力
 
 `KnowledgeRagContent` 用于渲染知识召回活动内容，包含活动标题、加载态、Markdown 摘要和引用来源列表。它是 `ActivityMessage` 在 `activityType === 'knowledge_rag'` 时使用的具体内容组件。
@@ -46,7 +49,7 @@
 
 <script setup lang="ts">
   import { ref } from 'vue';
-  import KnowledgeRagContent from '@blueking/chat-x/src/components/chat-content/knowledge-rag-content/knowledge-rag-content.vue';
+  // KnowledgeRagContent 未从包入口导出；文档站 demo 使用页面顶部相对路径
   import type { KnowledgeRagMessageContent } from '@blueking/chat-x';
 
   const collapsed = ref(false);

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

@@ -11,6 +11,9 @@ markdownItContainer 基于 markdown-it-container，支持字符串或正则匹
 
 # markdownItContainer 自定义容器插件
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 由 [MarkdownContent](/components/rendering/markdown-content) 内部注册。请用相对路径引入源码，不要写 `import { markdownItContainer } from '@blueking/chat-x'`。
+
 > **分类**：plugin
 
 将 `::: 容器名` 开头的块解析为带 `class` 的块级容器，闭合行使用 `:::`。

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

@@ -28,7 +28,7 @@ AI 消息内容渲染的核心基础组件，集成代码高亮、LaTeX 公式
 ## 组件结构与渲染流程
 
 ```
-props.content → completeMarkdownSyntax → md.parse → groupTokens → groupedTokens
+props.content → completeMarkdownSyntax().content → md.parse → groupTokens → groupedTokens
                                                                           │
                           div.ai-markdown-content（contain: layout style）
                                         │
@@ -148,7 +148,7 @@ props.content → completeMarkdownSyntax → md.parse → groupTokens → groupe
 | 机制              | 实现                                                                                         | 作用                                                       |
 | ----------------- | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
 | 极速节流          | `parseMarkdownContent` throttle **5ms**，leading + trailing                                  | 每 5ms 最多解析一次，兼顾实时性与性能                      |
-| Markdown 语法补全 | `completeMarkdownSyntax(content)`                                                            | 自动闭合代码块、行内代码、粗斜体、删除线、链接等未完成语法 |
+| Markdown 语法补全 | `completeMarkdownSyntax(content).content`                                                    | 自动闭合代码块、行内代码、粗斜体、删除线、链接等未完成语法 |
 | LaTeX 防闪烁      | `isIncomplete=true` 且已有渲染结果 → **跳过本次更新**                                        | 正在输入 LaTeX 命令时保持上一帧，避免闪白                  |
 | 子组件 throttle   | `handleTokenMounted` throttle 100ms                                                          | 限制子组件挂载后触发的滚动到底部频率                       |
 | CSS contain       | `.ai-markdown-content { contain: layout style }`<br>`.ai-markdown-body { contain: content }` | 限制重排/重绘范围，减少流式渲染的布局开销                  |

package/dist/mcp/generated/docs/mention-tag.md

@@ -14,6 +14,8 @@ MentionTag 渲染「图标 + 蓝色名称」的内联资源标签：节点数据
 
 # MentionTag 资源标签
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+
 > **能力域**：内容渲染
 
 ## 源码事实

package/dist/mcp/generated/docs/mention-text.md

@@ -13,6 +13,9 @@ MentionText 接收一份 TagSchema 文档（二维数组：行 → 节点），
 
 # MentionText 标签文本
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [UserMessage](/components/message/user-message) / [MessageRender](/components/message/message-render) 使用。
+
 > **能力域**：内容渲染
 
 ## 源码事实

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-负责消息分组渲染、滚动控制、工具栏和消息插槽透传。 源码位置：src/components/chat-message/message-container/message-container.vue。
+负责按传入的 `messageGroups` 渲染、滚动控制、工具栏和消息插槽透传。 源码位置：src/components/chat-message/message-container/message-container.vue。
 
 ### 关联组件
 - **message-render** — 按组渲染每条消息时委托 MessageRender
@@ -17,7 +17,7 @@
 
 - **源码位置**：`src/components/chat-message/message-container/message-container.vue`
 - **能力域**：对话搭建
-- **能力说明**：负责消息分组渲染、滚动控制、工具栏和消息插槽透传。
+- **能力说明**：负责按传入的 `messageGroups` 渲染、滚动控制、工具栏和消息插槽透传。
 
 > **能力域**：对话搭建
 
@@ -564,7 +564,7 @@ AI 回复状态为 `error` 时，消息以错误样式展示：
 | 属性名                   | 类型                                                                                         | 默认值  | 说明                                                                                                                                     |
 | ------------------------ | -------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
 | messages                 | `Message[]`                                                                                  | —       | **必填**，消息列表                                                                                                                       |
-| messageGroups            | `MessageGroup[]`                                                                             | —       | 预计算的消息分组；传入时跳过内部分组逻辑，由 `ChatContainer` 通过 `useMessageGroup` 提供                                                 |
+| messageGroups            | `MessageGroup[]`                                                                             | —       | **必填**。本组件不分组；由调用方用 `useMessageGroup` 算好后传入。`ChatContainer` 会代为计算。 |
 | messageStatus            | `MessageStatus`                                                                              | —       | 当前整体消息状态，控制底部「停止生成」按钮显示；`ChatContainer` 会结合末尾 Loading 占位推导 `fetching` 等再传入                                                                                                   |
 | messageTools             | `IToolBtn[]`                                                                                 | —       | AI 消息左侧工具（复制/引用等）的自定义配置；按 `id` 与内置 `CONST_MESSAGE_TOOLS` 合并（覆盖同 id、追加新 id、`hidden` 过滤），详见「自定义消息工具栏」 |
 | updateTools              | `IToolBtn[]`                                                                                 | —       | AI 消息右侧反馈工具（点赞/踩/删除等）的自定义配置；按 `id` 与内置 `CONST_UPDATE_TOOLS` 合并，规则同上                                     |
@@ -605,7 +605,7 @@ AI 回复状态为 `error` 时，消息以错误样式展示：
 ```typescript
 import { MessageRole, MessageStatus, MessageToolsStatus, type Message, type MessageGroup, type IToolBtn } from '@blueking/chat-x';
 
-// 消息组（由 useMessageGroup 生成，也可手动传入 messageGroups）
+// 消息组（必须传入 useMessageGroup 的结果）
 interface MessageGroup {
   checked: boolean;
   isHover: boolean;

package/dist/mcp/generated/docs/preview-toolbar.md

@@ -8,6 +8,10 @@
 
 # PreviewToolbar 图片预览工具栏
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ImagePreview](/components/medias/image-preview) 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { PreviewToolbar } from '@blueking/chat-x'`。
+
 > **能力域**：媒体文件
 
 ## 源码事实

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

@@ -11,6 +11,11 @@
 <!-- FULL DOC -->
 
 # ReferenceContent 引用文档内容
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ContentRender](/components/rendering/content-render) / [ActivityMessage](/components/message/activity-message) 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { ReferenceContent } from '@blueking/chat-x'`。
+
 ## 源码事实
 
 - **源码位置**：`src/components/chat-content/reference-content/reference-content.vue`
@@ -68,8 +73,8 @@ gotoLink(url, event):
 </template>
 
 <script setup lang="ts">
-  import { ReferenceContent } from '@blueking/chat-x';
   import type { ReferenceDocumentContent } from '@blueking/chat-x';
+  // ReferenceContent 未从包入口导出；文档站 demo 使用页面顶部相对路径
 
   const references: ReferenceDocumentContent[] = [
     { name: '蓝鲸 PaaS 平台文档', url: 'https://bk.tencent.com', originFile: '' },

package/dist/mcp/generated/docs/reference-doc-content.md

@@ -13,6 +13,8 @@
 
 # ReferenceDocContent 引用文档活动
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+
 > **能力域**：Agent 能力
 
 `ReferenceDocContent` 用于渲染“引用 N 篇资料作为参考”这类活动消息。组件基于 `ActivityLayout` 提供折叠外壳，并将文档数组交给 `ReferenceContent` 展示。
@@ -43,7 +45,7 @@
 
 <script setup lang="ts">
   import { ref } from 'vue';
-  import ReferenceDocContent from '@blueking/chat-x/src/components/chat-content/reference-doc-content/reference-doc-content.vue';
+  // ReferenceDocContent 未从包入口导出；文档站 demo 使用页面顶部相对路径
   import type { ReferenceDocumentContent } from '@blueking/chat-x';
 
   const collapsed = ref(false);

package/dist/mcp/generated/docs/simple-table.md

@@ -12,6 +12,8 @@ FlowAgent 节点详情中的轻量表格展示组件。 源码位置：src/compo
 
 # SimpleTable 简易表格
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+
 > **能力域**：Agent 能力
 
 `SimpleTable` 是 FlowAgent 节点详情中的轻量只读表格，用于展示参数名、参数值、插件输出定义等结构化信息。组件只根据 `columns` 和 `data` 渲染表格，不提供排序、筛选、分页或编辑能力。
@@ -41,7 +43,7 @@ FlowAgent 节点详情中的轻量表格展示组件。 源码位置：src/compo
 </template>
 
 <script setup lang="ts">
-  import SimpleTable from '@blueking/chat-x/src/components/chat-content/flow-agent-content/simple-table.vue';
+  // SimpleTable 未从包入口导出；文档站 demo 使用页面顶部相对路径
 
   const columns = [
     { key: 'key', label: '参数名' },

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

@@ -12,6 +12,10 @@
 <!-- FULL DOC -->
 
 # TextContent 文本内容
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [ContentRender](/components/rendering/content-render) / [MessageRender](/components/message/message-render) 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { TextContent } from '@blueking/chat-x'`。
 ## 源码事实
 
 - **源码位置**：`src/components/chat-content/text-content/text-content.vue`
@@ -45,7 +49,7 @@ div.ai-text-content
 </template>
 
 <script setup lang="ts">
-  import { TextContent } from '@blueking/chat-x';
+  // TextContent 未从包入口导出；文档站 demo 使用页面顶部相对路径
 </script>
 ```
 

package/dist/mcp/generated/docs/tool-btn.md

@@ -11,6 +11,10 @@
 <!-- FULL DOC -->
 
 # ToolBtn 工具按钮
+
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [MessageTools](/components/feedback/message-tools) 使用。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { ToolBtn } from '@blueking/chat-x'`。
 ## 源码事实
 
 - **源码位置**：`src/components/ai-buttons/tool-btn/tool-btn.vue`
@@ -117,7 +121,7 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 </template>
 
 <script setup lang="ts">
-  import { ToolBtn } from '@blueking/chat-x';
+  // ToolBtn 未从包入口导出；文档站 demo 使用页面顶部相对路径
   import type { IToolBtn } from '@blueking/chat-x';
 
   const handleClick = (data: IToolBtn & { active?: boolean; disabled?: boolean }, event: MouseEvent) => {
@@ -153,7 +157,7 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 
 <script setup lang="ts">
   import { ref } from 'vue';
-  import { ToolBtn } from '@blueking/chat-x';
+  // ToolBtn 未从包入口导出；文档站 demo 使用页面顶部相对路径
   import type { IToolBtn } from '@blueking/chat-x';
 
   const activeId = ref<string | null>(null);
@@ -212,7 +216,8 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 </template>
 
 <script setup lang="ts">
-  import { ToolBtn, DownloadIcon } from '@blueking/chat-x';
+  import { DownloadIcon } from '@blueking/chat-x';
+  // ToolBtn 未从包入口导出
 </script>
 ```
 
@@ -234,7 +239,8 @@ click 事件：disabled=true 时被 JS 拦截，不触发 emit
 </template>
 
 <script setup lang="ts">
-  import { ToolBtn, FullScreenIcon } from '@blueking/chat-x';
+  import { FullScreenIcon } from '@blueking/chat-x';
+  // ToolBtn 未从包入口导出
 
   const handleFullScreen = () => {
     // 进入全屏逻辑

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('这是一段 **加粗文本**。', {});