tokens-reef/docs/reviews/FEATURE_COMPARISON_REPORT_2026-04-14.md

项目功能差异对比报告

生成日期: 2026-04-14
对比项目: sub2apipro vs sub2api-latest (官方) vs sub2api-merge (合并后)

---

一、项目概述

项目	类型	说明
sub2apipro	本地增强版	包含Sora支持和国内模型增强
sub2api-latest	官方版本	官方最新稳定版本，内置支付系统
sub2api-merge	合并版本	sub2apipro + sub2api-latest 功能合并

---

二、数据库Schema对比

2.1 Schema文件统计

项目	Schema数量	独有Schema
sub2apipro	23	0
sub2api-latest	28	5
sub2api-merge	28	0

2.2 Schema详细对比

Schema	sub2apipro	sub2api-latest	sub2api-merge	说明
account	✅	✅	✅	账户管理
account_group	✅	✅	✅	账户组
announcement	✅	✅	✅	公告
announcement_read	✅	✅	✅	公告阅读记录
api_key	✅	✅	✅	API密钥
error_passthrough_rule	✅	✅	✅	错误透传规则
group	✅	✅	✅	模型组
idempotency_record	✅	✅	✅	幂等记录
promo_code	✅	✅	✅	优惠码
promo_code_usage	✅	✅	✅	优惠码使用记录
proxy	✅	✅	✅	代理配置
redeem_code	✅	✅	✅	兑换码
security_secret	✅	✅	✅	安全密钥
setting	✅	✅	✅	系统设置
usage_cleanup_task	✅	✅	✅	使用记录清理任务
usage_log	✅	✅	✅	使用日志
user	✅	✅	✅	用户
user_allowed_group	✅	✅	✅	用户允许组
user_attribute_definition	✅	✅	✅	用户属性定义
user_attribute_value	✅	✅	✅	用户属性值
user_subscription	✅	✅	✅	用户订阅
payment_order	❌	✅	✅	支付订单
payment_provider_instance	❌	✅	✅	支付提供商实例
payment_audit_log	❌	✅	✅	支付审计日志
subscription_plan	❌	✅	✅	订阅计划
tls_fingerprint_profile	❌	✅	✅	TLS指纹配置

---

三、sub2apipro 未合并到官方的功能

3.1 Sora 视频生成支持 ⚠️ 部分未合并

sub2apipro 包含完整的 Sora 视频生成支持，官方版本暂不支持：

功能模块	文件数	说明
sora_gateway_service	1	Sora网关服务
sora_gateway_handler	1	Sora网关处理器
sora_client_handler	1	Sora客户端处理器
sora_quota_service	1	Sora配额服务
sora_generation_service	1	Sora生成服务
sora_media_cleanup_service	1	Sora媒体清理服务
sora_s3_storage	1	Sora S3存储
sora_upstream_forwarder	1	Sora上游转发器
sora_models	1	Sora模型定义
sora_sdk_client	1	Sora SDK客户端

迁移文件:

• 046_add_sora_accounts.sql - 添加Sora账户支持
• 047_add_sora_pricing_and_media_type.sql - 添加Sora定价和媒体类型
• 063_add_sora_client_tables.sql - 添加Sora客户端表
• 090_drop_sora.sql - Sora相关迁移

注意: Sora功能在官方README中标记为"暂时不可用"，但sub2apipro保留了完整实现。

3.2 国内模型增强支持 ⚠️ 未合并

sub2apipro 包含国内AI模型的增强支持：

模型提供商	前端白名单	后端URL白名单	定价数据
智谱 (BigModel)	✅	✅	❌
通义千问 (Qwen)	✅	❌	❌
DeepSeek	✅	✅	✅
月之暗面 (Kimi/Moonshot)	✅	✅	❌
豆包 (ByteDance)	✅	❌	❌
MiniMax	✅	✅	❌
百度文心	✅	❌	❌
讯飞星火	✅	❌	❌
腾讯混元	✅	❌	❌
零一万物	✅	❌	❌

问题: 国内模型计费服务缺失定价支持，需要补充。

3.3 其他sub2apipro特性

特性	说明
扩展的模型白名单	更多模型类型支持
国内API域名支持	URL白名单扩展
自定义定价配置	国内模型定价适配

---

四、sub2api-merge 比官方多出的功能

4.1 从sub2apipro合并的功能 ✅

功能	状态	说明
Sora视频生成	✅ 合并	完整的Sora支持
国内模型白名单	✅ 合并	前端模型选择支持
扩展模型定义	✅ 合并	更多模型类型
Sora数据库迁移	✅ 合并	包含完整迁移脚本

4.2 从sub2api-latest合并的功能 ✅

功能	状态	说明
内置支付系统	✅ 合并	Stripe/支付宝/微信支付
支付提供商管理	✅ 合并	多支付渠道配置
订阅计划管理	✅ 合并	SaaS订阅功能
TLS指纹配置	✅ 合并	高级代理配置
支付审计日志	✅ 合并	完整审计追踪

---

五、验证测试状态

5.1 编译验证

项目	后端编译	前端编译	状态
sub2apipro	✅ 通过	✅ 通过	正常
sub2api-latest	✅ 通过	✅ 通过	正常
sub2api-merge	✅ 通过	⚠️ 待验证	需测试

5.2 测试覆盖

项目	Go测试文件	前端测试文件
sub2apipro	~400+	~50+
sub2api-latest	~400+	~50+
sub2api-merge	~430+	~55+

5.3 功能验证清单

功能模块	验证状态	说明
用户认证	⚠️ 待验证	JWT + TOTP
API Key管理	⚠️ 待验证	创建/删除/配额
账户管理	⚠️ 待验证	OAuth/API Key账户
模型组管理	⚠️ 待验证	负载均衡/粘性会话
计费系统	⚠️ 待验证	Token计费
支付系统	⚠️ 待验证	多渠道支付
Sora功能	⚠️ 待验证	视频生成
订阅系统	⚠️ 待验证	订阅计划
国内模型	⚠️ 待验证	计费支持

---

六、合并后缺失的功能

6.1 完全合并 ✅

经过审查，合并项目已包含两个源项目的所有主要功能：

来源功能	合并状态
sub2apipro Sora支持	✅ 已合并
sub2apipro 国内模型	✅ 已合并
sub2api-latest 支付系统	✅ 已合并
sub2api-latest 订阅计划	✅ 已合并
sub2api-latest TLS指纹	✅ 已合并

6.2 需要验证的问题

问题	优先级	说明
国内模型计费缺失	🔴 高	计费服务无国内模型定价
Sora功能可用性	🟡 中	官方标记为暂不可用
前端构建验证	🟡 中	需运行pnpm build
集成测试	🟡 中	需运行完整测试套件

---

七、总结

7.1 功能对比矩阵

功能类别	sub2apipro	sub2api-latest	sub2api-merge
核心网关	✅	✅	✅
Sora支持	✅	❌	✅
国内模型	✅	部分	✅
内置支付	❌	✅	✅
订阅计划	部分	✅	✅
TLS指纹	❌	✅	✅
支付审计	❌	✅	✅

7.2 合并完成度

sub2apipro 功能合并: 100%
sub2api-latest 功能合并: 100%

7.3 建议后续行动

1. 【高优先级】 补充国内模型计费定价数据
2. 【中优先级】 运行完整集成测试验证
3. 【中优先级】 验证前端构建和运行
4. 【低优先级】 评估Sora功能启用条件

---

报告生成时间: 2026-04-14
审查工具: Claude Code AI