前言¶
DeepSeek Harness (DSH) 生態強調插件化，旨在將具體能力封裝爲可插拔模塊。在配置 LLM 網關時，開發者通常需要手動處理路由、模型發現和 API Key 管理。gateway-config 插件通過 Web 設置面板和 Host 工具，解決了將任何 OpenAI 兼容網關（即支持 GET /models 端點）直接作爲提供者接入 DSH 的需求。
插件概覽¶
- 名稱：gateway-config
- 定位：DSH web profile 和 TapSVC 模型配置插件
- 所有者：iceprosurface
- 類別：模型推理
- License：MIT
- Stars：1
核心功能¶
該插件提供了以下能力：
- Host 工具：提供
gateway_configure命令行工具。 - Web 設置面板：提供 LLM 網關配置 界面，支持中英文本地化。
- 模型發現：通過
GET /models接口自動發現網關支持的模型，並進行非聊天模型的過濾。 - 能力映射：支持按模型配置推理努力級別（reasoning-effort）以及文本/圖像輸入能力。
- 憑據管理：每個路由僅管理一個憑據，存儲格式爲
<ROUTE>_API_KEY（例如CINDY_API_KEY），這些憑據存儲在 DSH 本地管理的憑據中，不會寫入本倉庫。 - OpenAI Codex 支持：針對
openai-codex提供商，支持原生 ChatGPT OAuth 登錄，並自動通過 pi-ai 刷新訪問令牌。 - Provider 固定預設：提供固定的預設路由（如 Cindy, Sub2API, Generic 等），不支持動態創建路由。
安裝與啓用¶
這是一個插件包，需安裝到現有的 DSH profile 中。
dsh plugin --profile web add https://github.com/iceprosurface/dsh-gateway-config.git
如果 DSH 版本要求使用 Git URL 格式，請使用：
dsh plugin --profile web add git+https://github.com/iceprosurface/dsh-gateway-config.git
安裝後，如果插件條目未自動同步，需在 $DSH_HOME/profiles/web/cordis.patch.yml 中添加：
- insert:
- id: gateway-config
name: gateway-config
最後重啓 DSH web 進程即可。
典型用法¶
1. Web 界面配置¶
- 打開 LLM 網關配置 面板。
- 從下拉列表中選擇網關類型（例如 Cindy, Sub2API, Generic 或其他 OpenAI 兼容的公共廠商）。
- 填寫 Base URL（網關的 OpenAI 兼容根路徑，通常以
/v1結尾）。 - 點擊 拉取模型，系統將列出支持的聊天模型。
- 勾選需要啓用的模型，並標記一個默認模型。
- 點擊 寫入配置。此時 API Key 會自動填入 DSH 本地憑據中，無需在界面再次輸入。
2. OpenAI Codex OAuth 登錄¶
- 在網關選擇器中選擇
openai-codex。 - 點擊 Sign in to ChatGPT。
- 瀏覽器將打開授權頁面，完成回調後，DSH 會將授權存儲爲
llm-pi-ai/openai-codex。 - 之後即可像普通網關一樣發現並導入模型。
3. 命令行使用¶
通過 Host 工具直接調用：
gateway_configure(apiKey?, baseURL?, route, displayName, defaultModel?)
參數說明：
* route：必填，路由名稱（如 cindy）。
* baseURL：網關基礎地址。
* apiKey：API 密鑰。
* displayName：顯示名稱。
* defaultModel：默認模型名稱。
注意：對於 openai-codex，在 OAuth 登錄完成後，apiKey 和 baseURL 可省略。
注意事項¶
- 安全性：插件以當前 DSH 進程權限運行。請勿將 API Key、私有網關地址、憑據文件、個人 DSH 設置、會話數據或運行時數據庫提交到本倉庫。
- Provider 限制：插件僅提供固定預設的 Provider，不支持手動創建臨時路由。
- 憑據存儲：所有密鑰均由 DSH 本地管理，不會寫入本代碼倉庫。
結語¶
gateway-config 插件通過標準化的 OpenAI GET /models 接口和可視化的配置界面，降低了接入各類 LLM 網關的門檻。對於需要管理多個私有或公共網關的開發者，這是一個簡潔且安全的配置方案。
