dsh-workbuddy2api
In a curated listMaintenance: Activetearslee/dsh-workbuddy2api
Supervises a local workbuddy2api gateway process and exposes its models as an LLM provider, reading context windows and reasoning efforts from the gateway's own model endpoint.
$ dsh plugin add dsh-workbuddy2apiInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work9
stars
0
forks
TypeScript
Language
MIT
License
2026-09-15
Created
2026-10-20
Last push
README
dsh-workbuddy2api
[!WARNING]
⚠️ 项目状态:已停止维护(2026-10-20)
本仓库不再积极维护。 不再开发新功能,不再响应 issue / PR。已安装的用户可以继续使用,但不再获得修复与适配。
原因:原始上游 Sliverkiss/workbuddy2api 已于 2026-09-24 从 GitHub 消失(API 返回 404,git ls-remote 报 Repository not found,并非改名重定向)。本插件的生命线直接绑在它身上 —— 网关二进制由本仓库 CI 从上游源码交叉编译,上游消失后,这条链路只能靠延续仓库续命。
我已改用 magpie 接入 WorkBuddy 账号:
- magpie 的社区插件
@magpie-community/opencode-workbuddy-auth 直接对接 WorkBuddy(国内版 workbuddy)与 WorkBuddy AI(国际版 workbuddy-ai)两个 provider,走浏览器 OAuth 登录,不需要自建网关、不需要 Go / Python / bash;
- magpie 是一套网关同时代理多家订阅(WorkBuddy / Trae / ZCode / …),账号池、熔断、冷却、用量统计由 magpie 统一负责,不再需要为每家订阅各养一个网关;
- 本机已切到 magpie 方案并弃用本插件的自动拉起链路。
给你的建议:
- 新用户:请直接用 magpie(magpie-community/plugins),本插件不再推荐安装;
- 已装用户:不影响继续使用。若日后遇到上游接口变动导致失效,可自行改用 magpie,或参考下方文档自行编译网关(
go build 路径仍然有效);
- 若你希望接手本插件的维护,欢迎提 issue 或直接 PR —— 但请先看下面的上游状态,接手前务必确认你要依赖的网关来源还活着。
下方内容全部保留,作为历史文档与自行构建的参考。
[!WARNING]
⚠️ 项目状态:已停止维护(2026-10-20)
本仓库不再积极维护。 不再开发新功能,不再响应 issue / PR。已安装的用户可以继续使用,但不再获得修复与适配。
原因:原始上游 Sliverkiss/workbuddy2api 已于 2026-09-24 从 GitHub 消失(API 返回 404,git ls-remote 报 Repository not found,并非改名重定向)。本插件的生命线直接绑在它身上 —— 网关二进制由本仓库 CI 从上游源码交叉编译,上游消失后,这条链路只能靠延续仓库续命。
我已改用 magpie 接入 WorkBuddy 账号:
- magpie 的社区插件
@magpie-community/opencode-workbuddy-auth直接对接 WorkBuddy(国内版workbuddy)与 WorkBuddy AI(国际版workbuddy-ai)两个 provider,走浏览器 OAuth 登录,不需要自建网关、不需要 Go / Python / bash; - magpie 是一套网关同时代理多家订阅(WorkBuddy / Trae / ZCode / …),账号池、熔断、冷却、用量统计由 magpie 统一负责,不再需要为每家订阅各养一个网关;
- 本机已切到 magpie 方案并弃用本插件的自动拉起链路。
给你的建议:
- 新用户:请直接用 magpie(magpie-community/plugins),本插件不再推荐安装;
- 已装用户:不影响继续使用。若日后遇到上游接口变动导致失效,可自行改用 magpie,或参考下方文档自行编译网关(
go build路径仍然有效); - 若你希望接手本插件的维护,欢迎提 issue 或直接 PR —— 但请先看下面的上游状态,接手前务必确认你要依赖的网关来源还活着。
下方内容全部保留,作为历史文档与自行构建的参考。
把 workbuddy2api 网关接进 DeepSeek Harness(dsh) 的插件。
装上之后:
- dsh 启动时自动拉起网关,退出时自动回收;端口上已有健康网关在跑则直接复用,不重复拉起,也不会去杀别人的进程。
- 模型目录自动同步 —— 模型列表、上下文窗口、输出上限、思考档位全部从网关
GET /v1/models实时读取,不必再手写settings.yaml里的模型元数据。 - 6 条管理命令:
/wb2api-setup·/wb2api-status·/wb2api-start·/wb2api-restart·/wb2api-login·/wb2api-account。 - 一条命令完成安装:
/wb2api-setup会取回网关可执行文件(校验 SHA256)、准备运行目录、引导登录、启动网关并同步模型 —— 不需要装 Go,也不需要 python3 / bash。
插件本身很薄:协议适配、账号池、加权选号、分级熔断、定时任务、登录与 token 刷新全部留在 Go 网关侧。它只负责两件事 —— 进程生命周期,和模型目录自动化。
它解决什么
直接用手工配置把 workbuddy2api 接进 dsh(在 ~/.dsh/settings.yaml 里写 llm-pi-ai.providers.workbuddy2api)也能用,但有几处手工负担:
| 问题 | 手工接法 | 本插件 |
|---|---|---|
| 模型元数据 | 每个模型的 contextWindow / maxTokens / reasoningEfforts / input 全手抄;网关增删模型必须手改文件 |
运行时读 /v1/models 自动映射 |
| 进程管理 | dsh 启动前必须另行常驻 wb2a-server.exe,退出也不联动 |
插件托管子进程,生命周期绑定 dsh |
| 获取网关二进制 | 装 Go 工具链 → git clone 上游 → go build |
/wb2api-setup 自动下载 + SHA256 校验 |
| 账号登录 | 上游 login.sh 需要 bash + python3(Windows 上基本劝退) |
插件内置同款 OAuth 流程,纯 Node 实现 |
| 可分发 | 配置只存在于本机,别人拿不到 | 一个 npm 包,装上即可用 |
字段映射
网关的 /v1/models 已经透出全部模型元数据(internal/server/handler.go 的 modelList(),对应上游 issue #84),因此插件无需内置静态兜底表:
网关 /v1/models |
dsh LlmResolvedModelInfo |
说明 |
|---|---|---|
context_length |
context.contextWindow |
网关保证有值(四级查找链,见下) |
max_output_tokens |
defaultMaxTokens |
网关未收录时不下发该键,插件随之不声明 |
supports_images |
inputModalities |
缺席即仅 ['text'] |
reasoning_supported_efforts |
reasoning.efforts |
空则不声明整个 reasoning |
reasoning_default_effort |
reasoning.defaultEffort |
插件先校验它确实包含于 efforts 内 |
内置的
openai-completions栈不认这些非标准字段 —— 这正是当初必须手写元数据的根因,也是本插件的核心价值。网关侧对
context_length/max_output_tokens走四级查找链:上游动态值 → 静态种子表 →model.json缓存 → models.dev 按需拉取;全未命中时窗口兜底 1M、输出上限省略。cn:与global:两域同口径。
为什么不破坏上游的「按轮聚合」
本插件的请求序列化有两条硬约束:工具结果必须发成 role:"tool"、用户消息的内容与顺序在轮内逐字不变。破坏任一条,上游按对话轮聚合 RequestID 的兜底键就会在每个 step 漂移,用量明细重新碎片化 —— 且是静默的(网关照常回包)。
原理、实测截图与端到端证据:docs/turn-level-aggregation.md。
前置条件
⚠️ 上游仓库已删库(2026-09-30 确认,CI 已迁走):原
Sliverkiss/workbuddy2api现已 404(并非改名重定向)。 延续仓库为HanawaBanana/workbuddy2api(MIT,描述明确写着"原 Sliverkiss/workbuddy2api 已删库")。
release-binaries工作流已改为从延续仓库构建,并把 ref 钉死在UPSTREAM_REF = 1c9aef9ab378217316ee2ddff7eace78381b46c0(2026-09-20)—— 这正是 已发布二进制内嵌的vcs.revision(可用go version -m wb2a-server.exe复核), 因此重新构建出的产物与既有版本同源、可复现。- 升级上游时改工作流里的那一行即可;不要改回
Sliverkiss/...,那个仓库已不存在。- 本机开发时若自行
git clone,同样应 clone 延续仓库。2026-10-20 复核:延续仓库
HanawaBanana/workbuddy2api仍在维护(当日 master 最新提交af5e779,2026-10-16;未归档、无 Release)。因此"自己go build出来源"这条路目前仍走得通 —— 但UPSTREAM_REF钉在 2026-09-20 的快照上,已发布二进制比延续仓库落后约一个月。 想跟最新上游就自行go build并把binaryPath指向你的产物(插件不会覆盖它)。
-
dsh,全局安装:
npm i -g @deepseek-ai/dsh本插件在 dsh
0.2.0-rc.2上验证通过;package.json声明的兼容区间是>=0.1.2-rc.1 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0(前一段覆盖0.1.x,后一段覆盖0.2.x)。装插件时 dsh 会拿运行时的 dsh 版本去比对这个区间(
dsh-app-boot的evaluatePluginCompatibility,内部用semver.satisfies(version, range, { includePrerelease: true }))。 因此0.2.0-rc.2这类预发布版本也能正确命中 —— 这一点很容易踩坑:若按普通 semver 语义 写>=0.1.2-rc.1 <0.2.0-0,它反而匹配不上任何0.1.7+预发布版,安装会被拒绝并回滚。 -
一个 WorkBuddy 账号(国内外账号体系相互独立,选你有的那个)。
-
网关二进制 —— 不用自己准备,
/wb2api-setup会自动下载并校验。
安装
⚠️ 先看顶部公告:本仓库已停止维护,新用户不建议安装。若你只是想用上 WorkBuddy 订阅, 直接上 magpie +
@magpie-community/opencode-workbuddy-auth(浏览器 OAuth 登录,无需自建网关 / Go / Python / bash)更省事。 下面三种安装方式仅供已决定继续使用本插件的人参考。
方式一:一条命令直装(推荐)
不需要先下载文件 —— pnpm 支持直接以 Release 的 tarball URL 作为依赖(已实测:装出来是真实目录、非 link:):
dsh plugin --profile web add https://github.com/tearslee/dsh-workbuddy2api/releases/download/v0.3.2/dsh-workbuddy2api-0.3.2.tgz
升级时把 URL 里的版本号换掉即可。
方式二:先下载再本地安装
在 Releases 下载 dsh-workbuddy2api-<版本>.tgz,然后:
dsh plugin --profile web add file:/绝对路径/dsh-workbuddy2api-0.3.2.tgz
方式三:从源码安装
git clone https://github.com/tearslee/dsh-workbuddy2api
cd dsh-workbuddy2api
npm install
node node_modules/typescript/bin/tsc -p tsconfig.json # 必须先构建出 lib/
npm pack --pack-destination dist
dsh plugin --profile web add file:./dist/dsh-workbuddy2api-0.3.2.tgz
More in Integrations & Sharing
dsh-notification
by omdsh-dev
Desktop notifications for DeepSeek Harness turn completions, with per-outcome controls and include/exclude keyword rules.
dsh-lark-bot
by plutokeating
Feishu/Lark bridge for DeepSeek Harness: scan-to-connect PersonalAgent binding, streaming cards, git-worktree project workspaces, parallel per-scope tasks, multi-role agents, cross-session notify, in-chat model/key management, and a safety-net guardian that still answers in Feishu after dsh crashes.
dsh-session-notification
by dingyi222666
Notifications for four session states, with browser alerts and prompts.
dsh-chatgpt-web
by wlv-zedd
DSH ChatGPT Free bridges standard ChatGPT Web directly into DeepSeek Harness
