背景信息

在 Next.js 生态系统中，Flag 系统提供了强大的预计算功能，允许在服务端预先生成 flag 值并序列化为字符串，然后在客户端快速反序列化获取结果。这种机制可以显著提升性能，减少服务端的重复计算。

然而，在 Koa 框架中使用 Flag 的预计算功能时，遇到了一个关键限制：

问题分析

1. Flag 预计算的限制：Flag 的 precompute 和 evaluate 函数不支持动态传入 request 对象。
2. Flag 函数的灵活性：flag/next 提供的 flag 函数本身是支持传递 request 参数的。 参考 Pages Router
3. Koa 环境的需求：在 Koa 应用中，不支持 Flag 内部自动获取 request ，需要手动传入。

解决方案

为了解决这个问题，我们为 Koa 环境提供了增强版的预计算函数，支持动态传入 request 对象

实现原理

// Koa 的增强版预计算函数
export async function evaluate<T extends FlagsArray>(
  flags: T,
  request?: KoaRequest, // ✅ 支持可选的 request 参数
): Promise<{ [K in keyof T]: Awaited<ReturnType<T[K]>> }>;

export async function precompute<T extends FlagsArray>(
  flags: T,
  request?: KoaRequest, // ✅ 支持可选的 request 参数
): Promise<string>;