需求：增加 claude code 版本选择

[makaixindalao]

自建号池和三方号池混用的时候，想筛选出部分中转的伪装请求，版本号是重要信息。能否增加一个版本上下限制调度控制，此功能可在号池端完成，但是会留档2 次请求拒绝

[github-actions]

分析中，请稍等...

[github-actions]

感谢您的功能建议。

基于代码库分析，此功能在现有架构下高度可行。

现有基础设施

代码库已经具备实现版本筛选所需的核心组件：

1. 版本解析能力

• src/lib/ua-parser.ts (43-77行) - 从 User-Agent 提取客户端类型和版本号
  • 支持格式：claude-cli/2.0.31 (external, claude-vscode, ...)
  • 返回 ClientInfo 对象包含 version 字段

2. 版本比较工具

• src/lib/version.ts (138-174行) - 完整的语义化版本比较函数
  • isVersionGreater(a, b) - 判断 a 是否比 b 新
  • isVersionLess(a, b) - 判断 a 是否比 b 旧
  • isVersionEqual(a, b) - 判断版本是否相等

3. 客户端过滤机制

• src/drizzle/schema.ts (231-232行) - 供应商表已有客户端限制字段

  allowedClients: jsonb('allowed_clients').$type<string[]>()
  blockedClients: jsonb('blocked_clients').$type<string[]>()

• src/app/v1/_lib/proxy/client-detector.ts (252-346行) - 客户端匹配引擎
  • 支持全局模式、正则、关键字匹配

4. 供应商选择逻辑

• src/app/v1/_lib/proxy/provider-selector.ts (582-629行) - 供应商级客户端限制检查
  • 在会话复用和选择阶段过滤不匹配的供应商
  • 过滤原因记录为 client_restriction

实现建议

要实现您需求的版本上下限控制，需要以下改动：

1. 数据库 Schema 扩展 (src/drizzle/schema.ts)

// 在 providers 表中添加
minClientVersion: varchar('min_client_version', { length: 20 }),
maxClientVersion: varchar('max_client_version', { length: 20 }),

2. 客户端检测增强 (src/app/v1/_lib/proxy/client-detector.ts)
扩展 isClientAllowedDetailed 函数接受版本约束参数：

export function isClientAllowedDetailed(
  session: ProxySession,
  allowedClients: string[],
  blockedClients?: string[],
  versionConstraints?: { min?: string; max?: string } // 新增
): ClientRestrictionResult

3. 供应商选择集成 (src/app/v1/_lib/proxy/provider-selector.ts)
在 582-629 行的客户端限制检查中，添加版本范围验证逻辑。

架构优势

将版本控制放在供应商级别（而非号池级）有以下优势：

• ✅ 单点决策 - 在调度阶段就过滤，避免上游拒绝造成的 2 次请求记录
• ✅ 精确路由 - 可以将不同版本路由到不同供应商组
• ✅ 详细日志 - 过滤原因会记录在 providerChain 中，便于审计

相关文件

需要修改的核心文件：

• src/drizzle/schema.ts (231-232行) - 添加版本字段
• src/app/v1/_lib/proxy/client-detector.ts (252-346行) - 版本检查逻辑
• src/app/v1/_lib/proxy/provider-selector.ts (582-629行) - 集成到供应商选择
• src/lib/ua-parser.ts - 已有版本解析，无需修改
• src/lib/version.ts - 已有比较工具，无需修改

实现考虑

配置方式建议：

• 供应商级配置：适合"此供应商仅处理 2.1.0+ 版本"场景
• 可选扩展到用户级：如需"此用户的请求仅允许来自 2.0.x 客户端"

边界情况：

• UA 解析失败时的降级策略（建议 Fail Open）
• 版本字段为空时表示不限制
• 版本比较失败时的默认行为

---

Automated response from Claude AI