SuperAPI AI 工具集

vercel-policy-guardrails

测试与质量

查看项目

更新于 10-15 23:30

技能介绍

用途:为 Vercel 项目建立自动化护栏,防范常见故障,包括密钥暴露在客户端包、Edge Runtime 中使用不兼容 API、凭证进入版本库、vercel.json 配置问题、未文档化的环境变量、受保护路由缺少认证以及高风险时段部署。

主要能力:ESLint 规则阻止以 NEXT_PUBLIC_ 前缀暴露敏感变量,并限制 Edge 文件中导入 fs、path、crypto、child_process、net;Husky 提交前钩子扫描暂存文件中的 VERCEL_TOKEN、sk_live_、Bearer 等凭证模式;CI 校验 vercel.json 中已弃用的 builds、compressHTML 与硬编码令牌,检查 Edge 运行时兼容性,并设定构建产物大小预算(示例为 250MB);脚本确保 .env.example 与代码中的 process.env 变量保持同步;middleware 对受保护路由强制认证;部署冻结脚本按 UTC 星期与小时阻止周末及周五 16 点后的生产部署。

使用方式:需项目已配置 ESLint、Git 钩子(husky 或 lefthook)、CI/CD(如 GitHub Actions)与 TypeScript。安装示例:npm install --save-dev husky、npx husky init。相关校验以 ESLint 规则、.husky/pre-commit、GitHub Actions 工作流与 middleware.ts 片段给出,可按项目结构调整。

限制:示例中的规则、路径模式、大小预算与时间窗口均为参考值,需按实际项目修改;部署冻结可用 --force 配合团队审批做限时例外,且应限定到具体发布而非全局关闭;ESLint 规则可能出现误报,可通过 eslint-disable-next-line 并注明理由或收窄正则以规避。官方未提供定价、平台支持范围与效果数据。