前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在接入 workbuddy2api 本地網關時，通常涉及手工配置模型元數據、手動管理進程生命週期、下載二進制文件以及處理登錄流程。本插件旨在接管這些重複性工作，實現網關進程的託管與模型目錄的自動同步。

插件定位¶

dsh-workbuddy2api 是一個 DeepSeek Harness (DSH) 插件，用於監管 workbuddy2api 網關進程並自動註冊其模型。它不包含邏輯實現，僅負責兩件事：進程生命週期管理，和模型目錄自動化。

核心功能¶

1. 進程託管：dsh 啓動時自動拉起網關，退出時自動回收。若端口已有健康網關在跑，直接複用，不重複拉起，也不會去殺別人的進程。
2. 模型同步：模型目錄自動同步，實時讀取網關 /v1/models 接口，自動映射模型列表、上下文窗口、輸出上限及思考檔位。
3. 一鍵安裝：通過 /wb2api-setup 命令自動下載網關二進制（含 SHA256 校驗）、準備運行目錄、引導登錄並啓動。
4. 管理命令：提供 6 條管理命令，涵蓋初始化、狀態查詢、啓停控制。
5. 認證與策略：內置 OAuth 登錄流程，支持協議適配、賬號池、加權選號、分級熔斷與定時任務。

安裝與啓用¶

使用以下命令完成安裝（版本 v0.3.2）：

dsh plugin --profile web add https://github.com/tearslee/dsh-workbuddy2api/releases/download/v0.3.2/dsh-workbuddy2api-0.3.2.tgz

安裝後必須重啓 dsh 才能使新插件生效。

使用與配置¶

在對話中執行 /wb2api-setup 完成初始化。該命令會依次定位或下載網關可執行文件、準備運行目錄、引導登錄並啓動網關。

常用命令還包括：
* /wb2api-status：查看網關狀態。
* /wb2api-start：啓動網關。
* /wb2api-restart：重啓網關。

在 cordis.patch.yml 中配置相關參數以啓用 provider：

- insert:
    - id: workbuddy2api
      name: 'dsh-workbuddy2api'
      config:
        baseURL: http://127.0.0.1:7863/v1
        autoStart: true

注意事項¶

1. 安裝後必須重啓：新安裝的插件代碼不會在運行時熱加載，需重啓 dsh。
2. 包名衝突：npm 上的同名包已被佔用，請勿使用 dsh plugin add dsh-workbuddy2api，請認準 GitHub Release 產物。
3. 上游倉庫狀態：上游原倉庫已刪庫，需使用延續倉庫。
4. 產物校驗：產物來自 Releases，下載後需校驗 SHA256。
5. 不支持熱掛載：不支持在運行中熱掛載新插件。