codebuddy2openai

https://github.com/Sliverkiss/workbuddy2api 这一个更好用，建议优先用这个

把 CodeBuddy / WorkBuddy（腾讯代码助手） 的订阅，转换成 OpenAI 兼容 API，让你能在任何支持 OpenAI 协议的客户端（ZCode、Cherry Studio、NextChat、LobeChat 等）里复用它。

⚠️ 关于 Codex CLI：新版 Codex CLI 已不再支持 wire_api = "chat"，只支持 completions 格式，因此本工具无法直接接入 Codex CLI，请改用下方「OpenAI 兼容客户端」方案。

English · 中文文档

---

中文文档

一个极简的本地协议转换器（proxy / adapter）：读取你本机已登录的 CodeBuddy 桌面端凭据，把它的对话能力包装成标准的 OpenAI /v1/chat/completions、/v1/models 接口。不碰登录授权、不碰你已有的客户端配置、跨平台、单文件。

✨ 特性

• 🔄 OpenAI 兼容：标准 /v1/chat/completions（支持流式 SSE）、/v1/models、/health。
• 🛠️ Function Calling（工具调用）：支持请求里的 tools，返回 OpenAI 格式的 tool_calls，可在 ZCode / Cherry Studio 等 agent 客户端里驱动工具、多轮回传结果。
• 🪶 单文件、极简：核心就一个 converter.py，不复杂。
• 🔐 零授权改动：直接调用本机已登录的 codebuddy CLI，自动复用桌面端登录态，不重新登录、不存密码。
• 🖥️ 跨平台：自动定位 macOS / Windows / Linux 上的 CLI 与登录文件。
• 🛡️ 安全：默认只监听 127.0.0.1；工具的声明与执行都由客户端负责，转换器只做鉴权与透传。
• ⚡ 流式输出：实时增量 token，体验与原生 OpenAI 流式一致。

🧠 它是怎么工作的

ZCode / Cherry Studio / 任意 OpenAI 客户端
        │  POST /v1/chat/completions  (标准 OpenAI 协议，含 tools)
        ▼
┌────────────────────┐
│  converter.py      │  ← 本地 FastAPI 服务 (127.0.0.1:8787)
│  读 token + 注入   │
│  鉴权 header + 透传│
└────────────────────┘
        │  POST /v2/chat/completions  (带 Authorization/X-User-Id 等头)
        ▼
┌────────────────────────────────┐
│  copilot.tencent.com 后端      │  ← 原生标准 OpenAI 协议
│  (GLM-5.2 / Kimi / DeepSeek)   │     含原生 tools / tool_calls / SSE 流式
└────────────────────────────────┘

转换器直连 CodeBuddy 后端（copilot.tencent.com/v2/chat/completions），该后端本身就是标准 OpenAI chat/completions 协议。转换器只做两件事：①读取本机登录凭据并注入鉴权 header；②在本地 /v1/* 与后端 /v2/* 之间透传。因为后端原生支持 tools / tool_calls，function calling 是模型自带能力，无需任何 prompt 注入或文本解析。token 过期时转换器会自动调刷新接口并回写。

历史版本曾通过「调 CLI + <tool_call> 文本标签解析」实现 function calling，但在嵌套 agent（subagent）场景下，subagent 的输出会夹带标签污染对话。v2.0 改为直连后端，彻底解决了这个问题。

📦 前置条件

1. 已安装并登录 CodeBuddy / WorkBuddy 桌面端（腾讯云 CodeBuddy 官网）。转换器会自动在这些位置找登录态：
   • macOS：~/Library/Application Support/CodeBuddyExtension/Data/Public/auth/*.info
   • Windows：%LOCALAPPDATA%\CodeBuddyExtension\Data\Public\auth\*.info
   • Linux：~/.local/share/CodeBuddyExtension\Data\Public\auth\*.info
2. Python 3.8+（无需 Node.js，不再依赖 CLI）。
3. 安装依赖（一次性）：

   pip install fastapi "uvicorn[standard]" httpx
   

🚀 快速开始

# 1. 克隆
git clone https://github.com/HanHan666666/codebuddy2openai.git
cd codebuddy2openai

# 2. 装依赖
pip install fastapi "uvicorn[standard]" httpx

# 3. 启动（确保 CodeBuddy 桌面端已登录）
python3 converter.py
# 看到「✅ 监听 http://127.0.0.1:8787」即成功

启动时会做一次预检，打印账号信息和 token 状态。

🛠️ Function Calling（工具调用）

后端原生支持标准 OpenAI function calling。客户端（如 ZCode / Cherry Studio）在请求里带 tools，模型原生返回 tool_calls（finish_reason:"tool_calls"），客户端执行工具后把 role:"tool" 的结果回传即可——和直连 OpenAI 完全一致。流式、非流式、多轮工具调用都支持。

🔌 接入客户端

⚠️ 关于 Codex CLI（重要）：新版本 Codex CLI 已移除 wire_api = "chat" 的支持，目前只认 completions 格式，因此本转换器无法直接接入 Codex CLI。仓库里的 codex-codebuddy.example.toml 仅作历史/参考保留，实测在当前 Codex 上跑不通，请不要照抄。

✅ 可用方式 —— 任何标准 OpenAI 兼容客户端（走 /v1/chat/completions）。常见选择：

• ZCode（OpenAI 兼容 Agent）
• Cherry Studio
• NextChat / LobeChat / Open WebUI
• 任何支持自定义 base_url 的 OpenAI SDK 客户端

通用接入步骤（以这类客户端为例）：