Provider API CLI Suite v18 图文教程增强版

Native、Compatible 与 Harness 一次讲透

这页专门回答:DeepSeek / Kimi / MiMo 到底是 Native 还是 Compatible?base_url 怎么判断?DeepSeek‑TUI 又在做什么?

本页目录:全局层级Native ProtocolNative vs CompatibleBase URL 判断Adapter 判断DeepSeek‑TUI

1. 全局层级:Provider / Protocol / Adapter / Harness 不是同一层

最容易混淆的是把“厂商是谁”和“接口像谁”混成一件事。判断时要拆成四层:Provider 看域名归属,Protocol 看请求/响应格式,Adapter 看接入方式,Harness 看是否在做任务编排、工具执行、权限与证据。

AI API 协议全局总览:CLI 与 Skill 在调用封装层,Provider API Core 在适配层,Native / Compatible / MCP 等位于不同协议面。
AI API 协议全局总览:CLI 与 Skill 在调用封装层,Provider API Core 在适配层,Native / Compatible / MCP 等位于不同协议面。

2. Provider Native Protocol 是什么?

Provider Native Protocol 是模型提供商自己定义的请求/响应/流式事件/工具调用语义。OpenAI Responses、Anthropic Messages、Gemini generateContent 都属于更典型的原生协议形态。

Provider Native Protocol 快速教程:它是厂商自己的“官方交互语言”,不是通用包装层。
Provider Native Protocol 快速教程:它是厂商自己的“官方交互语言”,不是通用包装层。
Provider Native Protocol 详细图解:它处在 Adapter 与 Provider Backend 之间,是能力完整度最高的接口面。
Provider Native Protocol 详细图解:它处在 Adapter 与 Provider Backend 之间,是能力完整度最高的接口面。

3. Native Provider 与 Compatible Provider 不是模型强弱之分

Native 更像“专用插头”,框架为厂商做了专属适配;Compatible 更像“转接头”,通过 OpenAI-compatible 或 Anthropic-compatible 接口快速接入。两者解决的是接入方式,不是模型能力高低。

Native Provider vs Compatible Provider 图文解释:同一厂商可能同时有专属接法和兼容接法。
Native Provider vs Compatible Provider 图文解释:同一厂商可能同时有专属接法和兼容接法。
AI SDK 视角:Native Providers 是专属包;Compatible Providers 通过 createOpenAICompatible 这类通用适配器接入。
AI SDK 视角:Native Providers 是专属包;Compatible Providers 通过 createOpenAICompatible 这类通用适配器接入。

4. Base URL 怎么判断?先看 Protocol,再看 Adapter

一个 base_url 不能只看域名。非 OpenAI 域名下的 /v1/chat/completions 通常是 OpenAI-compatible;非 Anthropic 域名下的 /anthropic/v1/messages 通常是 Anthropic-compatible。

Base URL 判断图:域名判断 Provider,路径和请求体判断 Protocol,SDK/CLI import 判断 Adapter。
Base URL 判断图:域名判断 Provider,路径和请求体判断 Protocol,SDK/CLI import 判断 Adapter。

5. Native Provider Adapter 与 Compatible Provider Adapter

Native Provider Adapter

框架或 CLI 为某个厂商写专属适配器,处理模型、鉴权、流式、usage、tool_calls、reasoning 等差异。适合长期生产和深度能力接入。

Compatible Provider Adapter

通用适配器通过 baseURL、apiKey、headers、queryParams 等参数接入 OpenAI-compatible / Anthropic-compatible 服务。适合快速接入、迁移和多云切换。

Adapter 对比图:Protocol 看接口长相,Adapter 看接入方式。
Adapter 对比图:Protocol 看接口长相,Adapter 看接入方式。

6. DeepSeek‑TUI 在做什么?

DeepSeek‑TUI 更准确地说是在做 Harness / Agent Runtime / TUI 层 的适配:它会理解 DeepSeek 的模型能力和接口字段,但它的产品重心不是重新定义协议,而是把模型调用接入上下文、工具、文件、终端、权限、日志和用户交互。

DeepSeek‑TUI 与 Harness 层:它内部可能有 DeepSeek native adapter 能力,但主轴是任务编排与可执行工作区。
DeepSeek‑TUI 与 Harness 层:它内部可能有 DeepSeek native adapter 能力,但主轴是任务编排与可执行工作区。
判断口诀:Protocol 看接口格式;Adapter 看接入方式;Harness 看是否在编排任务、调用工具、修改文件、留下证据。

延伸图文教程:API 工具 CLI vs Agent 编码 CLI

如果你想区分 lark-cli、openai CLI、Codex CLI、Claude Code 的产品层级,请阅读 CLI 层级图文教程

7. 小图补充:把常见误区拆开看

下面这些小图适合插入教程中间阅读:每张只回答一个问题,避免把 Provider、Protocol、Adapter、Harness 混在一起。

Native Provider 与 Compatible Provider 小图讲解
Native 像专用插头,Compatible 像转接头。
Base URL 判断 Native 或 Compatible
Base URL 先看路径和请求体,再看你用什么 Adapter。
Native Adapter 与 Compatible Adapter 对比
Adapter 是接入层,不是 Provider 本体。
兼容接口常见特征
看起来像标准接口,往往就是 compatible 路线。
Provider Native Protocol 的定义
Native Protocol 是厂商自己定义和维护的 API 语义。
记忆口决:域名判断 Provider;路径判断 Protocol;SDK/CLI 判断 Adapter;任务编排判断 Harness。