easy-elplus 1.0.1 → 1.2.0

package/.vscode/settings.json

@@ -1,7 +0,0 @@
-{
-  "editor.formatOnSave": true, // 保存时自动格式化
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit" // 保存时自动修复 ESLint 报错
-  }
-}

package/commitlint.config.js

@@ -1,145 +0,0 @@
-import { defineConfig } from "cz-git"
-
-export default defineConfig({
-  // 继承 commitlint 的 conventional 规范
-  // 约束最终生成的 commit message 格式
-  extends: ["@commitlint/config-conventional"],
-
-  // commitlint 校验规则（可按需补充）
-  rules: {
-    // @see https://commitlint.js.org/#/reference-rules
-  },
-
-  // cz-git 交互式提交配置
-  prompt: {
-    // 快捷别名：输入 fd 等价于 docs: fix typos
-    alias: {
-      fd: "docs: fix typos"
-    },
-
-    // 交互过程中的提示文案
-    messages: {
-      type: "选择你要提交的类型 :",
-      scope: "选择一个提交范围（可选）:",
-      customScope: "请输入自定义的提交范围 :",
-      subject: "填写简短精炼的变更描述 :\n",
-      body: '填写更加详细的变更描述（可选）。使用 "|" 换行 :\n',
-      breaking: '列举非兼容性重大的变更（可选）。使用 "|" 换行 :\n',
-      footerPrefixesSelect: "选择关联 issue 前缀（可选）:",
-      customFooterPrefix: "输入自定义 issue 前缀 :",
-      footer: "列举关联 issue（可选）例如: #31, #I3244 :\n",
-      confirmCommit: "是否提交或修改 commit ?"
-    },
-
-    // 提交类型（type）列表
-    // 会作为第一步选择项
-    types: [
-      { value: "feat", name: "feat:     新增功能 | A new feature" },
-      { value: "fix", name: "fix:      修复缺陷 | A bug fix" },
-      {
-        value: "docs",
-        name: "docs:     文档更新 | Documentation only changes"
-      },
-      { value: "style", name: "style:    代码格式 | 不影响逻辑的样式调整" },
-      { value: "refactor", name: "refactor: 代码重构 | 既不是修复也不是新增" },
-      { value: "perf", name: "perf:     性能提升 | 提升性能的代码修改" },
-      { value: "test", name: "test:     测试相关 | 测试用例新增或修复" },
-      { value: "build", name: "build:    构建相关 | 构建系统或依赖变更" },
-      { value: "ci", name: "ci:       持续集成 | CI 配置或脚本修改" },
-      { value: "revert", name: "revert:   回退代码 | 回滚某次提交" },
-      { value: "chore", name: "chore:    其他修改 | 非 src / test 变更" }
-    ],
-
-    // 是否在 commit message 中使用 emoji
-    useEmoji: false,
-
-    // emoji 对齐方式（启用 emoji 时生效）
-    emojiAlign: "center",
-
-    // 是否启用 AI 自动生成 commit 描述
-    useAI: false,
-
-    // AI 生成候选数量
-    aiNumber: 1,
-
-    // 主题色（用于终端高亮）
-    themeColorCode: "",
-
-    // 预定义的 scope 列表（为空表示不限制）
-    scopes: [],
-
-    // 是否允许自定义 scope
-    allowCustomScopes: true,
-
-    // 是否允许 scope 为空
-    allowEmptyScopes: true,
-
-    // 自定义 scope 选项在列表中的位置
-    customScopesAlign: "bottom",
-
-    // 自定义 scope 的别名
-    customScopesAlias: "自定义",
-
-    // 空 scope 的别名
-    emptyScopesAlias: "空",
-
-    // subject 是否强制首字母大写（null 表示不限制）
-    upperCaseSubject: null,
-
-    // 是否强制询问 breaking change
-    markBreakingChangeMode: false,
-
-    // 哪些 type 允许出现 breaking change
-    allowBreakingChanges: ["feat", "fix"],
-
-    // 每行最大长度（超出自动换行）
-    breaklineNumber: 100,
-
-    // 换行符号（body / breaking 中使用）
-    breaklineChar: "|",
-
-    // 跳过的提问步骤（例如 ['scope', 'body']）
-    skipQuestions: [],
-
-    // issue 前缀选项（常用于 gitee / gitlab）
-    issuePrefixes: [
-      // 关联 issue（进行中）
-      { value: "link", name: "link:     链接 ISSUES 进行中" },
-      // 关闭 issue
-      { value: "closed", name: "closed:   标记 ISSUES 已完成" }
-    ],
-
-    // 自定义 issue 前缀位置
-    customIssuePrefixAlign: "top",
-
-    // 不关联 issue 的别名
-    emptyIssuePrefixAlias: "空",
-
-    // 自定义 issue 前缀别名
-    customIssuePrefixAlias: "自定义",
-
-    // 是否允许自定义 issue 前缀
-    allowCustomIssuePrefix: true,
-
-    // 是否允许不填写 issue
-    allowEmptyIssuePrefix: true,
-
-    // 提交确认阶段是否高亮显示
-    confirmColorize: true,
-
-    // 针对不同 type 覆盖 scope（未使用）
-    scopeOverrides: undefined,
-
-    // body 默认值
-    defaultBody: "",
-
-    // issue 默认值
-    defaultIssues: "",
-
-    // scope 默认值
-    defaultScope: "",
-
-    // subject 默认值
-    defaultSubject: ""
-  }
-})

package/docs/.vitepress/config.mjs

@@ -1,100 +0,0 @@
-import { sidebar } from "./sidebar" // 确保路径正确
-import path from "path"
-import { containerPreview, componentPreview } from "@vitepress-demo-preview/plugin"
-const socialLinks = [{ icon: "github", link: "https://github.com/jiayc4215/easy-elplus" }]
-import { defineConfig } from "vitepress"
-export default defineConfig({
-  // 部署路径 注意： 部署到github pages 时，需要将 base 设置为 仓库名
-  base: "/easy-elplus/",
-  lang: "zh-CN",
-  lastUpdated: true, //显示最后更新时间
-  ignoreDeadLinks: true, //忽略死链
-  themeConfig: {
-    logo: "/logo.png",
-    sidebar
-  },
-  // markdown 配置
-  markdown: {
-    theme: {
-      light: "github-light",
-      dark: "github-dark"
-    },
-    config(md) {
-      md.use(containerPreview)
-      md.use(componentPreview)
-    }
-  },
-  // 多语言配置
-  locales: {
-    // 这里的 root 代表默认语言（无前缀）
-    root: {
-      lang: "zh-CN",
-
-      title: "easy-elplus",
-      description: "基于 Element Plus 的增强组件库",
-      label: "简体中文",
-      //主题配置
-      themeConfig: {
-        nav: [
-          { text: "指南", link: "/guide/", activeMatch: "^/guide/" },
-          { text: "组件", link: "/components/button", activeMatch: "^/components/" },
-          { text: "社区群", link: "/contact-me", activeMatch: "^/contact-me" }
-        ],
-        // 社交链接
-        socialLinks: [
-          {
-            icon: {
-              svg: '<svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" width="200" height="200"><path d="M937.4 423.9c-84 0-165.7-27.3-232.9-77.8v352.3c0 179.9-138.6 325.6-309.6 325.6S85.3 878.3 85.3 698.4c0-179.9 138.6-325.6 309.6-325.6 17.1 0 33.7 1.5 49.9 4.3v186.6c-15.5-6.1-32-9.2-48.6-9.2-76.3 0-138.2 65-138.2 145.3 0 80.2 61.9 145.3 138.2 145.3 76.2 0 138.1-65.1 138.1-145.3V0H707c0 134.5 103.7 243.5 231.6 243.5v180.3l-1.2 0.1"></path></svg>'
-            },
-            link: "https://www.douyin.com/user/MS4wLjABAAAA0-8Y13O22cp4uPQ9rr_128pB28ioDjWLWRdGK4gVtxw"
-          },
-          {
-            icon: {
-              svg: '<svg viewBox="0 0 1049 1024" xmlns="http://www.w3.org/2000/svg" width="200" height="200"><path d="M363.822 162.086l-96.96-93.983S251.714 49.46 277.346 28.36c25.76-20.972 27.056-11.651 35.73-5.826 8.672 5.826 144.21 139.551 144.21 139.551h-93.464z m322.08 3.496l96.962-93.984s15.146-18.641-10.486-39.742c-25.632-20.972-27.056-11.651-35.73-5.826-8.672 5.826-144.211 139.552-144.211 139.552h93.466z" ></path><path d="M1049.798 339.568c-3.495-147.19-131.396-175.152-131.396-175.152s-655.295-5.307-791.998 0C-10.3 202.994 0.186 339.568 0.186 339.568s1.813 292.565-0.13 440.66c14.759 148.096 128.938 171.656 128.938 171.656s45.567 0.906 78.837 0.906c3.495 9.58 6.084 56.054 57.866 56.054 51.652 0 57.866-56.054 57.866-56.054s378.523-1.812 409.98-1.812c1.812 15.793 9.58 58.643 61.36 57.866 51.653-0.906 55.149-61.361 55.149-61.361s17.476-1.813 70.034 0c122.593-22.784 129.713-166.478 129.713-166.478s-1.683-294.248 0-441.437zM944.292 808.06c0 23.172-18.382 42.072-41.037 42.072H157.214c-22.655 0-41.037-18.77-41.037-42.072V313.936c0-23.173 18.382-42.073 41.037-42.073h746.042c22.655 0 41.037 18.771 41.037 42.073V808.06z" ></path><path d="M194.755 453.487l219.037-42.073 16.57 82.333-217.223 42.073z m681.575 0l-219.036-42.073-16.7 82.333 217.353 42.073zM430.36 657.636s48.158 86.734 101.623-28.092c51.652 112.107 108.61 29.774 108.61 29.774l32.365 21.101s-60.455 97.22-140.2 23.69c-67.444 73.53-138.385-23.43-138.385-23.43l35.988-23.043z" ></path></svg>'
-            },
-            link: "https://space.bilibili.com/1525537842"
-          },
-          {
-            icon: {
-              svg: '<svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" width="200" height="200"><path d="M1003.52 430.08c-12.288-143.36-118.784-253.952-258.048-262.144-118.784-6.144-245.76 0-360.448 0-143.36 0-266.24 114.688-266.24 258.048 0 81.92 0 163.84 0 245.76 0 143.36 122.88 258.048 266.24 258.048 114.688 0 245.76 6.144 360.448 0 143.36-8.192 245.76-118.784 258.048-262.144 4.096-90.112 4.096-188.416 0-279.648zM573.44 696.32c-110.592 0-200.704-90.112-200.704-200.704s90.112-200.704 200.704-200.704c73.728 0 143.36 40.96 176.128 106.496l-73.728 36.864c-20.48-36.864-57.344-61.44-102.4-61.44-65.536 0-118.784 53.248-118.784 118.784s53.248 118.784 118.784 118.784c45.056 0 81.92-24.576 102.4-61.44l73.728 36.864c-32.768 65.536-102.4 106.496-176.128 106.496z" fill="#FC5531"></path></svg>'
-            },
-            link: "https://blog.csdn.net/qq_63358859"
-          },
-          ...socialLinks
-        ]
-      }
-    },
-    // 这里的 en 代表英语（路径带 /en/）
-    en: {
-      lang: "en-US",
-      title: "easy-elplus",
-      description: "Enhanced Component Library Based on Element Plus",
-      label: "English",
-      link: "/en/",
-      themeConfig: {
-        nav: [
-          { text: "Guide", link: "/en/guide/" },
-          { text: "Components", link: "/en/components/button" }
-        ],
-        socialLinks: [...socialLinks]
-      }
-    }
-  },
-  vite: {
-    server: {
-      port: 8090
-    },
-
-    resolve: {
-      alias: {
-        "easy-elplus": path.resolve(__dirname, "../../packages/components")
-      }
-    }
-  },
-  //  为了解决打包后，控制台不结束
-  buildEnd() {
-    setTimeout(() => {
-      process.exit(0)
-    }, 2000)
-  }
-})

package/docs/.vitepress/sidebar.js

@@ -1,48 +0,0 @@
-export const sidebar = {
-  "/en/": [
-    {
-      text: "Guide",
-      items: [
-        { text: "Introduction", link: "/en/guide/" },
-        { text: "Quick Start", link: "/en/guide/quickstart" },
-        { text: "Installation", link: "/en/guide/installation" }
-      ]
-    },
-    {
-      text: "Components",
-      items: [
-        { text: "Button", link: "/en/components/button" },
-        { text: "Dialog", link: "/en/components/dialog" },
-        { text: "Table", link: "/en/components/table" },
-        { text: "Descriptions", link: "/en/components/descriptions" },
-        { text: "Image Upload", link: "/en/components/image-upload" },
-        { text: "File Upload", link: "/en/components/file-upload" }
-      ]
-    }
-  ],
-  "/": [
-    {
-      text: "指南",
-      items: [
-        { text: "介绍", link: "/guide/" },
-        { text: "快速开始", link: "/guide/quickstart" },
-        { text: "安装", link: "/guide/installation" }
-      ]
-    },
-    {
-      text: "组件",
-      items: [
-        { text: "Button 按钮", link: "/components/button" },
-        { text: "Dialog 对话框", link: "/components/dialog" },
-        { text: "Table 表格", link: "/components/table" },
-        { text: "Descriptions 描述列表", link: "/components/descriptions" },
-        { text: "ImageUpload 图片上传", link: "/components/image-upload" },
-        { text: "FileUpload 文件上传", link: "/components/file-upload" }
-      ]
-    },
-    {
-      text: "社区群",
-      link: "/contact-me/"
-    }
-  ]
-}

package/docs/.vitepress/theme/index.js

@@ -1,23 +0,0 @@
-import DefaultTheme from "vitepress/theme"
-import { ElementPlusContainer } from "@vitepress-demo-preview/component"
-import "@vitepress-demo-preview/component/dist/style.css"
-
-import ElementPlus from "element-plus"
-import "element-plus/dist/index.css"
-import * as ElementPlusIconsVue from "@element-plus/icons-vue"
-
-export default {
-  extends: DefaultTheme, // 继承默认主题
-  enhanceApp: async ({ app }) => {
-    // 注册图标
-    for (const [key, component] of Object.entries(ElementPlusIconsVue)) {
-      app.component(key, component)
-    }
-
-    // 注册 demo-preview 组件
-    app.component("demo-preview", ElementPlusContainer)
-
-    // 注册 ElementPlus
-    app.use(ElementPlus)
-  }
-}

package/docs/api-examples.md

@@ -1,55 +0,0 @@
----
-outline: deep
----
-
-# Runtime API Examples
-
-This page demonstrates usage of some of the runtime APIs provided by VitePress.
-
-The main `useData()` API can be used to access site, theme, and page data for the current page. It works in both `.md` and `.vue` files:
-
-```md
-<script setup>
-import { useData } from 'vitepress'
-
-const { theme, page, frontmatter } = useData()
-</script>
-
-## Results
-
-### Theme Data
-
-<pre>{{ theme }}</pre>
-
-### Page Data
-
-<pre>{{ page }}</pre>
-
-### Page Frontmatter
-
-<pre>{{ frontmatter }}</pre>
-```
-
-<script setup>
-import { useData } from 'vitepress'
-
-const { site, theme, page, frontmatter } = useData()
-</script>
-
-## Results
-
-### Theme Data
-
-<pre>{{ theme }}</pre>
-
-### Page Data
-
-<pre>{{ page }}</pre>
-
-### Page Frontmatter
-
-<pre>{{ frontmatter }}</pre>
-
-## More
-
-Check out the documentation for the [full list of runtime APIs](https://vitepress.dev/reference/runtime-api#usedata).

package/docs/components/button.md

@@ -1,53 +0,0 @@
----
-title: Button 按钮
-description: 增强的按钮组件，自动处理异步操作的加载状态
----
-
-# Button 按钮
-
-EasyButton 是基于 Element Plus 的 Button 组件封装的增强版本，主要特性是自动处理异步操作的加载状态。
-
-## 在线演示
-
-EasyButton 的核心特性是自动处理异步操作。当点击事件返回 Promise 时，按钮会自动显示加载状态，直到 Promise 完成。
-
-<preview path="../demo/button-basic.vue" title="Button 基础示例" description="展示 Button 组件的各种用法"></preview>
-
-## API
-
-### Attributes
-
-EasyButton 继承了 Element Plus Button 的所有属性，常用属性如下：
-
-| 属性名   | 说明                       | 类型      | 可选值                                             | 默认值 |
-| -------- | -------------------------- | --------- | -------------------------------------------------- | ------ |
-| type     | 类型                       | string    | primary / success / warning / danger / info / text | —      |
-| size     | 尺寸                       | string    | large / default / small                            | —      |
-| plain    | 是否朴素按钮               | boolean   | —                                                  | false  |
-| round    | 是否圆角按钮               | boolean   | —                                                  | false  |
-| circle   | 是否圆形按钮               | boolean   | —                                                  | false  |
-| loading  | 是否加载中状态（手动控制） | boolean   | —                                                  | false  |
-| disabled | 是否禁用状态               | boolean   | —                                                  | false  |
-| icon     | 图标组件                   | Component | —                                                  | —      |
-
-### Events
-
-| 事件名 | 说明                   | 回调参数                                       |
-| ------ | ---------------------- | ---------------------------------------------- |
-| click  | 点击事件，支持异步函数 | (event: MouseEvent) => void \| Promise\<void\> |
-
-### Slots
-
-| 插槽名  | 说明     |
-| ------- | -------- |
-| default | 按钮内容 |
-
-## 特性说明
-
-EasyButton 会自动检测 `click` 事件处理函数是否返回 Promise。如果返回 Promise，按钮会：
-
-1. 立即进入加载状态（显示 loading 图标）
-2. 等待 Promise 完成
-3. 自动恢复正常状态
-
-这样可以避免重复点击导致的重复提交问题。

package/docs/components/descriptions.md

@@ -1,88 +0,0 @@
----
-title: Descriptions 描述列表
-description: 增强的描述列表组件,支持分组、动态渲染等
----
-
-# Descriptions 描述列表
-
-EasyDescriptions 是基于 Element Plus Descriptions 组件封装的增强版本,支持分组、动态组件、条件渲染等功能。
-
-## 在线演示
-
-<preview path="../demo/descriptions-basic.vue" title="Descriptions 基础示例" description="展示 Descriptions 组件的各种用法"></preview>
-
-## API
-
-### Attributes
-
-| 参数                 | 说明           | 类型   | 默认值 |
-| -------------------- | -------------- | ------ | ------ |
-| items                | 描述列表配置   | Array  | []     |
-| modelValue / v-model | 绑定的数据对象 | Object | {}     |
-
-继承 Element Plus Descriptions 的所有属性,如:
-
-| 参数      | 说明           | 类型    | 默认值     |
-| --------- | -------------- | ------- | ---------- |
-| column    | 一行显示的列数 | Number  | 3          |
-| border    | 是否带有边框   | Boolean | false      |
-| direction | 排列方向       | String  | horizontal |
-| size      | 尺寸           | String  | default    |
-
-### Items 配置
-
-#### 单组模式
-
-```javascript
-interface Item {
-  label: string | object // 标签文本或配置对象
-  value: string | object // 字段名或配置对象
-  hidden?: boolean | ((data) => boolean) // 是否隐藏
-  span?: number // 占据的列数
-  // ... 其他 Descriptions 属性
-}
-```
-
-#### 分组模式
-
-```javascript
-interface GroupItem {
-  title?: string // 分组标题
-  extra?: string // 操作区文本
-  items: Item[] // 该组的字段列表
-  hidden?: boolean | ((data) => boolean) // 是否隐藏整个分组
-  column?: number // 该组的列数
-  border?: boolean // 该组是否带边框
-  // ... 其他 DescriptionsItem 属性
-}
-```
-
-#### Value 对象配置
-
-```javascript
-interface ValueConfig {
-  id: string // 字段名
-  components: string | Component // 组件名或组件
-  props: Object // 组件属性
-}
-```
-
-### Events
-
-继承 Element Plus Descriptions 的所有事件。
-
-### Slots
-
-| 插槽名 | 说明           | 参数         |
-| ------ | -------------- | ------------ |
-| title  | 自定义标题     |              |
-| extra  | 自定义操作区   |              |
-| [id]   | 自定义字段内容 | label｜value |
-
-## 特性说明
-
-1. **简单展示**: 直接使用字符串配置
-2. **表单编辑**: 使用组件配置实现可编辑的描述列表
-3. **分组展示**: 使用分组模式组织复杂数据
-4. **条件显示**: 使用 hidden 函数实现动态显示逻辑
-5. **自定义渲染**: 使用插槽实现复杂的自定义需求

package/docs/components/dialog.md

@@ -1,61 +0,0 @@
----
-title: Dialog 对话框
-description: 命令式调用的对话框组件，支持组件载入、异步操作等
----
-
-# Dialog 对话框
-
-EasyDialog 是一个基于 Element Plus 的命令式对话框工具，支持函数式调用、组件载入、状态继承、异步操作等特性。
-
-## 在线演示
-
-<preview path="../demo/dialog-basic.vue" title="Dialog 基础示例" description="展示 Dialog 组件的各种用法"></preview>
-
-::: details 表单弹窗组件
-<<< ../demo/DialogFormContent.vue
-:::
-
-## API
-
-### 函数签名
-
-```javascript
-EasyDialog(
-  component: Component, // 组件
-  componentProps?: object, // 组件属性
-  modalProps?: DialogOptions, // 对话框属性
-  context?: object //  应用上下文
-): Promise<any>
-```
-
-### DialogOptions
-
-| 参数              | 说明                   | 类型                                   | 默认值   |
-| ----------------- | ---------------------- | -------------------------------------- | -------- |
-| title             | 对话框标题             | string                                 | '提示'   |
-| confirmButtonText | 确认按钮文字           | string                                 | '确 认'  |
-| cancelButtonText  | 取消按钮文字           | string                                 | '取 消'  |
-| showConfirmButton | 是否显示确认按钮       | boolean                                | true     |
-| showCancelButton  | 是否显示取消按钮       | boolean                                | true     |
-| methodKey         | 确认时调用组件的方法名 | string                                 | 'submit' |
-| beforeClose       | 关闭前回调             | (done) => void                         | —        |
-| onConfirm         | 确认回调               | (instance) => void \| Promise\<void\>  | —        |
-| onCancel          | 取消回调               | () => void                             | —        |
-| footer            | 自定义页脚渲染函数     | ({ close, confirm, loading }) => VNode | —        |
-| draggable         | 是否可拖拽             | boolean                                | true     |
-| ...dialogProps    | 其他原生 Dialog 属性   | —                                      | —        |
-
-### 返回值
-
-返回一个 Promise：
-
-- **resolve**: 用户点击确认按钮
-- **reject**: 用户点击取消按钮或关闭对话框
-
-## 特性说明
-
-1. **简单提示**: 使用字符串内容
-2. **复杂内容**: 使用组件载入
-3. **数据交互**: 通过 props 传递数据，通过 defineExpose 暴露方法
-4. **异步操作**: 在 onConfirm 或组件方法中使用 async/await
-5. **流程控制**: 利用 Promise 实现连续弹窗或条件弹窗

package/docs/components/file-upload.md

@@ -1,43 +0,0 @@
----
-title: FileUpload 文件上传
-description: 文件上传组件,支持多种文件类型和自动解析响应
----
-
-# FileUpload 文件上传
-
-EasyFileUpload 是一个基于 Element Plus Upload 组件封装的文件上传组件。它简化了上传逻辑，支持文件类型和大小校验，并能自动从后端响应中提取文件链接。
-
-## 在线演示
-
-<preview path="../demo/file-upload-basic.vue" title="FileUpload 基础示例" description="展示文件上传的基本功能，包括类型校验和数量限制"></preview>
-
-## API
-
-### Attributes
-
-| 参数          | 说明                                                                           | 类型                      | 默认值                                              |
-| ------------- | ------------------------------------------------------------------------------ | ------------------------- | --------------------------------------------------- |
-| v-model       | 绑定值，支持逗号分隔的字符串、对象或数组                                       | `String / Object / Array` | —                                                   |
-| action        | 上传地址（必传）                                                               | `String`                  | —                                                   |
-| limit         | 最大上传数量                                                                   | `Number`                  | 5                                                   |
-| file-size     | 文件大小限制 (MB)                                                              | `Number`                  | 5                                                   |
-| file-type     | 允许的文件类型后缀                                                             | `Array`                   | `["doc", "xls", "ppt", "txt", "pdf"]`               |
-| is-show-tip   | 是否显示上传提示信息                                                           | `Boolean`                 | true                                                |
-| headers       | 设置上传的请求头部                                                             | `Object`                  | `{}`                                                |
-| base-url      | 基础路径。上传成功后保存时会尝试去除该前缀；回显时如果不是绝对路径会拼接该前缀 | `String`                  | ""                                                  |
-| check-success | 自定义成功校验函数，接受响应对象作为参数                                       | `Function`                | `res => res.code === 200 \|\| res.success === true` |
-| response-path | 响应中文件地址所在的路径，支持深层嵌套（如 `data.url`）                        | `String`                  | "data"                                              |
-| error-field   | 响应中错误消息所在的路径                                                       | `String`                  | "msg"                                               |
-
-### Events
-
-| 事件名            | 说明             | 回调参数          |
-| ----------------- | ---------------- | ----------------- |
-| update:modelValue | 绑定值变化时触发 | `(value: string)` |
-
-## 特性说明
-
-1. **自动提取 URL**: 无需手动处理 `on-success`，只需通过 `response-path` 配置即可。
-2. **多文件支持**: 内置多文件上传支持，通过 `limit` 控制数量。
-3. **格式校验**: 自动根据 `file-type` 进行后缀名匹配。
-4. **路径处理**: 通过 `base-url` 方便地处理图片服务器前缀。