前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在使用 WorkBuddy 等本地模型工具時，多賬號管理、模型集成以及對外提供 OpenAI 兼容接口往往是痛點。dsh-hyperworkbuddy 旨在解決這些問題：在 DSH 設置裏直接管理 WorkBuddy 多賬號，並把模型接進 DSH 與任意 OpenAI 兼容客戶端。
插件簡介¶
該插件由 ChaYeWuu 維護，屬於“模型推理”類別。它允許在 DSH 設置裏直接管理 WorkBuddy 多賬號，並把模型接進 DSH 與任意 OpenAI 兼容客戶端。
核心功能¶
- 對外接口開關：獨立控制 OpenAI 兼容端點；關閉後僅停止對外服務，DSH 內的模型調用不受影響。
- API Key 管理：對外 Key 支持一鍵重新生成與自定義；舊 Key 立即失效，無需重啓。
- 雙版本隔離：國內版與國際版各自維護賬號、端點與模型表，同名模型不會串到另一區域。
- 賬號管理：自動發現桌面客戶端登錄；支持粘貼 token 與導入賬號文件。
- 故障轉移：額度不足、限流或登錄失效時自動切換賬號，並對該賬號指數退避。
- 會話親和：同一會話固定走同一賬號，保住上游的提示緩存命中，不會被輪詢打散。
- 用量看板：記錄每次請求的 token 與耗時，彙總今日 / 累計 / 近 7 天 / 分賬號 / 分模型。
- 自動續期：access token 臨近過期時自動刷新。
- 推理檔位：按上游聲明的檔位在 DSH 內選擇；未聲明的可探測補齊。
- 模型顯隱：可單獨關閉模型，僅影響選擇列表，不中斷進行中的會話。
安裝與啓用¶
前置條件：已安裝並登錄 WorkBuddy 桌面 App（國內版或國際版均可）。插件複用 App 的登錄狀態，零配置即可用。
- 使用以下命令安裝（僅限 web / CLI profile）：
dsh plugin --profile web add github:ChaYeWuu/dsh-hyperworkbuddy
- 安裝後必須完全退出並重啓 DSH（新增 bundle 不會被熱加載）。
注意：本包沒有發佈到 npm，直接使用包名會 404。
典型用法¶
重啓 DSH 後，打開設置 → WorkBuddy，面板分五塊：OpenAI 兼容端點、國內版分區、國際版分區、用量、導入區。
在任意 OpenAI 兼容客戶端中填入國內版或國際版的對外端點地址與 API Key。例如國內版端點默認爲 http://127.0.0.1:8791/v1。
使用鏈接登錄功能：選擇版本，點擊生成授權鏈接，在瀏覽器完成登錄後返回面板。
注意事項¶
- 權限限制：端點只監聽 127.0.0.1，並強制校驗迴環 Host 與 Origin。未顯式配置 apiKeys 時，會自動生成密鑰。
- 環境差異：國內版與國際版各有獨立賬號池、端點與模型表，互不串號。
- 安裝方式：桌面 App 的
desktopprofile 只能通過插件頁安裝，CLI 的webprofile 可用命令行安裝。
