dsh-xdpool

dsh plugin --profile web add dsh-xdpool

DSH XD Pool

<p align="center">

<a href="https://www.npmjs.com/package/dsh-xdpool"><img src="https://img.shields.io/npm/v/dsh-xdpool?style=flat-square&label=npm&color=cb3837" alt="npm version"></a>

<a href="https://www.npmjs.com/package/dsh-xdpool"><img src="https://img.shields.io/npm/dm/dsh-xdpool?style=flat-square&label=downloads&color=cb3837" alt="npm downloads"></a>

<a href="LICENSE"><img src="https://img.shields.io/github/license/XDTrees/dsh-xdpool?style=flat-square" alt="MIT license"></a>

<a href="https://github.com/XDTrees/dsh-xdpool/stargazers"><img src="https://img.shields.io/github/stars/XDTrees/dsh-xdpool?style=flat-square" alt="GitHub stars"></a>

</p>

先加群

<p align="center">

<img src="assets/community-qr-wechat.jpg" width="240" alt="微信机器人二维码：扫码添加后发送 XD 拉你进群">

&nbsp;&nbsp;&nbsp;&nbsp;

<img src="assets/community-qr-qq.jpg" width="240" alt="QQ 群二维码：直接扫码加入 XD 交流群">

<br>

<b>左：微信（机器人）</b> —— 扫码添加机器人后<b>发送「XD」</b>，它才会拉你进群；只扫码不加不发是不会有反应的。<br>

<b>右：QQ 群</b> —— 直接扫码即可加入，群号 1103463688。

<br>

_{两个群都在，哪个方便用哪个。二维码失效了在 <a href="https://github.com/XDTrees/dsh-xdpool/issues">issues</a> 说一声会换新。}

<br>

_{卡片右上角「点Star」旁边的「交流群」按钮打开的是同样这两张码 —— 不用回头找 README。}

</p>

<p align="center">

_{下载量徽章读的是 npm 上 <code>dsh-xdpool</code> 自己的实时统计，不再是改名前的快照。}

</p>

[English](./README.en.md) | 中文

把你手上所有能白嫖的模型额度，接进 DSH 的同一个模型池。

它从一件事开始——把本机 WorkBuddy 桌面 App 里登录过的所有账号合成一个自动容错的池子，哪个号被限流了、积分用光了，请求自动换到下一个能用的号上去。你不用挑号，不用手动导入。

然后它长成了六页：账号池之外，还能扫码登录十三家厂商的免费模型、把 76 家厂商的免费额度聚合成一条通道、看用量账本、把几个模型串成链、把池子开成一个本地 OpenAI 兼容网关。

页面 · 干什么

账号池 · 本机 WorkBuddy 账号、池健康、实时用量、积分自动化

扫码登录 · 十三家支持网页 / 扫码登录的厂商，登一次，它们的免费模型就进选择器

聚合渠道 · 76 家厂商的免费额度接进同一个池（默认一家都不开，填了 key 才亮）

数据看板 · 今天的轮次、调用、失败、换号救回、token、缓存命中、速度

路由 · 把多个模型串成一条链，按顺序或轮换使用

网关 · 把池子开成本地 OpenAI 兼容接口，可转发给局域网其它设备

另外附送一整套「积分自动化」：签到、领任务奖励、连登兑换、开猫猫旅行……这些每天都要手动点一遍的活儿，插件在后台替你干完了。

和单账号连接插件的区别：dsh-workbuddy-connect 那类插件是「一次一个账号」。XD Pool 把多账号当默认情况——不挑号、不手动导入，你在桌面 App 换登过的每个号都被池记下并跨重启保存，对外用一个 xdpool provider 分组，池内自动容错。

从旧名升级：这个插件以前叫 dsh-workbuddy-xdpool。改名后旧数据会自动接过来（你的 API key、忽略名单、账号 pin 都还在）；唯一需要你动手的是「默认模型」如果指向旧 id，见[从旧版升级](#从旧版升级)。

先看几张图

账号池（卡片首页：品牌栏 + 六个页面标签，顶部就是用量）

扫码登录（十三家支持网页或扫码登录的厂商，登一次就能用它们的免费模型）

聚合渠道（把各家的免费额度接进同一个模型池，76 家厂商按分类筛选）

账号积分详情（池中账号：积分包、连签天数、今日已签、保留积分）

积分自动化面板

模型选择器（国内版 / 国际版 两个独立分组）

国内版 / 国际版 双供应商（各自独立账号、积分与模型，可同时使用）

功能

一、多账号池

• 零配置：装上、打开，就完事了。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 天档」），免得你以为是坏了。

关于「今日收益」：卡片按来源分四行显示——任务奖励、签到、连登、旅行。今天赚了多少一眼看到，跨天自动清零。

关于保留积分：可以给每个账号设一个积分下限，余额低于这个数的账号就不派活了，省着点用。

国际版不显示这个面板——那边的网关压根没有积分系统。

安装

前置条件：装好 WorkBuddy 桌面 App 并登录（插件复用它存在本机的登录状态）。多账号 = 在桌面 App 里换着登几次，每次登录都会被自动吸进池里。

兼容 host 0.1.1-rc.2 起的整个 0.1.x 系列，以及 0.2.0-rc.2。安装设置节时会按 host 能力自动选择 settings.installSection（0.1.2-rc.1+）或更早的自由函数写法；卡片在 0.2.0 上作为设置面板里一个平级标签页渲染。

卡片在哪儿打开：DSH 设置面板本身。开法是侧边栏左下角的齿轮，或者快捷键 Ctrl+Alt+,。

面板顶部是平级标签：通用设置 / 模型 / 内置插件 / Agent 预设 / XD Pool —— 本插件就是最后那个 XD Pool。

（0.1.x 时代它叫「设置 → 插件 → DSH WorkBuddy XD Pool」，0.2.0 起改成了平级标签，按老路径找不到。）

方式一：从 npm 安装（推荐）

# dsh 不在 PATH 时，用 node ~/.dsh/profiles/node_modules/@deepseek-ai/dsh/lib/bin.js 代替 dsh
dsh plugin --profile desktop add dsh-xdpool

推荐 npm：需要拉取的依赖只有插件自己（约 1 个包，几秒搞定）。

从 GitHub 源码装会连带装开发依赖（构建器、测试框架等几百个包），慢得多。

方式二：从 GitHub 源码安装

dsh plugin --profile desktop add github:XDTrees/dsh-xdpool

方式三：手动注册 bundle

# 1) 先装包（npm 或 GitHub 任选）
dsh plugin --profile desktop add dsh-xdpool

# 2) 注册 bundle：编辑 ~/.dsh/profiles/desktop/package.json，
#    在 "dsh" → "profile" → "bundles" 数组末尾加上 "dsh-xdpool"

# 3) 重启 DSH Desktop

本地构建（开发者）

pnpm install
pnpm build              # 产出 lib/index.js + lib/index.d.ts + lib/bin.js + lib/client.js
pnpm test               # 814 项测试
pnpm typecheck          # 宿主侧类型检查
p

…(truncated)