前言¶
在 DeepSeek Harness（DSH）裏接 WorkBuddy 做模型推理時，常見做法是單賬號插件：一次請求綁定一個登錄態。若你在 WorkBuddy 桌面端換過多個賬號，或想按積分到期、輪詢、會話粘性等方式自動換號，就要自己管憑據路徑和額度排序。
dsh-connect-workbuddy-models 由維護者 DragonHorizon-xtihc 發佈，分類爲模型推理。它把本機所有曾登錄過的 WorkBuddy 賬號聚合成 DSH 裏的一個模型池：自動發現賬號、讀積分與到期、臨期提醒、簽到與可選自動簽到，並在模型選擇器與輸入框下方展示倍率、促銷徽標和剩餘總積分。與單賬號插件 dsh-connect-workbuddy 的 provider id 刻意不重疊，兩者可同時安裝。
這是什麼¶
插件包名 dsh-connect-workbuddy-models，當前資料中的版本爲 0.1.1，許可證 MIT。裝上後模型選擇器會出現兩個分組：WorkBuddy Models（國內版） 與 WorkBuddy Models（國際版）（provider id 分別爲 workbuddy-models / workbuddy-models-global）。
目錄頁：https://www.skillhub.cn/plugins/DragonHorizon-xtihc/dsh-connect-workbuddy-models
源碼與說明：https://github.com/DragonHorizon-xtihc/dsh-connect-workbuddy-models
賬號自動發現¶
插件不挑號、不手動導入，只讀掃描 WorkBuddy 桌面端留下的登錄文件，併兼容 DSH vault 與環境變量指定路徑。
| 平臺 | 路徑 |
|---|---|
| Windows | %LOCALAPPDATA% 與 %APPDATA% 下的 CodeBuddyExtension\Data\Public\auth\（兩處都探） |
| macOS | ~/Library/Application Support/CodeBuddyExtension/Data/Public/auth/ |
| Linux | $XDG_CONFIG_HOME/CodeBuddyExtension/Data/Public/auth/（回落 ~/.config） |
活文件 workbuddy-desktop.info；帶時間戳的 *.info 爲歷史快照，每個可解析爲一個賬號候選。第二個來源是 DSH vault（$DSH_HOME，回落 ~/.dsh）。環境變量 WORKBUDDY_AUTH_FILE 可指定單個文件或目錄。
多賬號即在 WorkBuddy 客戶端裏多次登錄，再在 DSH 設置頁點「重新檢測賬號」或重啓 DSH。讀不了的文件會列出原因（encrypted / unreadable / malformed），而不是靜默少號。
積分、到期與簽到¶
- 積分讀數使用上游
CycleCapacityRemainPrecise家族，而非 pool 家族的CapacityRemain。 - 支持剩餘總積分、各積分包餘額與到期；週期包顯示下次刷新時刻。
- 臨期提醒默認 3 天內將過期的額度單獨標出，可在設置中配置 1–90 天（
expiryWarnDays）。 - 設置頁可按賬號手動「簽到」；可選自動簽到（北京時間自然日冪等，默認整點
[9]）。 - 可選順帶領取補償 / 贈禮積分（
automation.claimBenefits/claimBenefits）。
賬戶使用方式¶
設置頁「賬戶使用方式」（distribution）會真正影響換號行爲，默認 expiry（一次性積分包最先到期的賬號優先服務）：
| 方式 | 行爲概要 |
|---|---|
expiry |
按最近到期時間升序，無到期信息排最後 |
priority |
固定同一號直到限流或積分耗盡 |
round-robin |
連續請求依次輪詢各號 |
balanced |
按權重抽取，避免單號被抽乾 |
sticky |
單會話釘一個號，新會話換下一個 |
accounts.cn / accounts.global 爲空時，由上述策略決定當前賬號；也可在輸入框下方或 HTTP 接口顯式切換。
模型列表、倍率與界面讀數¶
- 模型列表來自上游實時目錄；設置頁可「刷新模型」，並顯示各模型積分倍率。國內版 fallback 目錄無倍率字段時，未知顯示爲「—」，不當成 0。
- 「需要顯示的模型」：
enabledModelIds/enabledModelIdsGlobal空數組表示全部顯示。 - 模型選擇器行展示本次生效的促銷徽標與倍率，數據來自已在讀的
/v3/config（modelPromotions/modelTiers），渲染時按牆鍾或絕對窗口現算。 - 對話輸入框下方（
showCreditsInComposer，默認開）顯示當前區域賬號名、該賬號或整池剩餘總積分，並可切換賬號；僅當選中模型屬於本插件 provider 時出現。
安裝與啓用¶
插件以 npm 包裝進 DSH profile，資料推薦在目標 profile 的 package.json 中操作（例如 ~/.dsh/profiles/<profile>/package.json）。
1、在 dependencies 加入：
"dsh-connect-workbuddy-models": "^0.1.1"
2、在同一文件的 dsh.profile.bundles 數組裏加入包名：
"dsh.profile.bundles": ["...", "dsh-connect-workbuddy-models"]
3、執行 pnpm install（或 npm install）。
4、重啓 DSH（Web GUI 默認 3080 端口）。設置頁左側會出現「workbuddy模型」。
從 GitHub 安裝時，依賴寫法爲：
"dsh-connect-workbuddy-models": "github:DragonHorizon-xtihc/dsh-connect-workbuddy-models"
倉庫已提交 lib/ 構建產物，安裝期無需本地構建。
典型用法與 HTTP 接口¶
安裝並重啓後，可用本地 HTTP 彙總狀態或觸發重新掃描：
# 彙總狀態：賬號 / 積分 / 到期 / 簽到 / 模型 / 配置
curl http://127.0.0.1:3080/plugins/dsh-connect-workbuddy-models/status
# 重新掃描本機登錄賬號
curl -X POST http://127.0.0.1:3080/plugins/dsh-connect-workbuddy-models/accounts/refresh
其餘路由均掛在 /plugins/dsh-connect-workbuddy-models/ 下，包括單賬號積分（GET /account/credits）、手動簽到（POST /checkin）、刷新模型目錄（POST /models/refresh）、切換賬號（POST /accounts/select）、自動簽到配置（GET/POST /automation）等。設置命名空間爲 wbmodels，字段含 enabled、distribution、accountsEnabled、orderAccountIds、automation.enabled 等，詳見倉庫 README 配置表。
適用場景與注意¶
適合在本機已用 WorkBuddy 桌面端登錄過多個賬號、希望在 DSH 裏統一選模型並自動或策略化換號、同時關心積分到期與簽到的開發者。
兼容性（資料原文）：Node.js ^22.19.0 或 >=24.0.0；DSH 0.2.0-rc.1 線及對應 peer 包；Windows / macOS / Linux 均可做賬號發現，Windows 另有桌面端靜態加密憑據解封支持。所有 @deepseek-ai/* 依賴爲 peer，應使用 DSH 安裝內的一份，避免重複裝配。
DSH 社區插件目錄（如 skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。插件在本機以當前 DSH 進程權限運行，會只讀訪問上述 auth 路徑與 vault；安裝前請自行查閱源碼與 MIT 許可證，確認路徑與自動化行爲符合你的環境策略。
結尾¶
dsh-connect-workbuddy-models 把多賬號 WorkBuddy 收成國內/國際兩個模型池 provider，在發現、額度、簽到與換號策略上做成可配置的一體化接入。進一步說明與開發細節見 GitHub README：https://github.com/DragonHorizon-xtihc/dsh-connect-workbuddy-models；目錄入口：https://www.skillhub.cn/plugins/DragonHorizon-xtihc/dsh-connect-workbuddy-models。
