vercel-optimize - candidates

候选门控将可观测性信号转化为调查候选的确定性阈值表达式。纯 JS无 LLM。阈值位于lib/gates/*.mjs。门控总数15。预算上限MAX_CODE_CANDIDATES 6。门控版本1.8.0。门控build_minutes_fanout阈值构建分钟占比 0.15 或存在 turbo-force-bypass 发现计费维度build范围账户来源引用vercel-optimize gate threshold构建分钟行主导账单或 Turborepo 缓存被绕过。在 monorepo 上未更改的工作应通过 Vercel skip-unaffected 行为、经过验证的 Ignored Build Step 以及完整的 Turbo 缓存契约来跳过。cold_start阈值coldPct 0.4 且 total 1000计费维度function-duration范围路由来源引用vercel-optimize gate threshold冷启动调用占比超过 40% 的路由且流量可观窗口内总调用 1,000。冷启动为每个请求增加 200-800ms并破坏缓存未命中路径上的感知延迟预算。40% 阈值是冷启动率成为真实信号而非无服务器上的泊松噪声的点。数据来自按 function_start_type 分组的 vercel.function_invocation.count。cwv_poor阈值LCP p752500 或 INP p75200 或 CLS p750.1且 speed_insights 计数 50计费维度speed-insights范围路由来源引用https://web.dev/articles/vitals真实用户流量下 Core Web Vitals 落入 GooglePoor区间的路由。LCP 2500ms、INP 200ms 或 CLS 0.1 都会损害 SEO 和转化率。每个 (路由, 指标) 对产出一个候选以保持建议聚焦。external_api_slow阈值p75Ms 2000 且 callCount 500计费维度function-duration范围路由来源引用vercel-optimize gate thresholdp75 延迟超过 2 秒且窗口内至少有 500 次调用的外部 API 主机名。当上游处于热路径时外部 API 延迟是函数持续时间成本的主要驱动因素单个缓慢的陈旧调用不值得建议。isr_overrevalidation阈值写入/读取 0.5 且写入 100计费维度isr范围路由来源引用https://vercel.com/docs/incremental-static-regeneration每 2 次读取对应超过 1 次写入的 ISR 路由。相对于读取流量重新验证间隔过于激进——许多读取在付钱重新生成。调查页面是否可以容忍更长的重新验证窗口或通过 revalidateTag 进行按需重新验证。middleware_heavy阈值middlewareInv/totalInv 0.5 且 middlewareInv 1000计费维度edge-requests范围账户来源引用https://nextjs.org/docs/app/building-your-application/routing/middleware中间件调用覆盖总请求的 50% 以上且数量可观。匹配器可能比必要的更宽将其缩小到真正需要认证/重写/头的路径。observability_events_attribution阈值observabilityEventsShare 0.20 0.30 时为严重计费维度observability-events范围账户来源引用vercel-optimize gate thresholdObservability Events 行项目超过总计费成本的 20%。高占比通常追溯到低缓存命中率、中间件密集流量或不受约束的自定义 span 基数。Observability Plus 没有采样杠杆改为减少上游调用。platform_bot_protection阈值botIdEnabledfalse 且botPct 0.05 或 edge_cost $25/窗口 或 请求 14k/14d计费维度edge-requests范围账户来源引用vercel-optimize gate threshold当 BotID 被禁用且存在证据观测到的机器人带宽占比、边缘成本或大量请求表明机器人流量不可忽视时。机器人流量会抬高边缘请求计数而不带来用户价值分阶段的机器人保护可以减少机器人密集项目的浪费。在没有机器人证据的安静项目上跳过——该建议会是噪音。platform_fluid_compute阈值fluidfalse 且任何 cold_start 信号或任何 p951000ms 且 inv1000 的路由计费维度function-duration范围账户来源引用vercel-optimize gate threshold当项目禁用 Fluid Compute 且显示出冷启动压力高冷启动率或热路由上持续的函数 p95 缓慢时。Fluid Compute 通过实例复用减少冷启动——建议在项目级别开启它而不是按路由开启。region_misconfig阈值发现单区域固定 且 路由数 20仅扫描器分支计费维度function-duration范围账户来源引用vercel-optimize gate threshold在vercel.json或按路由的preferredRegion中固定了单个函数区域。由于没有按区域的 TTFB 数据数据缺口门控无法量化地理延迟成本——但在有 20 条路由的项目上固定单区域值得对照 Speed Insights 流量地理位置进行审计。route_errors阈值count 250 或totalRequests 1000 且 errorRate 0.01计费维度function-duration范围路由来源引用vercel-optimize gate threshold窗口内产生超过 250 个 5xx 错误的路由或在至少 1,000 个总请求上错误率超过 1%。出错的函数调用仍按完整持续时间计费高错误率也会破坏用户体验。scanner-driven阈值按种类scanner 匹配数 阈值计费维度混合范围混合来源引用vercel-optimize gate threshold从扫描器输出发出的已配置种类。每种都需要最小匹配数以避免噪音。除非底层扫描器是 trafficIndependent否则冷路径或无法映射的文件上的发现会被丢弃。slow_route阈值p95 500 且 inv 1400或p95 1500 且 inv 250当 5xx 率 50% 时取消资格Vercel Workflow 运行时端点被硬门控计费维度function-duration范围路由来源引用vercel-optimize gate threshold函数 p95 持续时间超过 500ms 且流量可观窗口内调用 1,400的路由或灾难性缓慢的路由任何 250 的流量下 p95 1500ms。高持续时间同时驱动函数持续时间成本和用户感知延迟。调查串行 await、缓慢的外部 API、缺失缓存、N1 模式。5xx 率超过 50% 的路由被取消资格——那些是可靠性问题不是性能调优目标并通过 route_errors 呈现。Vercel Workflow 运行时端点/.well-known/workflow/v1/*在启动前被硬门控因为长时间运行的步骤/流程请求是预期的编排而不是应用路由瓶颈。uncached_route阈值requests 500 且 hitRate 0.5 且 getShare 0.2缺少 getShare 则门控计费维度edge-requests范围路由来源引用vercel-optimize gate threshold每周期服务超过 500 个请求、缓存命中率低于 50% 且 GET 流量至少占 20% 的路由。每个未缓存的 GET 请求都会到达函数花费边缘请求 函数持续时间。主要是 POST/PUT/DELETE 的路由Server Actions、变更操作会被跳过——那里 0% 缓存是正确的行为。缺少方法占比数据的路由会被门控而不是启动。认证门控路由会被单独取消资格。usage_spike_triage阈值任意一天总数 2x 平均值 或 任意一天 SKU 3x SKU 平均值计费维度混合范围账户来源引用vercel-optimize gate threshold计费窗口中的某一天与窗口基线显著偏差。分流分支机器人或 AI 爬虫激增、病毒式时刻、定价模式迁移旧 SKU → 新、代码回退。没有按天粒度的数据时此门控保持休眠。