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

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-09-03T10:43:42.706Z",
+  "generatedAt": "2026-09-11T04:44:17.013Z",
   "domains": {
     "setup": {
       "label": "对话搭建",
@@ -29,12 +29,15 @@
         "animation-text",
         "cite-content",
         "code-content",
+        "collapsible-content",
         "common-error-content",
         "content-render",
         "desc-panel",
         "key-value-content",
         "latex-content",
         "markdown-content",
+        "mention-tag",
+        "mention-text",
         "mermaid-content",
         "reference-content",
         "text-content"
@@ -43,16 +46,14 @@
     "input": {
       "label": "输入交互",
       "components": [
-        "ai-prompt-list",
+        "add-menu-btn",
         "ai-selection",
-        "ai-skill-list",
-        "ai-slash-editor",
         "ai-slash-input",
-        "ai-slash-menu",
         "chat-input",
         "file-upload-btn",
         "input-attachment",
         "input-info-alert",
+        "input-menu-panel",
         "model-selector",
         "selection-footer",
         "shortcut-btn",
@@ -103,6 +104,7 @@
         "highlight-keyword",
         "message-loading",
         "questions-container",
+        "resource-icon",
         "selection-question",
         "vnode-renderer",
         "ai-image",
@@ -139,7 +141,7 @@
       "slug": "execution-summary",
       "kind": "component",
       "description": "按消息流提取执行摘要，支持关键词定位和消息渲染。",
-      "aiSummary": "按消息流提取执行摘要，支持关键词定位和消息渲染。 通过 useExecutionPanelProvider 提供 EXECUTION_PANEL_TOKEN，面板内消息按只读呈现， FlowAgent 失败节点在面板内不展示重试/跳过，只保留详情。 源码位置：src/components/execution-summary/execution-summary.vue。",
+      "aiSummary": "按消息流提取执行摘要，支持关键词定位和消息渲染。 源码位置：src/components/execution-summary/execution-summary.vue。",
       "relatedComponents": [
         {
           "slug": "message-render",
@@ -668,6 +670,33 @@
       "docFile": "docs/questions-container.md",
       "domain": "helper"
     },
+    {
+      "name": "ResourceIcon 资源图标",
+      "slug": "resource-icon",
+      "kind": "component",
+      "description": "按 URL / Vue 组件 / 类型兜底三级策略渲染资源图标，图片失效自动回退。",
+      "aiSummary": "ResourceIcon 统一渲染资源图标：icon 为字符串按 img 加载（加载失败回退内置图标）、 为 Vue 组件直接渲染、缺省时按 type 查内置图标表（artifact 交给 FileIcon 按文件名后缀推导， 未登记类型回退 ModuleIcon）；尺寸由 --ai-icon-size 控制，默认 16px。 源码位置：src/components/resource-icon/resource-icon.vue。",
+      "relatedComponents": [
+        {
+          "slug": "input-menu-panel",
+          "relation": "菜单条目左侧图标"
+        },
+        {
+          "slug": "mention-tag",
+          "relation": "输入框与消息中的资源标签图标"
+        },
+        {
+          "slug": "model-selector",
+          "relation": "模型选择器的触发器与选项图标"
+        },
+        {
+          "slug": "file-icon",
+          "relation": "artifact 类型委托给 FileIcon 按后缀推导"
+        }
+      ],
+      "docFile": "docs/resource-icon.md",
+      "domain": "helper"
+    },
     {
       "name": "SelectionQuestion 选择问题占位",
       "slug": "selection-question",
@@ -719,18 +748,26 @@
       "domain": "helper"
     },
     {
-      "name": "AiPromptList Prompt 列表",
-      "slug": "ai-prompt-list",
+      "name": "AddMenuBtn 添加菜单按钮",
+      "slug": "add-menu-btn",
       "kind": "component",
-      "description": "\\ Prompt 选择列表，供 AiSlashInput 插入模板文本。",
-      "aiSummary": "\\ Prompt 选择列表，供 AiSlashInput 插入模板文本。 源码位置：src/components/chat-input/ai-slash-input/ai-prompt-list/ai-prompt-list.vue。",
+      "description": "输入框左下角的 + 号按钮，唤起聚合菜单，展开态高亮。",
+      "aiSummary": "AddMenuBtn 是输入框底部工具栏最左侧的 + 号：只负责展示与 toggle 事件，菜单开合由上层控制； active 为 true 时保持 hover 底色；mousedown 已 preventDefault，点击不会抢走编辑器焦点。 源码位置：src/components/ai-buttons/add-menu-btn/add-menu-btn.vue。",
       "relatedComponents": [
         {
-          "slug": "ai-slash-input",
-          "relation": "输入 \\ 时由 AiSlashInput tippy 菜单渲染"
+          "slug": "chat-input",
+          "relation": "输入框底部工具栏渲染该按钮并处理 toggle"
+        },
+        {
+          "slug": "input-menu-panel",
+          "relation": "点击后唤起 plus 触发的聚合菜单"
+        },
+        {
+          "slug": "file-upload-btn",
+          "relation": "被本按钮取代的旧上传入口"
         }
       ],
-      "docFile": "docs/ai-prompt-list.md",
+      "docFile": "docs/add-menu-btn.md",
       "domain": "input"
     },
     {
@@ -752,98 +789,67 @@
       "docFile": "docs/ai-selection.md",
       "domain": "input"
     },
-    {
-      "name": "AiSkillList Skill 列表",
-      "slug": "ai-skill-list",
-      "kind": "component",
-      "description": "/ Skill 选择列表，供 AiSlashInput 插入 Skill 标签。",
-      "aiSummary": "/ Skill 选择列表，供 AiSlashInput 插入 Skill 标签。 无 icon 或 icon 加载失败时展示 skill_name 首字母 fallback。 源码位置：src/components/chat-input/ai-slash-input/ai-skill-list/ai-skill-list.vue。",
-      "relatedComponents": [
-        {
-          "slug": "ai-slash-input",
-          "relation": "输入 / 时由 AiSlashInput tippy 菜单渲染"
-        },
-        {
-          "slug": "chat-input",
-          "relation": "经 ChatInput.skills 透传数据源"
-        }
-      ],
-      "docFile": "docs/ai-skill-list.md",
-      "domain": "input"
-    },
-    {
-      "name": "AiSlashEditor 富文本编辑器",
-      "slug": "ai-slash-editor",
-      "kind": "component",
-      "description": "旧版富文本编辑器实现，封装 command selection 与提示菜单。",
-      "aiSummary": "旧版富文本编辑器实现，封装 command selection 与提示菜单。 源码位置：src/components/chat-input/ai-slash-editor/ai-slash-editor.vue。",
-      "relatedComponents": [],
-      "docFile": "docs/ai-slash-editor.md",
-      "domain": "input"
-    },
     {
       "name": "AiSlashInput 富文本命令输入",
       "slug": "ai-slash-input",
       "kind": "component",
-      "description": "ChatInput 内部富文本输入，支持 / Skill、\\ Prompt 与 @ 资源标签。",
-      "aiSummary": "ChatInput 内部富文本输入，支持 / Skill、\\ Prompt 与 @ 资源标签。 源码位置：src/components/chat-input/ai-slash-input/ai-slash-input.vue。",
+      "description": "ChatInput 内部富文本编辑区，负责触发符识别、资源标签插入与文档同步。",
+      "aiSummary": "ChatInput 内部富文本编辑区，基于 edix 编辑器渲染「文本 + 资源标签」文档。 自身不渲染菜单，只把触发方式与过滤关键字通过 menuChange 抛给上层，并暴露插入 / 替换 / 关闭菜单等命令。 源码位置：src/components/chat-input/ai-slash-input/ai-slash-input.vue。",
       "relatedComponents": [
         {
-          "slug": "ai-skill-list",
-          "relation": "输入 / 时渲染 Skill 选择列表"
+          "slug": "chat-input",
+          "relation": "上层输入区，持有菜单状态并调用本组件的 expose 方法"
         },
         {
-          "slug": "ai-prompt-list",
-          "relation": "输入 \\ 时渲染 Prompt 选择列表"
+          "slug": "input-menu-panel",
+          "relation": "由 menuChange 驱动的菜单面板，选中后回调插入方法"
         },
         {
-          "slug": "ai-slash-menu",
-          "relation": "输入 @ 时渲染资源选择菜单"
+          "slug": "mention-tag",
+          "relation": "文档中的 tag 节点由 MentionTag 渲染"
         }
       ],
       "docFile": "docs/ai-slash-input.md",
       "domain": "input"
     },
-    {
-      "name": "AiSlashMenu 资源菜单",
-      "slug": "ai-slash-menu",
-      "kind": "component",
-      "description": "@ 资源选择菜单，展示资源项供 AiSlashInput 插入标签。",
-      "aiSummary": "@ 资源选择菜单，展示资源项供 AiSlashInput 插入标签。 源码位置：src/components/chat-input/ai-slash-input/ai-slash-menu/ai-slash-menu.vue。",
-      "relatedComponents": [],
-      "docFile": "docs/ai-slash-menu.md",
-      "domain": "input"
-    },
     {
       "name": "ChatInput 聊天输入框",
       "slug": "chat-input",
       "kind": "component",
-      "description": "聊天输入区，组合富文本输入、快捷指令、附件、引用、发送/停止等交互。",
-      "aiSummary": "聊天输入区，组合富文本输入、快捷指令、附件、引用、发送/停止等交互。 源码位置：src/components/chat-input/chat-input.vue。",
+      "description": "聊天输入区，组合富文本输入、统一菜单（@ / \\ 与 + 号）、快捷指令、附件、引用、发送/停止等交互。",
+      "aiSummary": "聊天输入区，组合富文本输入、统一菜单、快捷指令、附件、引用、发送/停止等交互。 菜单数据由单一 menuSources 提供，按 type 分发到 `/` `@` `\\` 与左下角 + 号四种触发方式。 源码位置：src/components/chat-input/chat-input.vue。",
       "relatedComponents": [
         {
-          "slug": "shortcut-btns",
-          "relation": "底部附件区默认展示的快捷指令列表"
+          "slug": "ai-slash-input",
+          "relation": "内部富文本编辑区，负责触发符识别与标签插入"
         },
         {
-          "slug": "shortcut-btn",
-          "relation": "已选快捷指令以单按钮形式展示并可关闭"
+          "slug": "input-menu-panel",
+          "relation": "输入框正上方的统一菜单面板"
         },
         {
-          "slug": "shortcut-render",
-          "relation": "快捷指令含 components 时由外层唤起表单渲染"
+          "slug": "add-menu-btn",
+          "relation": "左下角 + 号，唤起聚合菜单"
         },
         {
-          "slug": "chat-container",
-          "relation": "顶层聊天布局中作为输入区子组件"
+          "slug": "mention-tag",
+          "relation": "菜单选中的资源以标签形式嵌入编辑器"
         },
         {
           "slug": "model-selector",
           "relation": "传入 models 后在发送按钮左侧默认展示模型选择器"
         },
+        {
+          "slug": "shortcut-btns",
+          "relation": "底部附件区默认展示的快捷指令列表"
+        },
         {
           "slug": "cite-content",
           "relation": "消息引用区展示选中的上下文片段"
+        },
+        {
+          "slug": "chat-container",
+          "relation": "顶层聊天布局中作为输入区子组件"
         }
       ],
       "docFile": "docs/chat-input.md",
@@ -856,6 +862,10 @@
       "description": "文件选择按钮，封装 input[type=file] 并输出选择事件。",
       "aiSummary": "文件选择按钮，封装 input[type=file] 并输出选择事件。 源码位置：src/components/ai-buttons/file-upload-btn/file-upload-btn.vue。",
       "relatedComponents": [
+        {
+          "slug": "add-menu-btn",
+          "relation": "ChatInput 内部已改用 + 号聚合菜单承载上传入口"
+        },
         {
           "slug": "chat-input",
           "relation": "输入区附件上传按钮常见挂载位置"
@@ -888,6 +898,33 @@
       "docFile": "docs/input-info-alert.md",
       "domain": "input"
     },
+    {
+      "name": "InputMenuPanel 输入框菜单",
+      "slug": "input-menu-panel",
+      "kind": "component",
+      "description": "输入框上方的统一菜单面板，@ / \\ 与 + 号共用一套数据源、分组与折叠逻辑。",
+      "aiSummary": "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）。",
+      "relatedComponents": [
+        {
+          "slug": "chat-input",
+          "relation": "上层持有触发态与数据源并渲染本面板"
+        },
+        {
+          "slug": "ai-slash-input",
+          "relation": "触发方式与过滤关键字由编辑器 menuChange 抛出"
+        },
+        {
+          "slug": "add-menu-btn",
+          "relation": "+ 号唤起 plus 触发的聚合菜单"
+        },
+        {
+          "slug": "resource-icon",
+          "relation": "条目左侧图标由 ResourceIcon 渲染"
+        }
+      ],
+      "docFile": "docs/input-menu-panel.md",
+      "domain": "input"
+    },
     {
       "name": "ModelSelector 模型选择器",
       "slug": "model-selector",
@@ -1163,7 +1200,7 @@
       "slug": "file-artifact-panel",
       "kind": "component",
       "description": "汇总当前会话全部文件产物，支持搜索、选中与分类型预览，挂载在 ChatContainer 侧栏「文件产物」Tab。",
-      "aiSummary": "汇总当前会话所有 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。",
+      "aiSummary": "汇总当前会话所有 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。",
       "relatedComponents": [
         {
           "slug": "assistant-message",
@@ -1180,6 +1217,10 @@
         {
           "slug": "message-loading",
           "relation": "ArtifactPreviewHost 取链 / 拉取正文过程使用 MessageLoading"
+        },
+        {
+          "slug": "mention-tag",
+          "relation": "引用后文件以资源标签形态进入输入框"
         }
       ],
       "docFile": "docs/file-artifact-panel.md",
@@ -1305,8 +1346,16 @@
       "slug": "user-message",
       "kind": "component",
       "description": "渲染用户消息，支持纯文本、键值引用、文件附件和编辑态输入。",
-      "aiSummary": "渲染用户消息：纯文本（非 Markdown）、键值引用、二进制附件与编辑态 ChatInput / ShortcutRender； 工具栏含 copy / cite / edit / delete。源码位置：src/components/chat-message/user-message/user-message.vue。",
+      "aiSummary": "渲染用户消息：纯文本（非 Markdown）、键值引用、二进制附件与编辑态 ChatInput / ShortcutRender； 正文经 CollapsibleContent 限高 200px，property.docSchema 含标签时改用 MentionText 还原资源标签； 工具栏含 copy / edit / delete。源码位置：src/components/chat-message/user-message/user-message.vue。",
       "relatedComponents": [
+        {
+          "slug": "mention-text",
+          "relation": "文档含标签时用它还原已选资源"
+        },
+        {
+          "slug": "collapsible-content",
+          "relation": "正文超过 200px 时折叠"
+        },
         {
           "slug": "message-render",
           "relation": "由 MessageRender 在 role 为 user 时创建"
@@ -1380,6 +1429,25 @@
       "docFile": "docs/code-content.md",
       "domain": "rendering"
     },
+    {
+      "name": "CollapsibleContent 折叠内容",
+      "slug": "collapsible-content",
+      "kind": "component",
+      "description": "内容超过阈值高度时折叠，并在下方展示「显示更多 / 收起」。",
+      "aiSummary": "CollapsibleContent 用 ResizeObserver 持续测量插槽真实高度，超过 maxHeight（默认 200px）才折叠并显示切换按钮； 折叠通过外层 max-height + overflow hidden 实现，展开态可由 v-model:expanded 受控，便于「全部展开」这类批量操作。 源码位置：src/components/chat-content/collapsible-content/collapsible-content.vue。",
+      "relatedComponents": [
+        {
+          "slug": "user-message",
+          "relation": "用户消息正文超过 200px 时折叠"
+        },
+        {
+          "slug": "activity-layout",
+          "relation": "活动消息的另一种折叠布局"
+        }
+      ],
+      "docFile": "docs/collapsible-content.md",
+      "domain": "rendering"
+    },
     {
       "name": "CommonErrorContent 错误内容",
       "slug": "common-error-content",
@@ -1502,6 +1570,56 @@
       "docFile": "docs/markdown-content.md",
       "domain": "rendering"
     },
+    {
+      "name": "MentionTag 资源标签",
+      "slug": "mention-tag",
+      "kind": "component",
+      "description": "单个资源标签，带类型图标、描述气泡与会话产物点击预览。",
+      "aiSummary": "MentionTag 渲染「图标 + 蓝色名称」的内联资源标签：节点数据全部落在 data-tag-* 属性上， 既是编辑器 void 节点的识别依据，也让消息里复制的标签能原样还原； description 非空时 hover / 点击弹出「类型：名称 + 描述」气泡；type 为 artifact 且存在产物预览上下文时点击打开侧栏预览。 源码位置：src/components/mention/mention-tag.vue（气泡见 mention-popover.vue 与 create-mention-tippy.ts）。",
+      "relatedComponents": [
+        {
+          "slug": "mention-text",
+          "relation": "按文档结构批量渲染标签与文本"
+        },
+        {
+          "slug": "ai-slash-input",
+          "relation": "编辑器内的 tag 节点由本组件渲染"
+        },
+        {
+          "slug": "resource-icon",
+          "relation": "标签左侧图标"
+        },
+        {
+          "slug": "file-artifact-panel",
+          "relation": "artifact 标签点击后打开的侧栏预览"
+        }
+      ],
+      "docFile": "docs/mention-tag.md",
+      "domain": "rendering"
+    },
+    {
+      "name": "MentionText 标签文本",
+      "slug": "mention-text",
+      "kind": "component",
+      "description": "把发送时保留的富文本文档还原成「文本 + 资源标签」，用于用户消息回显。",
+      "aiSummary": "MentionText 接收一份 TagSchema 文档（二维数组：行 → 节点），逐行渲染：text 节点输出文本、 tag 节点交给 MentionTag；行间用 <br> 分隔，空白以 pre-wrap 保留。 UserMessage 在 property.docSchema 含标签时用它替代 TextContent。 源码位置：src/components/mention/mention-text.vue。",
+      "relatedComponents": [
+        {
+          "slug": "mention-tag",
+          "relation": "tag 节点的实际渲染者"
+        },
+        {
+          "slug": "user-message",
+          "relation": "用户消息在文档含标签时改用本组件回显"
+        },
+        {
+          "slug": "text-content",
+          "relation": "纯文本消息仍走 TextContent"
+        }
+      ],
+      "docFile": "docs/mention-text.md",
+      "domain": "rendering"
+    },
     {
       "name": "MermaidContent Mermaid 图表",
       "slug": "mermaid-content",
@@ -1550,6 +1668,10 @@
         {
           "slug": "user-message",
           "relation": "用户消息中纯文本内容展示"
+        },
+        {
+          "slug": "mention-text",
+          "relation": "文档含资源标签时的替代渲染"
         }
       ],
       "docFile": "docs/text-content.md",
@@ -1736,7 +1858,7 @@
       "slug": "use-flow-node-actions",
       "kind": "composable",
       "description": "聚合 FlowAgent 节点行尾操作（详情 / 重试 / 跳过）为声明式视图模型列表，显隐与 resume 回调收敛于此。",
-      "aiSummary": "useFlowNodeActions 接收 onInterruptResume 与 openNodeDetail，返回 getNodeActions 与 isNodePending。 失败节点按 retryable/skippable 展示重试/跳过，详情恒在末尾；点击后进入 pending 防重复提交， 以 task_id:node_id:retry 为键自动收敛；点击 resume 时不传 interrupt。 hideResumeActions 为 true 时只返回详情，覆盖 Share 分享态与侧栏「执行情况」面板两类只读场景。",
+      "aiSummary": "useFlowNodeActions 接收 onInterruptResume 与 openNodeDetail，返回 getNodeActions 与 isNodePending。 失败节点按 retryable/skippable 展示重试/跳过，详情恒在末尾；点击后进入 pending 防重复提交， 以 task_id:node_id:retry 为键自动收敛；点击 resume 时不传 interrupt。",
       "relatedComponents": [
         {
           "slug": "flow-agent-content",
@@ -1767,8 +1889,8 @@
       "name": "useGlobalConfig",
       "slug": "use-global-config",
       "kind": "composable",
-      "description": "在聊天根容器与子组件之间通过 provide/inject 共享全局展示配置（字号主题档位、是否支持上传、消息时间时区等）。",
-      "aiSummary": "useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>、timezone?: ComputedRef<string | undefined>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload 与 timezone； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。",
+      "description": "在聊天根容器与子组件之间通过 provide/inject 共享全局展示配置（字号主题档位、是否支持上传、消息时间时区、输入框菜单数据源）。",
+      "aiSummary": "useGlobalConfig 接收 GlobalConfig（含 size?: ComputedRef<AiSizeMode>、supportUpload: ComputedRef<boolean>、timezone?: ComputedRef<string | undefined>、menuSources?: ComputedRef<IInputMenuItem[]>），以 GLOBAL_CONFIG_TOKEN provide 给后代； injectGlobalConfig 在子组件中取出配置，无 Provider 时返回 undefined。ChatContainer 在 setup 中调用 useGlobalConfig 注入 size、supportUpload、timezone 与 menuSources； 后代组件可通过 injectGlobalConfig 读取配置；字号主题主要通过根节点 data-ai-size 与 CSS 变量生效。",
       "relatedComponents": [
         {
           "slug": "chat-container",
@@ -1781,16 +1903,46 @@
       ],
       "docFile": "docs/use-global-config.md"
     },
+    {
+      "name": "useInputMention",
+      "slug": "use-input-mention",
+      "kind": "composable",
+      "description": "通过 provide/inject 把「资源插入输入框」的能力开放给任意深度的后代组件。",
+      "aiSummary": "useInputMentionProvider 由持有输入框的容器（ChatContainer）提供 insertMention， useInputMentionConsumer 在任意后代取出；无 Provider（只读 / 分享态）时返回 undefined，调用方据此隐藏「引用」入口。 消息区文件卡片与侧栏产物面板即用它把文件以标签形式追加进输入框。 源码位置：src/composables/use-input-mention.ts。",
+      "relatedComponents": [
+        {
+          "slug": "chat-container",
+          "relation": "根容器提供 insertMention，内部转发给 ChatInput 实例"
+        },
+        {
+          "slug": "chat-input",
+          "relation": "实际执行插入的组件，expose insertMention"
+        },
+        {
+          "slug": "file-artifact-panel",
+          "relation": "侧栏产物面板据此展示「引用」按钮"
+        },
+        {
+          "slug": "assistant-message",
+          "relation": "消息内文件卡片据此展示「引用」按钮"
+        }
+      ],
+      "docFile": "docs/use-input-mention.md"
+    },
     {
       "name": "useMenuKeydown",
       "slug": "use-menu-keydown",
       "kind": "composable",
       "description": "为弹出菜单提供键盘导航能力的组合式函数。在 `onMounted` 时于 **`window` 捕获阶段**注册 `keydown` 监听，在 `onScopeDispose` 时自动移除，通过 `menuRef.offsetParent` 检测菜单可见性来决定是否响应按键。",
-      "aiSummary": "useMenuKeydown 接收 items、menuRef、onSelect，在 window 捕获阶段监听 keydown；菜单不可见（offsetParent 为空）或列表为空时不响应。 维护 activeIndex，处理 ArrowUp/ArrowDown 循环与 Enter 选中，并 scrollIntoView 当前 .is-active 项。 AiSlashMenu、AiPromptList（ChatInput 子模块）内部使用。",
+      "aiSummary": "useMenuKeydown 接收 items、menuRef、onSelect，在 window 捕获阶段监听 keydown；菜单不可见（offsetParent 为空）或列表为空时不响应。 维护 activeIndex，处理 ArrowUp/ArrowDown 循环与 Enter 选中，并 scrollIntoView 当前 .is-active 项。 InputMenuPanel（输入框统一菜单）与 ModelSelectorPanel（模型下拉）内部使用。",
       "relatedComponents": [
         {
-          "slug": "chat-input",
-          "relation": "AiSlashMenu / AiPromptList 键盘导航"
+          "slug": "input-menu-panel",
+          "relation": "输入框菜单的键盘导航"
+        },
+        {
+          "slug": "model-selector",
+          "relation": "模型下拉的键盘导航"
         }
       ],
       "docFile": "docs/use-menu-keydown.md"
@@ -1937,7 +2089,7 @@
       "slug": "overflow-tips",
       "kind": "directive",
       "description": "当元素文本**水平溢出**（`scrollWidth > clientWidth`）时，鼠标悬停自动弹出 Tippy tooltip 显示完整内容；未溢出时不创建实例，零性能损耗。",
-      "aiSummary": "v-overflow-tips 在元素水平溢出（scrollWidth > clientWidth）时于 mouseenter 懒创建 Tippy，展示完整文本或自定义 text/content。 结合 IntersectionObserver 仅在可见时绑定悬停；隐藏时销毁实例。指令值为 Partial<TippyProps> 与 disabled 等。 DescPanel、ExecutionSummary、ToolcallRender、AiSlashMenu 等用于标题或列表溢出提示。",
+      "aiSummary": "v-overflow-tips 在元素水平溢出（scrollWidth > clientWidth）时于 mouseenter 懒创建 Tippy，展示完整文本或自定义 text/content。 结合 IntersectionObserver 仅在可见时绑定悬停；隐藏时销毁实例。指令值为 Partial<TippyProps> 与 disabled 等。 DescPanel、ExecutionSummary、ToolcallRender、InputMenuPanel 等用于标题或列表溢出提示。",
       "relatedComponents": [
         {
           "slug": "desc-panel",
@@ -1952,8 +2104,8 @@
           "relation": "工具标题行溢出"
         },
         {
-          "slug": "chat-input",
-          "relation": "AiSlashMenu 资源项（侧栏子模块）"
+          "slug": "input-menu-panel",
+          "relation": "菜单条目名称溢出"
         }
       ],
       "docFile": "docs/overflow-tips.md"

package/dist/types/editor.d.ts

@@ -1,30 +1 @@
-export interface IAiSlashGroupItem {
-    isExpand: boolean;
-    items: IAiSlashMenuItem[];
-    name: string;
-    type: keyof typeof resourceTypeMap;
-}
-export interface IAiSlashMenuItem {
-    [key: string]: unknown;
-    code?: string;
-    icon: null | string;
-    id?: number | string;
-    name: string;
-    type: keyof typeof resourceTypeMap;
-}
-export declare const resourceTypeMap: {
-    readonly tool: "工具";
-    readonly skill: "Skill";
-    readonly mcp: "MCP";
-    readonly doc: "知识库";
-    readonly knowledgebase: "知识库";
-    readonly shortcut: "快捷指令";
-};
-export type ResourceType = keyof typeof resourceTypeMap;
 export declare const noop: () => void;
-export interface ISkillListItem {
-    description: string;
-    icon: string;
-    skill_code: string;
-    skill_name: string;
-}

package/dist/types/index.d.ts

@@ -2,5 +2,6 @@ export * from './custom';
 export * from './editor';
 export * from './image';
 export * from './input';
+export * from './input-menu';
 export * from './shortcut';
 export * from './tool';

package/dist/types/input-menu.d.ts

@@ -0,0 +1,46 @@
+import type { Component } from 'vue';
+import type { lang } from '../lang/lang';
+/**
+ * 输入框菜单可选项类型。
+ *
+ * `file` 是组件内置的动作项（触发本地文件上传），不由业务方通过 `menuSources` 提供。
+ */
+export declare const MENU_ITEM_TYPES: readonly ["file", "skill", "mcp", "tool", "knowledgebase", "doc", "artifact", "prompt"];
+/** 面板渲染用的分组（已应用关键字过滤与折叠阈值） */
+export interface IInputMenuGroup {
+    /** 分组下方是否需要分隔线 */
+    divided: boolean;
+    /** 是否已展开全部条目 */
+    expanded: boolean;
+    /** 当前可见条目 */
+    items: IInputMenuItem[];
+    key: string;
+    /** 分组标题的文案 key，渲染时经 t() 转换 */
+    name: keyof typeof lang;
+    /** 被折叠隐藏的条数，为 0 表示无需折叠 */
+    restCount: number;
+}
+/** 输入框菜单的统一可选项模型 */
+export interface IInputMenuItem {
+    /** Prompt 全文；选中 prompt 时用它整体替换输入框内容 */
+    content?: string;
+    /** 描述文案，有值时 hover 弹出气泡说明 */
+    description?: string;
+    disabled?: boolean;
+    /**
+     * 图标：URL 字符串或 Vue 组件；缺省时按 type 回退到内置图标，artifact 按文件名后缀推导。
+     *
+     * 注意：选中后插入输入框的标签会把图标序列化到 DOM 属性上（文档需脱离数据源独立还原），
+     * 因此只有字符串形式能被保留，传组件时标签内会回退为类型默认图标。
+     */
+    icon?: Component | string;
+    /** artifact 类型必须使用文件的 outputId，不能用 URL 或文件名代替 */
+    id: string;
+    name: string;
+    type: MenuItemType;
+}
+export type MenuItemType = (typeof MENU_ITEM_TYPES)[number];
+/**
+ * 菜单触发方式。字符触发在编辑器中输入对应字符唤起，`plus` 由左下角 + 号按钮唤起。
+ */
+export type MenuTrigger = '/' | '@' | '\\' | 'plus';

package/dist/utils/artifact-tags.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 附件与 artifact 标签的互转。
+ *
+ * 上传附件既以文件卡片展示，也要以标签形式进入文档（业务方据此把已选资源发给后端）。
+ * 注入与剥离必须共用同一套 value 口径，否则发送时补上的标签在回显时剥不掉，就会重复展示。
+ */
+import type { AIFileInfo } from '../ag-ui/types/file';
+import type { TagSchema } from '../types/input';
+type TagLine = TagSchema[number];
+type TagNode = TagLine[number];
+type ArtifactTagNode = Extract<TagNode, {
+    type: 'tag';
+}>;
+/** 附件的最小身份契约，`Partial<UploadFile>` 与 `BinaryInputContent` 均可直接传入 */
+export type ArtifactIdentityLike = {
+    id?: string;
+    outputId?: string;
+};
+/**
+ * 文件转 artifact 标签节点：`label` 取展示名（上传接口 `name`），
+ * `value` 取文件身份（上传接口 `path`，即产物 `outputId`）。
+ */
+export declare const toArtifactTagNode: (file: AIFileInfo) => ArtifactTagNode;
+/**
+ * 发送前把待发送附件补成一行 artifact 标签。
+ *
+ * 编辑回填的文档可能已含同一文件的标签（上次发送时注入的），按 value 去重避免重复追加。
+ */
+export declare const appendArtifactTags: (doc: TagSchema, files: readonly AIFileInfo[]) => TagSchema;
+/**
+ * 消息回显与编辑回填前，去掉已由附件卡片承载的 artifact 标签，避免同一文件重复展示。
+ *
+ * 历史消息经 chat-helper 转换后只剩 `id`，因此 `id` 与 `outputId` 都参与匹配。
+ */
+export declare const omitArtifactTags: (doc: TagSchema, files: readonly ArtifactIdentityLike[]) => TagSchema;
+export {};