前言¶
DeepSeek Harness（DSH）對 API Key 類模型提供商已經有較完整的接入方式。另一類常見情況是：開發者已經在 WorkBuddy CN、Qoder CN 或 Trae CN 上持有訂閱或賬號權益，希望通過官方登錄流程在 DSH 裏選模型、發請求，而不是把密鑰散落在多處工具裏各自配置。
dsh-hitchfin 面向後者：把上述三個渠道的訂閱模型作爲原生 DSH 模型提供商接入，並在此基礎上提供多賬號故障轉移、按賬號 HTTP(S) 代理、免費模型過濾與模型可見性管理。下文介紹其定位、能力、安裝步驟與使用注意。
這是什麼¶
dsh-hitchfin 由維護者 LuckyOneTwoThree 發佈，當前版本爲 0.4.0，許可證 MIT，在 SkillHub 等社區目錄中歸類爲模型推理類 DSH 插件。
插件不試圖繞過廠商限額、不做賬號共享或自動簽到；憑證保存在本機 DSH 的憑證存儲中，請求經各渠道官方適配包走向廠商端點（可按賬號配置代理）。
核心功能¶
以下能力均來自項目 README 與 package.json 說明。
官方渠道與登錄¶
- 支持 WorkBuddy CN、Qoder CN、Trae CN，使用官方圖標與官方登錄流程。
- 一鍵瀏覽器登錄：點擊瀏覽器登錄會通過系統默認瀏覽器打開官方授權 URL（macOS / Windows / Linux 分別對應
open、rundll32、xdg-open）；部分渠道還支持 API Key 或 PAT。 - 設置頁爲原生 DSH 體驗：渠道 Tab、內聯額度進度、賬號菜單、按賬號代理編輯、模型管理、暗色模式等。
多賬號與自動故障轉移¶
- 同一渠道可綁定多個賬號，增刪或重新認證互不影響。
- 路由鍵爲 provider + model + session；某賬號在一次會話內成功使用後會成爲該鍵的優先賬號，有利於 prompt cache 局部性。
- 若在首個流式分片發出之前失敗（認證、額度、限流、服務端或傳輸錯誤等），適配器會嘗試其他已登錄賬號；一旦已有內容輸出，不會在流中間切換賬號，避免重複文本。
- 失敗賬號進入冷卻；全部賬號都在冷卻時，DSH 會收到明確的重試時間，而不是持續重試廠商。
冷卻窗口（節選）：
| 失敗類型 | 冷卻時間 |
|---|---|
| AUTH | 10 分鐘 |
| QUOTA | 15 分鐘 |
| RATE_LIMIT | 60 秒，或廠商提供的 Retry-After |
| SERVER | 60 秒 |
| TRANSPORT | 30 秒 |
| MODEL_NOT_FOUND | 30 分鐘（限定該賬號與該模型） |
重新認證、修改代理或移除賬號會清除對應路由狀態。
按賬號 HTTP(S) 代理¶
代理僅作用於該賬號的登錄、模型列表、用量與對話請求；其他賬號仍直連。界面中對代理憑據做掩碼，且不寫入日誌。
免費模型過濾與模型可見性¶
- 僅免費模型默認開啓；有免費/付費元數據的渠道會按此過濾；Trae CN 目前無該元數據，因此展示完整模型列表而非全部隱藏。
- 可搜索目錄、隱藏單個模型，或一鍵隱藏付費模型；可見性設置作用於整個渠道。
隱私與範圍¶
- 憑證經 DSH 憑證服務存儲；插件不把 token 寫入自有配置，也不在設置頁渲染進程中暴露明文。
- 設置頁僅接收模型列表、額度摘要、掩碼後的賬號標籤與掩碼後的代理 URL。
- 插件不運行遙測，除各渠道包設計的廠商端點外不上傳賬號數據。
渠道支持現狀¶
廠商目錄、額度與免費檔規則可能隨時變化；下表爲 README 中的維護狀態摘要。
| 渠道 | 狀態 | 登錄方式 | 免費/付費元數據 |
|---|---|---|---|
| WorkBuddy CN | Stable | 瀏覽器、API Key | 有 |
| Qoder CN | Stable | 瀏覽器、PAT | 有 |
| Trae CN | Experimental | 瀏覽器 | 無（展示全部模型） |
安裝與啓用¶
環境要求¶
- DSH >= 0.2.2-rc.1
- Node.js >= 20.18.1（當前 DSH Desktop 內置運行時通常已滿足）
- macOS、Windows 或 Linux
安裝方式¶
從 DSH 插件市場（上架後）：打開 Plugins → Discover，搜索 dsh-hitchfin，在卡片上安裝；若宿主提示則重啓 DSH。
從 npm（Web / CLI profile，包發佈後）：
dsh plugin --profile web add dsh-hitchfin
從本地構建：
npm install
npm run build
npm pack
dsh plugin --profile web add ./dsh-hitchfin-0.4.0.tgz
DSH Desktop profile 由 Electron 應用管理，宜通過應用內 Plugins 頁或插件市場安裝，而非手改 desktop profile。
安裝完成後，在 DSH 中打開 Settings → 訂閱接入。
典型用法¶
- 打開 Settings → 訂閱接入，選擇 WorkBuddy CN、Qoder CN 或 Trae CN 之一。
- 選擇登錄方式：瀏覽器登錄會自動調起默認瀏覽器；若渠道提供 API Key / PAT，也可選用。
- 除非明確需要付費模型，保持 Free models only（僅免費模型） 開啓。
- 該渠道的模型會出現在 DSH 模型選擇器中；可隨時添加第二賬號或爲某賬號配置代理。
經過上述步驟，對話請求會按多賬號路由與冷卻策略在已登錄賬號間調度；模型可見性可在同一設置流程中調整。
適用場景與注意¶
適合誰：已在 WorkBuddy / Qoder / Trae 擁有合規個人賬號或訂閱，希望在 DSH 統一選型與對話，並需要多賬號容災或按賬號走代理的開發者。
運行權限：插件以當前 DSH 進程權限運行，可訪問其聲明的網絡與憑證接口；安裝前建議在 GitHub 查看源碼與 MIT 許可證，確認與自身合規要求一致。
生態說明：DSH 採用「一切皆插件」思路；SkillHub 插件目錄 爲社區站點，與 DeepSeek / 幻方無官方從屬關係，不宜理解爲官方應用商店。
免費檔位由廠商提供，可能調整或下線；請遵守各廠商服務條款。
結尾¶
dsh-hitchfin 填補的是「訂閱制官方登錄渠道」接入 DSH 的空位：多賬號故障轉移、按賬號代理與模型可見性，均在設置頁 訂閱接入 內完成。進一步瞭解可從社區目錄頁與倉庫 README 覈對版本與渠道狀態。
- 目錄頁：https://www.skillhub.cn/plugins/LuckyOneTwoThree/dsh-hitchfin
- GitHub：https://github.com/LuckyOneTwoThree/dsh-hitchfin
