前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在使用 WorkBuddy 等本地模型工具时，多账号管理、模型集成以及对外提供 OpenAI 兼容接口往往是痛点。dsh-hyperworkbuddy 旨在解决这些问题：在 DSH 设置里直接管理 WorkBuddy 多账号，并把模型接进 DSH 与任意 OpenAI 兼容客户端。
插件简介¶
该插件由 ChaYeWuu 维护，属于“模型推理”类别。它允许在 DSH 设置里直接管理 WorkBuddy 多账号，并把模型接进 DSH 与任意 OpenAI 兼容客户端。
核心功能¶
- 对外接口开关：独立控制 OpenAI 兼容端点；关闭后仅停止对外服务，DSH 内的模型调用不受影响。
- API Key 管理：对外 Key 支持一键重新生成与自定义；旧 Key 立即失效，无需重启。
- 双版本隔离：国内版与国际版各自维护账号、端点与模型表，同名模型不会串到另一区域。
- 账号管理：自动发现桌面客户端登录；支持粘贴 token 与导入账号文件。
- 故障转移：额度不足、限流或登录失效时自动切换账号，并对该账号指数退避。
- 会话亲和：同一会话固定走同一账号，保住上游的提示缓存命中，不会被轮询打散。
- 用量看板：记录每次请求的 token 与耗时，汇总今日 / 累计 / 近 7 天 / 分账号 / 分模型。
- 自动续期：access token 临近过期时自动刷新。
- 推理档位：按上游声明的档位在 DSH 内选择；未声明的可探测补齐。
- 模型显隐：可单独关闭模型，仅影响选择列表，不中断进行中的会话。
安装与启用¶
前置条件：已安装并登录 WorkBuddy 桌面 App（国内版或国际版均可）。插件复用 App 的登录状态，零配置即可用。
- 使用以下命令安装（仅限 web / CLI profile）：
dsh plugin --profile web add github:ChaYeWuu/dsh-hyperworkbuddy
- 安装后必须完全退出并重启 DSH（新增 bundle 不会被热加载）。
注意：本包没有发布到 npm，直接使用包名会 404。
典型用法¶
重启 DSH 后，打开设置 → WorkBuddy，面板分五块：OpenAI 兼容端点、国内版分区、国际版分区、用量、导入区。
在任意 OpenAI 兼容客户端中填入国内版或国际版的对外端点地址与 API Key。例如国内版端点默认为 http://127.0.0.1:8791/v1。
使用链接登录功能：选择版本，点击生成授权链接，在浏览器完成登录后返回面板。
注意事项¶
- 权限限制：端点只监听 127.0.0.1，并强制校验回环 Host 与 Origin。未显式配置 apiKeys 时，会自动生成密钥。
- 环境差异：国内版与国际版各有独立账号池、端点与模型表，互不串号。
- 安装方式：桌面 App 的
desktopprofile 只能通过插件页安装，CLI 的webprofile 可用命令行安装。
