前言¶
DeepSeek Harness（DSH）以插件擴展對話能力時，若需要把另一套 OpenAI 兼容接口接進當前會話——例如審查代碼、翻譯，或在工作區內直接出圖——往往得自己寫遠程調用與憑據管理。社區插件 dsh-gpt-api（維護者 wildbyteai，分類：模型推理）把文本調用、文生圖、參考圖生圖和可搜索的模型選擇收成配置頁加三條對話工具；Key 走 DSH 憑據服務，基礎地址可指向官方或中轉服務。當前版本 1.2.0，許可 MIT。下文按安裝、配置、對話用法與注意點說明。
這是什麼¶
dsh-gpt-api 是面向 DeepSeek Harness 的 GPT API 插件：在對話裏通過 gpt_call 做文本類任務，通過 gpt_image 做文生圖或基於工作區本地圖的參考圖生圖，通過 gpt_models 查詢 /models 檢查連接。配置頁支持填寫 API Key、基礎地址，並在彈窗中搜索、選擇文本模型與圖片模型。項目爲獨立社區插件，參考 OpenAI Developers 插件入口思路，並非 OpenAI 官方插件。
- 目錄頁：https://www.skillhub.cn/plugins/wildbyteai/dsh-gpt-api
- 源碼與說明：https://github.com/wildbyteai/dsh-gpt-api
核心功能¶
- 文本：
gpt_call用於文本、代碼、分析、翻譯；只發送本次傳入的prompt與可選context，不自動上傳整段會話。 - 文生圖：省略
reference_images或傳空數組時，走/images/generations。 - 參考圖生圖：最多 10 張工作區內 PNG / JPEG / WebP（每張 ≤ 30 MiB），經 multipart 請求
/images/edits。 - 模型發現：配置頁「獲取模型」會保存當前接口配置，彈窗支持搜索、錯誤重試；圖片相關名稱優先排序。
- 接口模式：文本默認走
responses，可改chat-completions；兼容 OpenAI 協議的中轉地址需自帶/v1等前綴。
安裝與啓用¶
圖形界面¶
- 打開 DSH 側欄 插件 → 添加插件。
- 粘貼倉庫鏈接並安裝（無需手動克隆或構建）：
https://github.com/wildbyteai/dsh-gpt-api
- 安裝後打開 插件 → GPT API，填寫 API Key 與 API 基礎地址。倉庫不包含 Key；官方 Key 用官方地址，中轉 Key 用對應服務地址。
命令行¶
dsh plugin --profile desktop add "github:wildbyteai/dsh-gpt-api"
環境要求以包聲明爲準：Node.js ≥ 22，DSH 版本 >=0.2.1-rc.5 <0.3.0。插件在當前 DSH 進程權限下運行，安裝前應自行查看源碼與 MIT 許可證。
配置要點¶
安裝後在插件配置頁保存 Key 與地址。基礎地址需包含 API 前綴（如 /v1），插件再追加具體路徑；勿在地址裏寫用戶名、密碼或查詢參數。默認項如下（已手動保存的模型優先於默認）：
| 配置項 | 默認值 | 說明 |
|---|---|---|
| API 基礎地址 | https://api.openai.com/v1 |
支持兼容 OpenAI 的服務 |
| 文本模型 | gpt-6.1-sol |
按提供方實際支持選擇 |
| 生圖模型 | gpt-image-2.6-flare |
提供方需支持對應圖片接口 |
| 文本接口 | responses |
可選 chat-completions |
| 請求超時 | 180000 毫秒 |
可設 1000–600000 |
| 密鑰引用 | DSH_GPT_API_KEY |
Key 經 DSH 憑據服務保存 |
在 文本模型 或 圖片模型 旁點擊 獲取模型，搜索選中後 保存更改，即可在對話中使用所選模型。
典型用法¶
對話中的自然語言¶
在對話中說明要使用 GPT API，例如：
調用 GPT，幫我審查這段代碼，指出可能的 bug。
用 GPT 生圖：一隻在窗邊曬太陽的橘貓，水彩風格，正方形。
檢查 GPT API 連接並列出可用模型。
參考圖生圖¶
把參考圖放在當前會話工作區內，相對路徑按對話工作目錄解析。生成結果默認落在 output/gpt-api/，使用唯一文件名。
單圖示例：
用 GPT 生圖，參考 assets/subject.png。
保留主體和構圖，把背景換成海邊，輸出橫版圖片。
多圖時說明每張用途（主體 / 風格等）。網絡圖或對話附件須先保存到工作區再寫路徑；reference_images 只接受本地路徑，不接受 URL 或 Base64。
工具參數（集成或細調時）¶
gpt_image 常用：prompt（必填）、size（默認 auto）、quality、output_format、n（1–4）。gpt_call 常用：prompt（必填）、可選 context、instructions、max_output_tokens（默認 4096）。gpt_models() 無參數。
適用場景與注意¶
適合：需要在 DSH 裏統一走一套 OpenAI 兼容 API 的團隊或個人；既要文本又要圖片，且希望用配置頁選模型、用憑據服務管 Key。
注意：
- 文本與生圖計入所配置 API 賬號用量；超時後不會自動重試。
- 參考圖內容會上傳至配置的提供方；只讀工作區時生圖前會提示切換可寫模式。
- HTTP 401 時覈對 Key 與地址是否匹配；
/images/edits400/404 時覈對提供方是否支持參考圖編輯及生圖模型。 - 從 GitHub 安裝要更新版本：卸載後用同一鏈接重裝；刷新頁面不會拉取新源碼。
問題反饋：https://github.com/wildbyteai/dsh-gpt-api/issues
結尾¶
經過上面的步驟，dsh-gpt-api 把 GPT 兼容 API 的文本、生圖、模型列表和 Key 管理收進 DSH 插件形態，減少自寫橋接代碼。進一步細節見 GitHub README 與 SkillHub 目錄頁。
