让开源，少一点语言距离。
npm包中文文档

@bushizhanghan/dsh-workmate

中文文档
1.2.7发布于 2026/10/27MITTypeScriptES Module零依赖近 30 天下载 2370

WorkBuddy QQ/QQ DeepSeek Harness, WorkBuddy的免费付费模型,用于DeepSeek Harness,国际和国内,不需要桌面应用程序.

中文使用文档
中文原文
文档目录11 节
  1. 环境要求
  2. 安装
  3. 选模型
  4. 登录流程
  5. 设置项
  6. 命令行
  7. 兼容性
  8. 故障排查
  9. 与上游的关系
  10. 免责声明
  11. 许可证

DSH Workmate

把 WorkBuddy 的模型目录接进 DeepSeek Harness —— 国际版（www.workbuddy.ai）和国内版 （copilot.tencent.com）都支持，免费模型和付费模型都在内。不需要装 WorkBuddy 桌面端： 在浏览器里登录即可，插件自己按区域保存凭据，位置在 $DSH_HOME。

  • 登录 —— 走官方 CLI 的浏览器 OAuth，两个区域各自独立。如果机器上已经装了并登录过桌面端， 也可以只读导入它的凭据。
  • 账号 —— 每个区域一份账号列表，支持显式切换、卡片上显示剩余积分、给账号加备注。 插件的凭据副本从不写回桌面端的文件。
  • 一键签到 —— 每日签到、猫猫旅行、成长中心任务，一次操作全部收取。自动签到可选，默认关闭。
  • 区域隔离 —— 凭据、模型目录、余额三者互不串台。切换账号只影响之后的请求，在途请求 继续用它原来那个账号。
  • 开箱即用 —— 装上、启用、选模型，没有别的配置项。

支持的宿主：DSH 0.2.0-rc.2 至 0.2.1。

环境要求

  • Node.js 22.19+ 或 24+
  • 已安装 DeepSeek Harness，使用 web profile
  • 任一区域的 WorkBuddy 账号

安装

dsh plugin --profile web add @bushizhanghan/dsh-workmate
dsh web

然后打开 设置 → 插件 → DSH Workmate，点 连接，在弹出的 WorkBuddy 页面里登录。

也可以在终端登录：

dsh plugin --profile web exec dsh-workmate login

安装、升级、登录之后都要重启 dsh web。只刷新浏览器不够 —— 宿主把插件的模块留在内存里。

选模型

默认范围是仅免费模型，选择器里列出来的就是该区域实时目录当前标价 x0.00 的那些。 在设置卡片上把范围切成全部模型才能看到付费模型，注意会扣积分。

默认模型可以固定在 ~/.dsh/settings.yaml：

agent-default-model:
  provider: workbuddy-ai
  model: hy3
  reasoningEffort: high

请填该区域当前确实列出的 id。模型列表就是实时目录返回的内容，写死的默认值会过时； hy3 在撰写时两个区域都免费。

登录流程

每个区域独立访问自己的登录接口：

  1. POST /v2/plugin/auth/state?platform=CLI&nonce=
  2. 打开返回的 authUrl
  3. 轮询 GET /v2/plugin/auth/token?state= —— 还在等待时返回 11217
  4. 把 token 写入该区域的插件副本：国际版 $DSH_HOME/.workbuddy-ai-auth.json， 国内版 $DSH_HOME/.workbuddy-cn-auth.json

桌面端的 workbuddy-desktop-ai.info（国际）和 workbuddy-desktop.info（国内）只读打开， 插件只写自己通过 OAuth 拿到的副本。

断开和 logout 只删对应区域的插件凭据，桌面端不受影响。

设置项

设置 → 插件 → DSH Workmate：

  • 按区域连接 / 断开
  • 两个区域的账号列表：显式切换、剩余积分、账号备注、连通性测试
  • 国内账号勾选、自动签到开关（默认关闭）
  • 刷新间隔 —— 当前账号默认 15 分钟一次，其他账号 60 分钟一次
  • 模型范围：仅免费模型（默认）/ 全部模型

同样的配置也可以写在 profile 的 cordis.patch.yml 里：

- id: llm-workbuddy
  config:
    modelScope: free          # 国际版：free | all
    cnModelScope: free        # 国内版：free | all
    probeConsent: false       # 真实模型探测，默认关闭
    autoCheckin: false        # 国内自动签到，默认关闭
    refreshActiveMinutes: 15
    refreshInactiveMinutes: 60
    # 通过局域网访问 DSH Web 时用的 Host（不要写进回环名单）
    # allowedHosts: ["192.168.1.10"]
    # authFile / cnAuthFile：仅当桌面凭据不在默认位置时才需要

环境变量：

变量作用
DSH_WORKBUDDY_AUTH_FILE覆盖国际版桌面凭据路径。OAuth 凭据仍然写插件自己的文件。
DSH_WORKBUDDY_CN_AUTH_FILE覆盖国内版桌面凭据路径。

命令行

dsh plugin --profile web exec dsh-workmate login
dsh plugin --profile web exec dsh-workmate status
dsh plugin --profile web exec dsh-workmate doctor
dsh plugin --profile web exec dsh-workmate logout

status 和 doctor 支持 --json。logout 只删 $DSH_HOME/.workbuddy-ai-auth.json。

兼容性

7 个 @deepseek-ai/dsh-* peer 依赖声明为 >=0.2.0-rc.2 <0.2.1 || >=0.2.1-0 <0.3.0-0，而不是钉死某一个版本。DSH 在加载插件前会 逐条校验 peer 是否满足当前宿主，精确钉死会让插件在别的宿主构建上被整体拒载。第二段区间是 让 0.2.1-rc.2 能被命中的关键 —— 预发布版本不落在朴素的 >=0.2.0-rc.2 <0.3.0-0 里。

上界 <0.3.0-0 是刻意留的：0.3 的宿主可能改插件接口，这个包不会假装还能用。

故障排查

现象处理
设置里没有卡片，模型列表也没有 WorkBuddy重启 dsh web。刷新浏览器不会重载宿主。
点连接后 dsh web 直接退出无头 Linux 没有 xdg-open 时会出现，升级到处理了 spawn error 的版本，或者用卡片上的登录链接。
用局域网地址打开卡片报 403 request-not-trusted把该地址加进 allowedHosts，不要加进回环名单。
登录成功但模型列表是空的该区域的目录请求失败或返回为空。检查网络和 token 是否还有效 —— 列表保持为空，不会借用另一区域的模型。
doctor 显示 signed-out先跑 login，或者确认国际版桌面端已登录。
看不到付费模型在设置卡片把范围切成「全部模型」。会消耗积分。

与上游的关系

这个包最初是 Faide-cyber/dsh-workbuddy （v1.0.12，提交 9951d25）的兼容分支，由 @bushizhanghan 维护。同一功能的主线仍在上游；分支存在 的原因有两个：原包在 DSH 0.2.1 上加载不了，以及宿主默认的客户端名会被上游服务判成未知客户端。

之后代码库做过一轮整理 —— 模块划分、命名、注释、构建与 CI 接线 —— 行为保持不变。 原始 MIT 许可证与版权声明在 LICENSE 和 NOTICE 里原样保留，相对上游 1.0.12 的差异见 patches/。

如果上游发布了等价的修复，建议切回官方包。

免责声明

仅供个人学习与研究，只驱动你自己的 WorkBuddy 账号在本机调用。请遵守 WorkBuddy 服务条款。 本项目与腾讯、WorkBuddy、DeepSeek 均无关联。

许可证

MIT

版本与发布记录

@bushizhanghan/dsh-workmate 共发布 9 个版本，首次发布于 2026/10/22；过去 12 个月发布了 9 个版本。

版本发布日期距今
1.2.7latest2026/10/2712 天前
1.2.62026/10/2316 天前
1.2.52026/10/2316 天前
1.2.42026/10/2316 天前
1.2.32026/10/2316 天前
1.2.22026/10/2217 天前

关于 @bushizhanghan/dsh-workmate 的常见问题

@bushizhanghan/dsh-workmate 是什么？

WorkBuddy QQ/QQ DeepSeek Harness, WorkBuddy的免费付费模型,用于DeepSeek Harness,国际和国内,不需要桌面应用程序.

如何安装 @bushizhanghan/dsh-workmate？

在项目目录运行 npm install @bushizhanghan/dsh-workmate，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18.2.0）、@deepseek-ai/cordis（^4.0.2）、@deepseek-ai/dsh-llm（>=0.2.0-rc.2 <0.2.1 || >=0.2.1-0 <0.3.0-0）、@earendil-works/pi-ai（^0.87.1）、@deepseek-ai/schemastery（^3.18.2）、@deepseek-ai/dsh-settings（>=0.2.0-rc.2 <0.2.1 || >=0.2.1-0 <0.3.0-0）、@deepseek-ai/dsh-llm-pi-ai（>=0.2.0-rc.2 <0.2.1 || >=0.2.1-0 <0.3.0-0）、@deepseek-ai/dsh-attachment（>=0.2.0-rc.2 <0.2.1 || >=0.2.1-0 <0.3.0-0）、@deepseek-ai/dsh-home-paths（>=0.2.0-rc.2 <0.2.1 || >=0.2.1-0 <0.3.0-0）、@deepseek-ai/dsh-atomic-write（>=0.2.0-rc.2 <0.2.1 || >=0.2.1-0 <0.3.0-0）、@deepseek-ai/dsh-host-webserver（>=0.2.0-rc.2 <0.2.1 || >=0.2.1-0 <0.3.0-0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 dsh-workmate，可以用 npx dsh-workmate 直接运行。

@bushizhanghan/dsh-workmate 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@bushizhanghan/dsh-workmate 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@bushizhanghan/dsh-workmate 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js ^22.19.0 || >=24.0.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@bushizhanghan/dsh-workmate 可以商用吗？

@bushizhanghan/dsh-workmate 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@bushizhanghan/dsh-workmate 的下载量有多少？

根据 npm 官方下载统计，@bushizhanghan/dsh-workmate 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,370 次，日均约 79 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@bushizhanghan/dsh-workmate 还在维护吗？

最新版本 1.2.7 发布于 2026/10/27（12 天前）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/10/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。