用途:对已部署在 Vercel 的项目做观测优先的成本与性能优化审计,尤其面向 Next.js、SvelteKit、Nuxt,Astro 为有限支持。核心原则是先取得生产指标,再由确定性筛选决定哪些路由、文件或项目设置值得深入;在 signals.json 生成且有确定信号指向前不检查源码。
主要能力:通过 Vercel CLI 收集指标与用量,结合代码扫描合并信号;用 gate-investigations.mjs 生成代码范围候选与平台级建议;对候选做深挖、对账,再为每个候选生成简报并产出建议;建议需带观测指标证据、文件行号、适配框架与版本的引用。支持 Next.js App Router/Pages Router、SvelteKit、Nuxt 的路由映射;Astro 较少框架专属建议;Hono/Remix/未知框架默认阻断,需用户同意才做有限的平台/代码审计。
使用方式:需 Vercel CLI v53+(含 vercel metrics、vercel usage、vercel contract、vercel api)、已认证会话 vercel login、已链接的应用目录 vercel link、Node.js 20+、以及用于路由级指标建议的 Observability Plus。每次审计使用全新运行目录,例如 RUN_DIR="$(mktemp -d -t vercel-optimize-XXXXXX)"。流程依次为收集/扫描/合并信号、阻断检查、筛选候选、深挖与对账、生成简报并调查、验证建议、渲染报告并输出最终消息;不要在可能回显的命令中写入令牌。
适用场景:需要基于真实流量和成本信号优化 Vercel 生产项目的团队,尤其是使用上述受支持框架、希望得到可追溯到指标的建议。
限制:无流量时路由级指标稀疏;Observability Plus 不可用或配额耗尽时可能阻断或降级;不支持框架默认受阻;必须在链接目录下运行;报告面向客户时不用 $N 节省数字,也不建议对工作流运行时端点做时长削减。未提供的细节(如具体收费)暂未提供。