@blueking/chat-x 0.0.51-beta.5 → 0.0.52-dev.1

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

@@ -0,0 +1,78 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+CollapsibleContent 用 ResizeObserver 持续测量插槽真实高度，超过 maxHeight（默认 200px）才折叠并显示切换按钮； 折叠通过外层 max-height + overflow hidden 实现，展开态可由 v-model:expanded 受控，便于「全部展开」这类批量操作。 源码位置：src/components/chat-content/collapsible-content/collapsible-content.vue。
+
+### 关联组件
+- **user-message** — 用户消息正文超过 200px 时折叠
+- **activity-layout** — 活动消息的另一种折叠布局
+
+---
+<!-- FULL DOC -->
+
+# CollapsibleContent 折叠内容
+
+> **能力域**：内容渲染
+
+## 源码事实
+
+- **源码位置**：`src/components/chat-content/collapsible-content/collapsible-content.vue`
+- **能力说明**：默认插槽内容高度超过 `maxHeight` 时折叠，并在下方渲染「显示更多 / 收起」；未超出时**不渲染**切换按钮。
+- **切换按钮配色**：默认 `$color-text-secondary`（#979ba5），hover 转 `$color-text`（#4d4f56），箭头图标随展开态旋转。
+
+## 实现要点
+
+- **高度测量与折叠分离**：折叠由外层 `max-height` + `overflow: hidden` 实现，真实高度始终从内层测量容器读取，因此折叠状态不会污染测量结果。
+- **持续跟踪高度**：内容可能因为图片加载、流式追加或窗口缩放而变高，用 `ResizeObserver` 持续观测而非只测一次；`ResizeObserver` 不可用时不折叠（降级为完整展示）。
+- **展开态可受控**：`v-model:expanded` 允许外部驱动，便于实现「全部展开」；不绑定时组件内部自持。
+
+## 用法
+
+::: info 内部组件
+本组件不在包入口导出，由消息组件内部使用。
+:::
+
+```vue
+<template>
+  <CollapsibleContent :max-height="200">
+    <TextContent :content="content" />
+  </CollapsibleContent>
+
+  <!-- 外部受控展开态 -->
+  <CollapsibleContent v-model:expanded="allExpanded" :max-height="120">
+    <MarkdownContent :content="content" />
+  </CollapsibleContent>
+</template>
+```
+
+**渲染效果**（阈值 120px，可用按钮切换展开态）
+
+## API
+
+### Props
+
+| 属性名    | 类型     | 默认值 | 必填 | 说明                                           |
+| --------- | -------- | ------ | ---- | ---------------------------------------------- |
+| maxHeight | `number` | `200`  | -    | 折叠态下内容区最大高度（px），超出才出现按钮   |
+| expanded  | `boolean` | `false` | -   | 展开态，支持 `v-model:expanded`                |
+
+### Emits
+
+| 事件名          | 参数                | 触发时机           |
+| --------------- | ------------------- | ------------------ |
+| update:expanded | `(value: boolean)`  | 点击切换按钮       |
+
+### Slots
+
+| 插槽名  | 说明             |
+| ------- | ---------------- |
+| default | 被折叠的内容     |
+
+## 使用方
+
+[UserMessage](/components/message/user-message) 用它把用户消息正文限制在 `CONST_USER_MESSAGE_MAX_HEIGHT`（200px）以内。
+
+## 关联组件
+
+- [UserMessage](/components/message/user-message) — 用户消息正文折叠
+- [ActivityLayout](/components/helper/activity-layout) — 活动消息的折叠布局

package/dist/mcp/generated/docs/constants.md

@@ -227,8 +227,7 @@ const SELECTION_Z_INDEX = 10003;
 ```typescript
 const CONST_MESSAGE_TOOLS: IToolBtn[] = [
   { id: 'copy', name: '复制', description: '复制' },
-  { id: 'cite', name: '引用', description: '引用' },
-  { id: 'rebuild', name: '重新生成', description: '重新生成' },
+  { id: 'rebuild', name: '重新生成', description: '重新生成将清空下文内容' },
   { id: 'share', name: '分享', description: '分享' },
 ];
 ```
@@ -240,12 +239,21 @@ const CONST_MESSAGE_TOOLS: IToolBtn[] = [
 ```typescript
 const CONST_USER_MESSAGE_TOOLS: IToolBtn[] = [
   { id: 'copy', name: '复制', description: '复制' },
-  { id: 'cite', name: '引用', description: '引用' },
   { id: 'edit', name: '编辑', description: '编辑' },
   { id: 'delete', name: '删除', description: '删除' },
 ];
 ```
 
+> `cite`（引用）已从两份列表移除，后续不再支持。
+
+### CONST_USER_MESSAGE_MAX_HEIGHT
+
+用户消息正文的折叠阈值（px），超出后由 [CollapsibleContent](/components/rendering/collapsible-content) 折叠并展示「显示更多」：
+
+```typescript
+const CONST_USER_MESSAGE_MAX_HEIGHT = 200;
+```
+
 ### CONST_UPDATE_TOOLS
 
 更新工具按钮列表（点赞/不满意）：
@@ -268,6 +276,27 @@ const CONST_UPDATE_TOOLS: IToolBtn[] = [
 const DEFAULT_SHORTCUTS: Shortcut[] = [{ id: 'ask-whale', name: '问问小鲸' }];
 ```
 
+## 上传常量
+
+与 [ChatInput 文件上传](/components/input/chat-input#file-upload) 共用。完整扩展名列表见源码 `src/utils/upload-accept.ts`。
+
+```typescript
+const ALLOWED_UPLOAD_EXTENSIONS = {
+  image: ['.gif', '.jpeg', '.jpg', '.png', '.webp'],
+  document: ['.doc', '.docx', '.ppt', '.pptx', '.xls', '.xlsx', '.pdf' /* ... */],
+  text: ['.txt', '.md', '.json' /* ... */],
+  code: ['.py', '.js', '.ts', '.vue' /* ... */],
+};
+
+/** 「文件」项 / 拖拽 / 粘贴的默认 accept，以及入队校验默认值 */
+const DEFAULT_UPLOAD_ACCEPT = Object.values(ALLOWED_UPLOAD_EXTENSIONS).flat().join(',');
+```
+
+| 常量 | 说明 |
+| ---- | ---- |
+| `ALLOWED_UPLOAD_EXTENSIONS` | 默认允许的扩展名分类（含点）；分类用于 tooltip 展示 |
+| `DEFAULT_UPLOAD_ACCEPT` | `ChatInput.accept` 缺省值 |
+
 ## 使用示例
 
 ```typescript
@@ -280,6 +309,7 @@ import {
   CHAT_Z_INDEX,
   CONST_MESSAGE_TOOLS,
   DEFAULT_SHORTCUTS,
+  DEFAULT_UPLOAD_ACCEPT,
 } from '@blueking/chat-x';
 
 // 创建消息
@@ -301,6 +331,9 @@ console.log(
   '可用工具:',
   CONST_MESSAGE_TOOLS.map(t => t.name),
 );
+
+// 上传：「文件」项 / 拖拽 / 粘贴用 DEFAULT_UPLOAD_ACCEPT（已含图片扩展名）
+const filePickerAccept = DEFAULT_UPLOAD_ACCEPT;
 ```
 
 ## 关联组件

package/dist/mcp/generated/docs/execution-summary.md

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-按消息流提取执行摘要，支持关键词定位和消息渲染。 通过 useExecutionPanelProvider 提供 EXECUTION_PANEL_TOKEN，面板内消息按只读呈现， FlowAgent 失败节点在面板内不展示重试/跳过，只保留详情。 源码位置：src/components/execution-summary/execution-summary.vue。
+按消息流提取执行摘要，支持关键词定位和消息渲染。 源码位置：src/components/execution-summary/execution-summary.vue。
 
 ### 关联组件
 - **message-render** — 摘要列表内渲染消息内容
@@ -30,7 +30,6 @@
 - **关键词搜索**：实时过滤匹配的执行记录
 - **对话定位**：hover 显示「在对话中定位」按钮，点击滚动到对应消息
 - **空状态处理**：无数据或搜索无结果时显示空状态提示
-- **面板上下文（只读呈现）**：组件 setup 时通过 `useExecutionPanelProvider()` 提供 `EXECUTION_PANEL_TOKEN`，供内部消息组件识别「当前处于侧栏面板内」并隐藏交互操作。目前 `FlowAgentContent` 据此不展示节点「重试 / 跳过」，只保留「详情」
 
 ## 基础用法
 
@@ -94,27 +93,6 @@ ai-execution-summary
 />
 ```
 
-## 面板内的消息按只读呈现
-
-面板与对话流复用同一套渲染链路（`MessageRender` → `ContentRender` → 具体内容组件），但面板定位是「回看执行过程」，不承载操作。为此组件在 setup 阶段 provide 面板上下文：
-
-```typescript
-// 源码：src/composables/use-common.ts（内部上下文，未从包入口导出）
-import { useExecutionPanelProvider } from '../../composables/use-common';
-
-// 面板身份在组件树中恒定，provide 常量 true 即可，无需响应式
-useExecutionPanelProvider();
-```
-
-内容组件用 `useExecutionPanelInject()` 读取（缺省 `false`，即对话流内）。当前的差异：
-
-| 内容 | 对话流内 | 侧栏「执行情况」面板内 |
-| ---- | -------- | ---------------------- |
-| FlowAgent 失败节点「重试 / 跳过」 | 展示（依赖 `retryable` / `skippable`） | **不展示** |
-| FlowAgent 节点「详情」 | 展示 | 展示 |
-
-新增内容组件若也需要区分这两种场景，同样注入 `useExecutionPanelInject()` 即可，不必扩展 props。`EXECUTION_PANEL_TOKEN` 与这两个函数同属 `use-common.ts` 的内部上下文，未从 `@blueking/chat-x` 包入口导出，仅供库内组件使用。详见 [FlowAgentContent](/components/agent/flow-agent-content)。
-
 ## API
 
 ### Props

package/dist/mcp/generated/docs/file-artifact-panel.md

@@ -1,13 +1,14 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-汇总当前会话所有 AssistantMessage 的 artifacts（按 outputId 去重），支持关键词搜索、列表选中与下载； 预览区委托 ArtifactPreviewHost：由 resolveFileKind 把扩展名归入 code / markdown / html / text / image / binary 六类， 前四类走 text_from_download 拉正文（code 交给 highlight.js 高亮），image / binary 走 preview_url； download_url / preview_url 经 onArtifactClick 每次异步获取（无 URL 缓存，并发去重）； 预览重载键为 outputId:type；重试再次调用 load() 重新取链。 源码位置：src/components/chat-message/assistant-message/message-artifacts/file-artifact-panel.vue。
+汇总当前会话所有 AssistantMessage 的 artifacts（按 outputId 去重），支持关键词搜索、列表选中、复制、引用到输入框与下载； 预览区委托 ArtifactPreviewHost：由 resolveFileKind 把扩展名归入 code / markdown / html / text / image / binary 六类， 前四类走 text_from_download 拉正文（code 交给 highlight.js 高亮），image / binary 走 preview_url； download_url / preview_url 经 onArtifactClick 每次异步获取（无 URL 缓存，并发去重）； 预览重载键为 outputId:type；重试再次调用 load() 重新取链。 源码位置：src/components/chat-message/assistant-message/message-artifacts/file-artifact-panel.vue。
 
 ### 关联组件
 - **assistant-message** — 文件产物来源于 AssistantMessage.property.artifacts
 - **chat-container** — 面板挂载在侧栏「文件产物」Tab（固定、不可关闭），并通过 onArtifactClick 异步取链
 - **execution-summary** — 同为 ChatContainer 侧栏 Tab 面板，交互形态一致
 - **message-loading** — ArtifactPreviewHost 取链 / 拉取正文过程使用 MessageLoading
+- **mention-tag** — 引用后文件以资源标签形态进入输入框
 
 ---
 <!-- FULL DOC -->
@@ -32,9 +33,10 @@
 - **唯一命中**：以 `outputId` 作为会话内唯一键（同 `outputId` 视为同一文件）；文件名可能重复，不可作唯一键
 - **关键词搜索**：按文件名实时过滤列表
 - **整块空态**：`artifacts` 为空时不渲染列表与预览区，整块展示 bkui `Exception`「暂无数据」（Tab 常驻，无数据也可正常打开侧栏）
-- **异步取链**：`AIFileInfo` 本身不含 `url` / `previewUrl`，通过 `ChatContainer` 的 `onArtifactClick` 按 `outputId` 获取 `download_url` / `preview_url`（TTL 8 分钟缓存；预览重试会 `force` 刷新）
+- **异步取链**：`AIFileInfo` 本身不含 `url` / `previewUrl`，通过 `ChatContainer` 的 `onArtifactClick` 按 `outputId` 获取 `download_url` / `preview_url`（不做 URL 缓存，每次重新取链；同文件进行中的请求并发去重）
+- **引用到输入框**：预览头提供「引用」按钮（位于下载左侧），点击后该文件以资源标签形态进入输入框
 - **职责拆分**：
-  - **面板本身**：列表、搜索、预览头（文件名 / 图标 / 下载）
+  - **面板本身**：列表、搜索、预览头（文件名 / 图标 / 复制 / 引用 / 下载）
   - **`ArtifactPreviewHost`**：按策略加载正文或预览 URL，分派到对应 renderer；展示 loading / empty / error（含重试）
 - **未传 `onArtifactClick`**：下载按钮隐藏，预览区展示无数据
 
@@ -175,6 +177,21 @@ ArtifactFileCard（点击文件卡片）
 - `ChatContainer` 通过 `useArtifactPreviewProvider` 提供上下文，并把「打开侧栏 Tab」这一副作用以 `onOpen` 注入，保持 composable 职责单一
 - 侧栏「文件产物」Tab 固定不可关闭，`order: -1` 排在「执行情况」之前；**常驻不随产物有无增删**，无产物时由面板展示整块空态
 
+## 引用到输入框
+
+预览头与消息区文件卡片都提供「引用」入口（设计稿中位于下载左侧），点击后文件以资源标签形态追加进输入框，等价于用户在 `@` 菜单里选中它：
+
+```
+预览头 / 文件卡片「引用」
+  └─ useInputMentionConsumer()?.insertMention(toArtifactMenuItem(file))
+       └─ ChatContainer 提供的 insertMention
+            └─ ChatInput.insertMention → AiSlashInput.appendMention（追加到文档末尾）
+```
+
+- **入口显隐**：`useInputMentionConsumer()` 为 `undefined`（没有输入框，如 `Share` 只读态）时不渲染引用按钮，无需额外开关
+- **id 一致性**：统一走 [`toArtifactMenuItem`](/utils/#会话产物收集) 生成菜单条目，与 `@` 菜单里自动收集的产物同源；id 不一致会导致去重与已插入标签匹配同时失效
+- **消息区文件卡片**：`ArtifactFileCard` 右侧操作区 hover 时显示，引用在下载左侧
+
 ## 唯一键规则
 
 会话内以 **`outputId`** 作为文件产物唯一键：
@@ -283,11 +300,13 @@ type AIFileInfo = {
 
 ## 关联 Composable
 
-预览**命中与取链**由 [useArtifactPreview](/composables/use-artifact-preview) 提供（Provider / Consumer + `ARTIFACT_PREVIEW_TOKEN`）。**正文加载与渲染**由内部 `useArtifactPreviewLoader` + `ArtifactPreviewHost` 完成，不在该 composable 内。
+预览**命中与取链**由 [useArtifactPreview](/composables/use-artifact-preview) 提供（Provider / Consumer + `ARTIFACT_PREVIEW_TOKEN`）。**正文加载与渲染**由内部 `useArtifactPreviewLoader` + `ArtifactPreviewHost` 完成，不在该 composable 内。**引用到输入框**由 [useInputMention](/composables/use-input-mention) 提供。
 
 ## 关联组件
 
 - [AssistantMessage](/components/message/assistant-message) — 文件产物来源（`property.artifacts`）
 - [ChatContainer](/components/setup/chat-container) — 侧栏「文件产物」Tab 挂载场景，提供 `onArtifactClick`
 - [MessageLoading](/components/helper/message-loading) — Host 预览区异步加载态
-- [ExecutionSummary](/components/agent/execution-summary) — 同为侧栏 Tab 面板
+- [ExecutionSummary](/components/agent/execution-summary) — 同为侧栏 Tab 面板
+- [MentionTag](/components/rendering/mention-tag) — 引用后在输入框内的标签形态
+- [useInputMention](/composables/use-input-mention) — 引用入口的上下文来源

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

@@ -220,6 +220,10 @@ MIME 为 `image/*` 时渲染为图片缩略图（`cursor: zoom-in`）。点击
 </template>
 ```
 
+## 上传文件预览
+
+具有 `outputId` 且不处于上传中 / 失败态的附件，在 `ChatContainer` 内点击会通过统一的文件产物侧栏预览，使用 `onArtifactClick` 获取预览和下载链接。图片缩略图链接失效时仍可按 `outputId` 重新取链；无 `outputId` 的图片继续使用原有图片预览。
+
 ## API
 
 ### Props

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

@@ -4,6 +4,7 @@
 文件选择按钮，封装 input[type=file] 并输出选择事件。 源码位置：src/components/ai-buttons/file-upload-btn/file-upload-btn.vue。
 
 ### 关联组件
+- **add-menu-btn** — ChatInput 内部已改用 + 号聚合菜单承载上传入口
 - **chat-input** — 输入区附件上传按钮常见挂载位置
 - **file-content** — 选中文件常以列表形式展示待发送内容
 
@@ -19,7 +20,11 @@
 
 > **能力域**：输入交互
 
-聊天输入框内置的文件上传触发按钮，点击后弹出系统文件选择框。内部包含隐藏的 `<input type="file">` 与可见的图标按钮；**组件缺省不限制文件类型**（`ChatInput` 会传入对话默认允许列表）。在按钮层只对**单文件**做大小与空文件过滤，**已选文件个数上限与类型校验**由上层（如 `ChatInput`）统一校验并提示，避免按钮与输入区各弹一条错误提示。
+::: warning ChatInput 已不再使用本按钮
+输入区重构后，`ChatInput` 的上传入口改为左下角 [AddMenuBtn](/components/input/add-menu-btn) 聚合菜单里的「文件」项（内部走自持的隐藏 `input[type=file]`）。本组件仍保留在源码中并可用于自建输入区，但**不会**出现在 `ChatInput` 的默认布局里，也**未从包入口导出**——文档站示例经相对路径引入。
+:::
+
+文件上传触发按钮，点击后弹出系统文件选择框。内部包含隐藏的 `<input type="file">` 与可见的图标按钮；**不限制文件类型**，在按钮层只对**单文件**做大小与空文件过滤，**已选文件个数上限**由上层统一校验并提示，避免按钮与输入区各弹一条错误提示。
 
 ## 组件结构
 
@@ -30,7 +35,6 @@
 │     触发后走 handleFileInputChange → 校验 → emit upload → target.value = ''
 └── span.ai-shortcut-btn.file-upload-btn-icon（热区 32×32px / 圆角 8px；图标字号跟随 --ai-icon-size-sm：small=16px、normal=18px；color: #979ba5；hover: #f0f1f5）
       v-tippy: "上传文件，最多支持 {count} 个，单个最大 {size}MB"
-        传入 accept 时追加支持格式说明（默认允许列表用分类文案）
         （{count} / {size} 由 MAX_UPLOAD_FILES 与 MAX_UPLOAD_FILE_SIZE 运行时填充，theme: ai-chat-box，offset: [0, 16]，可通过 tippyOptions 扩展）
       @click → fileInputRef.click()
       └── <slot> 默认：FileUploadIcon
@@ -41,7 +45,7 @@
 ```
 用户选择文件
   │
-  ├─ 遍历所选文件：size > 0 且 size < MAX_UPLOAD_FILE_SIZE（约 2.4MB）→ 加入 toEmit
+  ├─ 遍历所选文件：size > 0 且 size < MAX_UPLOAD_FILE_SIZE（45MB）→ 加入 toEmit
   │       size 为 0 或 ≥ 上限 → sizeRejected += 1
   │
   ├─ sizeRejected > 0 → bkui-vue Message.error（formatUploadNotAddedMessage，说明可能超大或超出个数等）
@@ -55,16 +59,16 @@
 
 | 场景                                                         | 结果                                                                 |
 | ------------------------------------------------------------ | -------------------------------------------------------------------- |
-| 一次多选超过上层允许个数（如 `ChatInput` 内已达 3 个）       | 由 **ChatInput** 侧 toast 并丢弃/不计入，不在本按钮内按个数提前拦截 |
+| 一次多选超过上层允许个数                                     | 由**上层**（如输入区）toast 并丢弃 / 不计入，不在本按钮内按个数提前拦截 |
 | 部分文件因空文件或单文件超大被过滤                           | 弹出错误 toast；若仍有合法文件，**仍触发** `upload`（payload 为合法子集） |
 | 全部被过滤（均为空或超大）                                   | 仅 toast，**不触发** `upload`                                        |
 | `file.size === 0`                                          | 计入未添加提示，不进入 `upload` payload                              |
-| `file.size >= MAX_UPLOAD_FILE_SIZE`（与全局常量一致，约 2.4MB） | 计入未添加提示，不进入 `upload` payload（比较为严格 `<`）           |
+| `file.size >= MAX_UPLOAD_FILE_SIZE`（与全局常量一致，45MB） | 计入未添加提示，不进入 `upload` payload（比较为严格 `<`）           |
 | 选择后取消                                                   | `files.length === 0`，不触发 `upload`                                |
 
 > `multiple` prop 声明存在但当前模板中 `input` 的 `multiple` 属性为**硬编码**（非 `:multiple="multiple"` 绑定），始终允许多选，该 prop 暂时无实际效果。
 
-> **文件类型默认不限制**：组件本身不再默认 `accept="image/*"`。`ChatInput` 会传入对话默认允许列表；独立使用时若需收窄，显式传入 `accept`。个数上限与类型校验由上层（如 `ChatInput`）控制，详见 [ChatInput 文件上传](/components/input/chat-input#file-upload)。
+> **文件类型不做限制**：组件不再默认 `accept="image/*"`，任意类型文件都可选择。若业务需要收窄，显式传入 `accept`。个数上限由上层控制（`MAX_UPLOAD_FILES`），详见 [ChatInput 文件上传](/components/input/chat-input#file-upload)。
 
 ## 基础用法
 
@@ -74,8 +78,6 @@
 </template>
 
 <script setup lang="ts">
-  import { FileUploadBtn } from '@blueking/chat-x';
-
   const handleUpload = (files: File[]) => {
     console.log(
       '选中文件:',
@@ -108,7 +110,7 @@
 </template>
 ```
 
-> `accept` 仅影响本组件的文件选择框过滤 UI。`ChatInput` 会在选择/拖拽/粘贴后再按扩展名校验；独立使用 `FileUploadBtn` 时请在 `upload` 回调中自行校验。
+> `accept` 仅影响文件选择框的过滤 UI，不做服务端验证，请在 `upload` 回调中自行校验 MIME 类型。
 
 ## 自定义图标
 
@@ -136,7 +138,7 @@
 
 | 事件名 | 参数              | 说明                                                                                      |
 | ------ | ----------------- | ----------------------------------------------------------------------------------------- |
-| upload | `(files: File[])` | 当存在至少一个合法文件时触发；`files` 为过滤掉空文件与单文件超大（`size >= MAX_UPLOAD_FILE_SIZE`，约 2.4MB）后的数组；个数截断不在此组件内完成 |
+| upload | `(files: File[])` | 当存在至少一个合法文件时触发；`files` 为过滤掉空文件与单文件超大（`size >= MAX_UPLOAD_FILE_SIZE`，45MB）后的数组；个数截断不在此组件内完成 |
 
 ### Slots
 
@@ -146,7 +148,7 @@
 
 ## 使用场景
 
-`FileUploadBtn` 由 `ChatInput` 组件内置，当 `ChatInput` 的 `supportUpload` prop 为 `true`（默认值）时自动渲染。一般不需要单独引入，除非构建完全自定义的输入区域。
+仅在**自建输入区**时使用。若使用 `ChatInput`，上传能力由 `supportUpload`（默认 `true`）开启，入口是 + 号菜单里的「文件」项、拖拽与粘贴，无需再挂本按钮。
 
 ## 类型定义
 
@@ -158,5 +160,6 @@ type AITippyProps = Partial<Pick<TippyOptions, 'appendTo' | 'placement' | 'zInde
 
 ## 关联组件
 
-- [ChatInput](/components/input/chat-input) — 默认内置上传入口
+- [AddMenuBtn](/components/input/add-menu-btn) — `ChatInput` 现行的上传 / 资源入口
+- [ChatInput](/components/input/chat-input) — 上传能力与校验规则
 - [FileContent](/components/medias/file-content) — 选中文件列表展示

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

@@ -33,7 +33,6 @@
 - **重试 / 跳过进行中态**：点击后节点行进入 `is-pending`，按钮组常驻显示（无需 hover）；进行中按钮切换为 loading +「重试中 / 跳过中」，重试与跳过互斥禁用；被阻塞按钮 hover 显示提示（如「任务正在重试中，不可跳过」）；详情不受影响。pending 以 `task_id:node_id:retry` 为键，后端 `retry` 计数变化后自动失效
 - **详情入口联动**：「详情」按钮点击后通过自定义 Tab 挂载 `FlowAgentNodeDetail`
 - **分享态只读查看**：`RenderMode.Share` 下保留耗时、「详情」「有效证据」等只读查看入口，仅隐藏「重试 / 跳过」等交互式 resume 操作
-- **侧栏执行情况面板只读**：侧栏「执行情况」Tab 内经 `ExecutionSummary` 渲染的同一组件同样只保留「详情」，不展示「重试 / 跳过」；面板身份由 `ExecutionSummary` 通过 `EXECUTION_PANEL_TOKEN` 提供，组件以 `useExecutionPanelInject` 读取。因此重试 / 跳过只出现在对话流内的执行情况
 
 ## 状态映射
 
@@ -95,7 +94,7 @@
 
 ## 失败节点重试 / 跳过
 
-失败节点（`convergedState === 'failed'`）且具备对应能力位时，在**对话流内**的执行情况 hover 行尾展示「重试」或「跳过」按钮（侧栏「执行情况」面板与 Share 分享态不展示，见下方显隐条件）。点击后：
+失败节点（`convergedState === 'failed'`）且具备对应能力位时，hover 行尾展示「重试」或「跳过」按钮。点击后：
 
 1. 节点行添加 `is-pending` class，按钮组常驻显示（设计稿：鼠标移出后仍可见进行中反馈）
 2. 被点击按钮进入 loading +「重试中 / 跳过中」，重试与跳过均禁用（`is-disabled`，置灰色 `#c4c6cc`）
@@ -126,11 +125,11 @@ onInterruptResume?.({
 
 | 按钮 | 显隐条件                              | 进行中表现                         | `operation`          |
 | ---- | ------------------------------------- | ---------------------------------- | ---------------------- |
-| 重试 | 失败态且 `node.retryable === true`；且不在 Share 分享态、不在侧栏「执行情况」面板内 | loading +「重试中」，二者均禁用    | `flow_node_retry`      |
-| 跳过 | 失败态且 `node.skippable === true`；且不在 Share 分享态、不在侧栏「执行情况」面板内 | loading +「跳过中」，二者均禁用    | `flow_node_skip`       |
-| 详情 | 始终展示（含 Share 分享态与侧栏面板） | 不受 pending 影响                  | —（打开侧栏 Tab，不走 resume） |
+| 重试 | 失败态且 `node.retryable === true`    | loading +「重试中」，二者均禁用    | `flow_node_retry`      |
+| 跳过 | 失败态且 `node.skippable === true`    | loading +「跳过中」，二者均禁用    | `flow_node_skip`       |
+| 详情 | 始终展示（含 Share 分享态）           | 不受 pending 影响                  | —（打开侧栏 Tab，不走 resume） |
 
-行尾操作由内部 composable [`useFlowNodeActions`](/composables/use-flow-node-actions) 聚合为声明式列表，组件层仅遍历渲染；两类只读场景合并为它的 `hideResumeActions` 入参。
+行尾操作由内部 composable [`useFlowNodeActions`](/composables/use-flow-node-actions) 聚合为声明式列表，组件层仅遍历渲染。
 
 ## 节点详情联动
 
@@ -177,9 +176,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
@@ -255,9 +254,8 @@ interface BkFlowNode {
 4. **`task_outputs` 暂不渲染**：模板中任务输出展示区块已注释，传入也不会显示。
 5. **未知状态兜底为 `running`**：`getConvergedState` 对未识别的原始状态统一归为运行中。
 6. **Share 模式只读查看**：`RenderMode.Share` 下保留节点/任务耗时与「详情」「有效证据」查看入口，仅过滤「重试 / 跳过」等交互式 resume 操作（由 `useFlowNodeActions` 的 `hideResumeActions` 收敛）。
-7. **侧栏「执行情况」面板同为只读**：面板内经 `ExecutionSummary` → `MessageRender` 渲染的本组件不展示「重试 / 跳过」，只保留「详情」；判定来自 `useExecutionPanelInject()`（内部上下文，未从包入口导出；缺省 `false`），与 Share 态一起并入 `hideResumeActions`。因此脱离 `ExecutionSummary` 独立使用组件时，行为与对话流内一致。
-8. **`onInterruptResume` 透传链路**：`MessageRender` → `ActivityMessage` → `FlowAgentContent`；未传入时重试 / 跳过按钮仍展示但点击无回调。
-9. **pending 自动收敛**：`useFlowNodeActions` 以 `task_id:node_id:retry` 为 pending 键；节点重试再次失败（`retry` +1）后键变化，进行中态自动解除，无需手动清理。
+7. **`onInterruptResume` 透传链路**：`MessageRender` → `ActivityMessage` → `FlowAgentContent`；未传入时重试 / 跳过按钮仍展示但点击无回调。
+8. **pending 自动收敛**：`useFlowNodeActions` 以 `task_id:node_id:retry` 为 pending 键；节点重试再次失败（`retry` +1）后键变化，进行中态自动解除，无需手动清理。
 
 ## 关联组件
 

package/dist/mcp/generated/docs/input-menu-panel.md

@@ -0,0 +1,166 @@
+<!-- AI SUMMARY -->
+## 快速了解
+
+InputMenuPanel 渲染输入框菜单：分组标题 + InputMenuOption 条目 + 「更多 +N」折叠开关， 内置键盘上下导航与 Esc 关闭；分组数据由 useInputMenu 纯数据逻辑算出（按触发方式筛类型 → 关键字过滤 → 分组 → 折叠 → 扁平化）。 源码位置：src/components/chat-input/input-menu/（input-menu-panel.vue、input-menu-option.vue、use-input-menu.ts、constants.ts）。
+
+### 关联组件
+- **chat-input** — 上层持有触发态与数据源并渲染本面板
+- **ai-slash-input** — 触发方式与过滤关键字由编辑器 menuChange 抛出
+- **add-menu-btn** — + 号唤起 plus 触发的聚合菜单
+- **resource-icon** — 条目左侧图标由 ResourceIcon 渲染
+
+---
+<!-- FULL DOC -->
+
+# InputMenuPanel 输入框菜单
+
+> **能力域**：输入交互
+
+## 源码事实
+
+- **面板**：`src/components/chat-input/input-menu/input-menu-panel.vue`
+- **条目**：`src/components/chat-input/input-menu/input-menu-option.vue`
+- **数据逻辑**：`src/components/chat-input/input-menu/use-input-menu.ts`
+- **分组定义**：`src/components/chat-input/input-menu/constants.ts`
+- **能力说明**：`@` `/` `\` 与左下角 + 号共用同一个面板与同一份 `menuSources`，差异只体现在「展示哪些分组」。
+
+## 布局与交互
+
+- 面板由 [ChatInput](/components/input/chat-input) 绝对定位在输入框**正上方 8px**、与输入框等宽，**不跟随光标**；最大高度 400px，超出滚动。
+- 键盘导航由 [useMenuKeydown](/composables/use-menu-keydown) 提供：`↑` / `↓` 移动高亮，`Enter` 选中，高亮项滚动进可视区；结果集变化后高亮回到首项。
+- `Esc` 在**捕获阶段**监听并 emit `close`，避免被编辑器先行消费。
+- 面板滚动时关闭条目描述气泡，防止气泡与列表错位。
+- 条目 `disabled` 时不可选中，也不进入键盘导航序列。
+- 条目名称过长时用 `v-overflow-tips` 展示完整名称；`description` 非空时 hover 弹出「类型：名称 + 描述」气泡（与 [MentionTag](/components/rendering/mention-tag) 同一套气泡）。
+
+## 分组与触发方式
+
+| 触发方式 | 分组顺序                                                  |
+| -------- | --------------------------------------------------------- |
+| `/`      | Skill、MCP、工具                                          |
+| `@`      | 知识库、会话产物                                          |
+| `\`      | Prompt                                                    |
+| `plus`   | 添加、Skill、MCP、工具、知识库、会话产物、Prompt          |
+
+分组静态定义（`MENU_GROUP_DEFS`）：
+
+| `key`           | 标题     | 覆盖 `type`            |
+| --------------- | -------- | ---------------------- |
+| `add`           | 添加     | `file`                 |
+| `skill`         | Skill    | `skill`                |
+| `mcp`           | MCP      | `mcp`                  |
+| `tool`          | 工具     | `tool`                 |
+| `knowledgebase` | 知识库   | `knowledgebase`、`doc` |
+| `artifact`      | 会话产物 | `artifact`             |
+| `prompt`        | Prompt   | `prompt`               |
+
+- 组内无匹配条目时，`useInputMenu` **不产出该分组**（初始化与搜索过滤后均如此）；全部组都为空时 `groups` 为空数组，`ChatInput` 因此不弹出面板。
+- 面板组件本身若被传入 `items` 为空的分组，仍会渲染标题并展示「暂无数据」。`ChatInput` 默认路径不会走到这一支。
+- `DIVIDED_GROUP_KEYS` 决定哪些分组下方画分隔线，目前为 `['add']`。
+- `getMenuTypeLabel(type)` 由分组定义反查生成，菜单分组标题与标签气泡标题共用一份映射（`file` 映射到「添加」）。
+
+## 渲染示例
+
+## useInputMenu
+
+面板只负责渲染，分组结果由 `useInputMenu` 计算，可脱离 UI 单独单测。流程为：**按触发方式筛类型 → 按关键字过滤 → 分组 → 应用折叠阈值 → 扁平化供键盘导航**。
+
+::: info 内部模块
+面板、条目与 `useInputMenu` 都不在包入口导出，仅供 [ChatInput](/components/input/chat-input) 内部使用；`IInputMenuItem`、`MenuTrigger` 等类型从包入口导出。
+:::
+
+```typescript
+import { computed, shallowRef } from 'vue';
+
+const trigger = shallowRef<MenuTrigger | null>(null);
+const keyword = shallowRef('');
+
+const { groups, flatItems, hasContent, toggleGroup } = useInputMenu({
+  sources: computed(() => availableSources.value),
+  keyword,
+  trigger,
+  groupItemLimit: computed(() => props.menuGroupItemLimit),
+});
+```
+
+### 参数
+
+| 参数             | 类型                                          | 说明                                     |
+| ---------------- | --------------------------------------------- | ---------------------------------------- |
+| `sources`        | `Ref<IInputMenuItem[]>`                       | 全部可选项                               |
+| `keyword`        | `Ref<string>`                                 | 过滤关键字（触发符之后用户输入的文本）   |
+| `trigger`        | `Ref<MenuTrigger \| null>`                    | 当前触发方式，`null` 表示菜单未激活      |
+| `groupItemLimit` | `Ref<number>`                                 | 每个分组默认展示条数上限（内部下限为 1） |
+
+### 返回值
+
+| 字段          | 类型                            | 说明                                             |
+| ------------- | ------------------------------- | ------------------------------------------------ |
+| `groups`      | `ComputedRef<IInputMenuGroup[]>` | 渲染用分组（已应用过滤与折叠）                   |
+| `flatItems`   | `ComputedRef<IInputMenuItem[]>` | 当前可见且可选中的条目，顺序与面板一致           |
+| `hasContent`  | `ComputedRef<boolean>`          | 面板是否有内容，供上层决定显隐                   |
+| `toggleGroup` | `(key: MenuGroupKey) => void`   | 切换某个分组的展开 / 折叠                        |
+
+> 关键字或触发方式变化时，内部会清空手动展开状态——结果集已完全不同，沿用旧状态会造成误导。
+
+## API
+
+### InputMenuPanel Props
+
+| 属性名    | 类型                 | 必填 | 说明                                   |
+| --------- | -------------------- | ---- | -------------------------------------- |
+| groups    | `IInputMenuGroup[]`  | ✅   | 分组数据                               |
+| flatItems | `IInputMenuItem[]`   | ✅   | 可选中条目的扁平序列，供键盘导航       |
+
+### InputMenuPanel Emits
+
+| 事件名      | 参数                       | 触发时机                     |
+| ----------- | -------------------------- | ---------------------------- |
+| select      | `(item: IInputMenuItem)`   | 点击条目或按 Enter 选中      |
+| toggleGroup | `(key: string)`            | 点击「更多 +N / 收起」       |
+| close       | `()`                       | 按下 Esc                     |
+
+### InputMenuOption Props / Emits
+
+| 名称     | 类型                     | 说明                       |
+| -------- | ------------------------ | -------------------------- |
+| `item`   | `IInputMenuItem`         | 条目数据                   |
+| `active` | `boolean`                | 键盘导航选中态             |
+| `select` | `(item: IInputMenuItem)` | 条目未禁用时点击触发       |
+
+### 类型定义
+
+```typescript
+/** 面板渲染用的分组（已应用关键字过滤与折叠阈值） */
+interface IInputMenuGroup {
+  key: string;
+  /** 分组标题的中文文案 key，渲染时经 t() 转换 */
+  name: string;
+  /** 当前可见条目 */
+  items: IInputMenuItem[];
+  /** 被折叠隐藏的条数，为 0 表示无需折叠 */
+  restCount: number;
+  /** 是否已展开全部条目 */
+  expanded: boolean;
+  /** 分组下方是否需要分隔线 */
+  divided: boolean;
+}
+
+type MenuGroupKey = 'add' | 'skill' | 'mcp' | 'tool' | 'knowledgebase' | 'artifact' | 'prompt';
+
+/** 字符触发符，plus 由按钮唤起不在其中 */
+const CHAR_TRIGGERS = ['@', '/', '\\'] as const;
+
+/** 分组默认最多展示的条数 */
+const DEFAULT_GROUP_ITEM_LIMIT = 4;
+```
+
+`IInputMenuItem` 与 `MenuTrigger` 见 [ChatInput 类型定义](/components/input/chat-input#类型定义)。
+
+## 关联组件
+
+- [ChatInput](/components/input/chat-input) — 菜单数据源、触发态与选中后的动作分发
+- [AiSlashInput](/components/input/ai-slash-input) — 触发方式与关键字的来源
+- [AddMenuBtn](/components/input/add-menu-btn) — `plus` 触发入口
+- [ResourceIcon](/components/helper/resource-icon) — 条目图标
+- [useMenuKeydown](/composables/use-menu-keydown) — 键盘导航