用途:面向 transparent-proxy 付费 API 全生命周期维护,覆盖三类任务——修改价格与限频、修改付费 API 计价方式、添加和移除付费 API,并含测试与 Fly 部署流程。
架构约束:核心代理为 transparent-proxy/proxy.py,插件基类为 transparent-proxy/apis/base.py,每个付费 API 一个插件文件,配置快照位于 config/ 下的 pricing.json、rate_limits.json、proxied_apis.json、keys.json。要求每个付费 API 在插件内自包含(计价、限频、密钥注入),且配置快照保持一致。
标准流程:先读目标插件与相关配置,采用最小改动,先跑快速测试再按需跑全量,使用 fly deploy 部署(不假设热重载),部署后通过 sc-proxy.internal:8080 冒烟测试,并核对计费响应头与数据库扣费行为。
计价方式可选 Pricing.per_request、Pricing.per_token、Pricing.openrouter_usage;按需实现 extract_usage、rewrite_response、transform_sse_chunk、charge_api_type 等钩子。注意 proxy.py 仅在插件 is_llm = True 时调用 extract_usage。
限制与注意事项:不得假设热重载;每次部署尽量单一变更集;未用真实代理请求验证不得声称成功;IPv6 字段须用参数化 SQL 并将空值归一为 None;升级套餐须待 invoice.paid 后再生效;DB 连接增长需先排查各服务连接池总量。缺失信息:官方资料未提供具体定价数值、部署令牌实际值及完整测试命令清单。