---
name: guide-overview
description: 系统概述，介绍 Protocol Proxy 的定位、核心能力和典型使用场景
trigger: 用户询问这个系统是什么、有什么用、能做什么、系统介绍、Protocol Proxy 是什么、这个系统是干嘛的、帮我介绍一下
---

# Protocol Proxy 系统概述

## 一句话介绍

Protocol Proxy 是一个 AI API 统一网关，让用户在 Claude Code、Codex 等 Agent 工具中接入任意协议的大模型，并随时切换供应商和模型。

## 核心能力

### 1. 协议转换透明代理

将 OpenAI、Anthropic、Gemini 三种 API 协议互相转换。Agent 工具只需配置一个本地地址，代理自动处理协议适配，对客户端完全透明。

- 客户端用 OpenAI 格式请求 → 代理自动转成 Anthropic/Gemini 格式发送给上游
- 反向亦然，上游返回的响应自动转回客户端期望的格式
- 支持流式（SSE）和非流式两种模式

### 2. 一键切换供应商和模型

一个代理背后可挂载多个供应商，随时切换无需改动 Agent 工具配置：

| 能力 | 说明 |
|------|------|
| **多供应商接入** | OpenAI、Anthropic、Gemini、DeepSeek、通义千问、Kimi、豆包、智谱、MiniMax 等 |
| **API Key 轮换** | 多 Key 自动轮换，429 限流自动切换，3 分钟后自动恢复 |
| **路由策略** | 主备切换、轮询、加权随机、最快优先 |
| **高可用** | 多供应商池（providerPool），主供应商不可用时自动切换备选 |

### 3. AI 运维助手

内置智控助手，通过自然语言管理整个系统：

| 能力 | 说明 |
|------|------|
| **自然语言管理** | "帮我新建一个 DeepSeek 供应商"、"启动所有代理" |
| **系统诊断** | 健康检查、日志分析、代理诊断、MCP 诊断 |
| **技能扩展** | 通过 Skill 系统扩展 AI 能力，支持自定义技能 |
| **记忆系统** | 跨对话保持上下文和用户偏好 |
| **子智能体** | 复杂任务自动拆分，多子代理并行执行 |
| **MCP 集成** | 接入 MCP 服务器扩展工具能力 |

## 典型使用场景

### 场景一：在 Claude Code 中使用 DeepSeek

1. 创建 DeepSeek 供应商（填入 API 地址和 Key）
2. 创建一个代理（监听本地端口 8080，关联 DeepSeek 供应商）
3. 启动代理
4. 在 Claude Code 中将 API 地址改为 `http://localhost:8080`（详见 `/guide-client-config`）
5. 之后想换模型？只改代理配置，Claude Code 侧无需任何改动

### 场景二：统一管理多个 AI 供应商

- 同时接入 OpenAI、DeepSeek、通义千问
- 不同代理对接不同供应商，或同一代理配置多供应商轮询
- API Key 统一管理，健康状态一目了然

### 场景三：协议兼容

- 客户端只支持 OpenAI 格式，但想用 Anthropic 的 Claude？代理自动转换
- 想在 OpenAI 格式的工具中用 Gemini？代理自动转换
- 一个代理，三种协议自由切换

## 相关指南

| 主题 | 技能 | 说明 |
|------|------|------|
| 快速上手 | `/guide-provider` | 创建第一个供应商和代理 |
| 客户端配置 | `/guide-client-config` | 在 Claude Code、Codex 等工具中配置代理 |
| 代理配置 | `/guide-proxy` | 路由策略、协议转换、多供应商池 |
| MCP 扩展 | `/guide-mcp` | 接入 MCP 服务器扩展工具 |
| 智控助手 | `/guide-assistant` | 对话管理、技能系统、子智能体 |
| 监控日志 | `/guide-monitoring` | 用量统计、请求日志、系统日志 |
| 系统设置 | `/guide-settings` | 配置管理、主题、记忆系统 |
