2026/2/7大约 2 分钟开发指南工程治理包体积构建告警文档资产审计
项目精简执行清单
目标：在不破坏 API 兼容性的前提下，持续控制文档资产体积、构建告警与 NPM 发布包大小。
一次性基线
# 文档静态资产审计
npm run audit:docs:assets
# 构建（含告警策略）
npm run build
# 发布包审计（npm pack dry-run）
npm run audit:pack日常执行顺序（推荐）
- 改代码后先跑
npm run build
目的：确保构建成功，且只出现策略允许的已知告警。 - 发版前跑
npm run audit:pack
目的：确认 tarball / unpacked 大小和文件列表符合预期。 - 文档更新后跑
npm run audit:docs:assets
目的：避免超大图片或资源进入文档站点。 - 最后跑
npm run verify
目的：类型、测试、构建、包审计全链路通过。
阈值与策略
- 文档单文件资产阈值：
DOC_ASSET_MAX_KB（默认 200） - 发布包压缩大小阈值：
PACK_MAX_KB（默认 320） - 发布包解压大小阈值：
UNPACKED_MAX_KB（默认 900） - 发布包默认不允许
.map：如需放开，设置ALLOW_SOURCEMAP=1
示例：
PACK_MAX_KB=400 UNPACKED_MAX_KB=1200 npm run audit:pack
DOC_ASSET_MAX_KB=300 npm run audit:docs:assets失败时处理指南
audit:docs:assets失败
先压缩或替换大文件（优先 SVG/WebP），再重跑审计。build告警策略失败
新告警先定位来源，确认是否兼容性风险；必要时更新白名单策略并记录原因。audit:pack失败
先检查npm pack --dry-run的 top files，优先清理 source map、demo 产物、误入发布包的文件。