前言¶
DeepSeek Harness（DSH）的「一切皆插件」理念，让开发者可以通过插件扩展模型源。当你在桌面端使用 WorkBuddy 时，如果希望在其他客户端（如 DSH Web 或其他桌面客户端）里直接选 WorkBuddy 的模型，就需要一个中间层来复用桌面 App 的登录凭证，并将模型暴露给 DSH 的模型选择器。
dsh-workbuddy-connect-next 就是为此设计的一套插件。它位于 corrinehu/dsh-workbuddy-connect 的维护分支，负责把 WorkBuddy 桌面 App 的模型接入 DSH，提供多账号池、侧栏额度展示和仪表盘界面。
插件定位¶
- 定位：DSH 的 WorkBuddy 模型提供商插件
- 维护者：yoyo636
- 分类：客户端
- 核心价值：复用 WorkBuddy 桌面 App 的登录与额度，在 DSH 中直接使用 WorkBuddy / WorkBuddy AI 的模型
核心功能¶
仪表盘与额度展示¶
插件在侧栏底部提供一张额度卡，点开后可在中栏查看完整仪表盘。额度卡支持切换「剩余 / 已用」样式，也可以关掉。
设置 → DSH-WorkBuddy 页面会按产品（国内版 / 国际版）合并账号，每张卡片显示剩余额度、已用量、请求数、token 数与恢复时间。国内企业账号走企业计费接口。
多账号轮换¶
同一产品可配置多个账号，插件会在可用账号之间轮换。被上游限流的账号会暂时搁置，稍后自动重试。
添加账号的方式包括：
- 扫码
- 网页令牌
- 桌面端凭证
删除账号后不会被 30 秒扫描加回来。
模型接入与选择¶
安装并启用后，对话里会直接出现 WorkBuddy 模型。输入框显示倍率与推理档位，底栏显示用量和额度。
模型选择器按 WorkBuddy / WorkBuddy AI 分组，带倍率与免费标记。设置页可以勾选要出现在选择器里的模型，隐藏只影响选择器，已有会话不受影响。
推理档位与图片输入¶
上游声明的推理档位会直接显示。未声明的，Web / Desktop 可在选择器里点「推理等级」手动检测（会发少量请求，可能扣积分）。
多数模型支持粘贴或拖入图片。
安装与启用¶
前置条件：已安装并登录 WorkBuddy 桌面 App（国际版同理）。核心必须对上，否则 DSH 起不来。
从界面安装¶
- 打开设置 → 插件（有的客户端写「扩展管理」）。
- 选添加插件。
- 填下面任一标识，确认：
dsh-workbuddy-connect-next
或：
github:yoyo636/dsh-workbuddy-connect-next
- 装完刷新页面；没生效就重启 DSH 客户端。桌面 App 由它自己拉起 profile，不要用
dsh --profile desktop当启动命令。
从命令行安装¶
从 npm（推荐）：
dsh plugin --profile <profile> add dsh-workbuddy-connect-next
从 GitHub（仓库里已有预构建 lib/，git 安装不会跑 prepack）：
dsh plugin --profile <profile> add github:yoyo636/dsh-workbuddy-connect-next
<profile> 换成实际 profile（web / desktop）。
Web：
dsh plugin --profile web add dsh-workbuddy-connect-next
dsh web
Desktop（DSH 0.2+ 才让 CLI 管 desktop profile）：
dsh plugin --profile desktop add dsh-workbuddy-connect-next
DSH 0.2 之前 CLI 不接受 desktop profile，请走上面的界面安装。套壳桌面 App（如 DSH NEXT）的 CLI 入口是自带的 desktop-cli，它要求 PATH 上有 pnpm。
配置入口¶
- 设置 → 模型：不显示 WorkBuddy 两行（有意如此）
- 设置 → 内置插件 → workbuddy-connect：只读运行状态，不是配置入口
- 侧栏底部：额度卡，点开中栏仪表盘
- 设置 → DSH-WorkBuddy：账号、模型、侧栏显示
- 聊天模型选择器：WorkBuddy / WorkBuddy AI 分组
CLI 命令¶
插件 CLI 二进制仍叫 dsh-workbuddy-connect（和 provider id 一样没改，避免已装用户的脚本对不上）：
dsh plugin --profile <profile> exec dsh-workbuddy-connect status
dsh plugin --profile <profile> exec dsh-workbuddy-connect accounts
dsh plugin --profile <profile> exec dsh-workbuddy-connect doctor
支持的 DSH 版本¶
插件只支持 DSH 0.2.1-rc.x 线（实测 0.2.1-rc.2）。peerDependencies 已收窄到 ^0.2.1-rc.2 与 @earendil-works/pi-ai ^1.1.0，所以在装错的宿主上包管理器会直接拒绝安装。
0.2.0-rc.x 与 0.1.7-alpha.x 不支持，因为那一代的 dsh-llm-pi-ai 基于 pi-ai ^0.87.1，与本版锁定的 1.1.0 冲突，会导致请求在发出 HTTP 之前就报 PI_AI_ERROR。
风险提示¶
2026-10-20 起，WorkBuddy 对话网关启用了针对第三方客户端的渠道校验，本插件（以及所有同类第三方接入）都可能被直接拒绝。典型报错包括 400 / code 11128 / Illegal API invocation from an unapproved channel。
校验维度在持续增加，已确认的有：
- 系统提示词开头的固定句（DSH 核心注入的 You are an AI agent powered by DeepSeek Harness.）
- 请求头格式（X-Conversation-* 系列、acp-connection-id、X-No-* 的用法）
本插件是跟着官方客户端做字节级模仿，属于猫鼠游戏：上游改一次，插件就可能失效一次，直到有人再适配。没有任何版本能保证长期可用。
账号风险真实存在：一个 CN 账号的 refresh token 被上游吊销（invalid_grant: User disabled），另一个被判定「账号存在异常行为，已被限制使用」（403 / 11140）。频繁重试、批量轮换、异常调用节奏都可能加速这一判定。
上游 corrinehu/dsh-workbuddy-connect 已于 2026-10-20 停止维护，明确表示「尊重这一边界，不再继续适配」此类校验，仓库计划 2026-10-22 下线。本仓库是独立分支，仍在维护，但不代表这条路能一直走下去。
请自行评估是否值得用你的账号承担这个风险。介意的话，直接用官方 WorkBuddy 客户端。
适用场景¶
- 你已经在桌面端使用 WorkBuddy，希望在其他客户端里直接使用同一套账号与额度
- 你需要多账号轮换来分散风险或提高可用性
- 你需要侧栏可见的额度与用量统计
结尾¶
dsh-workbuddy-connect-next 通过复用 WorkBuddy 桌面 App 的登录凭证，将 WorkBuddy 模型接入 DSH，提供多账号池、仪表盘与额度展示。它位于 corrinehu/dsh-workbuddy-connect 的维护分支，与上游 npm 包 dsh-workbuddy-connect 不是同一条线。
插件当前版本为 0.14.0，支持 DSH 0.2.1-rc.x。安装命令见上文，配置入口集中在「设置 → DSH-WorkBuddy」与「侧栏底部」。
插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证。
- 目录页：https://www.skillhub.cn/plugins/yoyo636/dsh-workbuddy-connect-next
- GitHub：https://github.com/yoyo636/dsh-workbuddy-connect-next
