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

package/dist/mcp/generated/docs/flow-agent-content.md

@@ -13,6 +13,10 @@
 
 # FlowAgentContent FlowAgent 执行内容
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 业务请通过 [MessageRender](/components/message/message-render) 渲染 `role: 'activity'`（见本页「推荐入口」）。
+> 文档站 demo 使用相对路径引入源码；不要写 `import { FlowAgentContent } from '@blueking/chat-x'`。
+
 > **能力域**：Agent 能力
 
 渲染 FlowAgent（标准运维 / 流程编排）执行过程的活动组件，以「任务 → 节点」两级结构展示执行状态、耗时统计与详情入口。组件内部消费 `useCustomTabConsumer`，点击节点「详情」会向侧栏的自定义 Tab 注入 `FlowAgentNodeDetail` 渲染节点输入输出。
@@ -26,25 +30,29 @@
 
 ## 核心能力
 
-- **状态聚合统计**：汇总所有任务的 `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
 - **重试 / 跳过进行中态**：点击后节点行进入 `is-pending`，按钮组常驻显示（无需 hover）；进行中按钮切换为 loading +「重试中 / 跳过中」，重试与跳过互斥禁用；被阻塞按钮 hover 显示提示（如「任务正在重试中，不可跳过」）；详情不受影响。pending 以 `task_id:node_id:retry` 为键，后端 `retry` 计数变化后自动失效
 - **详情入口联动**：「详情」按钮点击后通过自定义 Tab 挂载 `FlowAgentNodeDetail`
 - **分享态只读查看**：`RenderMode.Share` 下保留耗时、「详情」「有效证据」等只读查看入口，仅隐藏「重试 / 跳过」等交互式 resume 操作
+- **侧栏执行情况面板只读**：侧栏「执行情况」Tab 内经 `ExecutionSummary` 渲染的同一组件同样只保留「详情」，不展示「重试 / 跳过」；面板身份由 `ExecutionSummary` 通过 `EXECUTION_PANEL_TOKEN` 提供，组件以 `useExecutionPanelInject` 读取。因此重试 / 跳过只出现在对话流内的执行情况
 
 ## 状态映射
 
-组件将后端原始 `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`                                                                         | 是   | 否          |
 
 ## 基础用法
 
@@ -61,8 +69,8 @@
 </template>
 
 <script setup lang="ts">
-  import { FlowAgentContent } from '@blueking/chat-x';
   import type { BkFlowMessageContent, OnInterruptResume } from '@blueking/chat-x';
+  // FlowAgentContent 未从包入口导出；文档站 demo 使用相对路径 FlowAgentContentComp
 
   const messageUid = 'flow-msg-1';
   const status = 'success';
@@ -94,7 +102,7 @@
 
 ## 失败节点重试 / 跳过
 
-失败节点（`convergedState === 'failed'`）且具备对应能力位时，hover 行尾展示「重试」或「跳过」按钮。点击后：
+失败节点（`convergedState === 'failed'`）且具备对应能力位时，在**对话流内**的执行情况 hover 行尾展示「重试」或「跳过」按钮（侧栏「执行情况」面板与 Share 分享态不展示，见下方显隐条件）。点击后：
 
 1. 节点行添加 `is-pending` class，按钮组常驻显示（设计稿：鼠标移出后仍可见进行中反馈）
 2. 被点击按钮进入 loading +「重试中 / 跳过中」，重试与跳过均禁用（`is-disabled`，置灰色 `#c4c6cc`）
@@ -125,11 +133,11 @@ onInterruptResume?.({
 
 | 按钮 | 显隐条件                              | 进行中表现                         | `operation`          |
 | ---- | ------------------------------------- | ---------------------------------- | ---------------------- |
-| 重试 | 失败态且 `node.retryable === true`    | loading +「重试中」，二者均禁用    | `flow_node_retry`      |
-| 跳过 | 失败态且 `node.skippable === true`    | loading +「跳过中」，二者均禁用    | `flow_node_skip`       |
-| 详情 | 始终展示（含 Share 分享态）           | 不受 pending 影响                  | —（打开侧栏 Tab，不走 resume） |
+| 重试 | 失败态且 `node.retryable === true`；且不在 Share 分享态、不在侧栏「执行情况」面板内 | loading +「重试中」，二者均禁用    | `flow_node_retry`      |
+| 跳过 | 失败态且 `node.skippable === true`；且不在 Share 分享态、不在侧栏「执行情况」面板内 | loading +「跳过中」，二者均禁用    | `flow_node_skip`       |
+| 详情 | 始终展示（含 Share 分享态与侧栏面板） | 不受 pending 影响                  | —（打开侧栏 Tab，不走 resume） |
 
-行尾操作由内部 composable [`useFlowNodeActions`](/composables/use-flow-node-actions) 聚合为声明式列表，组件层仅遍历渲染。
+行尾操作由内部 composable [`useFlowNodeActions`](/composables/use-flow-node-actions) 聚合为声明式列表，组件层仅遍历渲染；两类只读场景合并为它的 `hideResumeActions` 入参。
 
 ## 节点详情联动
 
@@ -140,7 +148,7 @@ addCustomTab?.({
   label: node.name,
   name: `${task.task_id}|${node.id}|${node.name}`,
   data: {
-    component: BkFlowNodeDetail,
+    component: FlowAgentNodeDetail,
     messageUid: props.messageUid,
     props: {
       loading: true,
@@ -162,7 +170,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（任务展开箭头）
@@ -176,9 +185,9 @@ ActivityLayout（activity-type=flow_agent，v-model:collapsed）
             └── node-trailing（含 Share 分享态）
                 ├── node-time（节点耗时，hover / pending 时隐藏）
                 └── node-actions（hover 或 `is-pending` 时显示，间距 12px）
-                    ├── node-action-btn「重试」（失败 + retryable；Share 态隐藏；进行中 loading + 禁用）
-                    ├── node-action-btn「跳过」（失败 + skippable；Share 态隐藏；进行中 loading + 禁用）
-                    └── node-action-btn「详情」（始终可用，含 Share 态，点击挂载详情 Tab）
+                    ├── node-action-btn「重试」（失败 + retryable；Share 态与侧栏面板隐藏；进行中 loading + 禁用）
+                    ├── node-action-btn「跳过」（失败 + skippable；Share 态与侧栏面板隐藏；进行中 loading + 禁用）
+                    └── node-action-btn「详情」（始终可用，含 Share 态与侧栏面板，点击挂载详情 Tab）
 ```
 
 ## API
@@ -187,14 +196,17 @@ ActivityLayout（activity-type=flow_agent，v-model:collapsed）
 
 | 属性名     | 类型                     | 必填 | 默认值      | 说明                                                                       |
 | ---------- | ------------------------ | ---- | ----------- | -------------------------------------------------------------------------- |
-| content    | `BkFlowMessageContent`   | 否   | `[{}]`      | 任务数组；传入单个 `BkFlowTask` 时自动包装为单元素数组                       |
+| content    | `BkFlowMessageContent`   | 否   | —           | 任务数组；传入单个 `BkFlowTask` 时自动包装为单元素数组                       |
+| collapsed  | `boolean`                | 否   | `false`     | `v-model:collapsed`，控制活动布局折叠                                       |
 | messageUid | `string`                 | 否   | —           | 所属消息唯一标识，注入到节点详情 Tab 的 `data.messageUid`，用于异步回填数据 |
 | onInterruptResume | `OnInterruptResume` | 否   | —           | 节点「重试 / 跳过」与第三方审批取消复用同一回调，按 `payload.operation` 分流；流程节点操作时不传 `interrupt` |
 | status     | `MessageStatus`          | 否   | —           | 消息状态；`pending` / `streaming` 时标题栏显示加载动画                       |
 
 ### Emits
 
-- 无。
+| 事件名 | 说明 |
+| --- | --- |
+| `update:collapsed` | `v-model:collapsed` 回写 |
 
 ### Slots
 
@@ -242,7 +254,7 @@ interface BkFlowNode {
 
 - `AiLoading` — 标题栏流式加载动画
 - `ActivityLayout` — 可折叠活动容器外壳
-- `BkFlowNodeDetail` — 节点详情面板（经自定义 Tab 挂载）
+- `FlowAgentNodeDetail` — 节点详情面板（经自定义 Tab 挂载）
 - `Loading`（bkui-vue） — 运行中状态的旋转指示
 - `HighlightKeyword` — 任务 / 节点名称的搜索关键词高亮
 
@@ -253,9 +265,11 @@ interface BkFlowNode {
 3. **任务总耗时为节点累加**：`task-time` 由各节点 `elapsed_time` 求和得到，并非任务级独立字段。
 4. **`task_outputs` 暂不渲染**：模板中任务输出展示区块已注释，传入也不会显示。
 5. **未知状态兜底为 `running`**：`getConvergedState` 对未识别的原始状态统一归为运行中。
-6. **Share 模式只读查看**：`RenderMode.Share` 下保留节点/任务耗时与「详情」「有效证据」查看入口，仅过滤「重试 / 跳过」等交互式 resume 操作（由 `useFlowNodeActions` 的 `hideResumeActions` 收敛）。
-7. **`onInterruptResume` 透传链路**：`MessageRender` → `ActivityMessage` → `FlowAgentContent`；未传入时重试 / 跳过按钮仍展示但点击无回调。
-8. **pending 自动收敛**：`useFlowNodeActions` 以 `task_id:node_id:retry` 为 pending 键；节点重试再次失败（`retry` +1）后键变化，进行中态自动解除，无需手动清理。
+6. **已终止整体覆盖**：判定只看任务 `task_state`（不扫节点）；叶子节点 `state === REVOKED` 使用已终止圆点；`REVOKED` 计入标题栏 / tooltip 统计，与叶子节点同色 `#F55B0E`。
+7. **Share 模式只读查看**：`RenderMode.Share` 下保留节点/任务耗时与「详情」「有效证据」查看入口，仅过滤「重试 / 跳过」等交互式 resume 操作（由 `useFlowNodeActions` 的 `hideResumeActions` 收敛）。
+8. **侧栏「执行情况」面板同为只读**：面板内经 `ExecutionSummary` → `MessageRender` 渲染的本组件不展示「重试 / 跳过」，只保留「详情」；判定来自 `useExecutionPanelInject()`（内部上下文，未从包入口导出；缺省 `false`），与 Share 态一起并入 `hideResumeActions`。因此脱离 `ExecutionSummary` 独立使用组件时，行为与对话流内一致。
+9. **`onInterruptResume` 透传链路**：`MessageRender` → `ActivityMessage` → `FlowAgentContent`；未传入时重试 / 跳过按钮仍展示但点击无回调。
+10. **pending 自动收敛**：`useFlowNodeActions` 以 `task_id:node_id:retry` 为 pending 键；节点重试再次失败（`retry` +1）后键变化，进行中态自动解除，无需手动清理。
 
 ## 关联组件
 

package/dist/mcp/generated/docs/flow-agent-node-detail.md

@@ -14,6 +14,9 @@
 
 # FlowAgentNodeDetail FlowAgent 节点详情
 
+> **导出状态**：内部实现，未从 `@blueking/chat-x` 包入口导出。
+> 由 [FlowAgentContent](/components/agent/flow-agent-content) 挂到自定义 Tab。
+
 > **能力域**：Agent 能力
 
 `FlowAgentNodeDetail` 用于展示 FlowAgent 单个节点的配置与输出详情。它通常被 `FlowAgentContent` 通过自定义 Tab 挂载到侧栏，应用层再根据 `messageUid`、`task_id`、`node_id` 拉取真实节点详情并回填到 `data`。
@@ -53,7 +56,7 @@
 </template>
 
 <script setup lang="ts">
-  import FlowAgentNodeDetail from '@blueking/chat-x/src/components/chat-content/flow-agent-content/flow-agent-node-detail.vue';
+  // FlowAgentNodeDetail 未从包入口导出；文档站 demo 使用页面顶部相对路径
   import type { NodeDetailData } from '@blueking/chat-x';
 
   const nodeDetailData: Partial<NodeDetailData> = {
@@ -127,7 +130,7 @@ addCustomTab?.({
   label: node.name,
   name: `${task.task_id}|${node.id}|${node.name}`,
   data: {
-    component: BkFlowNodeDetail,
+    component: FlowAgentNodeDetail,
     messageUid: props.messageUid,
     props: {
       loading: true,

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 = () => {
     // 进入全屏逻辑