iRelay

小而稳的 Codex → DeepSeek 本机中转服务。

iRelay 是一个极简本机服务，让 Codex 通过 OpenAI Responses API 形态使用 DeepSeek。只暴露 Codex 需要的最小接口，不做控制台、不做数据库、不做多供应商平台。

Codex Responses → iRelay → DeepSeek Chat Completions

项目	内容
当前版本	v1.6.1
默认地址	http://localhost:8787
依赖	Go 标准库，零第三方依赖
开源协议	MIT

功能

• 纯 Go 标准库，零第三方依赖
• 支持 /v1/models、/v1/responses（普通 + 流式）
• Codex function tools 完整支持，含多轮工具结果
• DeepSeek 流式工具调用 → Responses SSE 事件转换
• DeepSeek thinking/reasoning 可选开关（config.json 设 "thinking": true）
• reasoning 内容自动转换为 Responses API reasoning 事件（流式 + 非流式）
• 未知模型名自动 fallback 到 deepseek-v4-flash
• 可选本机 trace 调试

不做什么

iRelay 刻意保持小而稳。不做多 provider 路由、不做 Anthropic 兼容、不提供 /v1/chat/completions 透传、不兼容 hosted tools/图片/音频/文件/web search、不引入数据库或管理后台。

接口

路径	说明
GET /health	健康检查
GET /v1/models	Codex 模型元数据
POST /v1/responses	Responses 兼容接口

默认地址：http://localhost:8787

配置

~/.config/irelay/config.json：

{
    "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "upstream": "https://api.deepseek.com",
    "thinking": false
}

字段	默认值	说明
apiKey	—	DeepSeek API Key
upstream	https://api.deepseek.com	API 地址
thinking	false	开启 DeepSeek reasoning（思考过程），true 时响应含 reasoning output item

模型

• deepseek-v4-pro
• deepseek-v4-flash

未知模型名自动 fallback 到 deepseek-v4-flash。

快速开始

# 安装
npm install -g @xdfnet/irelay     # npm
# 或
make install                       # 源码

# 一键配置
irelay setup        # 写 config.json + 配置 Codex

# 启动
irelay serve

# 验证
irelay --version
curl http://localhost:8787/health
curl http://localhost:8787/v1/models

npm 安装会在本机用 Go 编译，需提前安装 Go。

配置 Codex

irelay setup

自动写入 ~/.codex/config.toml 的 irelay provider、设置默认 model_provider 和模型、追加环境变量到 ~/.zshrc。

开关命令：

irelay on       # 启用 iRelay
irelay off      # 停用 iRelay（只移除顶层配置，保留 provider 定义和密钥）
irelay restart  # 重启服务
irelay update   # 升级到最新版
irelay status   # 查看当前状态
irelay doctor   # 检查环境就绪情况

临时使用（不写配置）：

IRELAY_API_KEY=local codex exec --skip-git-repo-check \
  -c 'model_providers.irelay={name="iRelay",base_url="http://localhost:8787/v1",env_key="IRELAY_API_KEY",wire_api="responses"}' \
  -c model_provider=irelay \
  --model deepseek-v4-pro \
  "只回答 OK"

Trace 调试

IRELAY_TRACE=1 irelay serve

trace 文件写入 /tmp/irelay-trace/（可设 IRELAY_TRACE_DIR 指定目录）。记录 Codex 请求、DeepSeek 请求/响应和 iRelay 响应的关键 JSON。可能含提示词和工具参数，仅建议本机临时调试。

launchd

macOS 用户级服务：

# 重载
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.user.irelay.plist 2>/dev/null || true
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.user.irelay.plist
launchctl kickstart -k gui/$(id -u)/com.user.irelay

# 查看
launchctl list | rg irelay

开发

make test
make build
make clean

代码结构（单 package main）：

文件	职责
main.go	启动、配置加载、CLI 命令
server.go	HTTP handlers、DeepSeek 调用、响应序列化
models.go	/v1/models 元数据
responses.go	Responses 请求解析、Chat 格式转换
stream.go	DeepSeek SSE → Responses SSE
setup.go	Codex 配置写入 / on / off / status / doctor

make uninstall

安全提醒

• 保持监听在 localhost，不要暴露到公网
• trace 文件按敏感数据处理
• DEEPSEEK_API_KEY 放在 shell 环境里，不要提交到仓库

License

MIT