前言¶
DeepSeek Harness (DSH) 插件生态中，多账号管理往往意味着手动切换或复杂的配置。DSH RotaKit 把本机登录过的 WorkBuddy / CodeBuddy 账号合并成一个自动故障转移的模型池，并附带一套完整的积分自动化功能。插件读取桌面客户端凭据，自动发现账号，实现故障转移和积分管理。
核心功能¶
多账号池¶
插件支持对本地账号进行精细化调度：
1. 自动发现与权重：读取桌面端登录快照，空闲越久的账号权重越高。取权重最高的前 5 个账号再洗牌，避免长尾账号被反复抽中。
2. 故障转移机制：支持会话粘性（同一对话固定用同一账号）、在途租约（同一账号并发超过 2 个请求时让路）、冷却分级（429 与 5xx 分开计数）。
3. 熔断与预算：连续被拒的账号会移出池 30 分钟（凭据熔断）；余额低于门槛的账号自动跳过，恢复后自动回归。
模型目录¶
从上游实时拉取模型列表，标记状态。
* 状态标记：显示「无可用账号」的模型和「成本未知」的模型。
* 目录刷新：支持重试机制，应对网络抖动。
* 输出上限：可发现网关对 max_tokens 的静默限制。
积分自动化¶
提供一套自动化任务，默认在特定时刻执行：
* 每日签到：领取当日签到积分。
* 活跃上报：上报活跃状态。
* 任务奖励：报名并领取任务奖励。
* 连登奖励：连登档位兑换与抽奖。
* 猫猫旅行：出发与领取奖励。
* 漏跑补跑：应用关闭期间错过的任务，启动后立即补跑。
* 收益账本：跨天自动清零，重启不丢数据。
请求可观测¶
- 记录：记录时间、模型、账号、结果、总耗时、排队、首字、token 数、轮换次数。
- 统计：提供按模型的排队时长（p50/p95）、输出速度（tok/s）和消耗账本。
界面¶
- 双区域标签：国内版与国际版账号与积分隔离。
- 可折叠列表：默认收起，减少视觉干扰。
- 响应式布局：窄窗口自动堆叠。
- 主题三态：跟随系统 / 浅色 / 深色。
- 一键清除：清除冷却、熔断、按模型缓存状态。
协议兼容¶
池对外同时支持三种协议：
* OpenAI Chat (/v1/chat/completions)
* OpenAI Responses (/v1/responses)
* Anthropic Messages (/v1/messages)
兼容 DSH 本体、Codex、Claude Code 以及各类 SDK 客户端。
安装与启用¶
1. 安装¶
将仓库克隆到 DSH 的 profile 目录：
git clone https://github.com/2861292267/DSH-Official-WorkBuddy-Credit-Proxy.git \
~/.dsh/profiles/desktop/node_modules/dsh-rotakit
2. （可选）安装二维码依赖¶
用于二维码兜底登录（仅在上游不返回 authUrl 时需要）：
cd ~/.dsh/profiles/desktop/node_modules/dsh-rotakit && npm i qrcode
3. 配置与启用¶
在 DSH profile 的 package.json 的 dsh.profile.bundles 中确保包含 "dsh-rotakit"。
重启 DeepSeek Harness。模型选择器会出现 WorkBuddy XD Pool 分组。
注意事项¶
- 无热重载：宿主插件不会热重载。修改
lib目录下的源码文件必须完全退出应用再启动，否则运行中的实例仍在使用旧代码。 - 凭据来源：插件读取的是桌面客户端凭据，网页版登录不会被读取。
- 许可证：基于上游 MIT 许可证。
适用场景¶
适合需要同时使用多个 WorkBuddy / CodeBuddy 账号进行负载均衡或积分管理的 DSH 用户，以及需要通过 OpenAI / Anthropic 协议接入同一账号池的开发者。
