更新记录

1.1.0（2026-08-21） 下载此版本

上传

平台兼容性

uni-app(5.24)

uni-app x(5.24)

wc-upload

阿里云 OSS 直传封装，基于 wc-request（/core/mobile/system/aliyun/ossAuth）。 文件不经业务 server 中转（PostObject 表单直传），支持图片/视频/任意文件、多选、进度回调。

安装前置

1. wc-request ≥ 2.2.0、已 setupWcAuth()（ossAuth 需登录态）
2. server 侧已配置 OSS 密钥（WON_ALIYUN_OSS_KEY/SECRET 等）

使用

一站式：选 + 传（最常用）

import {
    chooseAndUploadImage,
    chooseAndUploadVideo,
} from '@/uni_modules/wc-upload/commons'

// 选 1 张图并上传（默认不传 subDir，跟随 server 配置目录）
const img = await chooseAndUploadImage(1)
console.log(img?.url)  // 公网地址

// 多选并发上传
const imgs = await chooseAndUploadImage(9)

// 选视频并上传（自动走视频存储目录）
const video = await chooseAndUploadVideo()
console.log(video.url, video.size)

通用：任意文件直传

import { uploadFileToOss } from '@/uni_modules/wc-upload/commons'

// 已有本地路径（chooseFile / chooseMessageFile / 录音等场景）
const result = await uploadFileToOss('/tmp/xxx.pdf', {
    mediaType: 'document',
    fileName: '合同_2026',          // 自定义文件名（可不带后缀）
})
// result: { url, objectName, fileName, fileType, mime_type, size }

仅拿凭证（自己控制上传时）

import { getOssAuth } from '@/uni_modules/wc-upload/commons'

const auth = await getOssAuth({ media_type: 'video' })
// auth: { accessid, host, policy, signature, expire, dir, ossHost }

存储目录规则（与 server 约定）

最终 OSS 目录由 server 拼接，前端只需要决定"传不传 subDir"：

目录 = [server 配置前缀] + [subDir（前端按需传）] + /年/月/
      ↑ .env 的 DIR_PREFIX     ↑ 不传就没有这一段

subDir 是 server 侧定义的参数（GET /ossAuth?sub_dir=...），支持多级（order/123）。 不要用它做"看起来整洁"的目录——除非有上面的运维/隔离需求，否则跟随 server 默认。

何时需要进度

await chooseAndUploadVideo({
    : (p) => console.log(`${p}%`),   // 0-100；多图时每张各自回调
})

行为约定

返回结构

interface UploadResult {
  url: string        // 公网访问地址
  objectName: string // OSS key，如 wc-tech/demo/2026/08/xxx.jpg
  fileName: string   // 文件名（不含目录）
  fileType: string   // 后缀，如 jpg / mp4
  mime_type: string  // MIME（可能为空）
  size: number       // 字节（可能为 0）
}

范围说明

刻意不包含（保持简单）：

• 分片上传 / 断点续传（server 有 ChunkUploadService，需要时另封装）
• 上传后回写业务库（各业务自己存 UploadResult.url）
• 内容安全检测（server 有 security 系列接口，需要时另封装）