sub2api-cn-relay-manager/README.md

sub2api-cn-relay-manager

sub2api-cn-relay-manager 是一个独立于 sub2api 宿主仓库的外部伴生安装器 / 控制面项目。

目标不是修改 sub2api，也不是把国产模型能力硬塞进宿主源码，而是通过 sub2api 已有的管理 API，把“国产模型 OpenAI 兼容中转能力”以独立交付物的形式安装到任意一台已部署的 sub2api 实例上。

项目定位

• 宿主：第三方开源系统 sub2api
• 约束：不修改宿主代码，不 fork 宿主，不要求宿主内置原生插件运行时
• 交付：一个独立控制面项目 + 一个或多个 model_pack
• 结果：管理员可一键导入多个国产模型 key，普通用户继续只用 sub2api 标准 API

这个项目解决的问题

• 不同机器部署了 sub2api 后，如何用同一套交付物补齐国产模型中转能力
• 如何把多个国产模型 key 批量导入为可用的宿主资源
• 如何在不改宿主的前提下实现热生效、探测、对账和漂移发现
• 如何让普通用户完全无感，继续走 sub2api 标准接口

非目标

• 不做宿主原生插件系统
• 不做任意第三方 Go 代码动态加载
• 不要求宿主识别“插件”概念
• 不接管宿主网关流量

目录结构

sub2api-cn-relay-manager/
  cmd/                         # 未来 CLI / server 入口
  internal/                    # 未来控制面后端实现
  web/                         # 未来管理端前端
  docs/
    2026-05-12-sub2api-cn-relay-manager-solution.md
  packs/
    openai-cn-pack/
      README.md
      pack.json.example
      providers/
        deepseek.json.example

交付模型

本项目最终会拆成两个可独立发布的产物：

1. sub2api-cn-relay-manager

   • 外部控制面 / 安装器
   • 连接已有 sub2api
   • 安装模型包
   • 调用宿主管理 API 创建资源
   • 做 smoke test、对账和状态展示

2. model_pack

   • 只包含 provider 定义、默认模板、导入规则和校验信息
   • 不携带宿主执行代码
   • 可以跨机器复用

当前文档

完整方案见：

• docs/2026-05-12-sub2api-cn-relay-manager-solution.md