前言¶

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