@blueking/chat-x 0.0.45-beta.7 → 0.0.45-beta.8

package/dist/lang/lang.d.ts

@@ -43,8 +43,8 @@ export declare const lang: {
     readonly 失败: "Failed";
     readonly 挂起: "Pending";
     readonly 待执行: "To Be Executed";
-    readonly 跳过: "Skipped";
     readonly 详情: "Details";
+    readonly 重试: "Retry";
     readonly 节点: "Node";
     readonly 节点配置: "Node Config";
     readonly 节点输出: "Node Output";
@@ -69,6 +69,25 @@ export declare const lang: {
     readonly 暂无数据: "No Data";
     readonly '\u8C03\u7528 MCP\uFF1A': "Call MCP:";
     readonly 更多: "More";
+    readonly 算法方案评审单: "Algorithm Plan Review Ticket";
+    readonly 评审中: "Reviewing";
+    readonly 已废弃: "Abandoned";
+    readonly 已批准: "Approved";
+    readonly 已通过: "Approved";
+    readonly 已取消: "Cancelled";
+    readonly 已过期: "Expired";
+    readonly 已拒绝: "Rejected";
+    readonly 已撤销: "Revoked";
+    readonly 单据编号: "Ticket No.";
+    readonly 提交时间: "Submitted At";
+    readonly 当前处理人: "Current Handler";
+    readonly 无: "None";
+    readonly 查看单据详情: "View Ticket Detail";
+    readonly 复制单据: "Copy Ticket";
+    readonly 复制单据链接: "Copy Ticket Link";
+    readonly 取消审批: "Cancel Approval";
+    readonly '\u5F53\u524D\u4F1A\u8BDD\u6709 {count} \u4E2A\u5F85\u5BA1\u6279\u5355\uFF0C\u5982\u9700\u7EE7\u7EED\uFF0C\u8BF7\u5148\u53D6\u6D88\u5BA1\u6279': "There are {count} pending approval tickets in the current conversation. To continue, cancel approval first.";
+    readonly 暂不支持的中断消息: "Unsupported interrupt message";
     readonly 检索中: "Searching";
     readonly 检索完成: "Search Completed";
     readonly 上传文件: "Upload File";
@@ -100,5 +119,18 @@ export declare const lang: {
     readonly 有效证据: "Valid Evidence";
     readonly 全屏: "Full Screen";
     readonly 退出全屏: "Exit Full Screen";
+    readonly 请选择以继续: "Please choose to continue";
+    readonly 继续: "Continue";
+    readonly '\u6536\u5230\u4FE1\u606F\uFF1A': "Received: ";
+    readonly 待审批: "Pending";
+    readonly 已审批: "Approved";
+    readonly 完成: "Done";
+    readonly 跳过: "Skip";
+    readonly 单选: "Single";
+    readonly 多选: "Multiple";
+    readonly 其他: "Others";
+    readonly 回答内容: "Answers";
+    readonly 已回复: "Replied";
+    readonly '\u8BF7\u8F93\u5165...': "Please enter...";
 };
-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" | "Skipped" | "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" | "Full Screen" | "Exit Full Screen" | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "跳过" | "详情" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 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" | "Retry" | "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" | "Algorithm Plan Review Ticket" | "Reviewing" | "Abandoned" | "Approved" | "Cancelled" | "Expired" | "Rejected" | "Revoked" | "Ticket No." | "Submitted At" | "Current Handler" | "None" | "View Ticket Detail" | "Copy Ticket" | "Copy Ticket Link" | "Cancel Approval" | "There are {count} pending approval tickets in the current conversation. To continue, cancel approval first." | "Unsupported interrupt message" | "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" | "Full Screen" | "Exit Full Screen" | "Please choose to continue" | "Continue" | "Received: " | "Done" | "Skip" | "Single" | "Multiple" | "Others" | "Answers" | "Replied" | "Please enter..." | "发送" | "停止" | "问问小鲸" | "复制" | "分享" | "点赞" | "不满意" | "删除" | "引用" | "重新生成" | "重新生成将清空下文内容" | "提交" | "取消" | "预览内容" | "跳转详情" | "调用工具：" | "调用中" | "调用成功" | "调用失败" | "说出您的想法" | "什么原因让你满意？" | "什么原因让你不满意？" | "返回内容" | "编辑" | "深度思考" | "图片加载中..." | "图片加载失败" | "思考中" | "已思考完成" | "思考失败" | "复制成功" | "复制失败" | "返回底部" | "停止生成" | "正在停止" | "耗时" | "参数" | "描述" | "执行情况" | "执行中" | "成功" | "失败" | "挂起" | "待执行" | "详情" | "重试" | "节点" | "节点配置" | "节点输出" | "基础信息" | "流程模板" | "节点名称" | "步骤名称" | "执行方案" | "是否可选" | "失败处理" | "超时控制" | "是" | "否" | "输入参数" | "输出参数" | "参数名" | "参数值" | "名称" | "变量说明" | "结构化输出" | "手动跳过" | "暂无数据" | "调用 MCP：" | "更多" | "算法方案评审单" | "评审中" | "已废弃" | "已批准" | "已通过" | "已取消" | "已过期" | "已拒绝" | "已撤销" | "单据编号" | "提交时间" | "当前处理人" | "无" | "查看单据详情" | "复制单据" | "复制单据链接" | "取消审批" | "当前会话有 {count} 个待审批单，如需继续，请先取消审批" | "暂不支持的中断消息" | "检索中" | "检索完成" | "上传文件" | "请求中..." | "取消满意" | "取消不满意" | "确认删除该回答？" | "删除操作无法撤回，请谨慎操作！" | "预览" | "缩小" | "放大" | "旋转" | "下载" | "抱歉，图片加载失败，可尝试重新加载" | "重置" | "重新加载" | "宽" | "高" | "上传图片" | "搜索 关键字" | "选择日期" | "在对话中定位" | "全选" | "确定" | "上传图片, 最多支持上传 3 个, 最大支持 2.4MB" | "你好，我是小鲸" | "清空搜索" | "搜索结果为空" | "有效证据" | "全屏" | "退出全屏" | "请选择以继续" | "继续" | "收到信息：" | "待审批" | "已审批" | "完成" | "跳过" | "单选" | "多选" | "其他" | "回答内容" | "已回复" | "请输入...";

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

@@ -0,0 +1,138 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+活动消息的折叠布局容器，提供 title/default 插槽。 源码位置：src/components/chat-content/activity-layout/activity-layout.vue。
+
+### 关联组件
+- **activity-message** — 活动消息通过本组件承载标题栏与内容区
+- **knowledge-rag-content** — 知识召回活动复用本组件展示加载标题与正文
+- **reference-doc-content** — 引用文档活动复用本组件展示文档数量与引用列表
+- **flow-agent-content** — FlowAgent 活动复用本组件，但隐藏默认折叠箭头
+
+---
+<!-- FULL DOC -->
+
+# ActivityLayout 活动布局
+
+> **能力域**：辅助能力
+
+`ActivityLayout` 是活动消息的通用折叠布局容器，负责渲染标题栏、折叠箭头和内容区域。它不关心活动内容类型本身，标题和正文均通过插槽传入，因此常被 `KnowledgeRagContent`、`ReferenceDocContent`、`FlowAgentContent` 等活动组件复用。
+
+通常不需要业务侧直接使用；如果要新增一种活动消息内容，可以用它作为标题/内容外壳。
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-content/activity-layout/activity-layout.vue`
+- **能力说明**：活动消息的折叠布局容器，提供 `title` / `default` 插槽。
+
+## 核心能力
+
+- **标题栏点击折叠**：点击标题栏切换 `collapsed`，内容区通过 `v-show="!collapsed"` 显示或隐藏
+- **双向绑定**：通过 `v-model:collapsed` 让父组件控制展开/收起状态，默认展开
+- **标题插槽透传状态**：`title` 插槽会收到 `{ collapsed }`，可根据折叠状态调整标题内容
+- **默认折叠箭头**：非 FlowAgent 活动自动在标题右侧显示折叠箭头
+- **FlowAgent 特例**：`activityType === MessageContentType.FlowAgent` 时隐藏默认折叠箭头，由 FlowAgent 自己渲染标题交互
+
+## 基础用法
+
+```vue
+<template>
+  <ActivityLayout v-model:collapsed="collapsed">
+    <template #title="{ collapsed }">
+      <span class="ai-activity-message-title-icon">
+        <DocumentIcon style="font-size: 12px" />
+      </span>
+      <span class="ai-activity-message-title-text">
+        {{ collapsed ? '已折叠' : '引用 2 篇资料作为参考' }}
+      </span>
+    </template>
+
+    <div style="padding: 0 14px;">
+      活动内容
+    </div>
+  </ActivityLayout>
+</template>
+
+<script setup lang="ts">
+  import { ref } from 'vue';
+  import ActivityLayout from '@blueking/chat-x/src/components/chat-content/activity-layout/activity-layout.vue';
+  import { DocumentIcon } from '@blueking/chat-x/src/icons/content';
+
+  const collapsed = ref(false);
+</script>
+```
+
+**渲染效果**
+
+## 折叠状态
+
+`collapsed` 默认为 `false`。设置为 `true` 时只展示标题栏，正文内容保留在 DOM 中但通过 `v-show` 隐藏。
+
+## FlowAgent 活动
+
+传入 `activityType="flow_agent"` 时，`ActivityLayout` 不渲染右侧默认折叠箭头。该场景下标题栏通常由 `FlowAgentContent` 自己展示状态统计、加载图标和展开箭头。
+
+```vue
+<ActivityLayout
+  v-model:collapsed="collapsed"
+  :activity-type="MessageContentType.FlowAgent"
+>
+  <template #title>
+    <span>执行情况: 成功 2 / 失败 1</span>
+  </template>
+  <div>FlowAgent 节点列表</div>
+</ActivityLayout>
+```
+
+## 组件结构
+
+```
+.ai-activity-message
+├── .ai-activity-message-title（点击切换 collapsed）
+│   ├── title slot（slot props: { collapsed }）
+│   └── CollapsedIcon（activityType !== flow_agent 时显示）
+└── .ai-activity-message-content（v-show="!collapsed"）
+    └── default slot
+```
+
+## API
+
+### Props
+
+| 属性名       | 类型                 | 必填 | 默认值 | 说明                                          |
+| ------------ | -------------------- | ---- | ------ | --------------------------------------------- |
+| activityType | `MessageContentType` | 否   | —      | 活动类型；为 `flow_agent` 时隐藏默认折叠箭头 |
+
+### Models
+
+| 名称      | 类型      | 默认值  | 说明             |
+| --------- | --------- | ------- | ---------------- |
+| collapsed | `boolean` | `false` | 活动内容是否折叠 |
+
+### Emits
+
+- 无显式 emits；`v-model:collapsed` 会产生 `update:collapsed`。
+
+### Slots
+
+| 插槽名  | 参数                    | 说明       |
+| ------- | ----------------------- | ---------- |
+| title   | `{ collapsed: boolean }` | 标题栏内容 |
+| default | —                       | 活动正文   |
+
+### Expose
+
+- 无。
+
+## 使用建议
+
+- 适合作为活动消息内部布局外壳，不建议替代通用卡片、面板或页面 Section。
+- 标题栏点击区域会整体触发折叠，标题插槽内如有按钮或链接，需要自行处理事件冒泡。
+- `default` 内容使用 `v-show` 控制可见性，折叠时不会卸载内部组件。
+
+## 关联组件
+
+- [ActivityMessage](../message/activity-message.md) — 活动消息分发入口。
+- [KnowledgeRagContent](../agent/knowledge-rag-content.md) — 知识召回活动。
+- [ReferenceDocContent](../agent/reference-doc-content.md) — 引用文档活动。
+- [FlowAgentContent](../agent/flow-agent-content.md) — FlowAgent 执行活动。

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-ActivityMessage 展示活动类消息：知识检索（knowledge_rag）、引用文档列表、FlowAgent 执行（activityType 区分），标题可折叠。 content 结构随模式变化。由 MessageRender 在 activity 角色下渲染，用于 RAG/引用/流程执行过程可视化。
+按 activityType 分发 FlowAgent、知识召回、引用文档等活动内容。 源码位置：src/components/chat-message/activity-message/activity-message.vue。
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 activity 时创建
@@ -11,12 +11,19 @@ ActivityMessage 展示活动类消息：知识检索（knowledge_rag）、引用
 <!-- FULL DOC -->
 
 # ActivityMessage 活动消息
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：消息展示
+- **源码位置**：`src/components/chat-message/activity-message/activity-message.vue`
+- **能力域**：消息系统
+- **能力说明**：按 activityType 分发 FlowAgent、知识召回、引用文档等活动内容。
+
+> **能力域**：消息系统
 
 活动消息组件，用于展示 AI 的知识检索（Knowledge RAG）过程、参考文档引用列表和 FlowAgent 流程执行情况。通过 `activityType` 切换三种工作模式，点击标题栏可折叠/展开内容区域。
 
-组件会将父级传入消息上的 **`uid`** 以 **`message-uid`** 形式透传给各活动子组件（`FlowAgentContent` / `KnowledgeRagContent` / `ReferenceDocContent`），用于侧栏自定义 Tab、`addCustomTab` 的 `data.messageUid` 与主对话区「在对话中定位」联动（详见 [ChatContainer](./chat-container.md)）。
+组件会将父级传入消息上的 **`uid`** 以 **`message-uid`** 形式透传给各活动子组件（`FlowAgentContent` / `KnowledgeRagContent` / `ReferenceDocContent`），用于侧栏自定义 Tab、`addCustomTab` 的 `data.messageUid` 与主对话区「在对话中定位」联动（详见 [ChatContainer](/components/setup/chat-container)）。
+
+`onInterruptResume` 仅由 `FlowAgentContent` 消费（失败节点「重试 / 跳过」），由 `MessageRender` 从 `ChatContainer` 透传；知识检索、引用文档等活动子组件忽略该 prop。
 
 ## 三种工作模式
 
@@ -160,7 +167,8 @@ 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 时出现「详情」按钮
+- **节点列表**：每个节点显示状态圆点、名称和耗时；hover 时出现行尾操作按钮组
+- **失败节点操作**：失败且 `retryable` / `skippable` 为 `true` 的节点，hover 时额外展示「重试」「跳过」按钮，点击后通过 `onInterruptResume` 回传 Agent（不传 `interrupt`）
 - **节点详情**：点击「详情」会通过 `useCustomTabConsumer` 在 `ChatContainer` 侧边栏新增自定义 Tab，展示节点配置（基础信息、输入参数、输出参数）
 
 > `FlowAgentContent` 会读取 `ChatContainer` 注入的 `renderMode`。当 `renderMode === RenderMode.Share` 时，任务行不展示总耗时与「有效证据」，节点列表不展示耗时与「详情」按钮，避免分享预览中出现可交互入口。独立使用 `ActivityMessage` 且没有上层 Provider 时，默认按 `Chat` 模式渲染。
@@ -184,7 +192,10 @@ FlowAgentContent（activityType = 'flow_agent'）
                 ├── 状态圆点（颜色对应状态）
                 ├── node.name（HighlightKeyword 支持搜索高亮）
                 ├── node.elapsed_time
-                └── 详情按钮（hover 显示）→ 打开节点详情 Tab
+                └── 行尾操作按钮组（hover 显示）
+                    ├── 重试（失败 + retryable）→ onInterruptResume
+                    ├── 跳过（失败 + skippable）→ onInterruptResume
+                    └── 详情 → 打开节点详情 Tab
 ```
 
 ### 用法示例
@@ -340,7 +351,9 @@ type BkFlowNode = {
   loop: number;
   name: string;
   retry: number;
+  retryable?: boolean;
   skip: boolean;
+  skippable?: boolean;
   start_time: string;
   state: string;
   type: string;
@@ -404,6 +417,7 @@ enum MessageContentType {
 | status       | `MessageStatus`                                                             | -      | 消息状态；在 `knowledge_rag` 模式下影响标题和图标，在 `flow_agent` 模式下影响标题 Loading 状态 |
 | id           | `string \| number`                                                          | -      | 消息 ID                                                   |
 | messageId    | `string \| number`                                                          | -      | 消息唯一标识                                              |
+| onInterruptResume | `OnInterruptResume`                                                    | -      | 仅 `flow_agent` 子组件消费；失败节点「重试 / 跳过」回调，由 `MessageRender` 透传 |
 
 ### v-model
 
@@ -448,5 +462,5 @@ enum MessageContentType {
 
 ## 关联组件
 
-- [MessageRender](./message-render.md) — activity 角色由其实例化
-- [AssistantMessage](./assistant-message.md) — 常与助手主回复配合出现
+- [MessageRender](/components/message/message-render) — activity 角色由其实例化
+- [AssistantMessage](/components/message/assistant-message) — 常与助手主回复配合出现

package/dist/mcp/generated/docs/ai-image.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-AiImage 负责缩略图展示，并处理加载中、失败重试与懒加载；无 ImagePreviewGroup 上下文时可内嵌 ImagePreview 做全屏预览。 在 Group 内通过 inject 注册子图，点击时参与多图集合预览；支持自定义下载与 preview 事件。 与 ImagePreview、ImagePreviewGroup 共同构成对话内图片展示与预览链路。
+图片展示组件，组合加载、错误、预览和 extra 插槽。 源码位置：src/components/image-preview/image.vue。
 
 ### 关联组件
 - **image-preview** — 独立模式下内嵌全屏预览，单图预览入口
@@ -11,8 +11,13 @@ AiImage 负责缩略图展示，并处理加载中、失败重试与懒加载；
 <!-- FULL DOC -->
 
 # AiImage 图片展示
+## 源码事实
 
-> **层级**：原子组件 · **功能域**：文件与图片
+- **源码位置**：`src/components/image-preview/image.vue`
+- **能力域**：媒体文件
+- **能力说明**：图片展示组件，组合加载、错误、预览和 extra 插槽。
+
+> **能力域**：媒体文件
 
 图片展示组件，支持加载状态、加载失败重试、懒加载、点击预览等功能。可独立使用（单图预览），也可配合 `ImagePreviewGroup` 实现多图预览。
 
@@ -223,5 +228,5 @@ interface ImagePreviewConfig {
 
 ## 关联组件
 
-- [ImagePreview](../molecular/image-preview.md) — 独立模式下的全屏预览
-- [ImagePreviewGroup](../molecular/image-preview-group.md) — 多图注册与预览上下文
+- [ImagePreview](/components/medias/image-preview) — 独立模式下的全屏预览
+- [ImagePreviewGroup](/components/medias/image-preview-group) — 多图注册与预览上下文

package/dist/mcp/generated/docs/ai-loading.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-AiLoading 使用纯 CSS/SVG 动画（旋转环与脉冲星形）展示加载中，不依赖 bkui Loading。 多实例时需用 cloneVNode 等为渐变 id 加前缀避免冲突；支持 stopLoading 暂停动画。
+小尺寸 AI 加载动效。 源码位置：src/components/ai-loading/ai-loading.vue。
 
 ### 关联组件
 - **loading-message** — 列表末尾加载占位
@@ -12,10 +12,15 @@ AiLoading 使用纯 CSS/SVG 动画（旋转环与脉冲星形）展示加载中
 <!-- FULL DOC -->
 
 # AiLoading AI 加载动画
+## 源码事实
 
-> **层级**：原子组件 · **功能域**：辅助组件
+- **源码位置**：`src/components/ai-loading/ai-loading.vue`
+- **能力域**：辅助能力
+- **能力说明**：小尺寸 AI 加载动效。
 
-AI 加载动画原子组件。由两层 SVG 叠加构成：外层旋转光环（带渐变弧线）+ 内层脉冲星形图标，两者共用同一套蓝→紫→粉渐变色。
+> **能力域**：辅助能力
+
+AI 加载动画基础组件。由两层 SVG 叠加构成：外层旋转光环（带渐变弧线）+ 内层脉冲星形图标，两者共用同一套蓝→紫→粉渐变色。
 
 ## 组件结构
 
@@ -124,6 +129,6 @@ ai-loading-star-{instanceId}
 
 ## 关联组件
 
-- [LoadingMessage](../molecular/loading-message.md) — 对话加载消息
-- [ReasoningMessage](../molecular/reasoning-message.md) — 推理加载态
-- [ActivityMessage](../molecular/activity-message.md) — 活动加载态
+- [LoadingMessage](/components/message/loading-message) — 对话加载消息
+- [ReasoningMessage](/components/message/reasoning-message) — 推理加载态
+- [ActivityMessage](/components/message/activity-message) — 活动加载态

package/dist/mcp/generated/docs/ai-prompt-list.md

@@ -0,0 +1,42 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+/ Prompt 选择列表，供 AiSlashInput 插入模板文本。 源码位置：src/components/chat-input/ai-slash-input/ai-prompt-list/ai-prompt-list.vue。
+
+---
+<!-- FULL DOC -->
+
+# AiPromptList Prompt 列表
+
+> **能力域**：输入交互
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-input/ai-slash-input/ai-prompt-list/ai-prompt-list.vue`
+- **能力说明**：/ Prompt 选择列表，供 AiSlashInput 插入模板文本。
+
+## API 摘要
+
+### Props
+
+- `{ onSelect: (prompt: string) =`
+
+### Emits
+
+- 无。
+
+### Slots
+
+- 无。
+
+### Expose
+
+- 无。
+
+## 组件依赖
+
+- 无组件依赖或仅依赖基础库。
+
+## 使用建议
+
+- 优先通过上层组合组件使用；直接使用前请确认 props 数据结构来自对应类型定义。

package/dist/mcp/generated/docs/ai-selection.md

@@ -1,18 +1,23 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-AiSelection 在 document 级监听文本选区，在选区附近弹出快捷操作菜单；每页建议只挂载一个实例。 通过 shortcuts、maxShortcutCount、offset 等配置菜单内容与布局，支持完全自定义 default 插槽与 Shadow DOM 场景。 常与 ChatInput 或业务侧联动，将选中文本作为追问上下文。
+监听选中文本并展示快捷操作浮窗。 源码位置：src/components/ai-selection/ai-selection.vue。
 
 ### 关联组件
-- **shortcut-btn** — 弹窗内快捷指令按钮/菜单项由该原子组件渲染
+- **shortcut-btn** — 弹窗内快捷指令按钮/菜单项由该基础组件渲染
 - **chat-input** — 划词结果常回填或触发与输入框联动的快捷指令
 
 ---
 <!-- FULL DOC -->
 
 # AiSelection AI 划词选择弹窗
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：输入交互
+- **源码位置**：`src/components/ai-selection/ai-selection.vue`
+- **能力域**：输入交互
+- **能力说明**：监听选中文本并展示快捷操作浮窗。
+
+> **能力域**：输入交互
 
 AI 划词选择组件，监听用户在页面中的文本选区，在选区附近弹出快捷操作菜单。支持自定义快捷指令列表、数量限制、垂直偏移以及完全自定义插槽内容。
 
@@ -432,5 +437,5 @@ interface Shortcut {
 
 ## 关联组件
 
-- [ShortcutBtn](../atomic/shortcut-btn.md) — 弹窗内快捷指令按钮单元
-- [ChatInput](./chat-input.md) — 选区文本常回填到聊天输入框
+- [ShortcutBtn](/components/input/shortcut-btn) — 弹窗内快捷指令按钮单元
+- [ChatInput](/components/input/chat-input) — 选区文本常回填到聊天输入框

package/dist/mcp/generated/docs/ai-slash-editor.md

@@ -0,0 +1,43 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+旧版富文本编辑器实现，封装 command selection 与提示菜单。 源码位置：src/components/chat-input/ai-slash-editor/ai-slash-editor.vue。
+
+---
+<!-- FULL DOC -->
+
+# AiSlashEditor 富文本编辑器
+
+> **能力域**：输入交互
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-input/ai-slash-editor/ai-slash-editor.vue`
+- **能力说明**：旧版富文本编辑器实现，封装 command selection 与提示菜单。
+
+## API 摘要
+
+### Props
+
+- `{ disabled?: boolean; modelValue?: string; placeholder?: string; prompts?: string[]; }`
+
+### Emits
+
+- `{ (e: 'update:modelValue', value: string): void; (e: 'focus'): void; (e: 'keydown', event: IKeyboardEvent): void; (e: 'layoutChange', layoutInfo: monacoEditor.EditorLayoutInfo): void; }`
+
+### Slots
+
+- 无。
+
+### Expose
+
+- `{ get editor(`
+
+## 组件依赖
+
+- `AiPromptList`
+- `AiSlashMenu`
+
+## 使用建议
+
+- 优先通过上层组合组件使用；直接使用前请确认 props 数据结构来自对应类型定义。

package/dist/mcp/generated/docs/ai-slash-input.md

@@ -0,0 +1,43 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+ChatInput 内部富文本输入，支持 / Prompt 与 @ 资源标签。 源码位置：src/components/chat-input/ai-slash-input/ai-slash-input.vue。
+
+---
+<!-- FULL DOC -->
+
+# AiSlashInput 富文本命令输入
+
+> **能力域**：输入交互
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-input/ai-slash-input/ai-slash-input.vue`
+- **能力说明**：ChatInput 内部富文本输入，支持 / Prompt 与 @ 资源标签。
+
+## API 摘要
+
+### Props
+
+- `{ modelValue: string | TagSchema; placeholder?: string; prompts?: string[]; resources?: IAiSlashMenuItem[]; }`
+
+### Emits
+
+- `{ (e: 'update:modelValue', value: TagSchema, selectedResourceList: IAiSlashMenuItem[]): void; (e: 'keydown', event: KeyboardEvent & KeyboardPayload): void; (e: 'upload', files: File[]): void; }`
+
+### Slots
+
+- 无。
+
+### Expose
+
+- `{ cleanup: (`
+
+## 组件依赖
+
+- `AiPromptList`
+- `AiSlashMenu`
+
+## 使用建议
+
+- 优先通过上层组合组件使用；直接使用前请确认 props 数据结构来自对应类型定义。

package/dist/mcp/generated/docs/ai-slash-menu.md

@@ -0,0 +1,42 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+@ 资源选择菜单，展示资源项供 AiSlashInput 插入标签。 源码位置：src/components/chat-input/ai-slash-input/ai-slash-menu/ai-slash-menu.vue。
+
+---
+<!-- FULL DOC -->
+
+# AiSlashMenu 资源菜单
+
+> **能力域**：输入交互
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-input/ai-slash-input/ai-slash-menu/ai-slash-menu.vue`
+- **能力说明**：@ 资源选择菜单，展示资源项供 AiSlashInput 插入标签。
+
+## API 摘要
+
+### Props
+
+- `{ onSelect: (item: IAiSlashMenuItem) =`
+
+### Emits
+
+- 无。
+
+### Slots
+
+- 无。
+
+### Expose
+
+- 无。
+
+## 组件依赖
+
+- 无组件依赖或仅依赖基础库。
+
+## 使用建议
+
+- 优先通过上层组合组件使用；直接使用前请确认 props 数据结构来自对应类型定义。

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-AnimationText 将文本拆成 chunk 并以淡入 keyframes 逐段显示，适合短文案一次性展示。 props.text 仅在挂载时参与动画；持续流式场景应直接使用 useAnimationText 或自行 watch Ref。 与 Markdown 流式渐显等场景可组合使用。
+按文本增量播放流式动画。 源码位置：src/components/animation-text/animation-text.vue。
 
 ### 关联组件
 - **use-animation-text** — 提供 chunk 拆分与 animationStyle 的 composable
@@ -11,10 +11,15 @@ AnimationText 将文本拆成 chunk 并以淡入 keyframes 逐段显示，适合
 <!-- FULL DOC -->
 
 # AnimationText 动画文本
+## 源码事实
 
-> **层级**：原子组件 · **功能域**：内容渲染
+- **源码位置**：`src/components/animation-text/animation-text.vue`
+- **能力域**：内容渲染
+- **能力说明**：按文本增量播放流式动画。
 
-动画文本原子组件，将文本以**淡入（fade-in）**方式渐显。内部由 `useAnimationText` composable 驱动，核心能力是将增量文本拆分为独立 chunk，每个 chunk 单独触发一次淡入动画，适用于流式文本的逐段渐显效果。
+> **能力域**：内容渲染
+
+动画文本基础组件，将文本以**淡入（fade-in）**方式渐显。内部由 `useAnimationText` composable 驱动，核心能力是将增量文本拆分为独立 chunk，每个 chunk 单独触发一次淡入动画，适用于流式文本的逐段渐显效果。
 
 ## 组件结构
 
@@ -196,4 +201,4 @@ interface AnimationConfig {
 ## 关联组件
 
 - [useAnimationText](../../composables/use-animation-text.md) — chunk 与动画样式逻辑
-- [MarkdownContent](./markdown-content.md) — 流式正文渲染时可配合渐显
+- [MarkdownContent](/components/rendering/markdown-content) — 流式正文渲染时可配合渐显

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-AssistantMessage 渲染 AI 助手回复：正文由 ContentRender（可被默认插槽替换）与 ToolCallRender 展示工具调用及 MCP 标记。 toolCalls[].toolMessage 可内联工具执行结果。用于 MessageRender 分发的 assistant 角色，流式场景配合 streaming 状态更新。
+渲染助手消息主体、工具调用与文件内容，默认插槽可覆盖正文渲染。 源码位置：src/components/chat-message/assistant-message/assistant-message.vue。
 
 ### 关联组件
 - **message-render** — 由 MessageRender 在 role 为 assistant 时创建
@@ -12,8 +12,13 @@ AssistantMessage 渲染 AI 助手回复：正文由 ContentRender（可被默认
 <!-- FULL DOC -->
 
 # AssistantMessage AI 助手消息
+## 源码事实
 
-> **层级**：分子组件 · **功能域**：消息展示
+- **源码位置**：`src/components/chat-message/assistant-message/assistant-message.vue`
+- **能力域**：消息系统
+- **能力说明**：渲染助手消息主体、工具调用与文件内容，默认插槽可覆盖正文渲染。
+
+> **能力域**：消息系统
 
 AI 助手消息展示组件，负责渲染 AI 回复的文本内容和工具调用（Tool Calls）结果。
 
@@ -419,6 +424,6 @@ interface ToolMessage extends BaseMessage<MessageRole.Tool, string> {
 
 ## 关联组件
 
-- [MessageRender](./message-render.md) — assistant 角色由其实例化
-- [ToolMessage](./tool-message.md) — 工具执行结果可通过 toolCall.toolMessage 内联
-- [ToolcallRender](./toolcall-render.md) — 工具调用列表渲染
+- [MessageRender](/components/message/message-render) — assistant 角色由其实例化
+- [ToolMessage](/components/message/tool-message) — 工具执行结果可通过 toolCall.toolMessage 内联
+- [ToolcallRender](/components/agent/toolcall-render) — 工具调用列表渲染