vercel-known-pitfalls

用途：审查 Vercel 代码库时识别常见反模式，辅助新开发者上手或进行安全与成本审计。主要能力：按严重级别整理五类问题——密钥泄露（NEXT_PUBLIC_ 变量、硬编码凭据、vercel.json 中的密钥）、Serverless 函数错误（模块级重初始化、未在所有路径返回响应、忽略超时、连接池耗尽）、边缘运行时违规（使用 fs/path/crypto 等 Node.js API、动态代码求值）、配置错误（环境变量作用域缺失、已弃用的 builds 属性、中间件匹配静态资源）、成本陷阱（未缓存的高流量端点、内存过度分配、中间件做重活）。每项含检测方式与修复建议。使用方式：审阅代码时逐项比对；可运行资料提供的审计脚本，包含 grep 检测 NEXT_PUBLIC_ 密钥、硬编码凭据、边缘文件中的 Node.js API，以及用 jq 检查 vercel.json 是否含已弃用的 builds 字段；修复后用 ESLint 与 CI 防止回归。限制：仅覆盖公开资料列出的反模式，未提供适用平台版本、定价或效果保证；具体超时与内存上限、池化方案需以实际环境与官方文档为准。