@growthbook/proxy-eval

中文文档
1.3.0发布于 2026/10/31MITTypeScriptCommonJS近 30 天下载 1.7万

为代理、边缘工人或后端API提供远程评价服务

中文使用文档
文档目录3 节
  1. 使用量
  2. 客户看到的
  3. 远程已保存组

@ growthbook/ 代理服务器

评价 GrowthBook 服务器上的特性标记和实验,用于 远程评价。GrowthBook代理程序使用它,您可以在自己的代理程序、边工或后端API中使用它。 客户端发送其属性并获取评价结果,而无需看到您的目标设定规则.

npm install @growthbook/proxy-eval

使用量

通过 SDK 有效载荷连接( 从 GrowthBook API, 缓存, 或 Webhook) 和用户属性 :

import { evaluateFeatures } from "@growthbook/proxy-eval";

const result = await evaluateFeatures({
  payload, // the SDK Connection's features payload
  attributes: { id: "user_123", country: "US" },
});

// { features, experiments, dateUpdated }

远程评价客户端发送 attributes,可选择 forcedVariations, (中文(简体) ), forcedFeatures 财务报告和审定财务报表 url传过去 为了保持实验任务的稳定,还通过了一个 stickyBucketService。 。 。 .

example/cloudflare 是一个完全的Cloudflare工人,从KV读取有效载荷.

客户看到的

规则留在服务器上。 假设你有一个特征 有两个瞄准规则和一个实验:

const rules = [
  { condition: { email: { $regex: "@acme\\.com$" } }, force: "acme-deal" },
  { condition: { plan: "enterprise" }, force: "enterprise" },
  { key: "banner-test", variations: ["standard", "promo"], coverage: 0.5 },
];

用户为 plan: "enterprise" 符合第二条规则。 他们的客户只得到由此产生的价值,没有条件,也没有迹象表明存在其他规则:

{ "defaultValue": "enterprise" }

不符合先行规则的用户会落入实验规则. 他们的委托人只接收他们分配的变异,其他人则被取出:

{ "key": "banner-test", "variations": ["standard", {}] }

实验和特征暴露跟踪在评估被降低的有效载荷时仍然有效.

远程已保存组

评价使用的规则 远程已保存组,通过一个 savedGroupResolver 查找用户组。 JS SDK的档案 redisResolver 读取Redis: @growthbook/remote-saved-groups-redis-loader 填充 :

import { redisResolver } from "@growthbook/growthbook";

const result = await evaluateFeatures({
  payload,
  attributes,
  savedGroupResolver: redisResolver({ sMembers: (key) => redis.smembers(key) }),
  onSavedGroupResolverError: (err) => console.error(err),
});

有了解析器,客户端发送的远程组ID会被忽略. 如果搜索失败, 用户没有远程组, 结果没有 dateUpdated,所以SDKs接受下一个正确的反应.

版本与发布记录

@growthbook/proxy-eval 共发布 14 个版本,首次发布于 2023/10/10;过去 12 个月发布了 5 个版本。

版本发布日期距今
1.3.0latest2026/10/3117 天前
1.2.02026/08/133 个月前
1.1.32026/05/136 个月前
1.1.22026/01/279 个月前
1.1.12026/01/239 个月前
1.1.02025/09/171.2 年前

关于 @growthbook/proxy-eval 的常见问题

@growthbook/proxy-eval 是什么?

为代理、边缘工人或后端API提供远程评价服务

如何安装 @growthbook/proxy-eval?

在项目目录运行 npm install @growthbook/proxy-eval,或使用 pnpm add / yarn add / bun add。

@growthbook/proxy-eval 支持 TypeScript 吗?

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

@growthbook/proxy-eval 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@growthbook/proxy-eval 可以商用吗?

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

@growthbook/proxy-eval 的下载量有多少?

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

@growthbook/proxy-eval 还在维护吗?

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