前言¶
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 完成。
安装前准备¶
| 项目 | 当前要求 |
|---|---|
| 运行位置 | 安装 DSH 的同一台 Mac |
| WorkBuddy | 安装在 /Applications/WorkBuddy.app，并在桌面版完成登录 |
| DSH | 0.2.2-alpha.2 |
| Node.js | >=24.9.0；命令行安装时需可运行的 dsh 和 pnpm |
| 已验证版本 | WorkBuddy 5.9.3，内置 CLI 2.165.0 |
当前包声明支持 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 界面安装¶
- 打开 DSH「插件」→「添加插件」。
- 填入上面的
.tgz地址，完成安装并选择「立即启用」。 - 按下一节关联 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 与系统用户的本地登录态决定。
- 打开
/Applications/WorkBuddy.app，登录并确认是当前要接入的账号。 - 用同一 macOS 用户启动 DSH，安装并启用本插件。
- 打开 DSH「插件」→ WorkBuddy 详情页。总积分、模型数量和更新时间正常显示，表示已读到有效登录态。若登录后仍报错，点一次「刷新余额和模型」。
- 新建聊天，在模型选择器 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
