前言¶
在 DeepSeek Harness(DSH)裏跑智能體,模型來源通常要自己配 API Key 或接第三方 provider。若你已經在 WorkBuddy(國內版)或 WorkBuddy AI(國際版)桌面 App 裏登錄賬號、用其內置模型與積分,再單獨在 DSH 裏維護一套憑據,既重複又容易不一致。
下面介紹社區插件 dsh-workbuddy-model(維護者 arnen7000):它讀取本機 WorkBuddy 桌面 App 的登錄狀態,把 App 裏可見的模型分組註冊進 DSH,國內版與國際版各自用各自賬號,無需在 DSH 裏再填 WorkBuddy 的 Key。分類上屬於 模型推理 類插件;倉庫見 GitHub,目錄頁見 SkillHub。
這是什麼¶
dsh-workbuddy-model 的定位是:把 已安裝並登錄 的 WorkBuddy / WorkBuddy AI 桌面 App 中的模型,自動接入 DeepSeek Harness。
實現上,插件複用 App 寫在本地配置目錄裏的 auth 信息,以與官方客戶端相近的方式調用上游接口;註冊的 provider id 爲 workbuddy(國內版)與 workbuddy-ai(國際版)。倉庫說明其基於 npm 包 dsh-workbuddy-connect@0.7.9 的構建產物修改,主要改動是適配 DSH 桌面版;當前 npm 版本爲 0.1.2(MIT 許可)。
插件以當前 DSH 進程權限運行,會讀取本機 App 憑據路徑。安裝前建議在 GitHub 查看 LICENSE、THIRD_PARTY_NOTICES.txt 與發佈產物(倉庫僅發佈預構建 lib/,無完整可重建源碼樹)。
核心功能¶
依據 README 與 package.json 描述,已覈實能力如下:
- 零配置模型列表:在 WorkBuddy 桌面 App 已登錄的前提下,DSH 側可看到與國內版或國際版 App 一致的模型分組(各用各自身份與積分)。
- 雙版本區分:國內 WorkBuddy 與國際 WorkBuddy AI 分支獨立,不會混用賬號。
- DSH 集成:通過 Cordis patch(
cordis.patch.yml)與 DSH client 注入項接入 Harness 的模型 provider 體系。 - 多安裝渠道:支持 npm、插件市場、GitHub 倉庫路徑、本地
file:目錄(桌面版走 App 內插件頁)。
README 未提供單獨的「選模型對話」CLI 示例;典型用法是安裝並重啓 DSH 後,在 Harness 的模型選擇裏使用 workbuddy / workbuddy-ai 下的條目(與 App 內可見模型對應)。
安裝與啓用¶
前置:本機已安裝並登錄 WorkBuddy 或 WorkBuddy AI 桌面 App 任一;Node 需滿足 ^22.19.0 || >=24.0.0;DSH 內核建議 >= 0.2.1-rc.1(文檔寫明最低可用內核爲 0.1.7,更老版本會在加載階段失敗)。
命令行(web profile)¶
從 npm 安裝(官方命令):
dsh plugin --profile web add dsh-workbuddy-model
安裝後重啓 dsh 生效。覈驗列表末尾不應出現 is incompatible with dsh ...:
dsh plugin --profile web list
升級:
dsh plugin --profile web add dsh-workbuddy-model@latest
若需固定到某次提交或 npm 尚未發佈時,README 還提供:
dsh plugin --profile web add github:arnen7000/dsh-workbuddy-model
本地開發或固定本地快照:
dsh plugin --profile web add <本插件目錄>
插件市場¶
打開 DSH 插件市場,搜索 workbuddy-model 並安裝;安裝、升級、卸載可在界面完成。
桌面版 DSH App¶
desktop profile 由 App 獨佔,CLI 的 dsh plugin --profile desktop add 會被拒絕。應在側欄 插件 → 添加插件 → 安裝第三方插件,輸入 npm 包名 dsh-workbuddy-model 或 file:<本插件目錄>(本地路徑必須帶 file: 前綴),鏡像選中國大陸源,裝完後 立即啓用。
首次安裝與 pnpm 腳本¶
首次安裝可能遇到 pnpm 攔截 @google/genai、protobufjs 的安裝腳本(均爲空操作或僅打印警告,不寫文件、不聯網)。命令行可在 profile 的 pnpm-workspace.yaml 中設置:
allowBuilds:
'@google/genai': true
protobufjs: true
然後重跑同一條 add 命令;桌面版插件頁可選 允許這些腳本並重試。
卸載¶
dsh plugin --profile web remove dsh-workbuddy-model
remove 會同時清理 dependencies 與 bundles 登記。桌面版在 已安裝 中對 dsh-workbuddy-model 執行卸載。
典型用法與協作關係¶
- 確認 WorkBuddy 桌面 App 已登錄且能正常使用模型。
- 按上一節安裝插件並 重啓 DSH。
- 若曾安裝其它 WorkBuddy 橋接插件(如 dsh-workbuddy-connect),先卸載再裝本插件——二者 provider id 相同,後註冊的會靜默不激活,模型列表裏看不到預期 provider。
- 在 DSH 會話中選擇
workbuddy或workbuddy-ai下的模型發起對話。
非 Windows 平臺若自動定位 Electron 失敗,可設置環境變量 WORKBUDDY_ELECTRON_BIN(國際版爲 WORKBUDDY_AI_ELECTRON_BIN)指向 App 可執行文件;macOS / Linux 分支在 README 中標註爲 未真機實測。
適用場景與注意¶
適合誰:已在 WorkBuddy 生態內用桌面 App 與積分/訂閱模型,又希望在 DSH 裏用同一套模型跑 Harness 工作流,且接受「憑據來自本機 App 登錄態」這一方式。
環境:Windows x64 爲 README 中唯一 已實測 平臺;macOS、Linux(含 WSL 探 Windows 目錄)有實現分支但未在真機驗證。
限制(務必知曉):
- 插件本質是讓 DSH 以接近官方客戶端的方式調用 WorkBuddy 接口;上游若有渠道校驗,可能隨時失效。
- 與
dsh-workbuddy-connect等同 id 插件 不可並存。 - 不對
@deepseek-ai/*聲明 peer 版本區間:能裝上不代表任意組合都穩定;App 或 DSH 升級後需自行驗證。 - 社區目錄 SkillHub 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;DSH 生態理念是「一切皆插件」,本插件爲社區維護的模型推理擴展。
結尾¶
dsh-workbuddy-model 把 WorkBuddy 桌面 App 裏已登錄的模型帶進 DeepSeek Harness,減少重複配 Key,並區分國內版與國際版賬號。安裝以 dsh plugin --profile web add dsh-workbuddy-model 爲準,裝前核對許可證與已知限制,裝後重啓並在模型列表中選用 workbuddy / workbuddy-ai。
- 目錄頁:https://www.skillhub.cn/plugins/arnen7000/dsh-workbuddy-model
- GitHub:https://github.com/arnen7000/dsh-workbuddy-model