前言¶

在 DeepSeek Harness（DSH）里接模型，常见做法是装一个「单账号连接」类插件，一次只绑一个上游账号。日常用 WorkBuddy 桌面 App 时，往往会换登多个号、还会碰到限流或积分见底；若每个号单独配 provider，既要手动挑号，也要自己处理 429 之后的切换。

DSH XD Pool（dsh-xdpool，维护者 XDTrees）把方向改成「池」：自动发现本机 WorkBuddy 已登录账号并持久化，请求在池内容错换号；在此基础上扩展扫码登录、多家厂商免费额度聚合、用量看板、模型路由、本地 OpenAI 兼容网关和积分自动化。插件在 DSH 社区目录中归类为模型推理；仓库 XDTrees/dsh-xdpool 采用 MIT 许可证（截至资料抓取时 GitHub 约 222 stars）。

下面按定位、能力、安装与用法说明，事实均来自插件 README 与 package.json（当前包版本 2.4.2）。

这是什么¶

一句话：把你手上能用的免费或本机已登录的模型额度，统一接到 DSH 的一个 xdpool provider 分组里。

与 README 中对比的 dsh-workbuddy-connect 不同：后者是「一次一个账号」；XD Pool 默认按多账号工作——不挑号、不在插件里手动导入账号列表，桌面 App 里登过的号会被发现并跨重启保存，对外用统一分组，池内自动容错。

设置界面在 DSH 设置面板（侧边栏左下角齿轮，或 Ctrl+Alt+,）。在 host 0.2.0 上，XD Pool 与「通用设置 / 模型 / 内置插件 / Agent 预设」平级；0.1.x 时代路径为「设置 → 插件 → DSH WorkBuddy XD Pool」，升级 host 后需按新入口查找。

卡片内共七个页面，职责如下（摘自 README 表格）：

装好后，模型选择器会出现 XD Pool（国内版）、XD Pool（国际版） 等分组；「聚合渠道」与 XD Pool · 免费模型 按需出现。

核心功能¶

多账号池与分配策略¶

前置依赖：安装 WorkBuddy 桌面 App 并登录；多账号即在 App 内多次换登，每次登录会被自动纳入池。

• 零配置发现：安装并打开插件后，各账号自动发现、持久保存，重启不丢。
• 自动容错：账号触发 429 进入冷却，后续请求落到健康账号；全部冷却时才排队等待。
• 四种分配方式（卡片上可切换，默认 priority）：
• priority：优先用尽当前号
• round-robin：顺序轮换
• balanced：随机，偏向闲置久的账号
• sticky：单对话固定同一账号（避免中途换号导致上游按账号隔离的缓存失效）
• 国内版 / 国际版：按凭据登录域自动选上游（国内默认 copilot.tencent.com，国际 www.workbuddy.ai），可混在同一池。
• 限流提示：免费档被冷却时，卡片与报错会指向同名付费行作为备选路径（README 举例：国际版 deepseek-v4.1-flash 与 deepseek-v4.1-flash-sg）。

卡片与命令行均提供「重新检测账号」「清除所有冷却」「每日签到」等操作。

积分自动化¶

国内版成长中心相关日常操作可在后台执行；国际版不显示该面板（上游无积分系统）。默认全自动，也可点「立即运行」。

可为每个账号设置保留积分下限，余额低于该值的账号不再被派活。README 记载开发者自测一轮四账号合计领到 3300 积分与 135 能量，仅为仓库自述，不构成普遍效果承诺。

扫码登录与聚合渠道¶

• 扫码登录：十三家厂商，网页或扫码登录后，免费模型进入选择器。
• 聚合渠道：七十六家厂商按分类筛选（README 截图说明含 API Key、免费、本地等筛选维度）；默认一家都不开，填写对应 key 后启用。

路由、网关与观测¶

• 路由：将多个模型串成链，顺序或轮换调用。
• 网关：本地 OpenAI 兼容接口，便于其它客户端或局域网设备复用同一池。
• 数据看板与 billion-context 页分别面向调用统计与本机压缩器只读状态。

模型目录会展示积分倍率、免费 / 限时免费 / 夜间折扣等标签，以及是否支持收图、上下文窗口等，随上游刷新。

安装与启用¶

环境：package.json 要求 Node ^22.19.0 || >=24.0.0，DSH >=0.1.5-rc.1 <0.3.0；README 写明兼容 host 0.1.1-rc.2 起的 0.1.x 及 0.2.0-rc.2。

方式一：npm（推荐）

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

README 说明 npm 方式仅拉取插件本体，耗时较短；从 GitHub 源码安装会连带开发依赖，体积与时间更大。

方式二：GitHub

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

方式三：手动注册 bundle（需先 npm 或 GitHub 安装包，再在 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 末尾加入 "dsh-xdpool"，并重启 DSH Desktop）。

Web / TUI 可使用 --profile web 或 --profile dsh-tui。

从旧版 dsh-workbuddy-xdpool 升级¶

自 2.1.0 起包名改为 dsh-xdpool。数据目录由 ~/.dsh/.workbuddy-xdpool 迁移至 ~/.dsh/.xdpool（启动时复制，旧目录保留）。若宿主「默认模型」仍用旧 provider id，需手动改为新 id，例如：

示例（~/.dsh/profiles/desktop/home/settings.yaml）：

agent-default-model:
  provider: xdpool        # 原为 workbuddy-xdpool
  model: hy3

遗漏修改时，可查看 ~/.dsh/.xdpool/startup.log 中的提示。

典型用法¶

命令行¶

统一前缀：

dsh plugin --profile desktop exec dsh-xdpool <子命令>

常用子命令（摘自 README）：

dsh plugin --profile desktop exec dsh-xdpool status    # 池内账号数 / 冷却数；可加 --credits、--json、--rates
dsh plugin --profile desktop exec dsh-xdpool accounts  # 已发现账号（--json）
dsh plugin --profile desktop exec dsh-xdpool doctor    # 发现、冷却、上游连通性诊断
dsh plugin --profile desktop exec dsh-xdpool reset     # 清除全部 429 冷却
dsh plugin --profile desktop exec dsh-xdpool checkin   # 查看签到；checkin all 领取全部账号当日签到
dsh plugin --profile desktop exec dsh-xdpool login     # 指引在桌面 App 再添加账号进池

在 DSH 里选模型¶

安装完成后，在对话或 Agent 配置中选择 XD Pool（国内版） 或 XD Pool（国际版） 下的模型；需要第三方免费渠道时，在 XD Pool 设置页配置聚合渠道 API key，并在选择器中使用对应分组。

需要本地其它工具走同一池时，在插件 网关 页按 README 说明启用 OpenAI 兼容端点（具体端口与路径以安装后界面与文档为准）。

适用场景与注意¶

适合谁

• 已在 WorkBuddy 桌面 App 使用一个或多个账号，希望在 DSH 里统一出口、自动换号。
• 希望把多家扫码登录或 key 驱动的免费额度收敛到一条通道，并查看用量与简单路由。
• 使用国内版且愿意用插件自动化处理成长中心签到、任务等重复操作（需理解自动化行为与账号规则）。

务必知晓

• DSH 插件以当前 DSH 进程权限运行，会读取本机 WorkBuddy 登录状态与插件自管目录（如 ~/.dsh/.xdpool）；安装前应阅读 源码 与 MIT 许可证，自行评估信任边界。
• 聚合渠道涉及多家第三方服务，key 与合规使用责任在用户；默认聚合项均为关闭，需主动填写并启用。
• 社区插件目录 SkillHub 上的 XD Pool 页 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；版本与星标以 GitHub 与 npm 为准。

结尾¶

DSH 的理念是「一切皆插件」；XD Pool 针对的是「多账号 + 免费额度分散」这一具体痛点，把发现、容错、聚合、观测和本地网关收进同一套 xdpool 分组。若你已在用 WorkBuddy 桌面版，可从 npm 一条命令装上，在设置面板 XD Pool 页确认池健康后再选模型或开网关。

• 社区目录：https://www.skillhub.cn/plugins/XDTrees/dsh-xdpool
• 源码与文档：https://github.com/XDTrees/dsh-xdpool