@blueking/chat-x 0.0.31 → 0.0.33

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

@@ -247,7 +247,7 @@ chat-input-container
 
 **渲染效果**（底部显示快捷指令按钮，点击选中后按钮变为已选状态）
 
-## 文件上传
+## 文件上传 {#file-upload}
 
 `supportUpload` 默认为 `true`，底部工具栏自动显示文件上传按钮。传入 `onUpload` 回调后即可处理文件上传：
 
@@ -257,6 +257,12 @@ chat-input-container
 - 文件自动去重（基于 `name + size + lastModified` 复合键），不会重复上传
 - 发送成功后，`uploadFiles` 自动清空
 
+**个数与大小校验（与 `FileUploadBtn` 分工）**：
+
+- 列表最多保留 **`MAX_UPLOAD_FILES`（3）** 个待发送附件；已满时再次选择/拖入/粘贴文件会弹出 **bkui-vue `Message` 错误提示**（`formatUploadNotAddedMessage`），且不会继续入队。
+- 在未满的前提下：空文件、单文件大小 **`>= MAX_UPLOAD_FILE_SIZE`（约 2.4MB）**、或与已有文件重复的项会被跳过；若本轮有任意文件因此未加入列表，会在处理结束后弹出**同一条文案风格**的错误提示，汇总未成功添加的数量。
+- `FileUploadBtn` 仅在按钮层过滤**空文件与单文件超大**，把合法文件以数组形式 `upload` 上来；**个数上限与重复校验**在 `ChatInput` 的 `handleUpload` 中统一处理，避免与按钮层各弹一条提示。
+
 **发送内容格式**（有文件时）：
 
 ```typescript

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

@@ -1,7 +1,7 @@
 <!-- AI SUMMARY -->
 ## 快速了解
 
-FileUploadBtn 提供隐藏 file input 与图标按钮，选择文件后 emit upload，并内置数量与单文件大小上限校验。 常用于 ChatInput 工具条；与 FileContent 等展示列表配合形成「选择 → 展示 → 发送」链路。
+FileUploadBtn 提供隐藏 file input 与图标按钮，选择后在按钮层过滤空文件与超大单文件并 emit upload； 个数上限不在此截断，由 ChatInput 等与 FileContent 配合完成「选择 → 展示 → 发送」链路。
 
 ### 关联组件
 - **chat-input** — 输入区附件上传按钮常见挂载位置
@@ -14,7 +14,7 @@ FileUploadBtn 提供隐藏 file input 与图标按钮，选择文件后 emit upl
 
 > **层级**：原子组件 · **功能域**：文件与图片
 
-聊天输入框内置的文件上传触发按钮，点击后弹出系统文件选择框。内部包含隐藏的 `<input type="file">` 与可见的图标按钮，并内置文件数量及大小校验逻辑。
+聊天输入框内置的文件上传触发按钮，点击后弹出系统文件选择框。内部包含隐藏的 `<input type="file">` 与可见的图标按钮；在按钮层对**单文件**做大小与空文件过滤，**已选文件个数上限**由上层（如 `ChatInput`）统一校验并提示，避免按钮与输入区各弹一条错误提示。
 
 ## 组件结构
 
@@ -33,27 +33,31 @@ FileUploadBtn 提供隐藏 file input 与图标按钮，选择文件后 emit upl
 ```
 用户选择文件
   │
-  ├─ files.length > Math.max(maxFiles, MAX_UPLOAD_FILES[3])
-  │       ↓ true → bkui-vue Message.error("最多上传 N 个文件")，终止，不 emit
+  ├─ 遍历所选文件：size > 0 且 size < MAX_UPLOAD_FILE_SIZE（约 2.4MB）→ 加入 toEmit
+  │       size 为 0 或 ≥ 上限 → sizeRejected += 1
   │
-  └─ emit('upload', files.filter(f => f.size > 0 && f.size < MAX_UPLOAD_FILE_SIZE[2.5MB]))
-        ↓
-      target.value = ''（重置 input，允许再次选择同一文件）
+  ├─ sizeRejected > 0 → bkui-vue Message.error（formatUploadNotAddedMessage，说明可能超大或超出个数等）
+  │
+  ├─ toEmit.length > 0 → emit('upload', toEmit)
+  │
+  └─ target.value = ''（重置 input，允许再次选择同一文件）
 ```
 
 **关键边界行为**：
 
-| 场景                                      | 结果                                                        |
-| ----------------------------------------- | ----------------------------------------------------------- |
-| 文件数超过 `Math.max(maxFiles, 3)`        | 弹出错误 toast，**不触发** `upload`                         |
-| 文件数未超限，但部分文件被大小过滤        | **仍触发** `upload`，payload 为过滤后的数组（可能为空数组） |
-| `file.size === 0`                         | 被过滤（空文件）                                            |
-| `file.size >= 2.5MB`（即 `2621440` 字节） | 被过滤（使用严格小于 `<`，等于 2.5MB 也会被过滤）           |
-| `maxFiles` 设为小于 3 的值（如 `1`）      | 实际限制取 `Math.max(1, 3) = 3`，不低于全局下限             |
-| 选择后取消                                | `files.length === 0`，不触发 `upload`                       |
+| 场景                                                         | 结果                                                                 |
+| ------------------------------------------------------------ | -------------------------------------------------------------------- |
+| 一次多选超过上层允许个数（如 `ChatInput` 内已达 3 个）       | 由 **ChatInput** 侧 toast 并丢弃/不计入，不在本按钮内按个数提前拦截 |
+| 部分文件因空文件或单文件超大被过滤                           | 弹出错误 toast；若仍有合法文件，**仍触发** `upload`（payload 为合法子集） |
+| 全部被过滤（均为空或超大）                                   | 仅 toast，**不触发** `upload`                                        |
+| `file.size === 0`                                          | 计入未添加提示，不进入 `upload` payload                              |
+| `file.size >= MAX_UPLOAD_FILE_SIZE`（与全局常量一致，约 2.4MB） | 计入未添加提示，不进入 `upload` payload（比较为严格 `<`）           |
+| 选择后取消                                                   | `files.length === 0`，不触发 `upload`                                |
 
 > `multiple` prop 声明存在但当前模板中 `input` 的 `multiple` 属性为**硬编码**（非 `:multiple="multiple"` 绑定），始终允许多选，该 prop 暂时无实际效果。
 
+> **`maxFiles` prop**：当前版本在按钮内**不参与截断或计数校验**，仅作类型与文档预留；列表最多几个文件由上层（如 `ChatInput` 的 `MAX_UPLOAD_FILES`）控制。详见 [ChatInput 文件上传](../molecular/chat-input.md#file-upload)。
+
 ## 基础用法
 
 ```vue
@@ -101,26 +105,6 @@ FileUploadBtn 提供隐藏 file input 与图标按钮，选择文件后 emit upl
 
 > `accept` 仅影响文件选择框的过滤 UI，不做服务端验证，请在 `upload` 回调中自行校验 MIME 类型。
 
-## 限制上传数量
-
-`maxFiles` 限制单次选择的文件上传上限，实际生效值为 `Math.max(maxFiles, 3)`，不会低于全局下限 3：
-
-```vue
-<template>
-  <!-- maxFiles=5：可一次选 5 个文件 -->
-  <FileUploadBtn
-    :max-files="5"
-    @upload="handleUpload"
-  />
-
-  <!-- maxFiles=1：实际等效 maxFiles=3（取 Math.max(1,3)） -->
-  <FileUploadBtn
-    :max-files="1"
-    @upload="handleUpload"
-  />
-</template>
-```
-
 ## 自定义图标
 
 通过默认插槽替换上传图标：
@@ -137,18 +121,18 @@ FileUploadBtn 提供隐藏 file input 与图标按钮，选择文件后 emit upl
 
 ### Props
 
-| 属性名       | 类型           | 默认值      | 说明                                                   |
-| ------------ | -------------- | ----------- | ------------------------------------------------------ |
-| accept       | `string`       | `'image/*'` | 文件选择框过滤类型，遵循 `<input accept>` 规范         |
-| maxFiles     | `number`       | `3`         | 单次选择文件数上限；实际限制为 `Math.max(maxFiles, 3)` |
-| multiple     | `boolean`      | `true`      | 声明属性（当前版本未实际绑定到 input，始终多选）       |
-| tippyOptions | `AITippyProps` | —           | 扩展 tooltip 配置，会与内置配置合并                    |
+| 属性名       | 类型           | 默认值      | 说明                                                                 |
+| ------------ | -------------- | ----------- | -------------------------------------------------------------------- |
+| accept       | `string`       | `'image/*'` | 文件选择框过滤类型，遵循 `<input accept>` 规范                       |
+| maxFiles     | `number`       | `3`         | 预留字段，**当前不在按钮内生效**；个数上限见 `ChatInput` 与全局常量 |
+| multiple     | `boolean`      | `true`      | 声明属性（当前版本未实际绑定到 input，始终多选）                     |
+| tippyOptions | `AITippyProps` | —           | 扩展 tooltip 配置，会与内置配置合并                                |
 
 ### Events
 
 | 事件名 | 参数              | 说明                                                                                      |
 | ------ | ----------------- | ----------------------------------------------------------------------------------------- |
-| upload | `(files: File[])` | 校验通过后触发；`files` 为过滤掉空文件和超大文件（≥ 2.5MB）后的数组；超出数量限制时不触发 |
+| upload | `(files: File[])` | 当存在至少一个合法文件时触发；`files` 为过滤掉空文件与单文件超大（`size >= MAX_UPLOAD_FILE_SIZE`，约 2.4MB）后的数组；个数截断不在此组件内完成 |
 
 ### Slots
 

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

@@ -150,8 +150,8 @@ Teleport(to="body")
 
 > **ObjectURL 生命周期管理**：组件内部维护 `objectUrls` 数组，在以下时机自动回收：
 >
-> - `images` prop 变化触发 `normalizedImages` 重新计算时
-> - `visible` 从 `true` 变为 `false` 时
+> - `normalizedImages` 计算属性重算时（会先 `revokeObjectUrls`，再按当前 `images` 与 `visible` 生成新列表）
+> - **`visible` 为 `false` 时**：计算属性直接清空并 `revokeObjectURL`，避免仅依赖 `props.images` 时 computed 仍缓存**已失效**的 blob URL，导致关闭预览后再次打开加载失败
 > - 组件 `onBeforeUnmount` 时
 
 ## API

package/dist/mcp/generated/docs/use-observer-visible-list.md

@@ -186,4 +186,4 @@ function useObserverVisibleList<T>(
 
 ## 关联组件
 
-- [ShortcutBtns](../components/molecular/shortcut-btns.md) — 快捷指令条与「更多」
+- [ShortcutBtns](../components/atomic/shortcut-btns.md) — 快捷指令条与「更多」

package/dist/mcp/generated/index.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-04-23T03:16:12.447Z",
+  "generatedAt": "2026-04-24T02:55:34.652Z",
   "domains": {
     "message": {
       "label": "消息展示",
@@ -210,8 +210,8 @@
       "name": "FileUploadBtn 文件上传按钮",
       "slug": "file-upload-btn",
       "category": "atomic",
-      "description": "聊天输入框内置的文件上传触发按钮，点击后弹出系统文件选择框。内部包含隐藏的 `<input type=\"file\">` 与可见的图标按钮，并内置文件数量及大小校验逻辑。",
-      "aiSummary": "FileUploadBtn 提供隐藏 file input 与图标按钮，选择文件后 emit upload，并内置数量与单文件大小上限校验。 常用于 ChatInput 工具条；与 FileContent 等展示列表配合形成「选择 → 展示 → 发送」链路。",
+      "description": "聊天输入框内置的文件上传触发按钮，点击后弹出系统文件选择框。内部包含隐藏的 `<input type=\"file\">` 与可见的图标按钮；在按钮层过滤空文件与超过单文件大小上限的文件，**上传个数上限由上层（如 ChatInput）统一处理**。",
+      "aiSummary": "FileUploadBtn 提供隐藏 file input 与图标按钮，选择后在按钮层过滤空文件与超大单文件并 emit upload； 个数上限不在此截断，由 ChatInput 等与 FileContent 配合完成「选择 → 展示 → 发送」链路。",
       "relatedComponents": [
         {
           "slug": "chat-input",

package/dist/utils/file.d.ts

@@ -22,3 +22,7 @@ export declare const getFileExtension: (file?: File) => string;
  * @returns 1024B -> 1KB 1024KB -> 1MB 1024MB -> 1GB
  */
 export declare const formatFileSize: (file?: File) => string;
+/**
+ * 未成功添加的文件统一提示（中文在数量为 1 时不带「n个」前缀）
+ */
+export declare const formatUploadNotAddedMessage: (count: number, maxMb: string, isEn: boolean) => string;

package/package.json

@@ -1,26 +1,8 @@
 {
   "name": "@blueking/chat-x",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "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"
   },
@@ -68,7 +50,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",
@@ -96,6 +77,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": "0.0.2"
+  },
+  "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"
   }
-}
+}