dsh-multi-agent-gateway
Free Token —— 把各平台的免费额度，装进 DSH 的模型选择器。
一个插件管起所有「AI Agent 平台」的账号：统一账号管理、每日签到、额度/积分拉取、 多账号智能路由；把各平台的模型按平台分组上报到 DSH 对话框的原生模型选择器， 并在每个模型名后标注积分消耗倍率。六个平台的适配器已全部实现。
不是独立 Nginx，也不是外部代理进程 —— 请求全部在插件内部转发，账号凭证只存在本机。 （本地 OpenAI 兼容网关属于后续计划，见路线图。）
理念：Free Token
各平台为了拉新，会持续放出免费额度：OpenCode 的匿名免费层、Qoder / WorkBuddy 的 每日签到积分、Trae 的赠送额度……这些「免费 token」分散在六个客户端里，每个都要单独 登录、单独签到、单独查余额，最后往往是放着过期。
这个插件的立场很简单：
- 免费额度不该被浪费，也不该被平台 UI 绑架 —— 账号收进来、模型接进 DSH、 签到与额度查询自动跑；
- 默认不烧钱 —— 模型默认一个都不勾，勾选并保存后才出现在选择器里
（见
docs/MODELS.md§6.5），避免「白嫖」变成「意外扣费」； - 福利跟进是长期承诺 —— 哪个平台出了新的免费模型或签到活动，适配器就跟着更新。 各平台接口并不公开，我们坚持逐个真机验证，而不是照抄文档。
一句话：能白拿的 token，一个都别浪费；拿不到的时候，我们自己写适配器。
界面：五页 + 浏览器登录
设置页现在是独立一页（设置 → 多 Agent 网关），内部按「你此刻要回答的问题」分五页：
| 页 | 回答什么问题 |
|---|---|
| 总览 | 现在健康吗？刚才那条花了多少？ |
| 账号 | 这个平台有哪些账号 / 模型？ |
| 任务 | 签到和活动任务跑得怎么样？ |
| 日志 | 刚才那次为什么失败？ |
| 设置 | 那些不常动的东西（含版本更新） |
添加账号不用手抄 token：账号页点「打开登录页」→ 浏览器里完成平台登录 → 回来稍等 几秒（会自动轮询），或点「刷新登录状态」→ 插件自己去换 token 并建账号 （token 不经过浏览器，加密落盘）。
| 平台 | 登录形态 |
|---|---|
| OpenCode | 设备码（显示 user_code，前端自动轮询） |
| WorkBuddy / 国际版 | 外链（auth/state → 打开登录页 → auth/token?state=） |
| Qoder / Qoder CN | 设备码 + PKCE |
两种形态都会自动轮询（3～5 秒一次）：浏览器里授权完成后回来即可看到变绿； 「刷新登录状态」只是手动补充入口，不是必点步骤。
模型表按「免费 → 厂商 → 倍率」排序，默认一个都不勾 —— 勾选并「保存并生效」
之后才进选择器；还没勾过时可以点「按推荐预选」（OpenCode 推免费，其余平台推全部）。
每行可单独改上下文长度、可单独「测一次」，状态列显示 可用 / 地区受限 / 不可用 / 未探测。
上游声明了思考档位的模型，选择器里还能选 off / low / medium / high…。
💬 DeepSeek Harness 插件交流群
欢迎加入 DeepSeek Harness 插件交流 QQ 群——插件开发、模型接入、推理档位、 第三方厂商配置等话题都可以在这里交流，本插件的问题与建议也欢迎直接进群反馈：
🐧 QQ 群号：
1105449571打开 QQ → 搜索群号 1105449571 即可加入（进群请备注「dsh 插件」）
群内可交流：插件开发经验、模型接入与档位配置、DSH 使用技巧、新功能需求投票等。
它解决什么
| 你现在的麻烦 | 这个插件怎么办 |
|---|---|
| 有五六个平台、十几个账号，每个平台一套登录/签到/查额度 | 一个配置页全管起来，按平台分组 |
| 某个号限流了 / 额度用完了，会话当场报错 | 同 Agent 内自动换号重试，用户无感 |
| 每天要手动去点签到、领活动任务积分 | 定时任务自动跑，流水可查 |
| 模型下拉里一堆同名模型，看不出哪个贵 | 按 Agent 分组，后面缀 (×2) / (免费) |
支持情况
六个平台的适配器全部实现，没有一个是「占位骨架」：
| Agent | 签到 | 额度 | 模型目录 | 对话 | 备注 |
|---|---|---|---|---|---|
| OpenCode | 上游无 / 可配 | ✅ | ✅ | ✅ 流式 + 思维链 | 匿名免费层零凭证可用；签到接口可填 checkInPath |
| Qoder | ✅ | ✅ | ✅ | ✅ | 签到 /sash/api/v1/me/campaigns、额度 /sash/api/v2/me/usage |
| Qoder CN | ✅ | ✅ | ✅ | ✅ | 同上，独立产品线与账号体系 |
| WorkBuddy | ✅ | ✅ | ✅ | ✅ | 签到 + 余额 + 会话头校验 |
| WorkBuddy 国际版 | 上游无 | ✅ | ✅ | ✅ | 上游确实没有签到接口，如实回报「不支持」 |
| Trae | ✅ | ✅ | ✅ | ✅ 流式 | 协议层已实现，默认隐藏（尚未真机验证），显式配置后可启用 |
关于签到与活动任务：opencode.ai 官方 Console 没有签到接口，国内反代平台则常见 「签到 + 活动任务」形态。所以本插件把接口路径做成可配置的：填了
upstream.checkInPath/tasksPath就真去调；没填就明确回报「上游没有这个接口 （这不是故障）」，绝不伪造签到结果。详见docs/OPENCODE-API.md。
「免费模型不要 key」——对，插件做到了一个字段都不用填
不登录、不填 API key、不填凭证 —— 账号卡片里只填一个标签就完事，
模型选择器里选 OpenCode · xxx (免费) 直接聊。
为什么以前会 403、现在能过：上游那句 FreeTierError（"can only be used from
within OpenCode"）是营销话术，它实际校验的是请求形状。消融实验实测出来的
过门三件事：
| 条件 | 去掉会怎样 |
|---|---|
stream: true |
403 —— 免费层只接受流式 |
请求里有一个叫 read 的工具 |
403 |
规范的 x-opencode-session（ses_… 降序编码） |
403 |
其余（Authorization、x-opencode-request、x-opencode-project）去掉照样过。
插件在「账号没有 key」时自动补齐这三样（upstream.freeTierMode: 'auto' 默认值），
stream: true 本来就是它的固定行为，read 工具 DSH 本来就发 —— 所以是真的零配置。
机制细节、实测报文、消融表见 docs/OPENCODE-API.md §1.5–1.6。
实测证据（npm run test:free）：空凭证账号 → 200 → 正文「收到」+
reasoning_content + usage，全程没有任何 key。
边界：匿名通道只对免费模型有效；付费模型在它上面会直接
401 Missing API key。要用付费模型就走登录/API key。上游随时可能再改门禁 ——
被拒时错误信息会把那三件事列出来，不会让你瞎试。
另外：模型目录完全免凭证，所以模型选择器里的分组与倍率 一个账号都不加也能显示，只是发不出请求。
Trae 为什么默认隐藏：适配器本身是能跑的（协议层、签到、余额、流式对话都实现了），
但本机没有 Trae 账号、没有一次真上游验证 —— 露出来只会让你点到一个没验证过的东西。
真机验证通过后，把 trae 加进 src/config.ts 的 DEFAULT_VISIBLE_AGENTS 即可显示，
别处不用改。
扩展方法见 docs/EXTENDING.md：新增一个平台只需加一个适配器
文件 + 在 adapters/index.ts 加一行，核心调度一行都不用改。
路线图
| 方向 | 说明 | 状态 |
|---|---|---|
| 新平台 / 新福利跟进 | 哪个平台放出新的免费模型、签到活动或赠送额度，就补对应适配器；接口以真机验证为准 | 持续进行 |
| 本地 OpenAI 兼容网关 | 增加本地端点（POST /v1/chat/completions、GET /v1/models），让 Cursor / VS Code / 任意 OpenAI SDK 也能用上这些账号与免费模型；端口可配、默认只绑 127.0.0.1 |
规划中，未发布 |
| 界面与可用性 | 五页设置界面 + 左侧导航入口，继续打磨 | 持续进行 |
现阶段它是 DSH 插件，不是独立服务：请求由宿主进程调进来、在进程内转发。 等网关功能落地后，才会额外暴露一个可被外部客户端直连的端点。
快速开始
# 1) 装进当前 profile（会自动应用 bundle patch）
# 从 GitHub 装：
dsh plugin --profile desktop add github:a1141171521/dsh-multi-agent-gateway
# 或从本地源码目录装（开发用）：
dsh plugin --profile desktop add D:\AI\DeepseekPlugin\dsh-multi-agent-gateway
# 2) 重启 DSH 桌面端（客户端 bundle 要重新加载）
# 3) 打开 设置 → 插件 → 多 Agent 网关，填账号
详细步骤见 docs/INSTALL.md。
文档地图
| 文档 | 内容 |
|---|---|
docs/INSTALL.md |
安装 / 卸载 / 升级 / 目录结构 / 常见安装问题 |
docs/USAGE.md |
添加账号、看积分、配自动任务、调账号路由 |
docs/MODELS.md |
模型分组与倍率标签是怎么进到 DSH 原生选择器的 |
docs/OPENCODE-API.md |
OpenCode 上游的真实接口事实（含核对过的端点表） |
docs/EXTENDING.md |
新增一个 Agent 适配器要写什么（含完整模板） |
docs/ERROR-HANDLING.md |
账号降级、重试规则、任务失败与熔断 |
docs/KNOWN-ISSUES.md |
已知问题 / 待修清单（含验证步骤与排查顺序） |
docs/NEXT-PHASE.md |
后续计划与暂缓项（含网关功能的前置条件） |
架构（分层模块化）
┌──────────────────────── DSH ────────────────────────┐
对话请求 ──▶ ctx.llm ──▶ src/llm/adapter.ts（每 Agent 一个 provider 路由）
│ │ │
│ ▼ │
模型选择器 ◀───────────│ src/runtime.ts（总装：模型缓存 / 分组 / 倍率标签） │
│ │ │
客户端配置页 ◀─ src/remote.ts ─┼─▶ core/router.ts 多账号路由（换号/降权/恢复）│
│ ├─▶ core/scheduler.ts 定时任务管理器 │
│ ├─▶ core/tasks.ts 活动任务引擎 │
│ └─▶ core/accounts.ts 账号（AES-256-GCM）│
│ │ │
│ ▼ │
工具 ◀────────────────┘ src/adapters/*.ts（每 Agent 一个适配器） │
└────────────────────────────────────────────────────┘
新增 Agent 只需要在 src/adapters/ 加一个文件 + 在 adapters/index.ts 加一行。
核心调度（路由 / 定时 / 任务 / 网关 / UI）一行都不用改。
数据落在哪
默认 <DSH_HOME>/multi-agent-gateway（DSH_HOME 一般是 ~/.dsh）：
| 文件 | 内容 | 丢了会怎样 |
|---|---|---|
.master-key |
AES-256-GCM 主密钥（0600） | 账号密文再也解不开，要重录 |
accounts.enc.json |
账号与凭证（整份加密） | 要重录账号 |
state.json |
额度缓存、健康、模型缓存、任务游标（明文、无敏感信息） | 重算，无损失 |
task-log.jsonl |
任务执行流水（可删） | 历史记录没了 |
安全边界（说清楚，不吹）：密文与密钥分文件，防的是「配置被云同步 / 被 grep 到明文 token / 备份泄露」。它不是硬件密钥库 —— 能读该目录的本机进程同样能读密钥。
开发
node scripts/build.mjs # TypeScript → lib/（零依赖，用 Node 自带的类型擦除）
npm test # 宿主测试 478 + 客户端契约 63 + 冒烟
node test/live-opencode.mjs # 真机管线：打真实 OpenCode 目录核倍率（需要联网，只读公开接口）
改完 src/ 必须重新构建（lib/ 是产物）；改完 client/ 也要重跑构建，
然后重启 DSH（宿主在启动时扫描 dsh.client 声明）。
已验证
| 验证 | 结果 |
|---|---|
node scripts/build.mjs |
54 个 TS 文件 → lib/，零不可擦除语法 |
宿主测试（npm test） |
478/478 通过（核心 + 六个适配器 + 推理档位 + 签到记账 + 额度刷新 + 日志采样） |
| 客户端契约测试 | 63/63 通过（端点、描述符、volatile 路径、真 apply(ctx)、无参端点零参数、真渲染 ModelList、登录弹框五态） |
| 假宿主冒烟 | 通过（provider 路由 / 5 个工具 / 模型上报策略真的改变选择器内容 / 密文落盘） |
真机免费层（npm run test:free，联网） |
空凭证账号 → 200 → 正文「收到」+ 思维链 + usage，全程零 key |
真机管线（npm run test:live，联网） |
真实模型目录 + 倍率；设备码登录实测发起成功、未授权正确返回 pending |
| 真实 DSH 进程（headless profile） | 通过（零 did not activate、零配置校验错误） |
| 真实浏览器（Edge + 真 web profile） | 通过 —— 客户端 bundle 在 boot combo 里、apply 正常激活、控制台零本插件错误 |
模型不是全塞进去：默认一个都不报
上游实测 85 个模型，全进下拉的话免费那几个会被淹没。所以每个 Agent 有一份上报策略
（设置页里是三个按钮 + 一个带搜索的勾选列表）：selected（默认，不勾不报）/
free / all。勾选只是草稿，点「保存并生效」才真正写配置并重发 provider。
详见 docs/MODELS.md §6.5。
📣 加入交流
对 DeepSeek Harness 插件开发、多平台模型接入感兴趣？欢迎加入交流群一起讨论：
QQ 群：1105449571（QQ 内搜索群号即可加入，进群请备注「dsh 插件」）
群内分享：插件开发经验、模型接入与倍率配置、多账号管理与路由调优、DSH 使用技巧。 如果这个插件帮到了你，也欢迎进群反馈问题、提建议、参与新功能投票 🌟
License
MIT
No comments yet. Be the first to write one.