pit-docs-mcp 1.0.2

package/docs/pitBusinessUi/dic-radio.md

@@ -0,0 +1,67 @@
+# pit-dic-radio 字典单选组
+
+从 Vuex store 加载字典数据并渲染为 `el-radio-group`，默认自动选中第一项。
+
+## 前置依赖
+
+> 同 `PitDic`：项目 Vuex store 中需实现 `base/getDictionaryData` action，接收 `{ sort: string }` 并返回包含 `enCode`/`fullName` 字段的字典数组。
+
+## Props
+
+| 参数 | 说明 | 类型 | 必填 | 默认值 |
+| --- | --- | --- | --- | --- |
+| value / v-model | 绑定值 | String | — | `""` |
+| code | 字典 code | String | ✅ | `""` |
+| options | 字典字段映射（label 与 value 对应的字段名） | Object | — | `{ label: 'fullName', value: 'enCode' }` |
+
+> 其余 `el-radio-group` 属性通过 `v-bind="$attrs"` 透传，事件通过 `v-on="$listeners"` 透传。
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `String` |
+| change | 选中项变化 | `String`（选中值），`Array`（完整字典列表） |
+
+## 示例
+
+### 基础用法
+
+```vue
+<pit-dic-radio v-model="form.status" code="APPROVE_STATUS" />
+```
+
+### 自定义字段映射
+
+```vue
+<!-- 字典列表字段非 enCode/fullName 时使用 -->
+<pit-dic-radio
+  v-model="form.type"
+  code="MY_DICT"
+  :options="{ label: 'name', value: 'code' }" />
+```
+
+### 获取变化时的完整字典列表
+
+```vue
+<pit-dic-radio
+  v-model="form.status"
+  code="APPROVE_STATUS"
+  @change="onStatusChange" />
+
+<script>
+methods: {
+  onStatusChange(value, list) {
+    // value: 当前选中值
+    // list: 完整字典数组
+    const selected = list.find(item => item.enCode === value)
+    console.log(selected.fullName)
+  }
+}
+</script>
+```
+
+## 注意事项
+
+- 字典加载完成后，若当前 `value` 为空，组件会**自动选中第一项**并触发 `input`。
+- 如需禁用自动选中，请在父组件初始化时手动设置 `value`。

package/docs/pitBusinessUi/dic.md

@@ -0,0 +1,78 @@
+# pit-dic 字典下拉选择
+
+从 Vuex store 中加载字典数据并渲染为 `el-select`，支持单选/多选。
+
+## 前置依赖
+
+> **必须**：项目 Vuex store 中需实现 `base/getDictionaryData` action，接收 `{ sort: string }` 并返回字典数组（每项含 `enCode`、`fullName` 字段）。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 绑定值（单选为 string，多选为逗号分隔的 string） | String | `""` |
+| code | 字典 code，对应 store 中的 sort 参数 | String | `""` |
+| placeholder | 占位文本 | String | — |
+| clearable | 是否可清空 | Boolean | `true` |
+| multiple | 是否多选 | Boolean | `false` |
+| disabled | 是否禁用 | Boolean | `false` |
+| filterable | 是否可搜索 | Boolean | `true` |
+| handleList | 外部直接传入选项数组（优先级高于 store 请求） | Array | `[]` |
+| changeCallBack | 选项变化回调函数（优先级高于 elForm 联动搜索） | Function | — |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `String` |
+| change | 选项变化 | `String` |
+| resultData | 字典数据加载完成 | `Array`（完整字典数组） |
+
+## 示例
+
+### 基础单选
+
+```vue
+<pit-dic v-model="form.status" code="APPROVE_STATUS" />
+```
+
+### 多选
+
+```vue
+<pit-dic v-model="form.tags" code="PROJECT_TAG" :multiple="true" />
+```
+
+### 外部传入选项（不走 store 请求）
+
+```vue
+<pit-dic
+  v-model="form.type"
+  :handle-list="[
+    { enCode: '1', fullName: '类型A' },
+    { enCode: '2', fullName: '类型B' }
+  ]" />
+```
+
+### 获取字典加载结果
+
+```vue
+<pit-dic
+  v-model="form.status"
+  code="APPROVE_STATUS"
+  @result-data="onDicLoaded" />
+
+<script>
+methods: {
+  onDicLoaded(list) {
+    // list: [{ enCode, fullName }, ...]
+    this.dicOptions = list
+  }
+}
+</script>
+```
+
+## 注意事项
+
+- 使用 `handleList` 时不会发起 store 请求，适合静态选项或接口自取场景。
+- 多选值固定以英文逗号拼接字符串存储，绑定时无需手动处理数组/字符串转换。
+- 当在 `el-form` 内且配合搜索时，`changeCallBack` 可接管默认的表单联动搜索行为。

package/docs/pitBusinessUi/document-preview.md

@@ -0,0 +1,54 @@
+# pit-document-preview 文档预览
+
+在 `<iframe>` 中渲染文档预览，支持两种预览引擎（LibreOffice → PDF 或永中 Office），引擎由系统配置决定。挂载时自动读取水印配置并叠加。
+
+## 前置依赖
+
+- `pit-business-utils` — `reqFileTransform`、`reqOssInfo`、`reqOssInfoByYz`、`getPreviewUrl`
+- 后端接口：`/api/permission/sysConfig/getFileEngine`（获取预览引擎配置）
+- `this.$store.state.settings.title` — 应用标题（用于设置 document.title）
+- `localStorage.isOpenWatermark` / `localStorage.watermark` — 水印配置
+- `this.$setWatermark` / `this.$clearWatermark` — 全局水印方法
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| documentObj | 文件对象（须含 `fileUploadRecordId`、`originalFilename`、`format` 等字段） | Object | `{}` |
+| title | 页面标题（为空时自动降级到文件名或路由标题） | String | `""` |
+
+## 预览引擎
+
+| fileEngine 值 | 引擎 | 说明 |
+| --- | --- | --- |
+| `1`（默认） | 永中 Office | 调用 `reqOssInfoByYz` 获取预览 URL |
+| 其他 | LibreOffice（转 PDF） | 调用 `getPreviewUrl` 获取 presigned URL |
+
+## 示例
+
+### 在 PitPreview 弹窗中内嵌（推荐通过 PitPreview 间接使用）
+
+```vue
+<!-- PitPreview 内部会根据文件类型自动调用 PitDocumentPreview -->
+<pit-preview
+  :visible.sync="previewVisible"
+  :file-obj="fileObj"
+  :is-open="false" />
+```
+
+### 直接使用（如独立预览页面）
+
+```vue
+<pit-document-preview
+  :document-obj="{
+    fileUploadRecordId: 'abc123',
+    originalFilename: '合同.docx',
+    format: 'docx'
+  }" />
+```
+
+## 注意事项
+
+- 组件挂载时自动读取 `localStorage.isOpenWatermark`，若为 `"true"` 则叠加登录用户信息水印，销毁时自动清除。
+- `document.title` 在 `mounted` 时被修改为当前文件名；在需要保留原有标题的场景（SPA 路由）需注意副作用。
+- 预览 URL 通过异步接口获取，首次渲染时 `iframe` 为空，加载完成后自动填入 `src`。

package/docs/pitBusinessUi/drawer.md

@@ -0,0 +1,67 @@
+# pit-drawer 抽屉
+
+对 `el-drawer` 的封装，默认禁止点击外部关闭，支持全局 `drawerSize` 配置。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| visible | 控制显隐，支持 `.sync` | Boolean | `false` |
+| title | 标题 | String | `"标题"` |
+| size | 抽屉宽度（不传则读取 `$Business.drawerSize`） | String / Number | — |
+| fullscreen | 是否全屏 | Boolean | `false` |
+| beforeClose | 关闭前回调，接管关闭逻辑 | Function | — |
+
+> 其余 `el-drawer` 属性可通过 `v-bind="$attrs"` 透传。
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| update:visible | 关闭时触发，配合 `.sync` 使用 | `false` |
+
+## Slots
+
+| 插槽名 | 说明 |
+| --- | --- |
+| default | 抽屉主体内容 |
+
+## 示例
+
+### 基础用法
+
+```vue
+<template>
+  <div>
+    <el-button @click="drawerVisible = true">打开抽屉</el-button>
+    <pit-drawer :visible.sync="drawerVisible" title="详情">
+      <p>抽屉内容</p>
+    </pit-drawer>
+  </div>
+</template>
+
+<script>
+export default {
+  data() {
+    return { drawerVisible: false }
+  }
+}
+</script>
+```
+
+### 自定义宽度与 beforeClose
+
+```vue
+<pit-drawer
+  :visible.sync="drawerVisible"
+  title="编辑"
+  size="900px"
+  :before-close="handleClose">
+  <form-component />
+</pit-drawer>
+```
+
+## 注意事项
+
+- `wrapperClosable` 固定为 `false`（点击外部不关闭），不可通过 props 覆盖。
+- 全局默认宽度通过 `Vue.use(PitBusinessUI, { drawerSize: '800px' })` 统一配置。

package/docs/pitBusinessUi/editor.md

@@ -0,0 +1,63 @@
+# pit-editor 富文本编辑器（WangEditor）
+
+基于 `@wangeditor/editor-for-vue` 封装的富文本编辑器，支持图片/视频上传、完整工具栏、禁用只读模式，注入 `el-form` 状态感知。
+
+## 前置依赖
+
+- `@wangeditor/editor-for-vue`（`^1.0.2`）
+- `pit-business-utils` — `getToken`（图片/视频上传鉴权）
+- `this.env.VUE_APP_BASE_API` — 上传接口 Base URL
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 编辑器 HTML 内容 | String | `""` |
+| disabled | 是否禁用（只读模式） | Boolean | `false` |
+| height | 编辑区域高度 | String | `"500px"` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 内容变化（v-model） | `String`（HTML） |
+
+## 工具栏功能
+
+内置以下工具组：标题、引用、加粗、下划线、斜体、更多样式（删除线/行内代码/上下标/清除格式）、字体颜色/背景色、字号、字体、行高、列表（无序/有序/待办）、对齐方式、缩进、表情、插入链接、**上传图片**、**上传视频**、表格、代码块。
+
+## 示例
+
+### 基础用法
+
+```vue
+<pit-editor v-model="form.content" />
+```
+
+### 指定高度
+
+```vue
+<pit-editor v-model="form.content" height="300px" />
+```
+
+### 只读显示
+
+```vue
+<pit-editor v-model="form.content" :disabled="true" />
+```
+
+### 在表单中使用
+
+```vue
+<el-form-item label="项目描述" prop="description">
+  <pit-editor v-model="form.description" height="400px" />
+</el-form-item>
+```
+
+## 注意事项
+
+- `disabled` 为 `true` 时，编辑区高度变为 `auto`（内容高度），工具栏隐藏。
+- 图片/视频上传接口为 `${VUE_APP_BASE_API}/api/oss/upload`，使用 `getToken()` 鉴权。
+- 编辑器销毁时需手动调用 `this.editor.destroy()`，组件在 `beforeDestroy` 钩子中已自动处理。
+- 组件注入 `elForm` / `elFormItem`，在 `el-form` 的 `disabled` 状态下自动切为只读。
+- 组件 name 为 `pitEditor`（小写 `p`），注册时注意区分。

package/docs/pitBusinessUi/expand-search-form.md

@@ -0,0 +1,65 @@
+# pit-expand-search-form 可展开搜索表单
+
+将搜索条件分为"常驻区"与"展开区"，通过展开/折叠按钮控制显示，适合条件较多的列表页。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| isShowBtn | 是否显示展开/折叠按钮 | Boolean | `true` |
+| styles | 外层容器自定义样式 | Object | — |
+
+## Events
+
+无自定义事件。
+
+## Slots
+
+| 插槽名 | 说明 |
+| --- | --- |
+| default | 常驻搜索条件（始终显示） |
+| expanded | 展开后显示的附加搜索条件 |
+
+## 示例
+
+### 基础用法
+
+```vue
+<template>
+  <pit-expand-search-form>
+    <!-- 常驻区 -->
+    <el-form-item label="项目名称">
+      <pit-input v-model="query.name" />
+    </el-form-item>
+    <el-form-item label="状态">
+      <pit-dic v-model="query.status" code="PROJECT_STATUS" />
+    </el-form-item>
+
+    <!-- 展开区 -->
+    <template slot="expanded">
+      <el-form-item label="创建时间">
+        <pit-date-time-picker v-model="query.createTime" />
+      </el-form-item>
+      <el-form-item label="负责人">
+        <pit-input v-model="query.owner" />
+      </el-form-item>
+    </template>
+  </pit-expand-search-form>
+</template>
+```
+
+### 隐藏展开按钮（展示所有条件）
+
+```vue
+<pit-expand-search-form :is-show-btn="false">
+  <el-form-item label="名称">
+    <pit-input v-model="query.name" />
+  </el-form-item>
+</pit-expand-search-form>
+```
+
+## 注意事项
+
+- 展开/折叠状态由组件内部维护，无需外部控制。
+- `slot="expanded"` 内的条件初始为折叠隐藏状态。
+- 组件内部使用了 `el-form--inline` 样式类，建议父层不要重复设置。

package/docs/pitBusinessUi/file-preview.md

@@ -0,0 +1,56 @@
+# pit-file-preview 文件预览（内嵌 Popover）
+
+以文字链接形式展示文件名，鼠标悬停弹出文件列表（支持多文件），列表中每项可点击预览或下载，无需打开新弹窗即可操作。
+
+## 前置依赖
+
+- `pit-business-utils` — `reqOssList`、`reqOssPresignedObjectUrl`、`downloadUrlFile`、`fileType`
+- `PitPreview` — 内部调用用于不支持类型的预览弹窗
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| fileId | 文件 ID（逗号分隔字符串，支持多文件） | String | — |
+| disabled | 是否禁用（仅展示，不可交互） | Boolean | `false` |
+| rowObj | 所在行数据对象（预留，用于扩展场景） | Object | `{}` |
+| placement | Popover 弹出方向（同 `el-popover` placement） | String | `"top"` |
+| modelKey | 模型 ID 字段名（预留） | String | `"modelId"` |
+
+## 特性
+
+- `fileId` 变化时自动调用 `reqOssList` 获取文件列表并更新展示文件名。
+- Popover 中展示每个文件的**预览**（眼睛图标）和**下载**（下载图标）操作。
+- 不支持预览类型时弹出 warning 提示；图片类型通过 `PitPreview` 弹窗渲染。
+
+## 示例
+
+### 表格列中使用
+
+```vue
+<el-table-column label="附件" width="200">
+  <template slot-scope="{ row }">
+    <pit-file-preview :file-id="row.fileId" />
+  </template>
+</el-table-column>
+```
+
+### 自定义弹出方向
+
+```vue
+<pit-file-preview :file-id="form.fileId" placement="bottom" />
+```
+
+## 与其他预览组件的区别
+
+| 组件 | 触发方式 | 适用场景 |
+| --- | --- | --- |
+| PitFilePreview | 悬停 Popover | 表格列内嵌、轻量展示 |
+| PitPreview | 编程调用 / v-model | 按钮触发的独立预览弹窗 |
+| PitImagePreview | 内嵌图片 + 点击放大 | 纯图片展示区域 |
+
+## 注意事项
+
+- `fileId` 为空时组件不渲染（`v-if="fileId"`）。
+- 触发器为文字链接（`<a>` 标签），悬停显示全部文件名 title。
+- 多文件逗号分隔时，Popover 列表会展示所有文件；单文件时文本缩略显示。

package/docs/pitBusinessUi/flow-table-status.md

@@ -0,0 +1,47 @@
+# pit-flow-table-status 流程状态标签
+
+根据流程审批状态值渲染带语义颜色的 `el-tag`，内置状态文字和颜色映射，无需调用方自行维护映射表。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| status | 流程状态值（见下方状态表） | String | `""` |
+
+## 状态映射表
+
+| status 值 | 显示文字 | Tag 类型（颜色） |
+| --- | --- | --- |
+| `"draft"` | 等待提交 | `info`（灰色） |
+| `"approval"` | 等待审核 | `primary`（蓝色） |
+| `"reject"` | 审核驳回 | `danger`（红色） |
+| `"end"` | 流程结束 | `success`（绿色） |
+| `"withdraw"` | 流程撤回 | `danger`（红色） |
+| `"pass"` | 审核通过 | `success`（绿色） |
+| `"termination"` | 流程作废 | `danger`（红色） |
+| 其他/空 | 等待提交 | `info`（灰色） |
+
+## 示例
+
+### 在表格列中使用
+
+```vue
+<el-table-column label="审批状态" width="100" align="center">
+  <template slot-scope="{ row }">
+    <pit-flow-table-status :status="row.approvalStatus" />
+  </template>
+</el-table-column>
+```
+
+### 独立展示
+
+```vue
+<pit-flow-table-status status="approval" />
+<pit-flow-table-status status="end" />
+<pit-flow-table-status status="reject" />
+```
+
+## 注意事项
+
+- `status` 值区分大小写，需与常量严格匹配（均为小写英文）。
+- 文字和颜色映射固定在组件内部，若业务需要不同颜色/文字，可改用 `PitTag` 组件自定义 `tagObj`。

package/docs/pitBusinessUi/icon-box.md

@@ -0,0 +1,74 @@
+# pit-icon-box 图标选择器
+
+带搜索的图标选择弹窗，提供"菜单图标"和"基础图标"两个分类 Tab，选中后通过 `choiceIcon` 事件返回图标 class 名称。使用 `.sync` 控制显示状态。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| visible | 弹窗是否可见（支持 `.sync`） | Boolean | `false` |
+| current | 当前已选图标的 class 名称（用于高亮显示） | String | `""` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| choiceIcon | 点击图标时触发 | `iconClass: String`（如 `"el-icon-star-on"`） |
+| update:visible | `.sync` 支持（点击关闭时触发） | `Boolean` |
+
+## 示例
+
+### 基础用法
+
+```vue
+<pit-icon-box
+  :visible.sync="iconPickerVisible"
+  :current="form.icon"
+  @choiceIcon="handleChoiceIcon" />
+
+<el-button @click="iconPickerVisible = true">
+  <i :class="form.icon" />
+  选择图标
+</el-button>
+
+<script>
+export default {
+  data() {
+    return {
+      iconPickerVisible: false,
+      form: { icon: 'el-icon-star-on' }
+    }
+  },
+  methods: {
+    handleChoiceIcon(iconClass) {
+      this.form.icon = iconClass
+      this.iconPickerVisible = false
+    }
+  }
+}
+</script>
+```
+
+### 在菜单管理表单中使用
+
+```vue
+<el-form-item label="菜单图标">
+  <div style="display:flex; align-items:center; gap:8px;">
+    <i :class="menuForm.icon" style="font-size:20px;" />
+    <span>{{ menuForm.icon || '未选择' }}</span>
+    <el-button size="small" @click="showIconPicker = true">选择</el-button>
+  </div>
+</el-form-item>
+
+<pit-icon-box
+  :visible.sync="showIconPicker"
+  :current="menuForm.icon"
+  @choiceIcon="icon => { menuForm.icon = icon; showIconPicker = false }" />
+```
+
+## 注意事项
+
+- 图标数据从静态 JSON 文件加载（`icon-custom.json` 菜单图标 / `icon-basics.json` 基础图标），不需要网络请求。
+- 搜索按 Tab 独立过滤，切换 Tab 时搜索关键词不共享。
+- `choiceIcon` 事件不会自动关闭弹窗，需在事件回调中手动将 `visible` 设为 `false`。
+- 内部使用 `pit-dialog` 组件，弹窗尺寸已内置，不支持自定义宽度。

package/docs/pitBusinessUi/image-preview.md

@@ -0,0 +1,55 @@
+# pit-image-preview 图片预览
+
+将文件 ID（OSS Record ID）转换为预签名 URL 后渲染 `el-image`，支持单图/列表展示、自动预览放大。
+
+## 前置依赖
+
+- `pit-business-utils` — `reqOssPresignedObjectUrl`（批量获取预签名 URL）
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value | 文件 ID（字符串逗号分隔）或 ID 数组 | Array / String | — |
+| size | 图片宽高（正方形，CSS 值如 `"80px"`） | String | — |
+| width | 图片宽度（优先级高于 size） | String | `""` |
+| height | 图片高度（优先级高于 size） | String | `""` |
+| showList | 是否展示全部图片列表（`false` 只显示第一张） | Boolean | `false` |
+| noPreview | 是否禁用点击放大预览 | Boolean | `false` |
+| cacheImages | 外部传入缓存 URL 列表（覆盖内部自动获取的 URL） | Array | `[]` |
+| cacheId | 预留字段（内部未使用） | String | `"id"` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| click | 点击图片时触发 | — |
+
+## 示例
+
+### 单图显示（ID 字符串）
+
+```vue
+<pit-image-preview :value="row.thumbnailId" size="60px" />
+```
+
+### 多图列表展示
+
+```vue
+<pit-image-preview
+  :value="form.photoIds"
+  size="80px"
+  show-list />
+```
+
+### 禁止预览放大
+
+```vue
+<pit-image-preview :value="form.coverId" size="100px" no-preview />
+```
+
+## 注意事项
+
+- `value` 为空时组件不渲染（`v-if="urls.length"`）。
+- 每个文件 ID 会异步调用一次 `reqOssPresignedObjectUrl`，多图时为并行请求（`Promise.all`）。
+- `cacheImages` 优先级高于内部获取的 URL 列表，传入后跳过 OSS 请求。

package/docs/pitBusinessUi/image.md

@@ -0,0 +1,53 @@
+# pit-image 图片显示
+
+将 OSS 存储的图片 ID（或数组）转换为 presigned URL 并展示，支持 `el-image` 内置预览功能。
+
+> 与 `PitImagePreview` 的主要区别：使用 `isPreview`（而非 `noPreview`），且不支持缓存复用（`cacheImages`）。对于新功能优先使用 `PitImagePreview`。
+
+## 前置依赖
+
+- `pit-business-utils` — `reqOssPresignedObjectUrl`（生成图片 presigned 访问 URL）
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 图片 ID 或 ID 数组 | String / Array | — |
+| size | 图片尺寸快捷设置（如 `"80px"`，同时设置宽高） | String | — |
+| width | 图片宽度 | String | `""` |
+| height | 图片高度 | String | `""` |
+| showList | 是否显示 `value` 为数组时的图片列表（多张） | Boolean | `false` |
+| isPreview | 是否启用点击预览（`el-image` 预览功能） | Boolean | `true` |
+
+## 示例
+
+### 显示单张图片
+
+```vue
+<pit-image :value="avatarId" size="80px" />
+```
+
+### 显示图片列表
+
+```vue
+<pit-image :value="imageIds" :show-list="true" width="60px" height="60px" />
+```
+
+### 禁用点击预览
+
+```vue
+<pit-image :value="imageId" :is-preview="false" size="100px" />
+```
+
+## 与 PitImagePreview 对比
+
+| 特性 | PitImage | PitImagePreview |
+| --- | --- | --- |
+| 启用预览 prop | `isPreview: true` | `noPreview: false`（逻辑相反） |
+| OSS URL 缓存 | ❌ | ✅ `cacheImages` |
+| 推荐程度 | 旧版，兼容保留 | 推荐新项目使用 |
+
+## 注意事项
+
+- `size` 同时覆盖宽高，若同时指定 `size` 和 `width`/`height`，`size` 优先。
+- 组件在 `created()` 钩子中发起 OSS presigned URL 请求，URL 有有效期（通常 15 分钟），长时间展示页面需自行刷新。