unpkg-white-list


- npmmirror.com 允许开启 unpkg 功能的白名单列表，避免 https://x.com/fengmk2/status/1791498406923215020 类似问题
- allowPackages 字段：用于添加指定包名和版本号，示例：

``json
"allowPackages": {
"urllib": {
"version": "*"
}
}
`

- allowScopes 字段：用于添加指定 scope，示例：

`json
"allowScopes": [
"@eggjs",
"@ant-design"
]
`

- npmmirror sync package tgz 超大文件白名单列表，避免 https://x.com/fengmk2/status/1999821026012889567 类似问题
- allowLargePackages 字段：用于添加指定包名和版本号，示例：

`json
"allowLargePackages": {
"aws-cdk-lib": {
"version": "*"
}
}
`

- allowLargeScopes 字段：用于添加指定 scope，示例：

`json
"allowLargeScopes": [
"@next",
"@swc"
]
`

添加白名单方式

> [!NOTE]
> 尽量使用 CLI 添加白名单，它可以确保字段顺序和格式正确，避免手动修改 package.json 文件。

$3

用 CLI 添加你想开启 unpkg 文件同步的 npm 包名和版本号，全量同步版本号可以设置为 *，以同步 urllib 为示例：

`bash


npm run add -- --pkg={package name}[:{version range}]

npm run add -- "--pkg=urllib" # 同步 urllib 所有版本

or

npm run add -- "--pkg=urllib:1.0.0" # 同步 urllib 1.0.0 版本

or

npm run add -- "--pkg=urllib:>=1.0.0" # 同步 urllib 大于等于 1.0.0 版本
`

_你将会看到 package.json 文件中的 allowPackages 字段被更新，如下所示：_

`json
"allowPackages": {
...
"urllib": {
"version": "*"
}
...
}
`

$3

> [!WARNING]
> 为避免滥用，申请添加的 scope 必须已包含热门包（如周下载量超过 1 万）。我们不接受为刚创建且无热门包的 scope 添加白名单。

当然你发布的是 scoped package，可以用 CLI 添加 scope 到白名单 allowScopes：

`bash
npm run add -- --scope=@eggjs
`

_你将会看到 package.json 文件中的 allowScopes 字段被更新，如下所示：_

`json
"allowScopes": [
...
"@eggjs",
...
]
`

$3

用 CLI 添加你想开启 npmmirror sync package tgz 超大文件同步的 npm 包名和版本号，全量同步版本号可以设置为 *，以同步 aws-cdk-lib 为示例：

`bash


npm run add -- --large-pkg={package name}[:{version range}]

npm run add -- "--large-pkg=aws-cdk-lib" # 同步 aws-cdk-lib 所有版本

or

npm run add -- "--large-pkg=aws-cdk-lib:1.0.0" # 同步 aws-cdk-lib 1.0.0 版本

or

npm run add -- "--large-pkg=aws-cdk-lib:>=1.0.0" # 同步 aws-cdk-lib 大于等于 1.0.0 版本
`

_你将会看到 package.json 文件中的 allowLargePackages 字段被更新，如下所示：_

`json
"allowLargePackages": {
...
"aws-cdk-lib": {
"version": "*"
}
...
}
`

$3

> [!WARNING]
> 为避免滥用，申请添加的 scope 必须已包含热门包（如周下载量超过 1 万）。我们不接受为刚创建且无热门包的 scope 添加白名单。

当然你发布的是 scoped package，可以用 CLI 添加 scope 到白名单 allowLargeScopes：

`bash
npm run add -- --large-scope=@next
`

_你将会看到 package.json 文件中的 allowLargeScopes 字段被更新，如下所示：_

`json
"allowLargeScopes": [
...
"@next",
...
]
`

提交 PR 并等待合并生效

修改完成后提交一个 Pull Request 合并到 master 分支，等待 Review，合并后会自动发布，预计最长 5 分钟后会全网生效。

$3

本项目使用 Conventional Commits 规范，所有 Pull Request 的标题必须符合 semantic-release 要求。

由于本项目使用 squash 合并方式，最终的 commit message 会基于 PR 标题生成，因此 PR 标题格式如下：

`
():