README

发布 NPM 包说明

https://docs.gitlab.cn/jh/user/packages/npm_registry/index.html

$ pnpm build
$ npm publish

OSS 上传请求头（0.1.2 起）

deploy --headers 接受一个或多个 Header-Name:value，上传时作为 OSS 标准 HTTP 头写入对象元数据。省略时保留原上传行为；目前仅支持 alioss。

lusun-scripts deploy --target out --bucket example --endpoint oss-cn-beijing.aliyuncs.com \
  --accessKeyId "$ACCESS_KEY_ID" --accessKeySecret "$ACCESS_KEY_SECRET" \
  --patterns '**/*.html' --headers 'Cache-Control:no-cache'

静态网站可以复用 --patterns 分三次调用（每次沿用相同的目标和凭据参数）：

1. --patterns '_next/static/**' --headers 'Cache-Control:public, max-age=31536000, immutable'
2. --patterns '**/*' '!_next/static/**' '!**/*.html' --headers 'Cache-Control:no-cache'
3. --patterns '**/*.html' --headers 'Cache-Control:no-cache'

调用方应使用 set -e，只在上一批全部成功后上传下一批；HTML 最后发布。 OSS 上传默认串行执行，并保留失败重试。最终失败会向调用方抛出错误，停止后续文件。 上传不会清理历史资源，以便已经打开的旧页面继续访问旧版本文件。

pnpm test 使用模拟 OSS 上传验证参数、缓存头、分批顺序及错误传播，不访问 OSS。

OSS 文件上传并发数（0.1.2 起）

deploy --concurrency <正整数> 控制同时上传的 OSS 文件数，默认 1。 例如在原有部署命令后添加 --concurrency 2，允许同时上传两个文件。 该参数针对 alioss 客户端，不改变 S3 / MinIO 的现有上传行为。 每批全部完成后命令才成功返回，因此可以继续按上述顺序分批发布。