前言¶
在 DSH 里做智能体开发时，模型往往不只有一家：OpenCode 的匿名免费层、Qoder / WorkBuddy 的签到积分、Trae 的赠送额度等，分散在不同客户端里。常见做法是每个平台单独登录、单独签到、单独查余额，再在对话里手动换账号或换模型；额度过期、限流报错、下拉框里同名模型分不清积分倍率，都是日常摩擦。
下面介绍社区插件 dsh-multi-agent-gateway（维护者 a1141171521）：在 DSH 进程内统一管理多个「AI Agent 平台」账号，把各平台模型按分组上报到 DSH 原生模型选择器，并标注积分消耗倍率。它不是独立 Nginx，也不是外部代理进程；账号凭证加密落在本机，请求由插件内部转发。
这是什么¶
dsh-multi-agent-gateway 是 DeepSeek Harness 的 Provider 类插件（当前版本 0.1.0，许可证 MIT）。README 用「Free Token」概括其立场：把各平台放出的免费额度收进统一配置，接进 DSH 对话框的模型选择器，用定时任务跑签到与活动任务，并在同 Agent 内做多账号智能路由（限流或额度用尽时自动换号重试）。
插件在 SkillHub 社区目录有条目（目录页），源码在 GitHub。社区目录与 DeepSeek / 幻方无官方从属关系，安装前建议自行查看源码与许可证。
核心功能¶
六个平台适配器¶
资料写明六个 Agent 适配器均已实现（非占位骨架），能力概览如下。
| Agent | 签到 | 额度 | 模型目录 | 对话 | 备注 |
|---|---|---|---|---|---|
| OpenCode | 上游无 / 可配 | 支持 | 支持 | 流式 + 思维链 | 匿名免费层可零凭证；签到路径可配 checkInPath |
| Qoder | 支持 | 支持 | 支持 | 支持 | |
| Qoder CN | 支持 | 支持 | 支持 | 支持 | 独立产品线与账号体系 |
| WorkBuddy | 支持 | 支持 | 支持 | 支持 | |
| WorkBuddy 国际版 | 上游无 | 支持 | 支持 | 支持 | 上游无签到接口时如实回报「不支持」 |
| Trae | 支持 | 支持 | 支持 | 流式 | 协议已实现，默认隐藏（尚未真机验证），显式配置后可启用 |
未配置的上游签到接口不会伪造结果；OpenCode 等平台的 upstream.checkInPath / tasksPath 行为见仓库内 docs/OPENCODE-API.md。
设置界面：五页 + 浏览器登录¶
配置入口为 设置 → 多 Agent 网关，按「此刻要回答的问题」分为五页：总览（健康与最近消耗）、账号（平台账号与模型）、任务（签到与活动任务）、日志（失败排查）、设置（含版本更新等低频项）。
添加账号时可在账号页点「打开登录页」，在浏览器完成平台登录后自动轮询（约 3～5 秒一次），或手动点「刷新登录状态」；token 由插件换取并加密落盘，不经过浏览器明文传递。OpenCode、Qoder / Qoder CN 等设备码流程，WorkBuddy 等国际版外链流程，README 中均有对应说明。
模型选择与默认策略¶
模型按「免费 → 厂商 → 倍率」排序上报到 DSH 原生选择器，名称后可带 (×2)、(免费) 等标签。默认一个模型都不勾选，勾选并「保存并生效」后才出现在选择器里，避免未预期的扣费；首次可使用「按推荐预选」。上游声明思考档位的模型，选择器内可选 off / low / medium / high 等。
OpenCode 匿名免费层：不登录、不填 API key 时，账号卡片可只填标签；插件在无 key 时按 upstream.freeTierMode: 'auto'（默认）补齐免费层所需的请求形状（流式、read 工具、x-opencode-session 等，详见 docs/OPENCODE-API.md）。匿名通道仅对免费模型有效；付费模型需登录或 API key。
多账号路由与本地数据¶
同 Agent 内支持多账号路由：限流或额度用尽时自动换号重试。账号与凭证默认存放在 <DSH_HOME>/multi-agent-gateway（DSH_HOME 一般为 ~/.dsh），含 AES-256-GCM 加密的 accounts.enc.json 与 .master-key；丢失主密钥需重新录入账号。state.json 缓存额度与健康状态等非敏感信息。
路线图（未发布能力）¶
本地 OpenAI 兼容网关（POST /v1/chat/completions、GET /v1/models，供 Cursor / VS Code 等）在 README 路线图中为规划中，当前仍以 DSH 插件形态在进程内转发为主。
安装与启用¶
官方快速开始命令如下（须带 --profile desktop）：
dsh plugin --profile desktop add github:a1141171521/dsh-multi-agent-gateway
开发时也可从本地源码目录安装，路径以你本机为准。安装后会应用 bundle patch。
完成安装后需要重启 DSH 桌面端，以便客户端 bundle 重新加载。再打开 设置 → 插件 → 多 Agent 网关 添加账号。更细的安装、卸载、升级说明见仓库 docs/INSTALL.md。
典型用法¶
- 按上一节命令安装并重启 DSH。
- 进入 设置 → 多 Agent 网关 → 账号，为需要的平台添加账号（浏览器登录或 OpenCode 等设备码）。
- 在账号或模型相关页勾选要暴露的模型，保存并生效后，在对话窗口的 DSH 模型选择器里按平台分组选用。
- 在 任务 页查看或配置自动签到、活动任务；在 总览 看额度与健康，在 日志 排查失败原因。
仅想预览模型分组与倍率、暂不发起对话时，README 说明模型目录可免凭证拉取，但发请求仍需可用账号或 OpenCode 免费层等符合条件的路径。
适用场景与注意¶
适合谁：同时使用多个 Agent 平台账号、希望把免费额度与签到自动化、并在 DSH 里统一选模型与看倍率的开发者。
运行与安全：插件以当前 DSH 进程权限运行，能读本机 ~/.dsh/multi-agent-gateway 目录的进程理论上也能读取密钥与密文；密文分文件存储主要防配置被云同步或明文泄露，并非硬件级密钥库。安装第三方插件前请阅读源码与 MIT 许可证，自行评估信任边界。
Trae：默认不在可见 Agent 列表中；真机验证通过后，按 README 将 trae 加入 src/config.ts 的 DEFAULT_VISIBLE_AGENTS 可显示。
问题与建议可在 README 记载的 DeepSeek Harness 插件交流 QQ 群 1105449571 反馈（进群备注「dsh 插件」）。
结尾¶
dsh-multi-agent-gateway 把分散在多平台的账号、签到、额度与模型目录收拢到 DSH 一处：进程内转发、模型进原生选择器、默认不勾选模型以降低误扣费风险。更完整的用法、错误处理与扩展适配器见 GitHub 仓库文档地图（docs/USAGE.md、docs/MODELS.md、docs/EXTENDING.md 等）。
