前言¶
DeepSeek Harness (DSH) 的插件生态允许将本地资源接入模型选择器。dsh-connect-workbuddy 是一个独立插件，用于将本机已登录的 WorkBuddy 账号接入 DSH。它提供只读的积分概览与模型管理功能，支持国内版与国际版双供应商并行接入。
核心功能¶
该插件主要包含以下能力：
- 双供应商并行接入：同时支持国内版（
workbuddy）与国际版（workbuddy-global）供应商。 - 插件卡片 tab 切换：设置卡片顶部提供「国内版 / 国际版」两个 tab，管理互不干扰。
- 可单独关闭供应商：取消勾选即可从模型选择器中彻底移除对应供应商。
- 模型管理：支持从上游刷新模型目录，并逐项勾选启用或禁用。
- 本机账号切换：自动发现本机 WorkBuddy 桌面端留下的多个登录凭据。
- 凭据失效处理：上游拒绝 token 时，会探测其他可用账号并提供一键切换建议。
- 只读积分概览：按套餐聚合展示剩余积分，查询不消耗积分。
- 凭据路径探测：支持多候选路径探测，并详细列出失败原因。
- 安全 loopback shim：通过随机端口和进程内 secret 与上游通信，不直接暴露 token。
- 命令行诊断：提供
status、doctor、logout命令进行诊断。
安装与使用¶
前置条件¶
- 需要安装并登录 WorkBuddy 桌面 App。
- 需要安装 DSH 0.1.7-rc.1 及以上版本。
安装命令¶
推荐使用 DSH 插件命令安装：
dsh plugin --profile desktop add dsh-connect-workbuddy
根据你使用的 DSH 界面环境，选择对应的 profile 参数：
dsh plugin --profile web add dsh-connect-workbuddy # Web 环境
dsh plugin --profile dsh-tui add dsh-connect-workbuddy # TUI 环境
安装或更新 bundle 后，需要重启对应的 DSH 进程。
命令行诊断¶
安装完成后，可以使用以下命令行工具检查登录状态和积分：
status # 报告登录状态与积分
doctor # 运行诊断
logout # 登出当前区域账号
平台支持与差异¶
该插件支持 Windows、macOS 和 Linux 三种平台。不同平台在实现细节上存在差异。
| 方面 | Windows | macOS | Linux |
|---|---|---|---|
| 凭据目录 | %LOCALAPPDATA% / %APPDATA% 优先，回落到 <home>\AppData |
~/Library/Application Support/CodeBuddyExtension/Data/Public/auth |
$XDG_CONFIG_HOME 优先，回落到 ~/.config |
| App 可执行文件定位 | 搜索 %LOCALAPPDATA%\Programs\WorkBuddy 等 |
读取 bundle 的 Info.plist，获取 CFBundleExecutable（真实值 Electron） |
不适用（加密凭据场景下 Linux 无对应 App） |
| 子进程窗口 | 必须使用 windowsHide（宿主为 GUI 进程） |
不适用 | 不适用 |
| 设置写入 | 可能被杀毒软件或 OneDrive 锁定 | 通常无锁定问题 | 无锁定问题 |
注意事项¶
- 插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证（MIT）。
- 国内版与国际版是两个并行的供应商，设置与账号互不干扰。
- 凭据文件为只读，插件不会向 WorkBuddy 桌面 App 写入任何数据。
生态背景¶
DSH 理念是「一切皆插件」。该插件维护在 GitHub，也可在 SkillHub 生态目录中查看。
- GitHub: https://github.com/dingminhua/dsh-connect-workbuddy
- Catalog: https://www.skillhub.cn/plugins/dingminhua/dsh-connect-workbuddy
