sub2api-cn-relay-manager/docs/2026-06-04-HOST_PROTOCOL_MATRIX.md

Host Protocol Matrix

日期：2026-06-04 状态：vNext.1 当前真相源（基于首轮 live probe） 适用范围：宿主协议能力判断、model pool 设计输入、默认链路准入前置判断

1. 目的

把 scripts/acceptance/verify_host_protocol_matrix.sh 的首轮 live probe 结果沉淀为可读结论，明确：

1. 哪些 provider/model 在“当前本机直连协议层”上已验证 models/chat/responses
2. 哪些结论只能说明 upstream protocol capability，不能外推为 host 或 user-key 已闭环
3. 哪些模型仍存在缺口，不能进入 vNext.1 已验证集合

本文件只陈述当前证据，不扩张为未验证能力。

2. 真相边界

当前 artifact 来自：

• /home/long/project/sub2api-cn-relay-manager/artifacts/host-capability/20260604_212413/protocol-matrix-summary.json

该 artifact 的证据层级是：

• 已验证：upstream 直连协议层
• 未验证：remote43 宿主入口 host probe
• 未验证：最终 user-key 对外调用层

因此，本文件中的 supported-direct 结论只能解释为：

• 当前本机对该 upstream 的 models/chat/responses 三端点探测成功
• 不能直接解释为：生产宿主一定支持、user-key 一定 200、可直接进入默认消费链路

3. 首轮 live probe 结果

证据文件：

• summary: /home/long/project/sub2api-cn-relay-manager/artifacts/host-capability/20260604_212413/protocol-matrix-summary.json
• per-target artifacts:
  • /home/long/project/sub2api-cn-relay-manager/artifacts/host-capability/20260604_212413/targets/01-deepseek-chat-official
  • /home/long/project/sub2api-cn-relay-manager/artifacts/host-capability/20260604_212413/targets/02-kimi-a7m
  • /home/long/project/sub2api-cn-relay-manager/artifacts/host-capability/20260604_212413/targets/03-minimax-m3-direct
  • /home/long/project/sub2api-cn-relay-manager/artifacts/host-capability/20260604_212413/targets/04-openai-zhongzhuan

3.1 DeepSeek Official

• provider_id: deepseek-chat-official
• base_url: https://api.deepseek.com/v1
• smoke_model: deepseek-chat
• 结果：
  • models_status = 200
  • chat_status = 200
  • responses_status = 200
  • support_level = supported-direct
  • models_has_smoke_model = false

结论：

• DeepSeek 官方 upstream 在当前本机直连协议层上通过 models/chat/responses
• 但 /v1/models 返回集合中未直接暴露 smoke_model=deepseek-chat
• 因此后续 model pool / route mapping 必须显式区分：
  • advertised model
  • callable model
• 不能再假设 /v1/models 返回名与真实 callable model 恒等

3.2 Kimi A7M

• provider_id: kimi-a7m
• base_url: https://kimi.a7m.com.cn/v1
• smoke_model: kimi-k2.6
• 结果：
  • models_status = 200
  • chat_status = 200
  • responses_status = 200
  • support_level = supported-direct

结论：

• Kimi A7M 当前不是“协议天然不支持”的证据状态
• 这次 live probe 说明：在当前时间点、本机直连协议层上，Kimi A7M 的 models/chat/responses 全部可用
• 因此前面遇到的 Kimi 问题，不能再笼统归因为“协议不兼容”；更可能来自：
  • 宿主出口路径
  • 供应商运行状态波动
  • 接入配置或中转层行为差异

3.3 MiniMax M3

• provider_id: minimax-m3-direct
• base_url: https://mimimax.cn/v1
• smoke_model: MiniMax-M3
• 结果：
  • models_status = 200
  • chat_status = 200
  • responses_status = 200
  • support_level = supported-direct

结论：

• MiniMax M3 在当前本机直连协议层上属于稳定的 supported-direct
• 可作为后续 host probe / user-key probe 的优先候选

3.4 OpenAI Zhongzhuan / asxs

• provider_id: openai-zhongzhuan
• base_url: https://api.asxs.top/v1
• smoke_model: gpt-5.4
• 结果：
  • models_status = 200
  • chat_status = 200
  • responses_status = 200
  • support_level = supported-direct

结论：

• asxs 在当前本机直连协议层上可用
• 但这不能替代“生产宿主出口可用”结论
• 结合历史记录，应继续区分：
  • 本机 curl / 当前直连可用
  • remote43 宿主出口可能仍受 Cloudflare 1010 或其他边界影响

4. 当前未纳入已验证集合的目标

4.1 GLM / 智谱

当前缺口：

• 缺少 ZHIPU_API_KEY
• 因此没有本轮 live probe artifact

当前结论：

• GLM 不能被写入“已验证协议矩阵”
• 后续若要进入 vNext.1 已验证集合，必须先补 key 并生成新的 live artifact

5. 对 vNext.1 的直接影响

5.1 对 model pool 设计的影响

已确认：

• supported-direct / supported-with-plugin-adapter / unsupported-by-host / upstream-unhealthy 四类 support level 是合理的最小分类
• DeepSeek 的 models_has_smoke_model=false 强制要求 model pool 区分：
  • public_model
  • advertised_model
  • callable_model

5.2 对默认链路准入的影响

当前不能直接做的事：

• 不能仅凭本文件把这些模型直接宣告可进入默认消费链路
• 不能仅凭 models/chat/responses=200 宣告生产宿主闭环完成

仍需补的真实门槛：

1. host probe
2. user-key probe
3. 真实 user-key chat/completions=200

5.3 对 Kimi 结论口径的影响

当前推荐口径：

• 不再说“Kimi 协议不支持”
• 改为说：
  • Kimi upstream 直连协议层当前已通过
  • 宿主/用户面闭环仍待进一步 probe 分层验证

6. 当前未完成项

以下事项仍未闭环：

1. remote43 宿主入口 host probe 未形成独立 artifact
2. user-key probe 未形成独立 artifact
3. GLM 未探测
4. 当前矩阵脚本虽已补强，但仍不是 production-grade protocol matrix

7. 当前可执行结论

可确认：

• DeepSeek Official / Kimi A7M / MiniMax M3 / asxs 的 upstream 直连协议层，在本轮 live probe 中均为 supported-direct
• DeepSeek 存在 advertised/callable name 差异风险，必须进入 model pool 设计真相源
• Kimi 的历史问题不能继续被笼统归因为“协议不支持”

不可确认：

• 生产宿主 host 层是否对这些目标同样 supported-direct
• user-key 层是否同样 200
• 哪些目标已经满足默认消费链路准入

8. 后续动作

vNext.1 后续实施顺序保持不变：

1. 用本文件作为 model pool 设计输入
2. 继续 pool 到 priority failover 运行面的映射
3. 再补 host / user-key 在线真实验证
4. 最终再判断默认链路准入