前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。當開發者需要同時管理多家廠商的訂閱計劃（如 ChatGPT Codex、Claude Code、ZCode (GLM) 或 Qwen）時，在 dsh 中逐一配置 provider 既繁瑣又容易出錯。dsh-plan-bridge 插件提供了一個本地橋接方案，通過一個進程將上述多種訂閱計劃映射到 dsh 的模型組中。
是什麼¶
dsh-plan-bridge 是一個運行在本地（127.0.0.1:8417）的迴環代理進程。它不修改 dsh 的核心文件，僅作爲中間層轉發請求。插件提供設置頁面的狀態卡片，支持一鍵接入和檢測，將多個 vendor subscription plans 整合進 dsh 的模型路由系統。
安裝¶
使用官方插件命令安裝。安裝後需要重啓 host 進程。
dsh plugin --profile <name> add -w @taylorswitiger/dsh-plan-bridge
核心功能¶
- 多計劃橋接：支持 ChatGPT Codex、Claude Code、ZCode (GLM) 和 Qwen 的訂閱計劃接入 dsh。
- 本地進程：通過 127.0.0.1:8417 監聽請求，路徑前綴分流。
- 可視化管理：提供設置頁狀態卡片，顯示接入狀態、憑據可用性及錯誤信息。
- 零侵入：不修改 dsh 核心文件，不依賴運行時 npm 包。
- 雙認證模式：支持 OAuth 和 API Key 兩種認證方式。
認證方式¶
插件處理不同類型的憑據存儲：
- OAuth 計劃：讀取廠商 CLI 的憑據文件（如 ~/.codex/auth.json 或 ~/.claude/.credentials.json）。插件負責 token 續期並寫回原文件。接入前需先運行廠商 CLI 登錄。
- API Key 計劃：使用 dsh 設置中的憑據庫。插件僅透傳 Authorization 頭，不存儲 key。
使用示例¶
安裝後，橋接默認監聽 127.0.0.1:8417。可通過 HTTP 直測或調用 RPC 方法管理計劃。
- 健康檢查：
GET http://127.0.0.1:8417/health
- RPC 方法調用（假設 host 運行在 3080）：
curl -s http://127.0.0.1:3080/dsh-plan-bridge/plans.list \
-H 'content-type: application/json' \
-d '{"type":"client-request","rpcId":"1","method":"plans.list","payload":{}}'
- 環境變量配置（如需上游代理）：
NODE_USE_ENV_PROXY=1
HTTPS_PROXY
注意事項¶
- 環境要求：需要 Node.js 版本 >= 22.19。
- 許可證：MIT License。
- 權限限制：插件進程以當前 host 進程權限運行，安裝前建議檢查源碼。
- 不可變性：插件不會修改
agent-default-model，憑據寫入全部通過 dsh 的 credentials 服務進行。
適用場景¶
適合需要整合現有 ChatGPT Codex Plus/Pro、Claude Pro/Max、ZCode 及 Qwen 訂閱額度，並希望統一在 DSH 中進行路由和管理的開發者。
生態背景¶
DSH 理念是“一切皆插件”。該插件收錄在社區目錄，與 DeepSeek 或幻方無官方從屬關係。
