- Home
- Plugin
- Modelli e provider
- dsh-xdpool
dsh-xdpool
etosurvivor/dsh-xdpool
Heybash model pool for DeepSeek Harness: account rotation, provider aggregation, routing chains, usage insights and a local OpenAI-compatible gateway.
Installazione
dsh plugin --profile web add github:etosurvivor/dsh-xdpoolREADME
Heybash
Heybash-xdpool 使用独立版本号,从 1.0.0 开始。

Heybash 项目 · 问题反馈 · MIT License
English | 中文
把你手上所有能白嫖的模型额度,接进 DSH 的同一个模型池。
它从一件事开始——把本机 WorkBuddy 桌面 App 里登录过的所有账号合成一个自动容错的池子,哪个号被限流了、积分用光了,请求自动换到下一个能用的号上去。你不用挑号,不用手动导入。
然后它长成了六页:账号池之外,还能扫码登录十三家厂商的免费模型、把 76 家厂商的免费额度聚合成一条通道、看用量账本、把几个模型串成链、把池子开成一个本地 OpenAI 兼容网关。
| 页面 | 干什么 |
|---|---|
| 账号池 | 本机 WorkBuddy 账号、池健康、实时用量、积分自动化 |
| 扫码登录 | 十三家支持网页 / 扫码登录的厂商,登一次,它们的免费模型就进选择器 |
| 聚合渠道 | 76 家厂商的免费额度接进同一个池(默认一家都不开,填了 key 才亮) |
| 数据看板 | 今天的轮次、调用、失败、换号救回、token、缓存命中、速度 |
| 路由 | 把多个模型串成一条链,按顺序或轮换使用 |
| 网关 | 把池子开成本地 OpenAI 兼容接口,可转发给局域网其它设备 |
另外附送一整套「积分自动化」:签到、领任务奖励、连登兑换、开猫猫旅行……这些每天都要手动点一遍的活儿,插件在后台替你干完了。
和单账号连接插件的区别:
dsh-workbuddy-connect那类插件是「一次一个账号」。Heybash 把多账号当默认情况——不挑号、不手动导入,你在桌面 App 换登过的每个号都被池记下并跨重启保存,对外用一个xdpoolprovider 分组,池内自动容错。
从旧名升级:这个插件以前叫
dsh-workbuddy-xdpool。改名后旧数据会自动接过来(你的 API key、忽略名单、账号 pin 都还在);唯一需要你动手的是「默认模型」如果指向旧 id,见从旧版升级。
功能
一、多账号池
-
零配置:装上、打开,就完事了。WorkBuddy 桌面 App 里每个登过的账号都会被自动发现、持久保存并入池(重启不丢),不需要在插件里录任何东西。
-
自动容错换号:池子记着每个账号的限流状态。某个号触发 429 就冷却它,后面的请求自动落到下一个健康的号上;冷却结束自动恢复。所有号都在冷却时,请求才排队等待。
-
四种账号分配方式:
priority先用完一个号;round-robin按顺序轮换;balanced随机抽、偏向闲置久的;sticky让一个对话只用一个账号,新对话才换下一个——上游缓存按账号隔离,中途换号等于把整段对话的缓存作废,sticky就是为这件事准备的。卡片上点一下即可切换,默认仍是priority。 -
池健康一眼看清:卡片显示「几个账号 / 几个在冷却」「下一个会轮到谁」,以及每个账号的令牌有效期和冷却倒计时。
-
剩余积分实时可见:按账号列出积分包(
套餐名 · 剩余 / 总量)和大字合计,跟着上游实时刷新。 -
模型目录带标注:列出池里能用的模型,附带积分倍率(如
GLM-5.2 · x0.79)、免费 / 限时免费 / 夜间折扣标签、能否收图和上下文窗口大小,全部跟随上游实时更新。 -
被限流时告诉你退路:免费档被 429 冷却时,卡片和报错都会点名同名的付费行(如国际版
deepseek-v4.1-flash对deepseek-v4.1-flash-sg、国内版hy3对hy3-x)。上游按「行」分别限流,所以免费行被关小黑屋时,收费行通常还是通的。 -
国内版 / 国际版自动适配:按账号凭据里的登录域名自动选上游——国际版登录(
workbuddy.ai)走www.workbuddy.ai,国内版(默认)走copilot.tencent.com。两种账号可以混在同一个池里。 -
想手动做点啥也行:卡片和命令行都提供「重新检测账号」「清除所有冷却」「每日签到」三个操作。
二、积分自动化
卡片上一个开关,插件在后台把你成长中心的日常动作全做掉。默认全自动,也可以随时点「立即运行」手动跑一轮。
它管这五件事:
| 任务 | 默认时间 | 干什么 |
|---|---|---|
| 每日签到 | 09:00 | 领取当天签到奖励 |
| 活跃上报 | 10:00 | 报个到,让成长中心知道你还在用 |
| 任务奖励 | 11:00 | 把任务中心的奖励该报名的报名、该领的领掉 |
| 连登奖励 | 12:00 | 连登档位兑换 + 抽奖 |
| 猫猫旅行 | 09:00 · 21:00 | 把猫派出去、回来领奖励 |
「任务奖励」这一项覆盖了 13 个任务,包括那些看起来非得本人坐在电脑前点鼠标才能完成的:
探索优秀灵感 · 使用 5 个模板 · 尝鲜热门技能 · 换「和平精英」主题 · 逛资料库 · 召唤 5 次专家 · 召唤 3 次专家团 · 体验腾讯轻量云专家 · 进入任一小助手应用 · 进入企鹅教师助手 · 设计创意模式建画布 · 创建定时任务 · 猫猫对话
实测一轮跑下来,四个账号合计领到 3300 积分 + 135 能量。
卡片上会告诉你这一轮具体领到了什么——不是只写「领了 8 个任务」,而是把任务名字列出来。连登还差几天解锁也会写清楚(比如「还差 4 天解锁 7 天档」),免得你以为是坏了。
关于「今日收益」:卡片按来源分四行显示——任务奖励、签到、连登、旅行。今天赚了多少一眼看到,跨天自动清零。
关于保留积分:可以给每个账号设一个积分下限,余额低于这个数的账号就不派活了,省着点用。
国际版不显示这个面板——那边的网关压根没有积分系统。
三、路由链推理强度
路由选择「均衡」时,每个「渠道+账号+模型」是独立组合:新会话优先使用路由中最久未使用的可用组合,同一会话固定渠道、账号和模型,失败或冷却后重新选择。子代理使用独立会话,优先选择不同于父会话的组合;其他组合不可用时仍可回退。路由内最近使用时间和会话绑定跨重启保留。DSH 提供会话标识,外部网关客户端可通过 x-session-id 提供稳定标识;未提供时每个请求单独选择。顺序兜底策略保持原来的优先级行为。
WorkBuddy 国内版与国际版可分别加入路由,国际版使用其账号和实际模型目录;旧路由中的裸模型 ID 继续表示国内版。国际版没有账号时不会提供不可用的国际模型。
包含推理模型的路由链提供 Low / High / Max。每次实际请求按候选模型的原生档位转换:不支持 Max 而支持 High 时,Max 降为 High;只有开关的模型将 Low 映射为关闭,High / Max 映射为开启。切换候选时重新计算,不沿用上一个候选的降档结果。
长会话压缩的 CodeArts 请求若遇到网络或网关超时,会使用已有的同模型路由链回退一次。需要已配置包含该 CodeArts 模型的路由链;回退仍失败时保留原错误处理。
路由链只要有明确支持图片的成员即可接收图片;带图片的请求只会尝试支持图片的成员,不会把图片丢给纯文本模型。图片能力取决于各渠道提供的模型信息。
安装
DSH 0.2.0 起,设置面板使用平级标签。安装后从左侧栏 Heybash-Xdpool 进入,或按 Ctrl+Alt+, 打开设置并选择 Heybash。
从 npm 安装 Heybash(推荐):
dsh plugin --profile desktop add heybash-xdpool
也可在 DSH「插件」页面的安装入口输入 heybash-xdpool。已有上游 dsh-xdpool 的同事应先停用并卸载旧插件,再安装 Heybash,避免同时加载两个模型池;保留原有数据目录即可复用账号与配置。
本地开发安装:
pnpm install
pnpm build
pnpm test
pnpm typecheck
pnpm typecheck:client
dsh plugin --profile desktop add "file:/你的项目路径/dsh-xdpool-fork"
改动源码后需重新构建并更新已安装的插件,再完整退出、重新启动 DSH Desktop。构建产物 lib/ 随仓库维护,源码和产物应同步提交。
安装包不自动执行依赖链接脚本。通常由 DeepSeek Harness 提供插件所需的共享依赖;如特殊环境出现依赖无法解析,可手动运行安装目录下的 node scripts/link-host-peers.mjs 进行排查。
模型选择器中的账号池分别显示为 WorkBuddy 国内版、WorkBuddy 国际版,免费模型分组显示为 Heybash · 免费模型。同一区域中与账号池重复的渠道模型只展示一次,原有渠道标识仍可用于已有会话。
从旧版升级
这个插件以前叫 dsh-workbuddy-xdpool。当前 Heybash 维护版的包名为 heybash-xdpool。
你的数据不会丢。 插件自己的目录从 ~/.dsh/.workbuddy-xdpool 变成了 ~/.dsh/.xdpool,启动时会自动把旧目录复制过来——你填过的第三方 API key、忽略名单、账号 pin、启动日志,都在。旧目录只复制、不删除,所以想退回旧版、或者两个版本并存,都还能用。
唯一需要你动手的地方:如果你的「默认模型」指向旧 id,它不会自己改。旧 id 是宿主配置里的一个字符串,插件不去改宿主的配置文件(那等于插件改自己的加载器配置)。
| 旧 id | 新 id |
|---|---|
workbuddy-xdpool | xdpool |
workbuddy-xdpool-global | xdpool-global |
workbuddy-xdpool-aggregate | xdpool-aggregate |
workbuddy-xdpool-free | xdpool-free |
要改两处(都在 profile 目录里):
# ~/.dsh/profiles/desktop/home/settings.yaml
agent-default-model:
provider: xdpool # 原来是 workbuddy-xdpool
model: hy3
# ~/.dsh/profiles/desktop/cordis.patch.yml
- id: agent-default-model
config:
provider: xdpool-global # 原来是 workbuddy-xdpool-global
插件每次启动都会把这件事写进 ~/.dsh/.xdpool/startup.log,所以忘了改也能在日志里找到确切该改什么。
命令行
统一用 dsh plugin --profile desktop exec heybash-xdpool <子命令> 调用:
dsh plugin --profile desktop exec heybash-xdpool status # 池里几个号 / 几个冷却 + shim 状态(--credits 查积分、--json 机器可读、--rates 看倍率)
dsh plugin --profile desktop exec heybash-xdpool accounts # 已发现的账号(--json)
dsh plugin --profile desktop exec heybash-xdpool doctor # 诊断发现 / 冷却 / 上游连通性
dsh plugin --profile desktop exec heybash-xdpool reset # 立刻清掉所有 429 冷却
dsh plugin --profile desktop exec heybash-xdpool checkin # 查每个账号今天签到了没(--json 机器可读)
dsh plugin --profile desktop exec heybash-xdpool checkin all
# 领掉所有账号今天的签到奖励;也可以只传一个账号标签领单个
dsh plugin --profile desktop exec heybash-xdpool login # 教你怎么在桌面再加一个号进池
池里怎么多账号?
桌面 App 同一时间只保留当前登录账号的凭据(每次换号都会覆盖同一个文件),所以 Heybash 自己把账号记下来:你在桌面 App 里换着登几个号,每个号在切走的瞬间就被池收进 ~/.dsh/.xdpool/accounts.json 持久保存——重启 DSH 也不会丢。之后点卡片上的「重新检测账号」,或者直接开始用,池都会带着全部历史账号服务。
如果你想给桌面 App 之外的一次登录做个显式快照(比如临时固定某个号做验证),也可以手动导入:
# 在 WorkBuddy 桌面 App 登录账号后(key 自己起名):
dsh plugin --profile desktop exec heybash-xdpool import myKey
# 查看 / 删除已导入的快照:
dsh plugin --profile desktop exec heybash-xdpool accounts
dsh plugin --profile desktop exec heybash-xdpool remove myKey
导入的快照与自动保存的账号存在同一个目录 ~/.dsh/.xdpool/ 下,每次扫描都会被一并收进池——不再是「导入了但没人读」。快照以 key 的 MD5 前 8 位命名(key 本身记在文件里),中文、带 /、带空格的 key 都安全。长期使用靠 refresh token 自动续期;失效了就回桌面重新登录,再 import <key> --force 覆盖。
配置
池的配置走插件设置节(settings.xdpool),模型设置页里能改,改完立即生效:
| 字段 | 说明 | 默认 |
|---|---|---|
authFile | 覆盖 WorkBuddy 桌面 auth 文件路径(跨平台自动探测出问题时用,等同于 WORKBUDDY_AUTH_FILE) | 自动探测 |
cooldownMs | 单账号 429 冷却时长(毫秒) | 60000 |
distribution | 账号分配方式:sticky(每对话固定一个账号,新对话换下一个)/ priority(先用完一个)/ round-robin(按顺序轮换)/ balanced(随机,偏向闲置久的) | priority |
上游 prompt 缓存按账号隔离,所以对话中途换号会把缓存整段作废。想让多账号同时分摊额度又不想掉命中率,用
sticky。
也可以直接写进 ~/.dsh/settings.yaml:
xdpool:
cooldownMs: 120000
distribution: sticky
架构
- 宿主侧(
src/,跑在 DSH 主进程里)index.ts—— 注册xdpoolprovider、xdpool设置节、各条同源路由(状态 / 重新检测 / 清除冷却 / 签到 / 自动化运行 / 保留积分),以及账号发现与模型目录播种。accounts.ts——WorkBuddyAccountPool:发现并持久保存本机 WorkBuddy 账号(account-store.ts落盘)、429 冷却、轮换与 token 刷新;账号停用与积分保留也在这里。scheduler.ts—— 积分自动化的调度器:按本地时点跑五个任务(签到 / 上报 / 任务 / 连登 / 旅行),每日收益账本落盘,手动「立即运行」走的是同一套逻辑。task-events.ts—— 13 条任务事件链的构造。每条链都是纯数据,外加它该走哪个指纹通道(桌面 / 网页);需要真实会话的任务(技能、专家)在这里先开一次真对话,拿到服务端 id。catalog.ts/upstream.ts—— 上游模型目录(含每模型积分倍率、免费 / 图片能力标签)、积分查询、签到、自动化各接口的上游客户端(按凭据域名自动切国内外)。web-status.ts/status-paths.ts—— 卡片读的同源状态文档与路由。写操作按「POST + 回环来源 + 显式 accountId」把关。bin.ts—— 上面那套 CLI。
- 客户端(
src/client/,浏览器卡片,经dsh.client由宿主加载) 折叠卡片外壳沿用宿主内置卡的dsm-plugin-card*样式语言(--dsw-alias-*主题变量),内容类名统一dsm-xdpool-*前缀,不污染宿主其它卡片;文案命名空间settings.xdpool。 - 构建
tsdown产出lib/index.js(宿主入口)+lib/index.d.ts(类型)+lib/bin.js(CLI)+lib/client.js(CJS,用window.__ModuleLoader__.load包起来的浏览器 bundle)。四个产物都随仓库提交,所以安装时不需要任何构建脚本。
已知限制
-
WorkBuddy 主账号的登录仍走桌面 App:Heybash 可以为插件自己的十三家扫码登录渠道发起扫码,但 WorkBuddy 本体的 token 由桌面 App 的腾讯 SSO 铸造并和设备绑定,池不会替你登录 WorkBuddy。加号 = 在桌面 App 里登录 / 切换,Heybash 自动吸收。
-
自动化里有几个任务刻意没做
Expert_Philanthropy(公益专家):需要真捐钱,绕不过去。black_cat(夜猫子):只在 23:00–08:00 计分,而且没有积分奖励——熬夜白熬。Model_chat_GLM5.2(指定模型对话)与wb_wechat_oa_subscribe_task(关注公众号):路径已经摸清,留到下个版本。
-
Expert_team_use_3偶发卡在 2/3:有个号当天用掉两次专家团后,第三次怎么发都不涨(换个没用过的专家团也不涨)。怀疑该任务对单账号有当日额度、跨天恢复,但没验证。新号不受影响(实测 0/3 → 3/3)。 -
依赖 WorkBuddy 客户端接口(不是官方开放 API),WorkBuddy 更新后插件可能得跟着调。某个账号的 refresh token 失效时,回桌面重新登录即可。
-
如果 Windows 和 Linux 用户名不同、且 Windows 环境变量没传进 WSL,请用
WORKBUDDY_AUTH_FILE或配置里的authFile指定实际位置。
免责声明
- 本项目仅供个人学习和研究使用,仅驱动使用者自己的 WorkBuddy 账号在本机调用,请勿用于商业用途或超出个人合理使用的场景。
- 使用者需遵守 WorkBuddy 的服务条款;因使用本项目产生的任何后果(包括但不限于账号被限制、额度被清空、服务中断),由使用者自行承担。
- 本项目作者不对任何因使用或滥用本项目产生的直接或间接损失负责。
- 本项目与腾讯、WorkBuddy、DeepSeek 均无关联,未获其授权或认可;文中出现的名称仅用于描述兼容关系,其商标权利归各自所有。
致谢
本项目由 Heybash 维护,基于 XDTrees 的 MIT 开源项目 dsh-xdpool 分叉;原始版权声明保留于 LICENSE。
本项目的实现参考了以下已公开的项目,并按其许可证要求保留版权声明。参考方向为设计思路与既有结论,代码为独立实现;关键模块在源文件头部注释中也标注了所参考的项目与模式:
- corrinehu/dsh-workbuddy-connect(MIT)—— 设置节注册(
settings.installSection)与 DSH 插件结构、客户端卡片加载机制、桌面端凭据刷新与 loopback shim 加固的核心参照;本项目沿用其「宿主通过 installSection 挂卡片」的打通路径。 - dingminhua/dsh-connect-workbuddy(MIT,Copyright (c) 2026 LaoDing)——
dsm-plugin-card*卡片样式语言与--dsw-alias-*主题变量的参照实现;每日签到(/v2/billing/meter/checkin-activity-status与/v2/billing/meter/daily-checkin)、积分包聚合口径(月度周期套餐 / 一次性礼包区分)与国内 / 国际版按domain选择上游域名的做法,参考了该项目已验证的接口形态。 - Sliverkiss/workbuddy2api(MIT)—— WorkBuddy 上游协议(
copilot.tencent.com的 wire behavior)与积分接口的参照实现;积分自动化(成长中心签到 / 活跃上报 / 连登兑换 / 猫猫旅行状态机 / 13 条任务事件链 / 专家召唤链)整体照该项目的 Go 版逆向实现移植,每条事件链的判据与实测结论都来自它。 - Wahwayhale/dsh-connect-doubao(MIT,Copyright (c) 2026 Wahwayhale)—— 豆包直连协议和模型目录的上游来源;随包保留 许可证。
- L0NE-6/WorkBuddy-Daily(MIT,Copyright (c) 2026 L0NE-6)—— 参考技能分享链接接口、分享事件以及首只 Buddy 领取流程;仅生成公开技能分享链接,不向任何人发送。
以上项目的版权归各自作者所有。引用及移植的代码遵循各项目许可证,随包保留相应版权和许可证。若标注有遗漏或不当之处,欢迎提交 issue 指正。
许可证
Plugin correlati
dsh-our-free-model
ebony-vinyl/dsh-our-free-model
dsh-routing-suite
yjh051108/dsh-routing-suite
dsh-connect-workbuddy
dingminhua/dsh-connect-workbuddy
dsh-workbuddy-connect
corrinehu/dsh-workbuddy-connect