Back to directory

dsh-workbuddy2api

In a curated listMaintenance: Active

tearslee/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.

View on GitHub
$ dsh plugin add dsh-workbuddy2api

Install

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 work

9

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 —— 但请先看下面的上游状态,接手前务必确认你要依赖的网关来源还活着。

下方内容全部保留,作为历史文档与自行构建的参考。

把 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 指向你的产物(插件不会覆盖它)。

  1. 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+ 预发布版,安装会被拒绝并回滚。

  2. 一个 WorkBuddy 账号(国内外账号体系相互独立,选你有的那个)。

  3. 网关二进制 —— 不用自己准备,/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

Read the full README on GitHub →

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.