corrinehu/dsh-workbuddy-connect: +759 stars this week

Rank of corrinehu/dsh-workbuddy-connect in each topic for today, this week and this month
Topic	Today	This week	This month
Desktop apps	#12of 62	#12of 157	#13of 217
Coding agents	#23of 188	#16of 415	#43of 537
TypeScript	#22of 206	#21of 584	#43of 861

DSH WorkBuddy Connect

将已登录的 WorkBuddy / WorkBuddy AI 桌面应用中可用的模型接入 DeepSeek Harness；两版分别显示各自的模型分组，并沿用各自的账号登录与积分。

安装

前置：本机已安装并登录 WorkBuddy（国内版）或 WorkBuddy AI 桌面 App。插件直接复用 App 的登录状态，账号切换自动跟随，两版互不影响。

推荐：把安装交给本机已有的 Agent——任何具备终端与文件操作能力的助手（DSH Agent、Codex、Claude Code、Cursor 等）都可以，把下面这段话原样发给它：

请帮我安装并验证 DSH（DeepSeek Harness）插件 dsh-workbuddy-connect（项目地址：https://github.com/corrinehu/dsh-workbuddy-connect）：
先阅读项目 README，确认我实际使用的界面（Web / Desktop / TUI）与 DSH 内核版本，桌面版以 App 内置核心为准，不要用独立 CLI 的版本代替；
再按版本对应关系从 npm 正式包安装（0.2.0-rc.2→0.7.5、rc.1→0.7.0、0.1.5–0.1.7→0.6.5），优先走本机受支持的非插件市场渠道；部分 Desktop 发行版（尤其官方 Electron 版）的 profile 由 App 管理，各发行版规则未必相同，先确认我所用的发行版，再探查其合规的安装方式，但不得绕过其校验；
任何本地文件或配置改动，先征得我同意并做好备份；
装完后验证模型选择器里出现 WorkBuddy 分组，并陪我完成一次简短对话；
若 Desktop 安装仍因 generation 校验失败（如 @types/retry 误报），请如实报告、参照上游 dataelement/dsh-desktop#688，并建议我改用独立的 Web / TUI，不要修改依赖包或绕过校验。

内核与插件版本速查（完整对应表见文末「版本兼容与历史版本」）：

DSH 内核	推荐插件版
0.2.0-rc.2	0.7.5（npm latest）
0.2.0-rc.1	0.7.0
0.1.5 – 0.1.7	0.6.5

手动安装（命令行，仅 Web / TUI）

# Web（按实际内核固定版本，示例为 0.2.0-rc.2 → 0.7.5；也可用 github:corrinehu/dsh-workbuddy-connect 从源码安装）
dsh plugin --profile web add dsh-workbuddy-connect@0.7.5
dsh web

# TUI（示例为 0.1.x 内核；该 profile 需用 pnpm 11 安装，如 npx pnpm@11）
dsh plugin --profile dsh-tui add dsh-workbuddy-connect@0.6.5
dsh --profile dsh-tui

TUI 版本搭配：终端壳 @deepseek-harness-tui/dsh-tui 需 0.10.0-beta.5 及以上，更早版本装本插件会启动失败（events is not iterable）；推理档位的手动检测仅 Web / Desktop 提供，TUI 没有。

Desktop：部分 Desktop 发行版（尤其官方 Electron 版）的 desktop profile 由 App 管理，官方版会直接拒绝独立 CLI 的 --profile desktop；其他发行版规则未必相同，请先检查你所用的发行版，不要盲用独立 CLI 的 --profile desktop。可以让 Agent 探查是否有合规的非市场安装路径，但不保证可行；切勿盲改 App 管理的目录或绕过其校验。

验证：重启对应界面后，模型选择器出现「WorkBuddy / WorkBuddy AI」分组（只装一版就只验对应一组），并从分组里选一个模型完成一次简短对话、能正常回复，才算安装成功。

功能

开箱即用：安装并启用插件后即可在 DSH 中直接使用，无需额外配置。

国内版与国际版并存：国内版显示为「WorkBuddy」分组，国际版（WorkBuddy AI）显示为「WorkBuddy AI」分组，两版的模型、账号和积分互不混用。各自只跟随对应 App 的登录状态：只装国际版就只出现 WorkBuddy AI，两版都装则两组并存，退出一版则对应分组消失。设置里两张卡片分别展示各自账号与余额。

图片输入：大部分模型支持在对话里直接粘贴或拖入图片（GLM-5.3-Flash、GLM-5.2、DeepSeek-V4 系列等）；少数纯文字模型（如 GLM-5.1）会明确提示不支持。
推理档位：WorkBuddy 明确声明的档位会直接显示，例如 GLM-5.3 和 GLM-5.3-Flash 可选 low / high / max。未声明档位的模型可在 Web 和 Desktop 的模型选择器中手动检测（发送少量请求，可能消耗积分）；未检测或没有可用档位的模型使用 WorkBuddy 默认档位。
余额速览：选中 WorkBuddy / WorkBuddy AI 模型时，输入框底部在模型选择器旁显示当前账号的剩余积分（如 WB.3,401（积分）、国际版 WB AI.3,401（积分））。积分不自动轮询（每次读取都是真实计费查询），挂载时读取一次后可点旁边的 ↻ 手动刷新。切换会话时组件可能短暂隐藏，模型选择就绪后自动恢复；即使模型没有推理档位检测入口或余额读取失败，刷新按钮仍保留。
信息查看与检测：设置 → 插件 → 对应卡片可查看账号、令牌有效期、剩余积分和模型优惠，也可手动刷新模型列表并查看当前列表来自上游还是内置兜底，或对可检测模型手动检测推理档位。DSH 0.1.5 的入口在「设置 → 插件」，0.1.6+ 移到主界面左侧栏「插件」面板（workbuddy-connect → 查看）；「设置 → 模型」页两代都不显示 WorkBuddy 条目，属有意设计。
模型显隐：两张卡片的「上下文窗口」标签里可勾选要在模型选择器中显示的模型。隐藏配置按登录账号分别保存：切换账号自动切换各自配置，切回后恢复；新账号和新上架模型默认显示。隐藏只影响选择器中的可选性，正在使用该模型的已有会话不受影响。

同一份界面在 DSH 0.1.5 的设置卡片中原样生效：

企业账号积分：国内版企业账号（enterpriseId 非空）走企业计费接口读取周期额度，卡片显示「企业额度」与周期重置时间。
费率比例：每个模型名后直接显示积分倍率（如 GLM-5.2 · x0.79、Hy3 · x0.00），/model 弹窗与输入框的模型下拉都能看到；倍率仅用于显示，不影响实际请求。
徽章展示：促销徽章（限时免费、夜间折扣）直接跟在模型名后（如 Hy4 preview · x0.00 · 限时免费），设置卡片会汇总当前有优惠的模型，数据以 WorkBuddy 服务端为准、每次启动 DSH 时同步。国际版促销来自服务端 modelPromotions（含生效时段），过期后徽章自动撤销；由于服务端把折后价直接写进模型的倍率字段，原价无法还原，此时该模型倍率显示为「价格未知 — 刷新后更新」，而不是继续显示折扣价或「免费」。

卡片展开后分「状态 / 上下文 / 明细」三个标签：状态页展示账号、令牌有效期、合计积分、模型列表来源与推理档位检测；上下文页列出各模型上下文窗口，国际版可在这里关闭「使用上游声明的最大上下文窗口」（默认开启，DSH 按上游最大窗口安排上下文压缩；关闭后改用上游默认窗口，偏好持久化）；明细页展示各套餐余量与模型优惠。国内版与国际版各有一张自己的卡片。

推理档位为什么这样设计

WorkBuddy 中模型的推理档位信息目前分散在上游接口与客户端自身的私有 UI 逻辑中，且模型目录变化很快。若插件根据经验为所有未声明模型补齐统一档位，就需要持续追赶这些未公开、没有稳定契约的产品逻辑。

实测还发现，有些模型虽然接受 reasoning_effort 参数，却可能忽略未知值并回退到默认行为；一次请求返回成功，并不能证明某个档位真实可用。

因此，对于没有声明档位的模型，Web 和 Desktop 采用用户主动授权触发、动态获取档位的方式：先确认上游会校验该参数，再逐项确认哪些规范档位被接受。检测会发送少量请求，可能消耗积分；结果只表示当前上游接受该档位，不承诺它一定改变推理效果、速度或积分消耗。

命令行

dsh plugin --profile <web|dsh-tui> exec dsh-workbuddy-connect status：登录状态与剩余积分（--json 输出机器可读格式；另有 doctor 诊断、logout 清理凭据）。desktop profile 一般由桌面 App 管理，CLI（含 exec）对其不可用（见安装章节的 Desktop 说明）。

默认操作国内版；加 --provider workbuddy-ai 操作国际版：

dsh plugin --profile web exec dsh-workbuddy-connect status --provider workbuddy-ai
dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-ai

logout 只删除该版插件自留的凭据副本，不动桌面 App 自己的登录，也不承诺一定让模型分组消失（App 的凭据文件仍在时依然生效）。

已知限制

在 macOS 的 DSH Web / Desktop / TUI 下验证通过（0.3.2 起要求 0.1.5-rc.1+、Node 22+；TUI 需终端界面插件 0.10.0-beta.5 及以上，见安装章节说明）。Windows 会依次探测 Local 与 Roaming AppData；WSL 会优先从挂载的 Windows 用户目录读取登录凭据。若 Windows 与 Linux 用户名不同且 Windows 环境变量未传入 WSL，请通过 WORKBUDDY_AUTH_FILE（国际版为 WORKBUDDY_AI_AUTH_FILE）指定实际位置。
加密桌面凭据的解密程序定位：解密程序在 macOS 与 Windows 上会自动探测；Windows 上国内版先查默认路径 %LOCALAPPDATA%\Programs\WorkBuddy\WorkBuddy.exe，再查卸载注册表记录，国际版没有已验证的默认路径、仅查注册表。自动探测失败时，可用 WORKBUDDY_ELECTRON_BIN（国内版）或 WORKBUDDY_AI_ELECTRON_BIN（国际版）显式指定可执行文件，设置后需完全退出并重启 DSH 才生效。Linux 无法自动发现，需显式指定。WSL 下调用 Windows 侧解密程序时，插件会自动把子进程 WSLENV 中的 ELECTRON_RUN_AS_NODE 条目规范化为单一安全旗标（含 /w 转发、不做路径转换，其余条目原样保留），无需手动设置。此改动已通过离线回归测试，尚未完成 WSL2 / Windows 真机验证。
国际版的模型目录来自 App 界面接口：服务端按 User-Agent 分流下发，属私有实现，上游改动可能使其失效。届时插件按「本账号上次成功目录 → 内置目录」降级，并在卡片上标明来源（实时 / 已保存 / 内置）、更新时间与失败原因，但不能保证长期兼容。国内版目录走官方 CLI 同款接口，不受此影响。
国际版仍未覆盖的环境：Windows / WSL / Linux 下国际版 App 的版本读取尚未找到可靠来源，会退回最近保存的版本或内置值。macOS 上已通过真实 shim 验证 GPT 系完整回复、工具调用与续轮。
无凭据时的行为变化：某版 App 从未登录、也没留下插件自留副本时，该版模型分组不再显示。此前国内版会显示一份内置兜底列表，但那些模型选了必然报错。
企业账号积分目前仅覆盖国内版：国际版企业账号的计费接口尚未验证，仍按个人版接口读取；待有实测结论后再扩展。企业账号分支在本机无法自测（开发机为个人账号），依据官方 App 的接口契约实现，欢迎企业账号用户反馈实测结果。
设置入口随 DSH 版本而异：0.1.5 / 0.1.6 上插件照常安装 authFile / authFileAI 等设置分区（settings.yaml 与 TUI /settings 均可读写）；0.1.7+ / 0.2.0 的设置服务不再提供该接口，插件降级为无设置项的 provider——模型、选择器、模型显隐与上下文窗口照常工作，只是「使用上游声明的最大上下文窗口」这一偏好不再可持久化。
依赖 WorkBuddy 客户端接口（非官方开放 API），WorkBuddy 更新后插件可能需要随之调整。

版本兼容与历史版本

插件版本必须与 DSH 内核匹配，不匹配的组合会导致 DSH 启动失败；桌面版按其内置核心选择插件版本。npm 上的最新版不一定适合你，以实际内核的匹配关系为准：

DSH 内核	推荐插件版	注意事项
`0.2.0-rc.2`	`0.7.5`（npm latest）	当前最新线；修复输入框组件消失与 WSL helper 环境转发，勿停留在有注册表回归的 0.7.2。
`0.2.0-rc.1`	`0.7.0`	0.7.1 起不再支持 rc.1，请停留本版。
`0.1.5` – `0.1.7`	`0.6.5`	旧内核最终版；0.7.0 起仅面向 0.2.0。
`0.1.2-rc.1`	`0.3.1`	更早旧线，仅历史维护。
`0.1.1-rc.2`	`0.2.6`	更早旧线，仅历史维护。

历次更新（完整记录见 releases）：

0.7.4：Windows 诊断与稳定性改进：注册表子进程输出超限准确分类、跨平台测试假设修正（#62），安装说明重排。
0.7.3：修复 Windows 非默认安装路径下注册表自动发现失败（#105）。
0.7.2：pi-ai 改为插件自带依赖，并修复推理字段请求被拒（#92）；该版存在 Windows 注册表回归，请使用 0.7.4 或更新的正式版本。
0.7.1：收窄 pi-ai 依赖范围。
0.7.0：适配 DSH 0.2.0 的设置服务改造，不再支持 0.1.x。
0.6.5：0.1.x 线最终版本。

固定版本安装示例：dsh plugin --profile web add dsh-workbuddy-connect@0.7.5。

不要把 profile 级的 @earendil-works/pi-ai 升到 1.x：本插件与 0.2.0-rc.2 这一代内核都要求 ^0.87.1（0.7.2 起由插件自带），第三方插件管理器的「可更新」提示不校验 peer 约束、不能照做（#86）；为此历史遗留的 overrides: {'@earendil-works/pi-ai': '0.87.1'} 在确认其他插件不依赖前也不要盲目移除。