DSH（DeepSeek Harness）是一個 AI 編程前端，使用前需配置模型提供商。如果你持有騰訊 CodeBuddy（WorkBuddy）賬號，希望在不產生 API 費用的情況下使用其額度，需要一個本地的 OpenAI 兼容網關。ethanweave/dsh-connect-workbuddy 插件爲上游網關提供了 Windows 環境下的安裝、自啓與運維套件，將其轉化爲可直接在 DSH 中調用的本地服務。
核心功能¶
插件主要解決 Windows 下本地網關的部署與維護問題：
- 一鍵安裝：自動下載官方二進制文件，進行 SHA256 校驗，並寫入
%USERPROFILE%\workbuddy-gateway目錄。 - 登錄自啓：註冊系統計劃任務
WorkBuddy Gateway，實現開機自動拉起網關。 - 統一管理：提供
manage.ps1腳本，支持對網關進行啓動、停止、重啓、查看日誌和卸載操作。 - 健康檢查：通過腳本監控任務狀態、進程運行情況、端口占用以及 HTTP 服務的可用性。
- 安全默認：憑據不入庫；默認僅監聽
127.0.0.1；支持配置 API Key 以增加訪問控制。
安裝與啓用¶
在 DSH 終端中執行以下命令安裝插件：
dsh plugin add github:ethanweave/dsh-connect-workbuddy
安裝完成後，在 DSH 的設置中添加模型提供商。配置如下：
- 協議：OpenAI 兼容
- Base URL：
http://127.0.0.1:8317/v1 - API Key：隨意填寫（網關默認不校驗 Key）
- 模型：可訪問
http://127.0.0.1:8317/v1/models獲取可用模型 ID
網關管理¶
插件提供 scripts\manage.ps1 腳本用於管理網關運行狀態：
.\scripts\manage.ps1 status # 查看任務/進程/端口/HTTP 四層狀態
.\scripts\manage.ps1 start # 啓動計劃任務
.\scripts\manage.ps1 stop # 停止任務並結束進程
.\scripts\manage.ps1 restart # 重啓服務
.\scripts\manage.ps1 logs # 查看網關日誌（默認讀取最近 200 行）
.\scripts\manage.ps1 update # 升級二進制並自動重啓
.\scripts\manage.ps1 uninstall # 卸載服務與文件（-Force 參數跳過確認）
賬號登錄¶
首次使用前，需在本地執行登錄命令以獲取訪問令牌：
& "$env:USERPROFILE\workbuddy-gateway\workbuddy-gateway.exe" login
注意事項¶
- 憑據安全：
workbuddy.json文件包含真實登錄憑據，切勿提交至代碼倉庫、粘貼分享或上傳網盤。 - 網絡限制：默認僅監聽
127.0.0.1。若需遠程訪問，需修改監聽地址並配合防火牆策略及 API Key。 - 權限要求：不需要管理員權限，計劃任務以當前用戶身份註冊和運行。
- 服務條款：插件僅做本地轉發，不提供繞過額度限制的能力，需遵守上游服務條款。
通過該插件，可以在 DSH 中直接調用騰訊 CodeBuddy 的額度，無需手動處理網關的部署與自啓流程。
