46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
|
# sub2api-cn-relay-manager PRD（MVP）
|
|||
|
|
|
|||
|
|
日期：2026-05-13
|
|||
|
|
|
|||
|
|
## 目标
|
|||
|
|
|
|||
|
|
在**完全不修改 sub2api 官方系统代码**的前提下，交付一个可独立打包运行的外部伴生项目，使管理员能够通过一次导入动作，把国产模型 OpenAI 兼容中转能力安装到任意一套兼容的 sub2api 实例中。
|
|||
|
|
|
|||
|
|
## 硬约束
|
|||
|
|
|
|||
|
|
1. 不修改宿主源码
|
|||
|
|
2. 不 fork 宿主并运行私有二进制
|
|||
|
|
3. 不直接写宿主数据库
|
|||
|
|
4. 不向宿主目录注入插件代码或补丁文件
|
|||
|
|
5. 仅通过宿主现有 HTTP 管理 API 与标准 API 工作
|
|||
|
|
|
|||
|
|
## 首版验收
|
|||
|
|
|
|||
|
|
1. `model_pack` 可独立校验与装载
|
|||
|
|
2. CLI 可直接读取 pack、选择 provider、导入多条 key
|
|||
|
|
3. 导入流程能创建 group / channel / plan（subscription 模式）/ accounts
|
|||
|
|
4. 至少一个 account 完成 `/test` 与 `/models` 验证
|
|||
|
|
5. 至少一种普通用户访问路径被真实探测：`GET /v1/models`
|
|||
|
|
6. 失败时明确区分：`succeeded / partially_succeeded / failed`
|
|||
|
|
|
|||
|
|
## 首版边界
|
|||
|
|
|
|||
|
|
### 做
|
|||
|
|
- pack runtime
|
|||
|
|
- provider schema 校验
|
|||
|
|
- 多 key 去重与批量导入
|
|||
|
|
- subscription/self-service 两种访问模式建模
|
|||
|
|
- CLI 一键导入
|
|||
|
|
- 基于 stub 的端到端测试
|
|||
|
|
|
|||
|
|
### 暂不做
|
|||
|
|
- Web 控制台
|
|||
|
|
- 多宿主管理
|
|||
|
|
- 自动代用户签发最终 API key
|
|||
|
|
- 对账调度器完整实现
|
|||
|
|
- 真实宿主删除/回滚链路
|
|||
|
|
|
|||
|
|
## 当前实现策略
|
|||
|
|
|
|||
|
|
首版先把“可独立打包 + 零侵入导入 + 用户访问验证”做成最小闭环；状态库、HTTP 控制面、对账调度在此基础上继续扩展。
|