前言¶

DeepSeek Harness（DSH）把聊天、上下文、工具審批和執行留在宿主裏，模型側往往需要單獨接 API 或自建網關。若你已經在 macOS 上使用 WorkBuddy 桌面版並持有官方賬號積分，再爲 DSH 重複配置一套密鑰並不划算。dsh-workbuddy 由社區維護者 KtKID 發佈，分類爲模型推理：它讀取本機 WorkBuddy 登錄態，經官方 CLI 發起模型請求，積分與用量仍歸 WorkBuddy 賬號，DSH 負責會話與工具鏈路。下面介紹定位、能力與安裝用法。

這是什麼¶

dsh-workbuddy（倉庫 KtKID/dsh-workbuddy）是 DSH 的 WorkBuddy 接入插件。一句話：在 DSH 中選模型、對話、走工具調用，實際推理走本機 WorkBuddy 官方 CLI，不替代 DSH 對會話的管理。插件源自 Kongming OS 的 packages/kmh-workbuddy，獨立包保留原有傳輸與錯誤碼，並帶有插件詳情頁。目錄頁：skillhub.cn/plugins/KtKID/dsh-workbuddy（社區目錄，與 DeepSeek / 幻方無官方從屬關係）。

核心功能¶

依據 README 與 package 描述，當前已聲明的能力包括：

• 在模型選擇器的 workbuddy 分組中選模型；名稱後的 ×0.11 等爲 WorkBuddy 返回的積分倍率。
• 插件 WorkBuddy 詳情頁展示總積分、分類餘額、更新時間與模型目錄；餘額成功結果緩存五分鐘，可點「刷新余額和模型」拉最新值。
• 支持流式文本、思考（thinking）、工具調用、續聊，以及請求診斷記錄。
• CLI 單次返回 credit 時插件會記錄；缺值保留爲未知，實際扣費以 WorkBuddy 官方賬單爲準。

聊天、上下文、工具審批和執行由 DSH 管理；模型請求通過安裝 DSH 的同一臺 Mac 上的 WorkBuddy CLI 完成。

安裝前準備¶

當前包聲明支持 macOS。WorkBuddy 憑據格式與 CLI 協議隨版本變化，升級後的兼容性以倉庫驗證記錄爲準。

插件以當前 DSH 進程權限運行；安裝前應查看倉庫源碼與許可證，確認可接受本機讀取 WorkBuddy 登錄態的行爲。

安裝與啓用¶

Release 版本爲 0.1.0，預構建包地址如下。包內包含已構建的 lib/、界面模塊和組合包配置，安裝時可直接加載。

https://github.com/KtKID/dsh-workbuddy/releases/download/v0.1.0/dsh-workbuddy-0.1.0.tgz

DSH 界面安裝¶

1. 打開 DSH「插件」→「添加插件」。
2. 填入上面的 .tgz 地址，完成安裝並選擇「立即啓用」。
3. 按下一節關聯 WorkBuddy 賬號，再選模型。

Desktop 用戶優先用界面安裝；Web profile 等場景可用命令行。

命令行安裝到 Web profile¶

下面命令來自 README 原文：先添加插件，再確認配置層是否出現，最後啓動 web。

dsh plugin --profile web add https://github.com/KtKID/dsh-workbuddy/releases/download/v0.1.0/dsh-workbuddy-0.1.0.tgz
dsh --profile web --dump-config
dsh web

--dump-config 的輸出應包含 dsh-workbuddy 層及 workbuddy 插件行。對已運行實例，按 DSH 安裝結果提示應用變更或重啓。其他 profile 將命令中的 web 換成目標 profile 名稱。

網絡受限時，從 Releases 下載同一文件，用絕對路徑安裝：

dsh plugin --profile web add /absolute/path/dsh-workbuddy-0.1.0.tgz

關聯 WorkBuddy 賬號與典型用法¶

插件沿用 WorkBuddy 桌面版當前登錄的賬號，由運行 DSH 的 Mac 與系統用戶的本地登錄態決定。

1. 打開 /Applications/WorkBuddy.app，登錄並確認是當前要接入的賬號。
2. 用同一 macOS 用戶啓動 DSH，安裝並啓用本插件。
3. 打開 DSH「插件」→ WorkBuddy 詳情頁。總積分、模型數量和更新時間正常顯示，表示已讀到有效登錄態。若登錄後仍報錯，點一次「刷新余額和模型」。
4. 新建聊天，在模型選擇器 workbuddy 分組中選模型，發一條短消息。收到回覆即表示可在 DSH 中用該 WorkBuddy 賬號對話；用量與積分歸該賬號。

切換賬號：在桌面版退出並登錄目標賬號，回到插件詳情頁點「刷新余額和模型」。出現 WORKBUDDY_AUTH_UNAVAILABLE 時，先在桌面版重新登錄，再刷新。自定義安裝位置與憑據路徑見倉庫 使用與維護。

配置¶

用戶配置寫在目標 profile 的 cordis.patch.yml 中，行 id 爲 workbuddy。按需設置以下字段，其餘用默認：

- id: workbuddy
  name: dsh-workbuddy
  config:
    transport: cli
    timeoutMs: 60000
    electronPath: /Applications/WorkBuddy.app/Contents/MacOS/Electron

完整配置、數據目錄與故障處理見 docs/usage.md。

適用場景與注意¶

適合已在 macOS 上使用 WorkBuddy 桌面版、希望在 DSH 統一會話與工具體驗、又不想單獨維護一套 WorkBuddy API 密鑰的開發者。不適合無 WorkBuddy 客戶端或非 macOS 環境——當前包聲明僅支持 macOS。

README 記錄：2026-11-03 前，同一傳輸實現已在 DSH 0.2.2-alpha.2 上完成真實 WorkBuddy DeepSeek-V4.1-Flash 對話，併成功刷新余額與模型目錄。維護問題可提交 Issues。

結尾¶

dsh-workbuddy 把 WorkBuddy 桌面賬號的模型與積分查詢接到 DSH，會話與工具仍由 DSH 編排。安裝 Release .tgz、確認桌面版登錄與插件詳情頁餘額後，即可在 workbuddy 分組中選模型使用。

• 目錄頁：https://www.skillhub.cn/plugins/KtKID/dsh-workbuddy
• GitHub：https://github.com/KtKID/dsh-workbuddy