SuperAPI AI 工具集

vercel-flags

测试与质量

查看项目

更新于 10-16 03:05

技能介绍

用途:Vercel Flags 是面向 Vercel 生态的功能开关(feature flags)平台,提供统一仪表盘、开发者工具 Flags Explorer 与分析集成。可直接以 Vercel 作为开关提供商,也可通过 Marketplace 适配器接入 LaunchDarkly、Statsig、Hypertune、GrowthBook 等第三方。资料称其处于公开测试阶段(2026 年 2 月),所有套餐团队可用,定价为每 100 万次开关请求 30 美元(每事件 0.00003 美元),配置采用全局主动复制,变更毫秒级传播。

主要能力:核心设计为仅服务端执行、调用点无参数、提供商无关。Flags SDK(flags 包,v4.0+,MIT 开源,由 @vercel/flags 更名)支持布尔与多值开关定义,框架适配器有 flags/next、flags/sveltekit。Vercel 适配器 @flags-sdk/vercel 读取 FLAGS 环境变量;FLAGS_SECRET 须为 32 随机字节的 base64 编码。Flags Explorer 已正式可用,可在浏览器会话中覆盖开关而无需改代码。还支持预计算模式(precompute、evaluate、serialize、getPrecomputed、generatePermutations)、自定义适配器接口、实体与细分、分析集成、草稿工作流,以及 CLI 管理(vercel flags add、vercel flags sdk-keys ls)。

使用方式:先查阅 https://vercel.com/docs/feature-flags 获取正确的 flag() 定义语法、适配器设置与求值模式,不要凭记忆猜测 API。App Router 需创建发现端点 app/.well-known/vercel/flags/route.ts,使用 createFlagsDiscoveryEndpoint 与 getProviderData;Pages Router 用 API 路由加 next.config.js 重写。

适用场景:渐进式发布与百分比定向、A/B 测试与实验、按环境配置开关、主干开发、整合多个开关提供商。

限制:简单静态配置应直接用 Edge Config;与功能无关的运行时配置用环境变量;无 UI 的纯服务端开关可考虑环境变量。v4 有破坏性变更,需按升级指南迁移。