88 lines
3.2 KiB
Markdown
88 lines
3.2 KiB
Markdown
# openai-cn-pack
|
||
|
||
这是 `sub2api-cn-relay-manager` 的最小模型包样例。
|
||
|
||
它不是宿主原生插件，而是一个可被控制面读取的 `model_pack`，用于描述国产模型 provider 的默认接入模板、默认模型映射、默认套餐和导入约束。
|
||
|
||
当前 pack 也可以承载 provider 级 `host_overlays` 元数据。
|
||
这类 overlay 不是立即在线改宿主代码，而是把“某个 provider 在某个宿主版本上需要额外运行时补丁/兼容层”的工程信息纳入 pack 管理，供 preview/import 阶段直接暴露，并可由 CLI 执行器生成 patched 宿主构建目录。
|
||
|
||
当前目录现在同时包含：
|
||
|
||
- 真实可校验包：`pack.json`、`providers/deepseek.json`、`checksums.txt`
|
||
- 协议样例：`pack.json.example`、`providers/deepseek.json.example`
|
||
|
||
当前 pack 除了历史中转 provider，也已经内置首批官方 provider 模板：
|
||
|
||
- `qwen-official.json`
|
||
- `qwen-coder-official.json`
|
||
- `deepseek-chat-official.json`
|
||
- `deepseek-reasoner-official.json`
|
||
- `glm-5-1-official.json`
|
||
- `glm-4-7-official.json`
|
||
- `kimi-k2-5-official.json`
|
||
- `kimi-k2-thinking-official.json`
|
||
- `minimax-m2-7-official.json`
|
||
- `minimax-53hk.json`
|
||
- `step-3-5-flash-official.json`
|
||
|
||
对应的 `provider_id` 与首选模型如下：
|
||
|
||
- `qwen-official`
|
||
- `qwen-plus`, `qwen-max`
|
||
- `qwen-coder-official`
|
||
- `qwen3-coder-plus`, `qwen3-coder-flash`
|
||
- `deepseek-chat-official`
|
||
- `deepseek-chat`
|
||
- `deepseek-reasoner-official`
|
||
- `deepseek-reasoner`
|
||
- `glm-5-1-official`
|
||
- `glm-5.1`
|
||
- `glm-4-7-official`
|
||
- `glm-4.7`
|
||
- `kimi-k2-5-official`
|
||
- `kimi-k2.5`
|
||
- `kimi-k2-thinking-official`
|
||
- `kimi-k2-thinking`
|
||
- `minimax-m2-7-official`
|
||
- `MiniMax-M2.7-highspeed`, `MiniMax-M2.5-highspeed`
|
||
- `minimax-53hk`
|
||
- `MiniMax-M2.7-highspeed`, `MiniMax-M2.5-highspeed`
|
||
- `step-3-5-flash-official`
|
||
- `step-3.5-flash`
|
||
|
||
一旦这些 provider 模板已经内置到 pack，后续新增同类官方 key 的导入就不需要再改代码或重写 provider JSON，直接走标准导入命令即可。例如导入 Qwen：
|
||
|
||
```bash
|
||
go run ./cmd/cli import-provider \
|
||
--host-base-url https://sub2api.example.com \
|
||
--host-api-key <sub2api-admin-key> \
|
||
--pack-dir ./packs/openai-cn-pack \
|
||
--provider-id qwen-official \
|
||
--keys <dashscope-api-key-1>,<dashscope-api-key-2> \
|
||
--access-mode self_service \
|
||
--access-api-key <user-gateway-key>
|
||
```
|
||
|
||
如果你要导入的不是这 10 个模板之一，而是一个全新的官方 provider，那么仍然需要先补一个新的 provider manifest，再做一键导入。
|
||
|
||
对已经声明 `host_overlays` 的 provider，也可以直接用最小执行器生成 patched 宿主源码目录。例如对 `kimi-a7m` 命中的 `sub2api v0.1.129` overlay：
|
||
|
||
```bash
|
||
go run ./cmd/cli apply-host-overlay \
|
||
--pack-dir ./packs/openai-cn-pack \
|
||
--provider-id kimi-a7m \
|
||
--host-version 0.1.129 \
|
||
--source-dir /tmp/sub2api-clean
|
||
```
|
||
|
||
命令会解析 provider manifest 中命中的 overlay，复制 `--source-dir` 到新的输出目录，应用 `patch_path` 指向的补丁，并在输出目录写入 `.sub2api-cn-relay-manager-overlay.json` 元数据文件。
|
||
|
||
后续真实交付时，还可以继续扩展更多 provider：
|
||
|
||
- `kimi.json`
|
||
- `qwen.json`
|
||
- `glm.json`
|
||
- `minimax.json`
|
||
- `minimax-53hk.json`
|