@yidun/cdn-upload-webpack-plugin 1.1.5 → 1.1.7

package/.eslintignore

@@ -1,3 +1,3 @@
-/dist/
-/dashboard/
+/dist/
+/dashboard/
 node_modules

package/.eslintrc.js

@@ -1,9 +1,9 @@
-module.exports = {
-  root: true,
-  env: {
-    node: true
-  },
-  extends: [
-    'standard'
-  ]
-}
+module.exports = {
+  root: true,
+  env: {
+    node: true
+  },
+  extends: [
+    'standard'
+  ]
+}

package/README.md

@@ -1,45 +1,68 @@
-## cdn-upload-webpack-plugin, 用于将静态资源上传到 cdn
-
-### usage
-
-### 构造函数
-
-```
-  /**
-   * @param {Object} options
-   * @param {Array|String} dirs 待上传的文件目录
-   * @param {Boolean} includeRootDir 文件的相对路径计算时包不包含根目录，默认 true
-   * @param {RegExp|Array<RegExp>} ignores 排除特定文件
-   * @param {Object} client 上传 client 配置，目前只支持 NosClient，不同的 client 配置参数可能不同，以 nos 举例
-   * @param {String} accessId
-   * @param {String} secretKey
-   * @param {String} bucket 桶名
-   * @param {String} namespace 不同项目在使用同一个桶时做隔离
-   */
-  new CdnUploadWebpackPlugin(options)
-```
-
-### 以 vue-cli 项目举例
-
-```
-  configureWebpack: config => {
-    if (process.env.NODE_ENV === 'production') {
-      config.plugins.push(...[
-        new CdnUploadWebpackPlugin({
-          dirs: path.resolve(__dirname, './dist'),
-          ignore: /.html$/,
-          client: {
-            bucket: '',
-            accessId: '',
-            secretKey: '',
-            namespace: 'yidunfe/cdntest'
-          }
-        })
-      ])
-    }
-  },
-```
-
-### adaptor
-
-目前仅支持 nos 上传，后续如有其他的上传需求，可自行扩展 adaptor，可通过 client 参数区分
+## cdn-upload-webpack-plugin, 用于将静态资源上传到 cdn
+
+### usage
+
+### 构造函数
+
+```
+  /**
+   * @param {Object} options
+   * @param {Array|String} dirs 待上传的文件目录
+   * @param {Boolean} includeRootDir 文件的相对路径计算时包不包含根目录，默认 true
+   * @param {RegExp|Array<RegExp>} ignores 排除特定文件
+   * @param {Object} client 上传 client 配置，目前只支持 NosClient，不同的 client 配置参数可能不同，以 nos 举例
+   * @param {String} accessId
+   * @param {String} secretKey
+   * @param {String} bucket 桶名
+   * @param {String} namespace 不同项目在使用同一个桶时做隔离
+   * @param {Boolean} incrementalUpload 仅 vite 插件支持。是否开启增量上传（仅对 content-hash 文件生效），默认 false
+   * @param {Number} precheckParallelCount 仅 vite 插件支持。增量上传预检查并发数，默认与 parallelCount 一致
+   * @param {Boolean} cleanupAfterUpload 仅 vite 插件支持。上传成功后是否清理本地资源，默认 false
+   * @param {RegExp|Array<RegExp>} cleanupKeepRules 仅 vite 插件支持。清理后保留规则，默认 [/\.html$/]
+   */
+  new CdnUploadWebpackPlugin(options)
+```
+
+### 以 vue-cli 项目举例
+
+```
+  configureWebpack: config => {
+    if (process.env.NODE_ENV === 'production') {
+      config.plugins.push(...[
+        new CdnUploadWebpackPlugin({
+          dirs: path.resolve(__dirname, './dist'),
+          ignore: /.html$/,
+          client: {
+            bucket: '',
+            accessId: '',
+            secretKey: '',
+            namespace: 'yidunfe/cdntest'
+          }
+        })
+      ])
+    }
+  },
+```
+
+### adaptor
+
+目前仅支持 nos 上传，后续如有其他的上传需求，可自行扩展 adaptor，可通过 client 参数区分
+
+### vite 额外能力：上传成功后清理本地静态资源
+
+```js
+CdnUploadVitePlugin({
+  dirs: [path.join(__dirname, './dist')],
+  ignores: [/\.html$/, /\.map$/],
+  incrementalUpload: true,
+  precheckParallelCount: 24,
+  cleanupAfterUpload: true,
+  cleanupKeepRules: [/index\.html$/],
+  client: {
+    bucket: '',
+    accessId: '',
+    secretKey: '',
+    namespace: 'yidunfe/cdntest'
+  }
+})
+```

package/package.json

@@ -1,24 +1,24 @@
-{
-  "name": "@yidun/cdn-upload-webpack-plugin",
-  "version": "1.1.5",
-  "description": "A webpack plugin for upload dist to cdn.",
-  "main": "src/index.js",
-  "scripts": {
-    "test": "node test/index.js"
-  },
-  "author": "zhanglulu01",
-  "license": "ISC",
-  "devDependencies": {
-    "eslint": "^7.14.0",
-    "eslint-config-standard": "^16.0.2",
-    "eslint-plugin-import": "^2.22.1",
-    "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-promise": "^4.2.1",
-    "eslint-plugin-standard": "^5.0.0"
-  },
-  "dependencies": {
-    "@nos-sdk/nos-node-sdk": "^0.2.6",
-    "bluebird": "^3.7.2",
-    "node-fetch": "^2.7.0"
-  }
-}
+{
+  "name": "@yidun/cdn-upload-webpack-plugin",
+  "version": "1.1.7",
+  "description": "A webpack plugin for upload dist to cdn.",
+  "main": "src/index.js",
+  "scripts": {
+    "test": "node test/index.js"
+  },
+  "author": "zhanglulu01",
+  "license": "ISC",
+  "devDependencies": {
+    "eslint": "^7.14.0",
+    "eslint-config-standard": "^16.0.2",
+    "eslint-plugin-import": "^2.22.1",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-promise": "^4.2.1",
+    "eslint-plugin-standard": "^5.0.0"
+  },
+  "dependencies": {
+    "@nos-sdk/nos-node-sdk": "^0.2.6",
+    "bluebird": "^3.7.2",
+    "node-fetch": "^2.7.0"
+  }
+}

package/src/adaptor/nos.js

@@ -1,39 +1,39 @@
-const { Task } = require('../task')
-const { NosClient } = require('@nos-sdk/nos-node-sdk')
-const { normalizeObjectKey } = require('../utils')
-const fs = require('fs')
-
-class NosUploadTask extends Task {
-  constructor (nosOptions, file) {
-    super(() => this.upload())
-    const { accessId, secretKey, bucket, endpoint = 'nos.netease.com', namespace = '' } = nosOptions
-    const nosClient = new NosClient({
-      accessKey: accessId,
-      accessSecret: secretKey,
-      endpoint: `https://${endpoint}`,
-      defaultBucket: bucket
-    })
-    this._nosClient = nosClient
-    this._bucket = bucket
-    this._file = file
-    this._namespace = namespace
-  }
-
-  upload () {
-    return new Promise((resolve, reject) => {
-      try {
-        const stream = fs.createReadStream(this._file.path)
-        const data = this._nosClient.putObject({
-          body: stream,
-          objectKey: normalizeObjectKey(`${this._namespace}/${this._file.relative}`)
-        })
-        resolve(data)
-      } catch (error) {
-        console.error(`upload to nos fail, because ${error}`)
-        reject(error)
-      }
-    })
-  }
-}
-
-module.exports = NosUploadTask
+const { Task } = require('../task')
+const { NosClient } = require('@nos-sdk/nos-node-sdk')
+const { normalizeObjectKey } = require('../utils')
+const fs = require('fs')
+
+class NosUploadTask extends Task {
+  constructor (nosOptions, file) {
+    super(() => this.upload())
+    const { accessId, secretKey, bucket, endpoint = 'nos.netease.com', namespace = '' } = nosOptions
+    const nosClient = new NosClient({
+      accessKey: accessId,
+      accessSecret: secretKey,
+      endpoint: `https://${endpoint}`,
+      defaultBucket: bucket
+    })
+    this._nosClient = nosClient
+    this._bucket = bucket
+    this._file = file
+    this._namespace = namespace
+  }
+
+  upload () {
+    return new Promise((resolve, reject) => {
+      try {
+        const stream = fs.createReadStream(this._file.path)
+        const data = this._nosClient.putObject({
+          body: stream,
+          objectKey: normalizeObjectKey(`${this._namespace}/${this._file.relative}`)
+        })
+        resolve(data)
+      } catch (error) {
+        console.error(`upload to nos fail, because ${error}`)
+        reject(error)
+      }
+    })
+  }
+}
+
+module.exports = NosUploadTask

package/src/index.js

@@ -1,45 +1,45 @@
-const { getFiles } = require('./utils')
-const { TaskDispatcher } = require('./task')
-const NosUploadTask = require('./adaptor/nos')
-const CdnUploadVitePlugin = require('./vite')
-
-exports.CdnUploadWebpackPlugin = class CdnUploadWebpackPlugin {
-  /**
-   * @param {Object} options
-   * @param {Array|String} dirs 待上传的文件目录
-   * @param {Boolean} includeRootDir 文件的相对路径计算时包不包含根目录，默认 true
-   * @param {RegExp|Array<RegExp>} ignores 排除特定文件
-   * @param {Object} client 上传 client 配置，目前只支持 NosClient，不同的 client 配置参数可能不同，以 nos 举例
-   * @param {String} accessId
-   * @param {String} secretKey
-   * @param {String} bucket 桶名
-   * @param {String} namespace 不同项目在使用同一个桶时做隔离
-   * @param {Number} parallelCount 并行上传数, 默认 3
-   */
-  constructor (options) {
-    const { dirs, includeRootDir, ignores, client, parallelCount } = options
-    this._dirs = dirs
-    this._includeRootDir = includeRootDir
-    this._ignores = ignores
-    this._client = client
-    this._parallelCount = parallelCount
-  }
-
-  apply (compiler) {
-    compiler.hooks.afterEmit.tapAsync('CdnUploadWebpackPlugin', (compiler, callback) => {
-      const files = getFiles(this._dirs, this._includeRootDir, this._ignores)
-      const tasks = files.map(file => new NosUploadTask(this._client, file))
-      const taskDispatcher = new TaskDispatcher(tasks, {
-        onSuccess: () => {
-          console.log('CdnUploadWebpackPlugin: assets upload success')
-          callback()
-        },
-        onError: error => callback(error)
-      })
-      console.log('CdnUploadWebpackPlugin: assets uploading ...')
-      taskDispatcher.dispatch(this._parallelCount)
-    })
-  }
-}
-
-exports.CdnUploadVitePlugin = CdnUploadVitePlugin
+const { getFiles } = require('./utils')
+const { TaskDispatcher } = require('./task')
+const NosUploadTask = require('./adaptor/nos')
+const CdnUploadVitePlugin = require('./vite')
+
+exports.CdnUploadWebpackPlugin = class CdnUploadWebpackPlugin {
+  /**
+   * @param {Object} options
+   * @param {Array|String} dirs 待上传的文件目录
+   * @param {Boolean} includeRootDir 文件的相对路径计算时包不包含根目录，默认 true
+   * @param {RegExp|Array<RegExp>} ignores 排除特定文件
+   * @param {Object} client 上传 client 配置，目前只支持 NosClient，不同的 client 配置参数可能不同，以 nos 举例
+   * @param {String} accessId
+   * @param {String} secretKey
+   * @param {String} bucket 桶名
+   * @param {String} namespace 不同项目在使用同一个桶时做隔离
+   * @param {Number} parallelCount 并行上传数, 默认 3
+   */
+  constructor (options) {
+    const { dirs, includeRootDir, ignores, client, parallelCount } = options
+    this._dirs = dirs
+    this._includeRootDir = includeRootDir
+    this._ignores = ignores
+    this._client = client
+    this._parallelCount = parallelCount
+  }
+
+  apply (compiler) {
+    compiler.hooks.afterEmit.tapAsync('CdnUploadWebpackPlugin', (compiler, callback) => {
+      const files = getFiles(this._dirs, this._includeRootDir, this._ignores)
+      const tasks = files.map(file => new NosUploadTask(this._client, file))
+      const taskDispatcher = new TaskDispatcher(tasks, {
+        onSuccess: () => {
+          console.log('CdnUploadWebpackPlugin: assets upload success')
+          callback()
+        },
+        onError: error => callback(error)
+      })
+      console.log('CdnUploadWebpackPlugin: assets uploading ...')
+      taskDispatcher.dispatch(this._parallelCount)
+    })
+  }
+}
+
+exports.CdnUploadVitePlugin = CdnUploadVitePlugin

package/src/task.js

@@ -1,103 +1,103 @@
-const { noop } = require('./utils')
-
-const TASK_STATUS = {
-  PENDING: 'pending',
-  DOING: 'doing',
-  REJECTED: 'rejected',
-  FULFILLED: 'fulfilled'
-}
-
-let uid = 0 // 任务 id
-/**
- * task 基类，提供重试等功能,供 adaptor 继承，如 NosUploadTask
- */
-class Task {
-  constructor (invoke) {
-    this.status = TASK_STATUS.PENDING
-    this._id = uid++
-    this._invoke = invoke
-    this._retryCount = 3
-  }
-
-  async start () {
-    let retryCount = this._retryCount
-    let res
-    try {
-      this.status = TASK_STATUS.DOING
-      res = await this._invoke()
-    } catch (error) {
-      retryCount--
-      if (retryCount < 0) {
-        this.status = TASK_STATUS.REJECTED
-        return Promise.reject(error)
-      } else {
-        res = await this._invoke()
-      }
-    }
-    this.status = TASK_STATUS.FULFILLED
-    return res
-  }
-}
-
-const PARALLEL_COUNT = 3 // 上传并行数
-/**
- * 任务调度器，完成整个上传任务的调度
- */
-class TaskDispatcher {
-  constructor (tasks, callbacks = {}) {
-    this.status = TASK_STATUS.PENDING
-    this._tasks = tasks
-    this._activeTasks = []
-    this._onError = callbacks.onError || noop
-    this._onSuccess = callbacks.onSuccess || noop
-  }
-
-  getPendingTask (count) {
-    return this._tasks.filter(t => t.status === TASK_STATUS.PENDING).slice(0, count)
-  }
-
-  getPendingTaskCount () {
-    return this._tasks.filter(t => t.status === TASK_STATUS.PENDING).length
-  }
-
-  removeActiveTask (task) {
-    const index = this._activeTasks.findIndex(t => task._id === t._id)
-    if (index > -1) {
-      this._activeTasks.splice(index, 1)
-    }
-  }
-
-  isAllTaskFulfilled () {
-    return this._tasks.every(t => t.status === TASK_STATUS.FULFILLED)
-  }
-
-  /**
-   * 任务调度入口
-   * @param {Number} count
-   */
-  dispatch (count = PARALLEL_COUNT) {
-    if (TASK_STATUS.REJECTED === this.status) return
-
-    this._activeTasks = this._activeTasks.concat(this.getPendingTask(count))
-    this._activeTasks.forEach(task => {
-      if (task.status === TASK_STATUS.PENDING) {
-        task.start().then(res => {
-          this.removeActiveTask(task)
-          if (this.getPendingTaskCount() > 0) {
-            this.dispatch(1)
-          } else if (this.isAllTaskFulfilled()) {
-            this._onSuccess(this._tasks)
-          }
-        }).catch(error => {
-          this.status = TASK_STATUS.REJECTED
-          this._onError(error)
-        })
-      }
-    })
-  }
-}
-
-module.exports = {
-  Task,
-  TaskDispatcher
-}
+const { noop } = require('./utils')
+
+const TASK_STATUS = {
+  PENDING: 'pending',
+  DOING: 'doing',
+  REJECTED: 'rejected',
+  FULFILLED: 'fulfilled'
+}
+
+let uid = 0 // 任务 id
+/**
+ * task 基类，提供重试等功能,供 adaptor 继承，如 NosUploadTask
+ */
+class Task {
+  constructor (invoke) {
+    this.status = TASK_STATUS.PENDING
+    this._id = uid++
+    this._invoke = invoke
+    this._retryCount = 3
+  }
+
+  async start () {
+    let retryCount = this._retryCount
+    let res
+    try {
+      this.status = TASK_STATUS.DOING
+      res = await this._invoke()
+    } catch (error) {
+      retryCount--
+      if (retryCount < 0) {
+        this.status = TASK_STATUS.REJECTED
+        return Promise.reject(error)
+      } else {
+        res = await this._invoke()
+      }
+    }
+    this.status = TASK_STATUS.FULFILLED
+    return res
+  }
+}
+
+const PARALLEL_COUNT = 3 // 上传并行数
+/**
+ * 任务调度器，完成整个上传任务的调度
+ */
+class TaskDispatcher {
+  constructor (tasks, callbacks = {}) {
+    this.status = TASK_STATUS.PENDING
+    this._tasks = tasks
+    this._activeTasks = []
+    this._onError = callbacks.onError || noop
+    this._onSuccess = callbacks.onSuccess || noop
+  }
+
+  getPendingTask (count) {
+    return this._tasks.filter(t => t.status === TASK_STATUS.PENDING).slice(0, count)
+  }
+
+  getPendingTaskCount () {
+    return this._tasks.filter(t => t.status === TASK_STATUS.PENDING).length
+  }
+
+  removeActiveTask (task) {
+    const index = this._activeTasks.findIndex(t => task._id === t._id)
+    if (index > -1) {
+      this._activeTasks.splice(index, 1)
+    }
+  }
+
+  isAllTaskFulfilled () {
+    return this._tasks.every(t => t.status === TASK_STATUS.FULFILLED)
+  }
+
+  /**
+   * 任务调度入口
+   * @param {Number} count
+   */
+  dispatch (count = PARALLEL_COUNT) {
+    if (TASK_STATUS.REJECTED === this.status) return
+
+    this._activeTasks = this._activeTasks.concat(this.getPendingTask(count))
+    this._activeTasks.forEach(task => {
+      if (task.status === TASK_STATUS.PENDING) {
+        task.start().then(res => {
+          this.removeActiveTask(task)
+          if (this.getPendingTaskCount() > 0) {
+            this.dispatch(1)
+          } else if (this.isAllTaskFulfilled()) {
+            this._onSuccess(this._tasks)
+          }
+        }).catch(error => {
+          this.status = TASK_STATUS.REJECTED
+          this._onError(error)
+        })
+      }
+    })
+  }
+}
+
+module.exports = {
+  Task,
+  TaskDispatcher
+}

package/src/utils.js

@@ -1,41 +1,73 @@
-const Promise = require('bluebird')
-const fs = Promise.promisifyAll(require('fs'))
-const path = require('path')
-
-function getFiles (dirs, includeRootDir = true, ignores) {
-  if (typeof dirs === 'string') dirs = [dirs]
-  if (ignores instanceof RegExp) ignores = [ignores]
-
-  const res = []
-  dirs.forEach(dir => deep(dir, dir))
-
-  function deep (dir, rootDir) {
-    const files = fs.readdirSync(dir)
-    files.forEach(fileName => {
-      const pathName = `${dir}${path.sep}${fileName}`
-      const info = fs.lstatSync(pathName)
-      if (info.isDirectory()) {
-        deep(pathName, rootDir)
-      } else {
-        if (!ignores || ignores.every(ignore => !ignore.test(pathName))) {
-          res.push({
-            path: pathName,
-            relative: path.relative(includeRootDir ? path.join(rootDir, '../') : rootDir, pathName)
-          })
-        }
-      }
-    })
-  }
-
-  return res
-}
-
-function normalizeObjectKey (objectKey) {
-  return path.normalize(objectKey).replace(/\\/g, '/')
-}
-
-module.exports = {
-  getFiles,
-  normalizeObjectKey,
-  noop () {}
-}
+const Promise = require('bluebird')
+const fs = Promise.promisifyAll(require('fs'))
+const path = require('path')
+
+function getFiles (dirs, includeRootDir = true, ignores) {
+  if (typeof dirs === 'string') dirs = [dirs]
+  if (ignores instanceof RegExp) ignores = [ignores]
+
+  const res = []
+  dirs.forEach(dir => deep(dir, dir))
+
+  function deep (dir, rootDir) {
+    const files = fs.readdirSync(dir)
+    files.forEach(fileName => {
+      const pathName = `${dir}${path.sep}${fileName}`
+      const info = fs.lstatSync(pathName)
+      if (info.isDirectory()) {
+        deep(pathName, rootDir)
+      } else {
+        if (!ignores || ignores.every(ignore => !ignore.test(pathName))) {
+          res.push({
+            path: pathName,
+            relative: path.relative(includeRootDir ? path.join(rootDir, '../') : rootDir, pathName)
+          })
+        }
+      }
+    })
+  }
+
+  return res
+}
+
+function normalizeObjectKey (objectKey) {
+  return path.normalize(objectKey).replace(/\\/g, '/')
+}
+
+function cleanupFiles (dirs, keepRules = [/\.html$/]) {
+  if (typeof dirs === 'string') dirs = [dirs]
+  if (!(keepRules instanceof Array)) keepRules = [keepRules]
+
+  const shouldKeep = (filePath) => keepRules.some((rule) => rule.test(filePath))
+
+  function cleanDir (dir) {
+    if (!fs.existsSync(dir)) return
+    const entries = fs.readdirSync(dir)
+    entries.forEach((entryName) => {
+      const entryPath = path.join(dir, entryName)
+      const stat = fs.lstatSync(entryPath)
+      if (stat.isDirectory()) {
+        cleanDir(entryPath)
+        const remain = fs.readdirSync(entryPath)
+        if (remain.length === 0) fs.rmdirSync(entryPath)
+        return
+      }
+      if (!shouldKeep(entryPath)) fs.unlinkSync(entryPath)
+    })
+  }
+
+  dirs.forEach((dir) => {
+    try {
+      cleanDir(dir)
+    } catch (error) {
+      console.warn(`cleanupFiles warn: failed to clean "${dir}", error: ${error.message || error}`)
+    }
+  })
+}
+
+module.exports = {
+  getFiles,
+  normalizeObjectKey,
+  cleanupFiles,
+  noop () {}
+}

package/src/vite.js

@@ -1,46 +1,137 @@
-const fetch = require('node-fetch')
-const { getFiles } = require('./utils')
-const { TaskDispatcher } = require('./task')
-const NosUploadTask = require('./adaptor/nos')
-
-/**
- * @param {Object} options
- * @param {Array|String} dirs 待上传的文件目录
- * @param {Boolean} includeRootDir 文件的相对路径计算时包不包含根目录，默认 true
- * @param {RegExp|Array<RegExp>} ignores 排除特定文件
- * @param {Object} client 上传 client 配置，目前只支持 NosClient，不同的 client 配置参数可能不同，以 nos 举例
- * @param {String} accessId
- * @param {String} secretKey
- * @param {String} bucket 桶名
- * @param {String} namespace 不同项目在使用同一个桶时做隔离
- * @param {Number} parallelCount 并行上传数, 默认 3
- * @returns
- */
-function CdnUploadVitePlugin (options) {
-  const { dirs, includeRootDir, ignores, client, parallelCount, domain = 'https://yidunfe.nosdn.127.net' } = options
-  return {
-    name: 'vite-plugin-cdn-upload',
-    closeBundle () {
-      const files = getFiles(dirs, includeRootDir, ignores)
-      const tasks = files.map((file) => new NosUploadTask(client, file))
-      return new Promise((resolve, reject) => {
-        const taskDispatcher = new TaskDispatcher(tasks, {
-          onSuccess: async (task) => {
-            // cdn 上传成功后健康检查
-            const { _file, _namespace } = task?.[0] || {}
-            const data = await fetch(`${domain}/${_namespace}/${_file.relative}`)
-            if (!data.ok || data.status !== 200) {
-              reject(new Error(`CdnUploadVitePlugin Error: url: ${data.url}, status: ${data.status}`))
-            }
-            console.log('CdnUploadVitePlugin: assets upload success')
-            resolve()
-          },
-          onError: (error) => reject(error)
-        })
-        console.log('CdnUploadVitePlugin: assets uploading ...')
-        taskDispatcher.dispatch(parallelCount)
-      })
-    }
-  }
-}
-module.exports = CdnUploadVitePlugin
+const fetch = require('node-fetch')
+const { getFiles, cleanupFiles } = require('./utils')
+const { TaskDispatcher } = require('./task')
+const NosUploadTask = require('./adaptor/nos')
+
+function isContentHashedFile (relativePath) {
+  // e.g. assets/index-abc12345.js / css / png / svg...
+  return /-[a-zA-Z0-9_]{8,}\.[^/]+$/.test(relativePath)
+}
+
+async function shouldUploadFile (domain, namespace, file) {
+  if (!isContentHashedFile(file.relative)) return true
+  const url = `${domain}/${namespace}/${file.relative}`
+  try {
+    const headResp = await fetch(url, { method: 'HEAD' })
+    // hashed file already exists remotely, can be safely skipped
+    return !headResp.ok
+  } catch (error) {
+    // network uncertainty -> upload to be safe
+    return true
+  }
+}
+
+async function mapWithConcurrency (items, concurrency, mapper) {
+  const size = Math.max(1, Number(concurrency) || 1)
+  const results = new Array(items.length)
+  let cursor = 0
+  async function worker () {
+    while (cursor < items.length) {
+      const index = cursor++
+      results[index] = await mapper(items[index], index)
+    }
+  }
+  const workers = Array.from({ length: Math.min(size, items.length || 1) }, () => worker())
+  await Promise.all(workers)
+  return results
+}
+
+/**
+ * @param {Object} options
+ * @param {Array|String} dirs 待上传的文件目录
+ * @param {Boolean} includeRootDir 文件的相对路径计算时包不包含根目录，默认 true
+ * @param {RegExp|Array<RegExp>} ignores 排除特定文件
+ * @param {Object} client 上传 client 配置，目前只支持 NosClient，不同的 client 配置参数可能不同，以 nos 举例
+ * @param {String} accessId
+ * @param {String} secretKey
+ * @param {String} bucket 桶名
+ * @param {String} namespace 不同项目在使用同一个桶时做隔离
+ * @param {Number} parallelCount 并行上传数, 默认 3
+ * @param {Boolean} incrementalUpload 是否开启增量上传（仅对 content-hash 文件生效），默认 false
+ * @param {Boolean} cleanupAfterUpload 上传成功后是否清理本地静态资源，默认 false
+ * @param {RegExp|Array<RegExp>} cleanupKeepRules 清理后保留规则，默认仅保留 html
+ * @returns
+ */
+function CdnUploadVitePlugin (options) {
+  const {
+    dirs,
+    includeRootDir,
+    ignores,
+    client,
+    parallelCount,
+    precheckParallelCount = parallelCount ?? 3,
+    domain = 'https://yidunfe.nosdn.127.net',
+    incrementalUpload = false,
+    cleanupAfterUpload = false,
+    cleanupKeepRules = [/\.html$/]
+  } = options
+  let buildStartAt = 0
+  return {
+    name: 'vite-plugin-cdn-upload',
+    buildStart () {
+      buildStartAt = Date.now()
+    },
+    async closeBundle () {
+      const uploadStageStart = Date.now()
+      const files = getFiles(dirs, includeRootDir, ignores)
+      let filesToUpload = files
+      if (incrementalUpload) {
+        const precheckStart = Date.now()
+        const uploadFlags = await mapWithConcurrency(
+          files,
+          precheckParallelCount,
+          (file) => shouldUploadFile(domain, client.namespace || '', file)
+        )
+        filesToUpload = files.filter((_, index) => uploadFlags[index])
+        const skippedCount = files.length - filesToUpload.length
+        const precheckCost = Date.now() - precheckStart
+        console.log(`CdnUploadVitePlugin: precheck done, total=${files.length}, upload=${filesToUpload.length}, skipped=${skippedCount}, cost=${precheckCost}ms`)
+        if (skippedCount > 0) {
+          console.log(`CdnUploadVitePlugin: skip upload ${skippedCount} hashed files already on CDN`)
+        }
+      }
+      if (filesToUpload.length === 0) {
+        if (cleanupAfterUpload) {
+          cleanupFiles(dirs, cleanupKeepRules)
+          console.log('CdnUploadVitePlugin: local static assets cleaned')
+        }
+        const totalCost = Date.now() - uploadStageStart
+        console.log(`CdnUploadVitePlugin: no files need upload, total upload stage cost=${totalCost}ms`)
+        if (buildStartAt > 0) {
+          console.log(`CdnUploadVitePlugin: build+upload total cost=${Date.now() - buildStartAt}ms`)
+        }
+        return
+      }
+      const tasks = filesToUpload.map((file) => new NosUploadTask(client, file))
+      const uploadStart = Date.now()
+      return new Promise((resolve, reject) => {
+        const taskDispatcher = new TaskDispatcher(tasks, {
+          onSuccess: async (task) => {
+            // cdn 上传成功后健康检查
+            const { _file, _namespace } = task?.[0] || {}
+            const data = await fetch(`${domain}/${_namespace}/${_file.relative}`)
+            if (!data.ok || data.status !== 200) {
+              return reject(new Error(`CdnUploadVitePlugin Error: url: ${data.url}, status: ${data.status}`))
+            }
+            if (cleanupAfterUpload) {
+              cleanupFiles(dirs, cleanupKeepRules)
+              console.log('CdnUploadVitePlugin: local static assets cleaned')
+            }
+            const uploadCost = Date.now() - uploadStart
+            const totalCost = Date.now() - uploadStageStart
+            console.log(`CdnUploadVitePlugin: upload cost=${uploadCost}ms, total upload stage cost=${totalCost}ms`)
+            if (buildStartAt > 0) {
+              console.log(`CdnUploadVitePlugin: build+upload total cost=${Date.now() - buildStartAt}ms`)
+            }
+            console.log('CdnUploadVitePlugin: assets upload success')
+            resolve()
+          },
+          onError: (error) => reject(error)
+        })
+        console.log('CdnUploadVitePlugin: assets uploading ...')
+        taskDispatcher.dispatch(parallelCount)
+      })
+    }
+  }
+}
+module.exports = CdnUploadVitePlugin