怎么说呢，

如果说工具程序让 AI 有了“动手”的能力。那么 Provider 层就是 AI 的“感官”——它负责接收使用者的指令，把指令发给不同的大模型，再把模型返回的结果解析回来。

mini‑cc 的目标是支持多个模型：Anthropic 的 Claude、OpenAI 的 GPT 系列，还有各种 OpenAI 兼容接口。

但这些模型的 API 协议各不相同。上层代码如果直接耦合某个厂商的 SDK，后面换模型就会变成一大堆改造工作。使用者痛点：切换模型时频繁改动 Agent 代码，维护成本高。

为了解决这一痛点。我设计了一个 Provider 抽象层，让上层只依赖统一接口，底层具体实现可随时替换。

Provider 抽象的设计思想

Provider 层主要目标很简单：把不同 LLM 服务差异隔离开，让上层只关心“发消息、收回复”。话说回来，

再看整体结构如下。

│ Agent 层 │
│ │
└────────────────────────┬────────────────────────────────┘
│ ▼
┌─────────────────────────────────────────────────────────┐
│ Provider 层 │
│ ┌───────────────┐ ┌───────────────┐ ┌───────────┐ │
│ │ OpenAI │ │ Anthropic │ │ 其他 │ │
│ │ Provider │ │ Provider │ │ Provider │ │
│ └───────┬───────┘ └───────┬───────┘ └─────┬─────┘ │
│ ▼ ▼ ▼ ▼
│ OpenAI API Anthropic API 兼容 API

主要是策略模式——对外暴露统一 LLMProvider 接口，底层实现随时可替换。话说回来，

主要接口定义

LLMProvider 接口在 src/services/providers/index.ts 定义：

export interface LLMProvider {
modelName?: string，sendMessage(
userMessage: string。onTextResponse: => void,abortSignal?: AbortSignal): Promise;sendToolResults(
results: { id: string;name: string;result: string;isError，: boolean }。onTextResponse: => void,abortSignal?: AbortSignal): Promise;}

ProviderResponse 简单包装结果：

export interface ProviderResponse {
text这方面，string;toolCalls: ToolCall;}

• 工具调用通过独立方法 sendToolResults: 因为 Agent 循环天然分为两阶段；这样更清晰，
• 两个方法都支持 abortSignal: 大模型响应时间长时使用者可能取消请求；提供优雅中断，

OpenAI Provider 实现

程序提示词注入

创建 Provider 时把 System Prompt 注入消息列表开头，定义 AI 的角色与行为约束：

const messages = as OpenAI.Chat.ChatCompletionMessageParam;messages.push({
role的观点是，'system'。content:
'你是一个名为 mini‑cc 的高级 AI 编程助手。...'
})，

痛点解决： 默认输出目录 & 防覆盖机制防止文件被误写或覆盖，让使用者用起来更舒服。

流式响应 + 思维链展示

"createMessage" 函数处理流式数据块并实时推送回调：

• Qwen 模型 reasoning_content 字段识别： 如果存在则标记 并单独展示思考过程；识别方式基于 URL 包含 `dashscope.aliyuncs.com`。
• Ollama 格式工具调用兼容： Ollama 返回 JSON 块，需要缓冲后解析；虽然不是最优，但能支持本地模型。老实说，
• 小技巧： `isThinking=true` 标记可让 UI 用不一样式区分思考与答案。

工具定义转换与 JSON 容错处理

• 工具列表全局共享：若某 provider 不支持某工具需手动过滤。
• A 各 provider 都用一样格式转换至 OpenAI function calling；代码示例：

const getTools = : OpenAI.Chat.ChatCompletionTool =>
tools.map(t => ({
type的观点是。'function',function:{
从name来看，t.name,description:t.description,parameters:t.inputSchema as any,}
}));

A JSON.parse 错误常见：未转义
\r \t 等导致报错。采用简单转义修复函数：
typescript
const fixJsonString = :string =>
raw.replace.replace.replace;其实，

Anthropic Provider 实现

API 风格差异与事件驱动流式响应

Antrhopic SDK 使用事件驱动：`stream.on` 与 OpenAI 的 `for await` 不同。它同时支持 `tool_use`、`input_json` 等多种事件类型。将其封装在 provider 内部即可透明化给上层。

工具格式差异

• Antrhopic 工具直接放在顶层：name/description/input_schema；而 OpenAI 要嵌套 `function`。provider 内部做映射即可隐藏差异。其实，
• 通过统一 `getTools` 转换保证所有 provider 都能接受相同 Tool 定义。

程序提示词位置差异

• OpenAI 把 System Prompt 当作 `role:'system'` 消息塞进数组；Anthropics 则有独立 `system` 参数，与 messages 分开传递。这一细节被 provider 隐藏起来上层无需关心。

Provider 工厂模式与配置热切换

 export function createOpenAIProvider(
从apiKey来看。string,baseURL?:string,model:string='gpt‑4o'):LLMProvider{…}
export function createAnthropicProvider(
从apiKey来看。string,model:string='claude‑sonnet'):LLMProvider{…}

baseURL 可选。可用于连接 Qwen、DeepSeek 等兼容接口，只需修改地址即可切换，无需改代码。
配置文件保存在 `<>`，使用者可通过 `mini‑cc config set …​​​​​​​​​​​ ​​  命令切换 Model / Provider。而运行时则可以通过 `/provider` 热切换，无需重启进程。不过，

⚡️ 使用者痛点方法：集中管理配置 & 热更新减少停机时间。​​ ​​​  ​​ ​​​​​ ​​ ​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​.