# 项目功能差异对比报告

**生成日期**: 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
