@blueking/chat-x 2.4.1 → 2.4.2-beta.1

package/dist/mcp/generated/docs/shortcut-render.md

@@ -309,6 +309,24 @@ const components: ShortcutComponent[] = [
 ];
 ```
 
+`type: 'select'` 时，组件会把默认挂载点写进 `popoverOptions.boundary`，再与 `component.props.popoverOptions` 浅合并。调用方传入的字段（含 `boundary`）优先。
+
+## select 下拉挂载
+
+Select 的下拉是 bkui Popover，默认会 Teleport 到 `document.body`，层级从 8000 起算。小鲸浮窗是 `position: fixed; z-index: 10000`，下拉挂到 body 后会画在浮窗后面。
+
+`ShortcutRender` 挂在 `ChatContainer` 内时，复用同一份 tippy `appendTo`（`useCommonTippyInject`）作为 `popoverOptions.boundary`：
+
+| `appendTo` | `boundary` |
+| --- | --- |
+| `HTMLElement` | 该元素 |
+| 返回 `HTMLElement` 的函数 | 函数返回值。ChatBot 默认是 `() => rootRef ?? document.body`，即 `.ai-chatbot` |
+| 未注入，或值为 `'parent'` 等无法解析的结果 | `'body'` |
+
+这样下拉留在小鲸自己的层叠上下文里，bkui 自己的递增 z-index 即可盖过表单，不必再写死一个高于浮窗的数字。
+
+不要把 `boundary` 设成 `'parent'`。`.ai-shortcut-render` 有 `overflow: hidden`，下拉会被裁掉。全屏时 `ChatContainer` 会把 `appendTo` 换成全屏容器，下拉跟着挂到那里。
+
 通过 `component.formItemProps` 透传给 `Form.FormItem`：
 
 ```typescript
@@ -368,7 +386,7 @@ const components: ShortcutComponent[] = [
 | `text`          | `Input`                | 同 `input`，兼容旧版写法     |
 | `textarea`      | `Input[type=textarea]` | 多行文本，**始终独占一行**   |
 | `number`        | `Input[type=number]`   | 数字输入，支持 `min` / `max` |
-| `select`        | `Select`               | 下拉选择，需配置 `options`   |
+| `select`        | `Select`               | 下拉选择，需配置 `options`；下拉挂载见 [select 下拉挂载](#select-下拉挂载) |
 | `radioGroup`    | `Radio.Group`          | 单选组，需配置 `options`     |
 | `checkboxGroup` | `Checkbox.Group`       | 多选组，需配置 `options`     |
 | `switcher`      | `Switcher`             | 开关，值为 `boolean`         |

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-09-21T11:36:57.667Z",
+  "generatedAt": "2026-09-28T07:36:28.606Z",
   "domains": {
     "setup": {
       "label": "对话搭建",

package/package.json

@@ -1,26 +1,8 @@
 {
   "name": "@blueking/chat-x",
-  "version": "2.4.1",
+  "version": "2.4.2-beta.1",
   "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"
   },
@@ -69,7 +51,6 @@
     "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",
@@ -98,6 +79,24 @@
     "vite-bundle-analyzer": "^1.3.2",
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18",
-    "vue-tsc": "^3.1.4"
+    "vue-tsc": "^3.1.4",
+    "@blueking/chat-helper": "2.4.0"
+  },
+  "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"
   }
-}
+}

package/skills/blueking-chat-x/references/components/shortcut-render.md

@@ -306,6 +306,24 @@ const components: ShortcutComponent[] = [
 ];
 ```
 
+`type: 'select'` 时，组件会把默认挂载点写进 `popoverOptions.boundary`，再与 `component.props.popoverOptions` 浅合并。调用方传入的字段（含 `boundary`）优先。
+
+## select 下拉挂载
+
+Select 的下拉是 bkui Popover，默认会 Teleport 到 `document.body`，层级从 8000 起算。小鲸浮窗是 `position: fixed; z-index: 10000`，下拉挂到 body 后会画在浮窗后面。
+
+`ShortcutRender` 挂在 `ChatContainer` 内时，复用同一份 tippy `appendTo`（`useCommonTippyInject`）作为 `popoverOptions.boundary`：
+
+| `appendTo` | `boundary` |
+| --- | --- |
+| `HTMLElement` | 该元素 |
+| 返回 `HTMLElement` 的函数 | 函数返回值。ChatBot 默认是 `() => rootRef ?? document.body`，即 `.ai-chatbot` |
+| 未注入，或值为 `'parent'` 等无法解析的结果 | `'body'` |
+
+这样下拉留在小鲸自己的层叠上下文里，bkui 自己的递增 z-index 即可盖过表单，不必再写死一个高于浮窗的数字。
+
+不要把 `boundary` 设成 `'parent'`。`.ai-shortcut-render` 有 `overflow: hidden`，下拉会被裁掉。全屏时 `ChatContainer` 会把 `appendTo` 换成全屏容器，下拉跟着挂到那里。
+
 通过 `component.formItemProps` 透传给 `Form.FormItem`：
 
 ```typescript
@@ -365,7 +383,7 @@ const components: ShortcutComponent[] = [
 | `text`          | `Input`                | 同 `input`，兼容旧版写法     |
 | `textarea`      | `Input[type=textarea]` | 多行文本，**始终独占一行**   |
 | `number`        | `Input[type=number]`   | 数字输入，支持 `min` / `max` |
-| `select`        | `Select`               | 下拉选择，需配置 `options`   |
+| `select`        | `Select`               | 下拉选择，需配置 `options`；下拉挂载见 [select 下拉挂载](#select-下拉挂载) |
 | `radioGroup`    | `Radio.Group`          | 单选组，需配置 `options`     |
 | `checkboxGroup` | `Checkbox.Group`       | 多选组，需配置 `options`     |
 | `switcher`      | `Switcher`             | 开关，值为 `boolean`         |