Agent Skills
返回列表
CodeBuddy 多模型安全接入

CodeBuddy 多模型安全接入

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2590aa89/codebuddy-secure-model-bridge

技能介绍

要解决的问题

CodeBuddy 原生只内置官方模型列表,但很多用户手里已经有 ChatGPT(Codex)或 Gemini(Antigravity)订阅。直接手写 ~/.codebuddy/models.json 有两个坑:一是不知道订阅里真正可用的模型 ID,靠猜出来的名称写进去,调用时才报错;二是本机代理、OAuth 凭据和配置之间的耦合很容易把 CodeBuddy 拖进死循环——最典型的就是它缓存了过期的系统代理,之后所有请求都走不通,而反复改 JSON 只会让情况更糟。

核心能力

这个技能把「接入外部模型」拆成一条可审计的流水线:

  • 审计优先,不急着写配置:先检查 CLIProxyAPI 是否存在、是否只监听 127.0.0.1、models.json 当前有多少条目、以及是否出现 codebuddy_stale_system_proxy。一旦发现过期代理,立刻停止写操作,让用户完全退出并重启 CodeBuddy。
  • 本地桥接:以 Homebrew(macOS)或官方 Release + SHA-256 校验(Windows)安装 CLIProxyAPI,绑定回环地址,禁用远程管理和控制台,生成独立的随机 client key,并在改动前做时间戳备份。
  • 分提供者授权:GPT 和 Gemini 各自走 CLIProxyAPI 原生 OAuth 流程,不从 Codex CLI、Gemini CLI 或浏览器复制 token,也不把 Provider 凭据写进 CodeBuddy。
  • 探测后同步:从实时 /v1/models 读取账户实际可用模型,分别探测文本、SSE 流式、工具调用、图像输入和推理控制;失败的可选能力降级为 false,文本或流式失败的模型直接跳过。同步采用原子合并,保留手动条目,拒绝覆盖非 Skill 管理的同名 ID。
  • 验证无回归:确认桥接仍只监听回环、内置模型回复正常、至少各有一个 GPT 与 Gemini 模型完成真实调用。

适用边界

  • macOS 优先,Windows 需自行校验 Release ZIP 的 SHA-256,校验失败必须停止。
  • --skip-probes 只用于离线测试,真实安装中不得使用。
  • 图像理解探测通过不能当作图像生成能力。
  • 输出日志中不得出现 API key、OAuth token、一次性授权码、账号邮箱或 Authorization 头。
  • 修复时先区分桥接服务、client key、Provider OAuth、路由、缓存与系统代理六类原因,不要反复覆写同一份 JSON。
  • Provider OAuth 续期不需要轮换 CodeBuddy 使用的本地代理 key,两者生命周期不同。

使用场景

  • 在 Mac 电脑上部署本地桥接,将已有的 ChatGPT 订阅安全接入 CodeBuddy。
  • 同步外部模型时,通过实时接口探测 GPT 和 Gemini 的真实可用性,过滤无效条目。
  • 遇到客户端报错时,排查本地代理与系统缓存冲突,恢复外部模型的正常调用。
  • 在 Windows 环境下载官方包,校验 SHA-256 哈希值后安装本地模型代理服务。

适合人员

  • Mac 端重度依赖 ChatGPT 订阅的独立开发者,希望在 CodeBuddy 中直接调用自己已付费的模型。
  • 拥有 Gemini 企业版账号且需处理长文档的团队管理员,需要将内部订阅安全桥接给成员使用。
  • 熟悉本地代理配置且注重数据隐私的技术运维,要求所有外部模型流量必须严格限制在本地回环地址。
  • 经常在 Windows 和 macOS 双平台切换的全栈工程师,需要统一管理跨系统的模型代理接入与校验。