@blueking/chat-x 0.0.52-dev.2 → 0.0.52-dev.4

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

@@ -32,16 +32,16 @@
 ai-chat-input-container（padding: 0 16px 16px）
 ├── slot#top（框体外顶部）
 ├── slot#interrupt（框体外顶部，位于 top 之后）
-└── chat-input-wrapper（相对定位；宽度 168px ~ 1000px）
-    ├── InputMenuPanel（绝对定位于框体上方 8px、与框体等宽，菜单激活且有条目时渲染）
-    └── chat-input（框体，min-height 110px，max-height 由 inputMaxHeight 控制）
-        ├── slot#input-header（默认：cite 非空时渲染 CiteContent）
-        ├── slot#files（默认：有上传文件时渲染 FileContent）
-        ├── AiSlashInput（富文本编辑区，默认保持 4 行高度）
-        └── InputAttachment（底部工具栏，固定 32px 高）
-            ├── slot#default → 隐藏 file input + AddMenuBtn（+ 号）+ 分隔线 + slot#attachment
-            ├── slot#before-send → slot#model-selector（默认 ModelSelector）
-            └── slot#send-icon（默认：发送 / 停止图标）
+└── chat-input-wrapper（宽度 168px ~ 1000px）
+    └── InputMenu（vue-tippy 挂到输入框，菜单激活且有条目时展开；面板在 body，框体上方 8px、与框体等宽）
+        └── chat-input（框体，min-height 110px，max-height 由 inputMaxHeight 控制）
+            ├── slot#input-header（默认：cite 非空时渲染 CiteContent）
+            ├── slot#files（默认：有上传文件时渲染 FileContent）
+            ├── AiSlashInput（富文本编辑区，默认保持 4 行高度）
+            └── InputAttachment（底部工具栏，固定 32px 高）
+                ├── slot#default → 隐藏 file input + AddMenuBtn（+ 号）+ 分隔线 + slot#attachment
+                ├── slot#before-send → slot#model-selector（默认 ModelSelector）
+                └── slot#send-icon（默认：发送 / 停止图标）
 ```
 
 > `slot#attachment` 只替换快捷指令区，`AddMenuBtn` 在其外部，使用该插槽不会移除 + 号。`slot#send-icon` 只替换图标，点击逻辑与按钮样式仍由组件控制。
@@ -396,7 +396,7 @@ const defaultFiles: UploadFile[] = [
 
 ## 模型选择
 
-传入 `models` 后在发送按钮左侧展示 [ModelSelector](/components/input/model-selector)。选中值（模型的 `llm_name`）通过 `v-model:selected-model` 双向绑定，`@model-change` 可获取完整模型对象，能力标签由组件依据 `property` 自动派生。
+传入 `models` 后在发送按钮左侧展示 [ModelSelector](/components/input/model-selector)。选中值（模型的 `llm_name`）通过 `v-model:selected-model` 双向绑定，`@model-change` 可获取完整模型对象，能力标签由组件依据 `property` 自动派生。默认选择器展开时会收起输入框菜单；自定义 `#model-selector` 时需自行处理。
 
 ```vue
 <template>

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

@@ -1,10 +1,10 @@
 <!-- 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）。
+InputMenuPanel 渲染输入框菜单：分组标题 + InputMenuOption 条目 + 「更多 +N」折叠开关， 内置键盘上下导航与 Esc 关闭；分组数据由 useInputMenu 纯数据逻辑算出（按触发方式筛类型 → 关键字过滤 → 分组 → 折叠 → 扁平化）。 源码位置：src/components/chat-input/input-menu/（input-menu.vue、input-menu-panel.vue、input-menu-option.vue、use-input-menu.ts、constants.ts）。
 
 ### 关联组件
-- **chat-input** — 上层持有触发态与数据源并渲染本面板
+- **chat-input** — 上层持有触发态与数据源，通过 InputMenu（vue-tippy）渲染本面板
 - **ai-slash-input** — 触发方式与过滤关键字由编辑器 menuChange 抛出
 - **add-menu-btn** — + 号唤起 plus 触发的聚合菜单
 - **resource-icon** — 条目左侧图标由 ResourceIcon 渲染
@@ -19,6 +19,7 @@ InputMenuPanel 渲染输入框菜单：分组标题 + InputMenuOption 条目 +
 ## 源码事实
 
 - **面板**：`src/components/chat-input/input-menu/input-menu-panel.vue`
+- **浮层壳**：`src/components/chat-input/input-menu/input-menu.vue`（vue-tippy，把面板挂到输入框上方）
 - **条目**：`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`
@@ -26,7 +27,7 @@ InputMenuPanel 渲染输入框菜单：分组标题 + InputMenuOption 条目 +
 
 ## 布局与交互
 
-- 面板由 [ChatInput](/components/input/chat-input) 绝对定位在输入框**正上方 8px**、与输入框等宽，**不跟随光标**；最大高度 400px，超出滚动。
+- 面板由 [ChatInput](/components/input/chat-input) 的 `InputMenu` 通过 **vue-tippy** 挂到输入框上：默认 `appendTo` body，位于框体**正上方 8px**、与输入框等宽，**不跟随光标**；最大高度 400px，超出滚动。浮层不再使用绝对定位，避免被外层 `overflow` 裁切。
 - 键盘导航由 [useMenuKeydown](/composables/use-menu-keydown) 提供：`↑` / `↓` 移动高亮，`Enter` 选中，高亮项滚动进可视区；结果集变化后高亮回到首项。
 - `Esc` 在**捕获阶段**监听并 emit `close`，避免被编辑器先行消费。
 - 面板滚动时关闭条目描述气泡，防止气泡与列表错位。

package/dist/mcp/generated/docs/model-selector.md

@@ -98,6 +98,7 @@ ModelSelector（Tippy 容器，theme: ai-model-selector）
 | 事件名 | 参数                    | 说明                 |
 | ------ | ----------------------- | -------------------- |
 | change | `(model: IModelOption)` | 用户选中模型时触发   |
+| show   | —                       | 下拉展开时触发（ChatInput 用来收起输入框菜单） |
 
 ## 类型定义
 

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-09-15T08:21:06.653Z",
+  "generatedAt": "2026-09-16T03:27:02.809Z",
   "domains": {
     "setup": {
       "label": "对话搭建",
@@ -903,11 +903,11 @@
       "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）。",
+      "aiSummary": "InputMenuPanel 渲染输入框菜单：分组标题 + InputMenuOption 条目 + 「更多 +N」折叠开关， 内置键盘上下导航与 Esc 关闭；分组数据由 useInputMenu 纯数据逻辑算出（按触发方式筛类型 → 关键字过滤 → 分组 → 折叠 → 扁平化）。 源码位置：src/components/chat-input/input-menu/（input-menu.vue、input-menu-panel.vue、input-menu-option.vue、use-input-menu.ts、constants.ts）。",
       "relatedComponents": [
         {
           "slug": "chat-input",
-          "relation": "上层持有触发态与数据源并渲染本面板"
+          "relation": "上层持有触发态与数据源，通过 InputMenu（vue-tippy）渲染本面板"
         },
         {
           "slug": "ai-slash-input",

package/package.json

@@ -1,8 +1,26 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.52-dev.2",
+  "version": "0.0.52-dev.4",
   "description": "蓝鲸智云 AI Chat 组件库 —— 遵循 AG-UI，为 AI Agent 和人类开发者共同设计的对话 UI 组件库。",
   "main": "index.js",
+  "scripts": {
+    "prepublishOnly": "vite --config vite.config.ts build && pnpm dts && pnpm mcp:build",
+    "dev": "vite --config vite.config.ts",
+    "dts": "vue-tsc --project tsconfig.dts.json",
+    "build": "vitest && vite --config vite.config.ts build && pnpm dts",
+    "preview": "vite --config vite.config.ts build --mode preview && pnpm dts",
+    "lint:script": "eslint . --ext .vue,.ts --fix",
+    "lint:style": "stylelint \"**/*.{scss,css,vue}\" --fix",
+    "lint:all": "pnpm lint:script && pnpm lint:style",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "wiki:dev": "vitepress dev wikis",
+    "wiki:build": "vitepress build wikis",
+    "mcp:build:index": "tsx mcp/scripts/build-index.ts",
+    "mcp:build": "tsc -p mcp/tsconfig.json && pnpm mcp:build:index",
+    "mcp:start": "node dist/mcp/index.js",
+    "mcp:dev": "tsx mcp/src/index.ts"
+  },
   "bin": {
     "chat-x-mcp": "dist/mcp/index.js"
   },
@@ -51,6 +69,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@blueking/chat-helper": "workspace:*",
     "@types/katex": "^0.16.7",
     "@types/lodash": "^4.17.23",
     "@types/markdown-it": "^14.1.2",
@@ -79,24 +98,6 @@
     "vite-bundle-analyzer": "^1.3.2",
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18",
-    "vue-tsc": "^3.1.4",
-    "@blueking/chat-helper": "0.0.13-dev.1"
-  },
-  "scripts": {
-    "dev": "vite --config vite.config.ts",
-    "dts": "vue-tsc --project tsconfig.dts.json",
-    "build": "vitest && vite --config vite.config.ts build && pnpm dts",
-    "preview": "vite --config vite.config.ts build --mode preview && pnpm dts",
-    "lint:script": "eslint . --ext .vue,.ts --fix",
-    "lint:style": "stylelint \"**/*.{scss,css,vue}\" --fix",
-    "lint:all": "pnpm lint:script && pnpm lint:style",
-    "test": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "wiki:dev": "vitepress dev wikis",
-    "wiki:build": "vitepress build wikis",
-    "mcp:build:index": "tsx mcp/scripts/build-index.ts",
-    "mcp:build": "tsc -p mcp/tsconfig.json && pnpm mcp:build:index",
-    "mcp:start": "node dist/mcp/index.js",
-    "mcp:dev": "tsx mcp/src/index.ts"
+    "vue-tsc": "^3.1.4"
   }
 }

package/skills/blueking-chat-x/references/components/chat-input.md

@@ -24,16 +24,16 @@
 ai-chat-input-container（padding: 0 16px 16px）
 ├── slot#top（框体外顶部）
 ├── slot#interrupt（框体外顶部，位于 top 之后）
-└── chat-input-wrapper（相对定位；宽度 168px ~ 1000px）
-    ├── InputMenuPanel（绝对定位于框体上方 8px、与框体等宽，菜单激活且有条目时渲染）
-    └── chat-input（框体，min-height 110px，max-height 由 inputMaxHeight 控制）
-        ├── slot#input-header（默认：cite 非空时渲染 CiteContent）
-        ├── slot#files（默认：有上传文件时渲染 FileContent）
-        ├── AiSlashInput（富文本编辑区，默认保持 4 行高度）
-        └── InputAttachment（底部工具栏，固定 32px 高）
-            ├── slot#default → 隐藏 file input + AddMenuBtn（+ 号）+ 分隔线 + slot#attachment
-            ├── slot#before-send → slot#model-selector（默认 ModelSelector）
-            └── slot#send-icon（默认：发送 / 停止图标）
+└── chat-input-wrapper（宽度 168px ~ 1000px）
+    └── InputMenu（vue-tippy 挂到输入框，菜单激活且有条目时展开；面板在 body，框体上方 8px、与框体等宽）
+        └── chat-input（框体，min-height 110px，max-height 由 inputMaxHeight 控制）
+            ├── slot#input-header（默认：cite 非空时渲染 CiteContent）
+            ├── slot#files（默认：有上传文件时渲染 FileContent）
+            ├── AiSlashInput（富文本编辑区，默认保持 4 行高度）
+            └── InputAttachment（底部工具栏，固定 32px 高）
+                ├── slot#default → 隐藏 file input + AddMenuBtn（+ 号）+ 分隔线 + slot#attachment
+                ├── slot#before-send → slot#model-selector（默认 ModelSelector）
+                └── slot#send-icon（默认：发送 / 停止图标）
 ```
 
 > `slot#attachment` 只替换快捷指令区，`AddMenuBtn` 在其外部，使用该插槽不会移除 + 号。`slot#send-icon` 只替换图标，点击逻辑与按钮样式仍由组件控制。
@@ -388,7 +388,7 @@ const defaultFiles: UploadFile[] = [
 
 ## 模型选择
 
-传入 `models` 后在发送按钮左侧展示 [ModelSelector](/components/input/model-selector)。选中值（模型的 `llm_name`）通过 `v-model:selected-model` 双向绑定，`@model-change` 可获取完整模型对象，能力标签由组件依据 `property` 自动派生。
+传入 `models` 后在发送按钮左侧展示 [ModelSelector](/components/input/model-selector)。选中值（模型的 `llm_name`）通过 `v-model:selected-model` 双向绑定，`@model-change` 可获取完整模型对象，能力标签由组件依据 `property` 自动派生。默认选择器展开时会收起输入框菜单；自定义 `#model-selector` 时需自行处理。
 
 ```vue
 <template>

package/skills/blueking-chat-x/references/components/input-menu-panel.md

@@ -2,9 +2,9 @@
 
 > 能力域：输入交互 ｜ 未从包入口导出：内部组件，请通过上层组件使用 ｜ since 0.0.51
 
-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）。
+InputMenuPanel 渲染输入框菜单：分组标题 + InputMenuOption 条目 + 「更多 +N」折叠开关， 内置键盘上下导航与 Esc 关闭；分组数据由 useInputMenu 纯数据逻辑算出（按触发方式筛类型 → 关键字过滤 → 分组 → 折叠 → 扁平化）。 源码位置：src/components/chat-input/input-menu/（input-menu.vue、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 渲染）
+**关联**：chat-input（上层持有触发态与数据源，通过 InputMenu / vue-tippy 渲染本面板）、ai-slash-input（触发方式与过滤关键字由编辑器 menuChange 抛出）、add-menu-btn（+ 号唤起 plus 触发的聚合菜单）、resource-icon（条目左侧图标由 ResourceIcon 渲染）
 
 ---
 
@@ -15,6 +15,7 @@ InputMenuPanel 渲染输入框菜单：分组标题 + InputMenuOption 条目 +
 ## 源码事实
 
 - **面板**：`src/components/chat-input/input-menu/input-menu-panel.vue`
+- **浮层壳**：`src/components/chat-input/input-menu/input-menu.vue`（vue-tippy，把面板挂到输入框上方）
 - **条目**：`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`
@@ -22,7 +23,7 @@ InputMenuPanel 渲染输入框菜单：分组标题 + InputMenuOption 条目 +
 
 ## 布局与交互
 
-- 面板由 [ChatInput](/components/input/chat-input) 绝对定位在输入框**正上方 8px**、与输入框等宽，**不跟随光标**；最大高度 400px，超出滚动。
+- 面板由 [ChatInput](/components/input/chat-input) 的 `InputMenu` 通过 **vue-tippy** 挂到输入框上：默认 `appendTo` body，位于框体**正上方 8px**、与输入框等宽，**不跟随光标**；最大高度 400px，超出滚动。浮层不再使用绝对定位，避免被外层 `overflow` 裁切。
 - 键盘导航由 [useMenuKeydown](/composables/use-menu-keydown) 提供：`↑` / `↓` 移动高亮，`Enter` 选中，高亮项滚动进可视区；结果集变化后高亮回到首项。
 - `Esc` 在**捕获阶段**监听并 emit `close`，避免被编辑器先行消费。
 - 面板滚动时关闭条目描述气泡，防止气泡与列表错位。

package/skills/blueking-chat-x/references/components/model-selector.md

@@ -96,6 +96,7 @@ ModelSelector（Tippy 容器，theme: ai-model-selector）
 | 事件名 | 参数                    | 说明                 |
 | ------ | ----------------------- | -------------------- |
 | change | `(model: IModelOption)` | 用户选中模型时触发   |
+| show   | —                       | 下拉展开时触发（ChatInput 用来收起输入框菜单） |
 
 ## 类型定义