diff --git a/src/components/base/upload-imgs/README.md b/src/components/base/upload-imgs/README.md
new file mode 100644
index 00000000..cf59f002
--- /dev/null
+++ b/src/components/base/upload-imgs/README.md
@@ -0,0 +1,88 @@
+# 多图上传
+
+多图片上传组件 `UploadImgs`, 附有预览, 排序, 验证等功能 [演示效果](http://face.cms.7yue.pro/#/imgs-upload/stage1)
+
+## 基础示例
+
+```vue
+
+
+
+```
+
+### 返回值说明
+
+新上传的图像会有完整的图像信息
+
+| 属性 | 类型 | 默认 | 说明 |
+| :--------: | :-----: | :--: | :--------: |
+| width | Number | null | 图像宽度 |
+| height | Number | null | 图像高度 |
+| size | Number | null | 文件大小 |
+| isAnimated | Boolean | null | 是否是动图 |
+
+## props
+
+| 参数 | 类型 | 默认值 | 说明 |
+| :------------: | :-----------: | :------: | :----------------------------------------------------------------------------------------: |
+| value | Array | [] | 初始化数据 |
+| auto-upload | Boolean | true | 新增图片是是否自动上传 |
+| disabled | Boolean | false | 是否禁用 |
+| preview | Boolean | true | 是否可预览 |
+| multiple | Boolean | false | 是否可以一次多选 |
+| min-num | Number | 0 | 最少图片数量 |
+| max-num | Number | 0 | 最多图片数量, 0 表示无限制 |
+| before-upload | Function | null | 上传前自定义校验函数, 返回 true 表示校验成功, 否则校验失败不进行后续上传, 支持返回 Promise |
+| remote-fuc | Function | null | 重写远程方法, 支持返回 Promise |
+| sortable | Boolean | false | 是否可排序 |
+| accept | String | image/\* | 运行上传的类型 |
+| animated-check | Boolean | false | 是否需要检测是否是动图 |
+| rules | Object | {} | 图像规则 |
+| fit | String | contain | 图像显示形式 |
+| width | Nulber/String | 200 | 宽度 |
+| height | Number/String | 200 | 高度 |
+
+图像验证规则属性 rule 支持的验证规则有:
+
+| 属性 | 类型 | 默认 | 说明 |
+| :-----------: | :-----: | :--: | :-------------: |
+| ratio | Array | null | 比例 [宽,高] |
+| width | Number | null | 宽度必需等于 |
+| height | Number | null | 高度必需等于 |
+| minWidth | Number | null | 最小宽 |
+| minHeight | Number | null | 最小高 |
+| minSize | Number | null | 最小 size(Mb) |
+| maxSize | Number | null | 最大 size(Mb) |
+| allowAnimated | Boolean | true | 最大 size(Mb) |
+
+默认值为 `{ maxSize: 2 }` 图片文件大小限制 2M 内. 这与 lin-cms 服务端文件上传接口默认限制一致
+
+## methods
+
+| 方法名 | 参数 | 说明 |
+| :------: | :--: | :------------------------------------------: |
+| getValue | 无 | 获取当前组件的值, 如果验证不通过则返回 false |
+| clear | 无 | 清空当前所选图片 |
diff --git a/src/components/base/upload-imgs/index.vue b/src/components/base/upload-imgs/index.vue
index 63305bb5..68587f42 100644
--- a/src/components/base/upload-imgs/index.vue
+++ b/src/components/base/upload-imgs/index.vue
@@ -1,39 +1,11 @@
@@ -117,19 +89,42 @@