dsh-wb
把WorkBuddy强行兼容进DeepSeekHarness
- Stars
- 1
- Language
- PowerShell
- Created
- Oct 19, 2026
- Updated
- Oct 20, 2026
Introduction
DSH-WB
把 WorkBuddy 的模型接进 DeepSeek Harness(DSH)。
English | 中文
dsh-workbuddy-connect 是一个社区 DSH 插件(MIT,上游 corrinehu/dsh-workbuddy-connect)。它把已登录的 WorkBuddy 桌面端里可用的模型(GLM-5.x、DeepSeek-V4、Kimi-K3、MiniMax-M3、Hy3/Hy4 等)注册成 DSH 的模型提供方:复用桌面端登录态,不需要 API key,国内版显示为「WorkBuddy」分组,国际版显示为「WorkBuddy AI」分组。
本仓库是一个 Agent Skill:把「网页版」和「桌面端」两条接入路径、版本匹配规则、以及我们踩过的坑固化成可复用的操作手册。
两条路径
| 网页版 / TUI | 桌面端(官方 Electron App) | |
|---|---|---|
| 适用 | npx @deepseek-ai/dsh web、自装 dsh CLI、TUI | 官方 DSH 桌面应用 |
| profile | ~/.dsh/profiles/web,普通 CLI 管理 | ~/.dsh/profiles/desktop,由 App 独占管理 |
| 安装方式 | dsh plugin --profile web add … | App 自带 CLI:<app>\resources\runtime\cli\bin\dsh.cmd plugin --profile desktop add … |
| 难点 | pnpm 缺失、bundles 未注册 | 版本必须匹配、DSH_HOME 污染、pnpm 构建批准 |
| 详细步骤 | references/web.md | references/desktop.md |
快速开始
网页版
# 依赖:Node 22.19+ / 24+、pnpm 11+、已登录的 WorkBuddy 桌面端
npx @deepseek-ai/dsh@0.2.1-rc.2 web
dsh plugin --profile web add dsh-workbuddy-connect@0.7.9
# 重启 dsh web,在模型下拉里找「WorkBuddy」分组
桌面端
:: 版本必须与 App 内置内核一致(读 <app>\resources\runtime\primary-runtime\runtime.json 的 desktopVersion)
set WORKBUDDY_ELECTRON_BIN=C:\path\to\WorkBuddy.exe :: WorkBuddy 装在非默认路径时才需要
"<app>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-workbuddy-connect@0.7.9
:: 完全退出 App(含托盘)再启动
装完用 doctor 验证:
"<app>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop exec dsh-workbuddy-connect doctor
看到 Sign-in state: signed-in,并且重启后 %USERPROFILE%\.dsh\.workbuddy-host-heartbeat.json 被 App 的活进程重写,才算真的接通。
更新后自愈(Windows)
powershell -ExecutionPolicy Bypass -File scripts\repair-desktop.ps1
自动完成:读内核版本 → 找匹配插件版本(内置表 + npm peerDependencies)→ 用 App 自带 CLI 重装 → 补回 dsh.profile.bundles 与 pnpm allowBuilds → doctor 验证。
版本匹配(硬规则)
| DSH 内核 | 插件版本 |
|---|---|
| 0.2.1-rc.2 | 0.7.9 |
| 0.2.1-rc.1 | 0.7.7 |
| 0.2.0-rc.2 | 0.7.6 |
| 0.2.0-rc.1 | 0.7.0 |
| 0.1.5 – 0.1.7 | 0.6.5 |
| 0.1.2-rc.1 | 0.3.1 |
| 0.1.1-rc.2 | 0.2.6 |
不匹配的组合可能导致 DSH 直接起不来。表里没有你当前的内核时,去 npm 找一个 peerDependencies["@deepseek-ai/dsh-llm"] 等于该内核的插件版本;找不到就停下,不要硬装。
安装为技能
# WorkBuddy
git clone <this-repo> ~/.workbuddy/skills/dsh-wb
# Claude Code / 其他 Agent Skills 兼容运行时
git clone <this-repo> ~/.claude/skills/dsh-wb
技能入口是 SKILL.md;两条路径的完整步骤在 references/ 下,按需加载。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 模型下拉没有 WorkBuddy 分组 | 插件没被加载 | 桌面端看心跳文件;网页版看 bundles 是否注册 |
doctor 报 signed-out | WorkBuddy 没登录 / 装在非默认路径 | 登录桌面端;设置 WORKBUDDY_ELECTRON_BIN |
ERR_PNPM_IGNORED_BUILDS | pnpm 拦了 postinstall | 在 profile 的 pnpm-workspace.yaml 加 allowBuilds(见 references) |
报 'pnpm' is not recognized | 插件管理器依赖 pnpm | 装 pnpm 11+ 并加入 PATH |
| App 打开的是空 profile | 用户级 DSH_HOME 把它带偏了 | 删除用户级 DSH_HOME |
| 更新后 DSH 起不来 | 内核/插件版本不匹配 | 跑 scripts/repair-desktop.ps1 |
边界
- 不增加 WorkBuddy 没有的模型,不绕过 WorkBuddy 的额度与计费。
- 内核还没有匹配插件版本时,本技能只会如实报告并指向 releases,不会硬装。
- 上游是社区项目,非 DeepSeek / 腾讯官方;请遵守 WorkBuddy 服务条款,仅用于个人合理使用。
致谢
corrinehu/dsh-workbuddy-connect:插件本体(MIT)。Sliverkiss/workbuddy2api、franksong2702/dsh-codex-connect:上游参考实现。- DeepSeek Harness:Cordis 插件内核与桌面运行时。