前言¶
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
