@flags-sdk/vercel

中文文档
1.6.0发布于 2026/10/30MITTypeScriptESM + CJS构建来源已验证近 30 天下载 217.6万

Vercel 旗的旗帜 SDK 适配器

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 读取连接的工程旗
  4. 使用自己的客户端( 如用于单通)
  5. 文档

@flags-sdk/vercel

这个 Vercel 适配器 联 合 国 旗帜 SDK 连接您的特性旗 Vercel 旗帜在Vercel内建的地标旗平台。 管理旗帜,定义目标规则,逐步推出,直接从Vercel Dashboard运行实验.

安装

npm i flags @flags-sdk/vercel

使用量

import { flag } from 'flags/next';
import { vercelAdapter } from '@flags-sdk/vercel';

export const exampleFlag = flag({
  key: 'example-flag',
  adapter: vercelAdapter,
});

读取连接的工程旗

在源项目 旗帜 – 连接 页面中,允许您的项目阅读访问。 这两个项目必须属于同一个团队。 将源项目ID传递给适配器:

import { flag } from 'flags/next';
import { createVercelAdapter } from '@flags-sdk/vercel';

const sharedAdapter = createVercelAdapter({ projectId: 'prj_source' });

export const sharedFeature = flag({
  key: 'shared-feature',
  adapter: sharedAdapter,
  defaultValue: false,
});

这个是使用您的项目OIDC的代号,没有SDK密钥. 保留 vercelAdapter 为您的项目自己的旗帜。 连接适用于不同的环境;令牌选择源环境,并绘制自定义环境预览. 地方发展,运行 vercel env pull 在你的项目.

见 工程连接 允许和设置.

使用自己的客户端( 如用于单通)

如果你的应用程序也使用 @vercel/flags-core 直接创建客户端一次并将其传递给适配器,所以两者都使用同一实例:

import { createClient } from '@vercel/flags-core';
import { createVercelAdapter } from '@flags-sdk/vercel';

const vercelFlagsClient = createClient(process.env.FLAGS);
const vercelAdapter = createVercelAdapter(vercelFlagsClient);

export const exampleFlag = flag({
  key: 'example-flag',
  adapter: vercelAdapter,
});

文档

版本与发布记录

@flags-sdk/vercel 共发布 109 个版本,首次发布于 2025/10/25;过去 12 个月发布了 101 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.6.0latest2026/10/3016 天前
1.5.42026/10/2818 天前
1.6.0-31e6462-20261026142820snapshot2026/10/2620 天前
1.5.32026/10/2620 天前
1.5.22026/10/2026 天前
1.5.2-7d24d3a-202610190723432026/10/1927 天前

关于 @flags-sdk/vercel 的常见问题

@flags-sdk/vercel 是什么?

Vercel 旗的旗帜 SDK 适配器

如何安装 @flags-sdk/vercel?

在项目目录运行 npm install @flags-sdk/vercel,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:flags(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@flags-sdk/vercel 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@flags-sdk/vercel 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@flags-sdk/vercel 可以商用吗?

@flags-sdk/vercel 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@flags-sdk/vercel 的下载量有多少?

根据 npm 官方下载统计,@flags-sdk/vercel 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,176,121 次,日均约 72,537 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@flags-sdk/vercel 还在维护吗?

最新版本 1.6.0 发布于 2026/10/30(16 天前);至今共发布 109 个版本,其中过去 12 个月发布了 101 个;首次发布于 2025/10/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。