Codex Adapter Toolkit

功能概述

Codex Adapter Toolkit 提供统一的本地 API 适配器，支持多种大模型 Provider：

| Provider | 类型 | 认证方式 | |----------|------|----------| | DeepSeek | deepseek | Bearer Token | | MiniMax | minimax | API Key | | OpenAI | openai | Bearer Token | | Google Gemini | gemini | API Key | | xAI Grok | grok | Bearer Token | | Ollama (本地) | ollama | 无 | | Claude Direct | claude_direct | Bearer Token | | OpenRouter | openrouter | Bearer Token |

工作原理

Codex (Responses API) → http://127.0.0.1:<port>/v1/responses
         ↓ 本地适配器（协议转换）
第三方 API (Chat Completions API)

• 适配器是轻量 Python HTTP 服务，监听 127.0.0.1:<port>
• 将 Codex 的 Responses API 转换为各厂商的 Chat Completions API
• 内置熔断器模式（Circuit Breaker）
• 支持故障自动切换（Failover）

默认端口

| Provider | 端口 | |----------|------| | DeepSeek | 18669 | | MiniMax | 18667 | | 讯飞 | 18666 | | 自定义 | 可配置 |

安装脚本

一键安装

.\scripts\setup.ps1

安装指定 Provider

.\scripts\install-adapter.ps1 -Provider deepseek -ApiKey "your-api-key"

切换 Provider

.\scripts\switch-provider.ps1 -Provider openai

查看帮助

.\scripts\diagnose.ps1

启动适配器

方式一：使用统一适配器框架

python adapters/universal_adapter.py <端口> <provider类型> [api_key] [failover备选...]

示例：

# DeepSeek 主节点
python adapters/universal_adapter.py 18669 deepseek "sk-xxxx"

# 带故障切换（DeepSeek 主，OpenAI/Gemini 备选）
python adapters/universal_adapter.py 18669 deepseek "sk-xxxx" openai gemini

# 本地 Ollama
python adapters/universal_adapter.py 18669 ollama

方式二：使用独立适配器

# 启动 DeepSeek 适配器
python deepseek_codex_adapter.py

# 启动 MiniMax 适配器
python minimax_codex_adapter.py

运维脚本

| 脚本 | 功能 | |------|------| | setup.ps1 | 一键安装所有组件 | | install-adapter.ps1 | 安装适配器 | | switch-provider.ps1 | 切换 Provider | | monitor-adapter.ps1 | 进程监控（自动重启）| | failover.ps1 | 故障切换测试 | | diagnose.ps1 | 智能诊断 | | notify.ps1 | 通知系统配置 | | backup.ps1 | 备份与恢复 | | apikey.ps1 | API Key 管理 | | usage-stats.ps1 | 使用统计 | | logs.ps1 | 日志查看 | | dashboard-server.ps1 | Web 监控面板 | | register-startup.ps1 | 注册开机启动 |

配置目录

适配器配置文件位于用户目录下：

• Windows: %USERPROFILE%\.cc-switch\
• 配置: settings.json

熔断器模式

当 Provider 失败达到阈值时自动熔断：

• 失败阈值: 3 次
• 恢复超时: 60 秒
• 半开尝试: 2 次成功恢复

熔断状态可通过健康检查端点查看：

curl http://127.0.0.1:18669/health

故障切换

配置 failover providers：

python universal_adapter.py 18669 deepseek "key" openai gemini

主节点故障时自动切换到备选节点。

Web 监控面板

启动 Dashboard 服务器：

.\scripts\dashboard-server.ps1

然后访问 http://localhost:18670 查看实时状态。

通知系统

配置通知渠道：

# 钉钉
.\notify.ps1 -Config -Channel dingtalk -ConfigAction set -ConfigValue "https://oapi.dingtalk.com/..."

# 邮件
.\notify.ps1 -Config -Channel email -ConfigAction set -ConfigValue "smtp:port:user:pass:from:to"

发送测试通知：

.\notify.ps1 -Test -Channel dingtalk

备份恢复

# 备份
.\backup.ps1

# 列出备份
.\backup.ps1 -Action list

# 恢复
.\backup.ps1 -Action restore latest

验证安装

# 1. 检查进程
Get-Process python | Where-Object { $_.CommandLine -like "*adapter*" }

# 2. 健康检查
curl http://127.0.0.1:18669/health

# 3. 诊断
.\diagnose.ps1

版本

v1.0.0