前言¶
DeepSeek Harness (DSH) 採用微內核架構，插件化是其核心特性。在本地部署大模型時，管理多渠道訂閱（如 Google Antigravity、OpenAI Codex）往往需要編寫複雜的代理腳本。此插件提供了一個本地化的可視化控制台，基於擁有 52k+ Stars 的開源內核 CLIProxyAPI，將上述渠道反代爲標準的 OpenAI 兼容接口，並深度集成至 DSH 生態。
它提供集環境部署、多渠道 OAuth 授權、多賬號智能輪換池、5 小時與 7 天周額度大盤、自適應出海網絡代理與上下文智能調優於一體的完整圖形化控制中樞。
核心功能¶
插件主要解決多渠道訂閱管理、額度監控與網絡代理配置三個問題。
多渠道模型反代¶
網關支持將多個上游渠道統一轉換爲標準 OpenAI 協議接口，供 DSH 及其他兼容客戶端調用。
* Google Antigravity 通道：支持 Gemini 3.8 Flash (262k/1M)、Claude Sonnet 4.6/Opus 4.6 等模型。
* OpenAI Codex 通道：支持 GPT-5.6 系列及 o1 系列推理模型。
* ZCode / 智譜 BigModel 通道：內置驅動，自動解密本地憑據文件。支持 GLM-5.3 等模型，支持流式 reasoning_content 與 tool_calls。注意：該通道依賴客戶端指紋，無法在純服務端復刻免費額度通道。
多賬號輪換與故障轉移¶
- 負載均衡：多個賬號按 Round-Robin 輪流調度，擴充可用併發。
- 無縫接力：當某一賬號觸碰 5 小時限流或偶發 429 時，網關在毫秒級平滑切換至可用賬號，前端任務不中斷。
額度監控看板¶
提供精確的 5 小時滾動窗口與 7 天周額度監控。
* 高精指標：直連官方後端 API 計算。
* 倒計時預測：顯示額度回滿時間點。
* 狀態膠囊：翠綠（>40%）、黃色（15%~40%）、紅色（<15%）。
SWR 極速響應與代理優化¶
- SWR 機制：內存級緩存，打開面板 0~1ms 瞬時直出，後臺 45s 異步預熱。
- 智能代理：自動探測環境變量、註冊表、本地端口（如 7890/7892），解決 TUN 虛擬網卡 Fake-IP 模式下的長對話握手超時問題。
安裝與啓用¶
插件通過 DSH CLI 進行安裝。
- 安裝插件
執行以下命令將插件添加至指定 profile：
dsh plugin --profile web add dsh-plugin-ai-gateway
或在插件工程根目錄使用內置腳本：
node tools/install-into-profile.mjs --profile web
- 重啓服務
安裝後需要重啓 DSH Web 進程以加載插件：
node tools/restart-web.mjs --yes
配置與使用¶
安裝並重啓後，需在瀏覽器中完成賬號接入。
- 打開 DSH Web 界面。
- 導航至左側 「設置 → AI 聚合網關」。
- 點擊
➕ 登錄 Google 賬號或➕ 登錄 Codex 賬號，在彈出的鏈接中完成一次性 OAuth 授權。 - 授權成功後，點擊下方 「一鍵接入」，插件會自動將網關配置及安全密鑰寫入 DSH。
安全設計¶
插件在設計上側重於本地化與安全性。
- 本地綁定：默認嚴格綁定
127.0.0.1，拒絕局域網暴露。 - 密鑰分離：API Key 與管理密鑰完全獨立生成，API Key 持久化存儲於 DSH 專屬憑據區，主配置僅保留引用。
- 同源防護：前端管理接口強制校驗
Origin，攔截跨站請求（CSRF）。 - 自愈機制：內置 60 秒看門狗，意外斷線自動拉起，DSH 退出時自動清理子進程。
依賴與注意事項¶
- 運行環境：依賴 Node.js >= 22.5。
- ZCode 限制：ZCode 通道依賴客戶端指紋（如 User-Agent、X-Title 等），無法在純服務端復刻其官方免費額度通道，日常使用請依賴計費通道。
- 插件權限：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
鏈接¶
- 插件目錄：https://www.skillhub.cn/plugins/huguangyu666/dsh-plugin-ai-gateway
- GitHub 倉庫：https://github.com/huguangyu666/dsh-plugin-ai-gateway
