前言¶
WorkBuddy 自带一批内置模型；若你还持有 OpenAI Codex/GPT 或 Google Gemini 的订阅额度，往往希望在同一客户端里直接选用这些模型。手工改代理、往配置里堆 API 地址，容易误伤内置模型列表，或触发连接类错误（例如资料中提到的错误 3002、系统代理失效）。
下面介绍 SkillHub 社区 Skill「WorkBuddy GPT & Gemini 安全接入」：由发布者 user_86d3f55f 维护（来源 community，分类 it-ops-security，版本 1.0.0，标签 requires_api_key=true），把「安装与审计本地桥接 → OAuth → 探测模型 → 同步到 WorkBuddy」收成一套可复现流程，并尽量保留内置模型与你原先手工添加的条目。
这是什么¶
一句话定位：在 macOS 或 Windows 上，把你本人订阅可用的 Codex/GPT 与 Gemini 模型，经本地桥接安全接到 WorkBuddy。
维护方与入口：
- Skill 坐标：
@user_86d3f55f/workbuddy-gpt-gemini-bridge - SkillHub 页面：https://www.skillhub.cn/skills/user_86d3f55f/workbuddy-gpt-gemini-bridge
- API 地址：https://api.skillhub.cn/user_86d3f55f/workbuddy-gpt-gemini-bridge
官方简介强调：自动完成本地桥接审计、OAuth 授权、模型能力探测和配置同步；能诊断错误 3002、失效系统代理等问题。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取简介，不展开未公开的实现细节。
-
安全接入订阅模型
对接你账号下可用的 OpenAI Codex/GPT 与 Google Gemini，而非替代 WorkBuddy 官方托管通道。 -
本地桥接全生命周期
覆盖安装、审计，以及在桥接或配置异常时的排查与修复方向（与 Skill 英文说明中的 install / audit / repair / manage 一致；中文简介以「审计」「诊断」表述）。 -
OAuth 与模型探测
走 OAuth 授权后探测模型能力，再把可用模型同步进 WorkBuddy，减少手工抄模型 ID 的差错。 -
保留既有配置
同步时保留 WorkBuddy 内置模型及原有手工条目；Skill 说明亦提到可在代理影响内置模型后协助恢复。 -
环境与依赖
支持 macOS、Windows；因标签requires_api_key=true，使用前需准备好各厂商侧订阅与授权所需凭据（具体字段以 Skill 执行时的指引为准）。
安装与启用¶
Skill 基于通用 SKILL.md 格式分发。安装前建议先确认本机是否已有 SkillHub CLI；完整步骤见 https://skillhub.cn/install/skillhub.md。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按官方文档执行（完整安装含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装到 WorkBuddy 的 skills 目录¶
WorkBuddy 的 skills 目录为 ~/.workbuddy/skills/。安装时必须用 --dir 指向该目录，否则默认落到 ./skills/，Agent 可能识别不到。
skillhub install @user_86d3f55f/workbuddy-gpt-gemini-bridge --dir ~/.workbuddy/skills/
SkillHub 页面也支持把下面提示交给当前 AI，由其按安装文档完成同样坐标下的安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_86d3f55f/workbuddy-gpt-gemini-bridge`。
3、启用方式¶
安装后重启或重新加载 WorkBuddy（或当前承载 Skill 的 Agent），使 ~/.workbuddy/skills/ 下的 Skill 被加载。若你同时在 Cursor、Codex CLI 等环境使用 SkillHub，skills 路径不同（例如 Cursor 为 ~/.cursor/skills/）；本 Skill 面向 WorkBuddy 场景，应优先装到 ~/.workbuddy/skills/。
典型用法¶
Skill 设计为在对话中由 Agent 按 SKILL.md 执行步骤，而非单独提供一个长期运行的用户命令。下列场景与官方 Skill 说明中的触发条件一致，可直接用自然语言发起：
-
首次接入
「帮我在 WorkBuddy 接入 GPT / Gemini，用我订阅的模型。」
Agent 应依次处理桥接安装与审计、OAuth、模型探测、写入 WorkBuddy 配置。 -
同步模型列表
「把当前账号里可用的 GPT、Gemini 模型同步到 WorkBuddy。」 -
修复自定义或内置模型异常
「自定义 GPT/Gemini 连不上了，帮我修。」
「代理改过后 WorkBuddy 内置模型没了，帮我恢复。」 -
排查连接与代理
「WorkBuddy 报 3002 / 系统代理好像失效了。」
Skill 简介明确包含对此类问题的诊断方向。
经过上面的步骤，你无需自行拼凑代理规则；由 Skill 约束在本地桥接范围内完成授权与同步，并避免覆盖你仍要保留的内置与手工条目。
适用场景与注意¶
适合谁
- 已在 WorkBuddy 日常开发，且拥有 OpenAI Codex/GPT 或 Google Gemini 订阅的开发者。
- 希望用 Skill 统一「桥接 + OAuth + 模型列表同步」，而不是每次手改配置的用户。
限制与注意
- 平台：仅官方写明支持 macOS、Windows；其他系统未在简介中承诺。
- 凭据：标签要求 API Key / 订阅侧授权，请仅在本机完成 OAuth，勿把密钥写入公开仓库。
- 数据口径：SkillHub 展示评分为 100000、下载约 3562 次（以页面抓取为准）；选用前仍建议在 SkillHub 查看最新版本与说明。
- 安全分类为
it-ops-security：涉及本地桥接与网络/代理诊断，建议在可信网络环境下操作，并理解修改系统代理对全局应用的影响。
结尾¶
「WorkBuddy GPT & Gemini 安全接入」把订阅模型接入 WorkBuddy 的重复劳动（桥接审计、OAuth、探测、同步、排错）收敛成可对话驱动的 Skill 流程，并强调保留内置与手工模型配置。若你正在 WorkBuddy 里整合 GPT 与 Gemini，可从官方 SkillHub 页获取最新说明与安装坐标：
https://www.skillhub.cn/skills/user_86d3f55f/workbuddy-gpt-gemini-bridge
