百度搭子(DuMate)接入 DSH
⚠️ 已停止维护(2026-11-16),欢迎二创。 先看下面「30 秒装好」,再读 docs/FOR-FORKERS.md —— 上游实测事实与十个坑都在那里。
把你已经登录的百度搭子,变成 DSH 里的一个模型供应商。 模型出现在选择器里可以直接对话,积分余额、消耗明细、每日签到都挂在输入框上 —— 不用在 DSH 和搭子窗口之间来回切。
桌面版 App 不用开着。 对话默认走搭子自己的云端模型网关,App 只是提供这台机器上的登录态。
30 秒装好
前提只有两个:DSH ≥ 0.2.2,以及一个百度搭子账号(桌面版装不装都行,见下面「两种登录方式」)。
# ① 下载并解压(Windows 10/11 自带 tar;macOS / Linux 同命令)
curl -L -o dumate.tgz https://codeload.github.com/seacoral1223/dsh-connect-dumate/tar.gz/refs/tags/v0.9.26
tar -xzf dumate.tgz
# 解压出来是一个目录:dsh-connect-dumate-0.9.16
② 打开 DSH → 插件管理 → Add plugin(添加插件) → 选中上面那个目录 ③ 重启 DSH(必须重启,否则新的 JS 世代不会加载 —— 这是"装完看不见东西"的头号原因)
⚠️ 不要用
npm i -g。 全局安装不会把 bundle 注册进 DSH 的 profile,装完看不到东西是必然的 —— 网上不少教程会那么写,那是错的。 会用 git 的话也可以:git clone --branch v0.9.26 https://github.com/seacoral1223/dsh-connect-dumate.git,然后同样 Add plugin 选那个目录。
装好后应该看到这四样
- 模型选择器里出现 百度搭子 DuMate 一组(默认 11 个模型,可在设置里增减)
- 选中其中任意模型时,输入框上出现积分胶囊(选别的模型就不出现,这是设计)
- 设置 → 百度搭子 有账号 / 积分 / 模型 / 能力 / 诊断 五个分栏
- 对话里打
/dumate doctor出诊断表;或直接问「我的搭子积分还剩多少」
四项里有任何一项没有 → 先确认 DSH 版本。 版本低于 0.2.2 时宿主会整个跳过这个 bundle,而且页面上不报错,表现就是"装了但什么都没有"。
卡住了怎么办:把 /dumate doctor 那一段整块复制出来贴给问题反馈即可 —— 那一栏就是为这个设计的,路径已缩成 ~,不含账号主键,也没有任何会改设置的控件。
停止维护,以及为什么
做到 v0.9.26 就到这里了。不是因为做完了,是因为碰到了天花板,而天花板不在我能力范围内:
- 上游账号级限流绕不过去。 配额按账号算、与选哪个模型无关(具体阈值上游没公布,我这边也复现不出稳定数字,见下面「限流是怎么回事」里那段撤回说明) (撞的那次正是跨 5 个模型时发生的,所以「限流时自动换模型」这个方案实测无效)。 真正能扩容的办法只有多个账号 + 账号池自动换号,而那个我没实现。
- macOS / Linux 只有单元测试、没有真机。 目录探测是按 Electron 惯例猜的候选 + 验证
auth.json是否存在。 我不愿意把它写成「支持三平台」—— 那是句假话。 - 插件市场需要的位图图标与截图没做(只有 SVG,按对方规则会被拒)。
欢迎二创,请先读这份
docs/FOR-FORKERS.md —— 项目里最有价值的不是代码,是挖接口时攒下的实测事实。 它们花的时间比代码多;代码会被重构掉,事实不会过期得太快。那份文档里有:
- 上游鉴权链与全部接口,以及每个字段的真实形态(哪些是字符串不是数字、
status认不出时为什么必须单独回传、为什么不能只信expireDate); - 43 个 SKU 逐个探测出的实际后端映射(
glm-5其实是 DeepSeek-V4.1 Flash,五个 id 落同一个后端); - 限流的真实形状与两次实验数据;
- 架构决定的理由(为什么零依赖、为什么目录必须三层兜底、
settingsNs写错会怎样双双静默失效); - 十个按代价排序的坑,包括几个「看起来能跑」的静默失效。
MIT 许可证,可以随便改、随便闭源。做出了更好的版本,欢迎开个 issue 说一声 —— 不是为了收回去,是想让还在用的人知道往哪走。
已经装了的人不需要做任何事:现有功能不受影响,只是不会再有更新。
它能做什么
- 模型进选择器:43 个上游模型里筛出的可用户,逐模型开关、可选图片输入开关、可改显示名
- 对话走云端网关:App 关着也能用;App 的本地代理作为备胎通道,失败时自动退回
- 积分只读概览:余额、每个积分包的余量与到期、24 小时 / 7 天实际消耗、逐条消耗明细(哪次对话、哪个技能)
- 每日签到:一键领取;自动签到默认关闭,开了也只在 DSH 进程活着时跑
- 多账号:本机登录过几个账号档就能在设置里切
- 两种登录方式:桌面版登录态,或只粘两个 Cookie(不装 App 也能用)
- 限流会退避:上游 429 映射到官方失败码并声明重试策略,不会一句话把整轮对话打死
- 诊断可粘贴:
/dumate doctor与设置页诊断栏输出同一套事实,含插件版本与宿主版本
两种登录方式
插件不注册账号、不代你登录 —— 它复用这台机器上已有的百度登录态。
方式一:桌面版 App(默认,什么都不用填)
装好百度搭子桌面版(https://www.dumate.cn/download )并登录一次,插件直接读它的登录数据(只读,绝不写 App 的任何文件)。多个账号档可以在设置页里选。
方式二:手动导入 Cookie(不想装桌面版,或那台机器装不了)
只需要两个 Cookie —— 这是逐个剔除 34 个 Cookie 实测出来的最小集,其余全是冗余:
| Cookie | 是否 HttpOnly | 作用 |
|---|---|---|
bce-sessionid |
是(document.cookie 读不到) |
会话凭据 |
bce-user-info |
否 | 同时当 csrftoken 用 |
- 用浏览器登录 https://console.bce.baidu.com (和搭子同一个百度账号)
- 按 F12 → Application 标签 → 左侧 Cookies → 选
https://console.bce.baidu.com - 复制上面两项的 Value,按
bce-sessionid=…; bce-user-info=…的形式粘进 设置 → 百度搭子 → 账号 - 点导入并验证 —— 插件会先去换一个真 token,成功才保存。换不到会直接说清是哪一项的问题,不会存一份假的让你以为登录好了
⚠️ 必须从 Application → Cookies 复制:bce-sessionid 是 HttpOnly,控制台里 document.cookie 拿不到它 —— 这是这条路最容易卡死的一步。
存储方式:Cookie 用随机密钥做 AES-256-GCM 加密后写进 ~/.dsh/dumate-state.json,密钥单独放 ~/.dsh/dumate-cookies.key;明文只在内存里短暂存在,不写日志、不回传页面、不回填输入框。不想留就点清除。读取路径不会写密钥文件,所以同步盘瞬时占用不会把已导入的凭据作废。
风险提示
这是第三方非官方接入。 它调用的是百度搭子桌面客户端自己使用的私有接口(不是开放 API),上游随时可能收紧,插件可能某一天就失效。请自行评估账号风险后再决定是否安装使用。
说清楚四件事:
- 不提供账号、不共享凭据、不绕过计费。 每次调用消耗的都是你自己账号的积分,按上游真实扣费。
- 没有提权、刷额度、批量注册的能力。 全部写操作只有一个:每日签到,而且必须你点按钮或显式开启自动签到才会执行 —— 默认关闭。
- 不修改搭子 App 的任何文件,只读它的登录态;运行期只写
~/.dsh/下自己的两个文件。 - 使用官方桌面版客户端始终是最安全的选择。 这个插件解决的是一件很小的事:省掉来回切换。
目录
- 上面:装法 · 它能做什么 · 两种登录方式 · 风险提示
- 下面:支持的系统 · 卸载前必看 · 数据边界 · 两条通道 · 积分口径 · 它不做什么 · 胶囊与设置页 · 模型数量与显示名 · 上游实测 · 限流处理 · 已知边界 · 排障 · 免责声明 · 致谢
- 最末尾是维护者附录(内部实现复盘与验证记录),普通使用者不用读
支持的系统(说清楚到哪一步)
- Windows:已实机验证(本文所有实测数据都来自 Windows)。
- macOS / Linux:按 Electron 惯例做了目录探测,未在实机上验证。 找登录目录时不猜死一个名字:Windows 试
%APPDATA%/%LOCALAPPDATA%,macOS 试~/Library/Application Support,Linux 试$XDG_CONFIG_HOME/~/.config,每处试qianfan-desktop-app/DuMate/qianfan_desk_xdg三个名字,判据是里面的auth.json在不在。装完在诊断页能看到「找过的 App 目录」和「命中的 App 目录」两行。 - 目录结构非标准(App Store 沙盒、flatpak、snap、便携版)时,用环境变量
DUMATE_USER_DATA直接指向那个目录(指到目录本身)。它严格生效:指错了就报「这个目录里没有 auth.json」,不会悄悄退回用别的登录态跑。 - 百度搭子是否有 Linux 桌面版本身未核实,所以 Linux 上更可能是「App 装不了」而不是「插件找不到目录」。
卸载 / 停用之前先看这两条
- 先把默认模型从
dumate/*上切走。如果你把 DSH 的默认模型设成了搭子的某个模型(agent-default-model的 config 里provider: dumate),插件一移除,那行配置指向的 provider 就没了 —— 这类幽灵条目会让每次启动都加载失败。 - 插件唯一写的文件是
~/.dsh/dumate-state.json(DSH 数据目录内)。卸载不会清掉它,里面有你的模型勾选和activeProfileId(账号档标识);想彻底清空就手工删掉。 config.enabled: false现在是真的全关:不注册模型路由、不轮询积分、不发任何上游请求,工具和命令只会回「已禁用」。
数据边界
一句话:Cookie 密文与密钥只在本机内存里用,明文不落盘、不打印;请求只发往百度自己的域名,没有第三方、没有遥测;唯一的写操作是领每日签到,默认关闭。
完整清单在包内 docs/PRIVACY.md —— 读你登录态的插件应该有一份能独立读的隐私说明,而不是让你翻源码。
通道 A(默认):云端模型网关,App 可以关着
本机登录 Cookie(auth.json 密文 + .cookie-key 解密)
-> GET https://console.bce.baidu.com/api/dumate/app/token/get 换 36 位短期 token(寿命由上游 expired_at 决定,实测同一 token 会反复原样返回)
-> GET https://dumate-svc.baidu.com/gateway/apis/v1/models 43 个模型的目录
-> POST https://dumate-svc.baidu.com/gateway/apis/v1/chat/completions Authorization: Bearer <token>
三条都是实测:目录字段与 App 写进 opencode.json 的那份逐字一致(limit / modalities / thinking);对话支持 SSE;stream_options.include_usage 才回 usage,所以插件每次都带上;坏 token 回 401 + error_code 336100,据此作废缓存重取一次。响应头 x-dumate-gw-realmodel-displayname 会告诉这次真正路由到哪个模型(比如 glm-5 实为 DeepSeek-V4.1 Flash),插件把它记下来当显示名,只在上游给过名字时才用。
通道 B(备胎):App 自带的本地代理
POST http://127.0.0.1:<随机端口>/api/qianfanproxy/v1/chat/completions 无需鉴权头
端口与目录来自 App 每次启动重写的 qianfan_desk_xdg/<userId>/config/opencode/opencode.json。mode: local 可强制只走这条;默认 auto = 先试云端,拿不到 token 才退回本地。
积分(与通道无关,恒走云端只读接口)
| 能力 | 接口 |
|---|---|
| 余额 / 积分包 | GET …/api/dumate/points/package/list,余额 = active 包 Σ(totalPoints − usedPoints) |
| 24 小时 / 7 天消耗 | GET …/api/dumate/points/records/usage?startAt&endAt(两个参数必填),带 consumedPoints |
| 发放与充值流水 | GET …/api/dumate/points/records/charge?startAt&endAt |
| 今日签到状态 | GET …/api/dumate/points/loginBonusInfo(signInDays / hasIssued) |
| 领取今日签到(500 分/天) | POST …/api/dumate/points/loginBonus —— 唯一写接口,只能手点或显式调工具 |
| 账号身份与多账号档 | GET …/api/dumate/user/info + auth.json.accountProfiles |
登录态直接复用本机搭子:读 %APPDATA%\qianfan-desktop-app\auth.json 的 Cookie 密文,用同目录 .cookie-key(32 字节)做 AES-256-GCM(base64(iv12‖tag16‖ct))解密。App 的两个文件全程只读,Cookie 与 token 只活在插件进程内存里,不落盘、不进日志、不出浏览器。
它不做什么
- 不编造积分倍率。 个人版上游没有公开的逐模型倍率:
global/model/list对个人账号返回空,前端那个「模型价格系数」只属于企业/自定义模型。所以读数只报余额与真实消耗,不报x0.79。 - 不做账号池自动换号、不做生图/生视频、不后台自动签到。
- 不写 DSH 默认模型,不碰 profile 的
package.json/cordis.patch.yml(安装走 plugin manager)。
装完要做的事
# 代码换版必须重启 DSH 才会加载新的 JS 世代
配置在 profile 的 cordis.patch.yml 里那一行:
- id: dsh-connect-dumate
name: dsh-connect-dumate
config:
enabled: true
mode: auto # auto | gateway | local
pollIntervalMs: 300000 # 60000 / 300000 / 600000 / 1800000 / 3600000
积分胶囊只在选中百度搭子时出现
判据是会话当前选中的 provider,来自宿主自己的 modelSelection 投影:
const provider = (projection?.next ?? projection?.lastUsed)?.provider; // next 优先:刚提交还没落地也算
visible = provider === "dumate";
不是本插件的路由就 return null,而且不起定时器、一次请求都不发(hooks 全部先跑完才做条件返回,顺序稳定)。宿主配置里改了 providerId 的部署也能认出来:不可见时做一次一次性探测拿回 providerId,总共一个请求,不起轮询。
注意分层:Host 侧的积分轮询照旧每
pollIntervalMs跑一次(与选没选无关,这样切过来的第一帧就是新数字);被省掉的是浏览器里的读取与渲染。
「胶囊不见了」怎么区分两种原因
按上面的规则,会话没选百度搭子时它就是不该出现 —— 这是设计,不是坏掉。区分只看一处:设置左侧有没有「百度搭子」这一条。
- 有 → 客户端模块正常加载,那就是当前会话选的模型不是搭子。把模型切成 DuMate 任意一个,胶囊立刻回来(不用重启)。
- 没有 → 客户端半段压根没跑起来(模块加载失败),这时才需要查 JS 报错。
两个兜底已经加上:
- 安全阀:座位没把
useProjection注进来(宿主换了 props 形状)时,判定无从做起,此时退回一直显示 —— 静默消失是最难查的坏法,宁可多显示也别装死。 - 浏览器把自己的判定回报给宿主:每次读
/api/dumate/state都带上view=canTell=…;selected=…;visible=…,宿主记下来。/dumate doctor里新增一行「浏览器胶囊判定」,下次再问"为什么没出现"就有实测答案,不用猜。
回归:tests/client-structure.test.mjs 里钉了四种情形 —— 别的 provider 不渲染、选中 dumate 渲染、只有 lastUsed 渲染、拿不到 useProjection 必须渲染、投影未就绪不渲染。这个用例还当场抓到一个真 bug(viewRef 声明在使用之后 → TDZ ReferenceError → 整个座位崩掉)。
回归:node tests/pill-visibility.test.mjs 把 client.js 里 GATE 标记块原样抠出来跑 10 个用例(next/lastUsed 优先级、空投影、空串 provider、非本插件路由等),测的就是浏览器实际跑的那段代码,不是副本。
设置页:设置 → 百度搭子
左侧导航里与「模型 / 费用 / 内置插件」并列的一页,五个分栏。照 dsh-connect-workbuddy 的分栏思路做,但只放搭子真有的能力:
| 分栏 | 内容 | 写操作 |
|---|---|---|
| 账号 | 本机登录过的账号档;每档可选「由本插件使用」;点「读所有账号积分」才逐个查余额与签到 | 换档(只改插件用谁的凭据) |
| 积分 | 余额、24h/7d 消耗、积分包与到期、今日签到 + 领取按钮、近 7 天消耗明细 | 领取签到(唯一花钱的按钮) |
| 模型 | 逐个启用/禁用、图片输入开关、显示名覆盖;显示上游实际路由到的模型 | 写插件自己的状态文件 |
| 能力 | 通道(auto / gateway / local)、积分刷新间隔、每天自动签到(默认关) | 全部即时生效,不用重启 |
| 诊断 | 只读事实表 + 可复制的 JSON(含宿主答复的 hostView) |
无 —— 这一栏故意不放任何会改设置的控件 |
分栏里的旋钮落在 ~/.dsh/dumate-state.json,优先级高于 cordis.patch.yml 里的同名字段(后者只当出厂默认)。这样换通道、改刷新间隔、换账号档都不用重启 DSH —— 上一版每次改都得重启,而重启会连带把别的插件的 JS 世代一起换掉,代价太大。
逐账号积分只在人点按钮时才发请求:每档要一次余额 + 一次签到状态,让它在后台按刷新间隔自动跑,等于替用户多烧 N 倍请求量。
选择器里的数量 = 设置里勾选的数量(这是同一件事)
不是两份名单:设置页勾选 → 写 disabledModels → listModels() 过滤 → 宿主 llm/models-updated 重拉 → 选择器变。设置页模型栏顶上那行直接当面比:
选择器里 11 / 22 · live
选择器里 那个数取自宿主的答复(ctx.llm.listModels('dumate')),不是拿自己的 enabled 数自证 —— 两个数一旦不一致,就是过滤逻辑真坏了,这样能当场看见。
三个一键按钮
| 按钮 | 做什么 |
|---|---|
| 推荐(按后端去重) | 每个互不相同的后端只留一行;同组留上下文窗口最大的,并列按 key 排(确定性)。自动路由档位一律关 |
| 全选 / 全不选 | 整组开关,含路由档位 |
「推荐」这条为什么值得存在:实测 glm-5、ernie-4.5-turbo-vl-32k、qwen2.5-vl-32b-instruct、deepseek-v4-flash-0731、deepseek-v41-flash 五个 id 落的是同一个模型。全开着,选择器里就是五个名字不同、行为一样的行 —— 看着"模型很多"其实是重复。推荐后从 22 行收敛到 11 行,后端互不相同:
deepseek-v4-pro deepseek-v41-flash doubao-seed-2-0-pro glm-53 glm-53-flash
kimi-k3 kimi-k31 qwen3.5-27b qwen3.5-35b-a3b qwen3.8-max qwen38-flash
幂等(再点一次结果一样),且每次都会广播 llm/models-updated(批量改动不能靠签名去重,否则选择器会停在旧的一套上)。
显示名怎么拼
规则(项目约定):主名 = 上游说过的真实模型名,括号里 = 中转站返回的 id。
DeepSeek-V4.1 Flash (glm-5)
DeepSeek-V4 Pro (deepseek-v4-pro)
Kimi-K3.1 Pro (kimi-k31)
GLM-5.3 Flash (glm-53-flash)
Qwen-3.8 Flash (qwen38-flash)
Qwen-3.8 Flash (qwen3.5-397b-a17b)
DeepSeek-V4.1 Flash (deepseek-v4-flash-0731) ← 这一行上游没给名字,但同一个后端在别的行被叫过,借来用
kimi-k3 ← 上游从没给过名字 → 只显示 id,不硬造
qwen3.5-27b ← 同上
三条边界:
- 只用上游亲口说过的名字(响应头
x-dumate-gw-realmodel-displayname)。上游没说过就显示 id 原文 —— 不把n2p5sdmw_qwen35-35b-a3b、doubao-seed-2-0-pro-260215这种内部后端串包装成「模型名」,那是另一种编造;完整后端 id 放在设置页「后端:」那一行。 - 括号不能省:
glm-5、ernie-4.5-turbo-vl-32k、qwen2.5-vl-32b-instruct、deepseek-v4-flash-0731、deepseek-v41-flash五个 id 落到同一个后端,只留真实名就是五行同名,选哪个都分不清。 dm-auto-model/*是自动路由档位,不记名字、默认不启用;启用后显示的就是那个别名本身。
名字是学到才有:这台机器没真发过一次请求之前,那一行显示 id 原文。已用探测脚本把 22 个 id 各打一次(约 2.4 积分),16 条真实路由写进了状态文件并标了探测时间;要刷新就在设置页点「重新读目录」或再跑一次探测脚本 —— 插件自己不会替你花钱。
这些 id 实际落到哪个模型(2026-11-15 逐个实测)
每个 id 发一次 max_tokens=1 的最小请求,读响应头 x-dumate-gw-realmodel;对可疑的再连打三次,结果每次都一样,所以路由是按 id 固定的,不随负载漂。这轮探测实花约 2.4 积分(47 条记录,39 条 <0.05)。
顺带确认:
points/records/usage的consumedPoints是按区间聚合、不按分页(limit=1/5/20/100与第 2 页都返回同一个值),所以设置页那个「24 小时消耗」可以直接信。
| SKU id(上游目录) | 实际落地模型 | 上游给的名字 |
|---|---|---|
deepseek-v4-flash-0731 |
deepseek-v4.1-flash-low-latency-1017 |
— |
deepseek-v41-flash |
deepseek-v4.1-flash-low-latency-1017 |
DeepSeek-V4.1 Flash |
deepseek-v4-pro |
deepseek-v4-pro-0813 |
DeepSeek-V4 Pro |
glm-5 |
deepseek-v4.1-flash-low-latency-1017 |
DeepSeek-V4.1 Flash |
ernie-4.5-turbo-vl-32k |
deepseek-v4.1-flash-low-latency-1017 |
DeepSeek-V4.1 Flash |
qwen2.5-vl-32b-instruct |
deepseek-v4.1-flash-low-latency-1017 |
DeepSeek-V4.1 Flash |
glm-53 |
glm-5.3 |
GLM-5.3 |
glm-53-flash |
glm-5.3-flash |
GLM-5.3 Flash |
kimi-k3 |
kimi-k3 |
— |
kimi-k31 |
kimi-k3.1-pro |
Kimi-K3.1 Pro |
doubao-seed-2-0-pro |
doubao-seed-2-0-pro-260215 |
— |
qwen3.5-27b |
qwen3.5-27b |
— |
qwen3.5-35b-a3b |
n2p5sdmw_qwen35-35b-a3b |
— |
qwen3.5-397b-a17b |
qwen3.8-flash |
— |
qwen3.8-max |
qwen3.8-max |
— |
qwen38-flash |
qwen3.8-flash |
Qwen-3.8 Flash |
dm-auto-model/mm.L0/L1/L2 |
deepseek-v4.1-flash-low-latency-1017 |
DeepSeek-V4.1 Flash |
dm-auto-model/text.L0 |
deepseek-v4.1-flash-low-latency-1017 |
DeepSeek-V4.1 Flash |
dm-auto-model/text.L1 |
kimi-k3 |
— |
dm-auto-model/text.L2 |
qwen3.8-max |
— |
三个要点:
- 名字没写错,是 SKU 标签:
qwen38-flash=qwen.3.8的压缩写法,deepseek-v41-flash=v4.1。上游目录里根本没有 name 字段,所以这些 id 就是全部对外信息。 - 五个不同的 id 落到同一个后端(
glm-5、ernie-4.5-turbo-vl-32k、qwen2.5-vl-32b-instruct、deepseek-v4-flash-0731、deepseek-v41-flash全是deepseek-v4.1-flash-low-latency-1017)。尤其注意glm-5不是智谱的模型,两个带vl的 id 也不是视觉模型(目录里它们的modalities.input就只有text,对得上)。 qwen3.5-397b-a17b名字像个 397B MoE,实际落的是qwen3.8-flash。
所以显示名规则见上面「显示名怎么拼」一节:主名 = 上游说过的真实模型名,括号里 = 中转站返回的 id(括号不能省,否则上面那五行会变成一模一样的「DeepSeek-V4.1 Flash」)。上游没给过名字就只显示 id 原文,绝不把内部后端串包装成模型名。自动路由档位(dm-auto-model/*)不记名字、默认不启用 —— 那一行本来就是「让上游挑」。
目录的三层兜底(为什么不能让它空)
宿主的 dsh-api-session-controller/src/catalog.ts 在 buildModelCatalog 里对每个 provider 单独 try/catch,并且 filter(group => group.models.length > 0) —— 抛错或空数组是整组从选择器消失,不是只少一行;一行解析不出上下文窗口的坏数据也能把整组拖没。所以目录有三层:
| 层 | 来源 | 什么时候用 |
|---|---|---|
| 1 | 网关 /gateway/apis/v1/models(43 个) |
正常在线 |
| 2 | ~/.dsh/dumate-state.json 的 lastCatalog |
冷启动首帧、通道还在飞 |
| 3 | 代码里的静态兜底(src/upstream.cjs FALLBACK_MODELS 22 个;适配器内再留 5 个最保守行) |
全新机器 / 断网 / inspect 直接抛 |
listModels() / resolveModel() 都不抛:目录里没有的模型按 200K 上下文保守报出来,真发请求时由上游给准确错误。回归 node tests/fresh-machine.test.mjs 就是拿「没装 App + 网络不通 + inspect 强制抛」这一最坏情况断言这一组仍有模型可列。
限流是怎么回事(实测,2026-11-16)
两次实验:
- 同一模型连发 5 次、每次约 7k token、间隔 0.7 秒 → 全部成功;
- 等 25 秒后换 5 个不同模型各发 1 次 → 前 4 次成功,第 5 次(累计第 10 次)429,86 毫秒返回。
结论:能站住的只有两条 —— 撞的时候是跨多个模型撞的(所以换模型躲不掉),以及 86ms 就拒 = 事前配额拦截、不是算力不足。
「约 10 次/分钟」这个数字我撤回。 后来按同样形状重放 12 次(约 6k token/条、间隔 700ms)、42 次极小请求、8 次×15k token,全部不触发。昨天那次多半是并发用量叠加:DSH 会话本身、标题生成与探针同时在打同一个账号。孤立探针测不出这个窗口,因为它按账号汇总所有客户端 —— 阈值不知道就写不知道,别装作知道。
所以:
- 换模型躲不掉。撞的那次正是跨 5 个模型时发生的 —— 这也是本插件不做「限流自动换模型」的原因:实测无效。
- 同一账号在别人设备上不限流、在你这里会,差别不在设备,在工作量:搭子 App 一句对话 = 1 次请求,DSH 的 agentic 会话一轮 = 10–30 次请求。
- 撞到后本插件递增等待(15 秒 → 30 秒 → 60 秒封顶,最多重试 4 次);上游给了合理的 retry-after 就尊重上游的值。
- 诊断表里有两行专门看这个:近 60 秒网关请求(含实测上限与已用百分比)与近 60 秒撞限流。觉得莫名其妙不能用时,先看这两行。
- 想要更多额度只有两条路:多个账号(插件支持账号档切换,但自动换号还没做,见改进清单),或等上游放宽。插件也不会主动做限速 —— 把请求压到某个阈值以下会让 agentic 会话慢到不可用,而这个取舍该由你决定,不该插件替你定。
限流与故障怎么处理
搭子网关会回 429 {"error":{"code":"user_rate_limit_exceeded",…}}(用户级窗口,不是账号被封)。v0.5 撞过一次:一整轮对话直接失败,原因是适配器把失败码写成了 RATE_LIMITED / UPSTREAM_ERROR —— 这两个名字不在 dsh-llm/src/error.ts 的 LLM_FAILURE_CODES 表里,而 dsh-llm-retry 插件正是按 code 决定要不要退避重试,认不出来就等于不重试。
现在的映射(tests/failure-codes.test.mjs 逐个钉住):
| 上游 | 规范码 | 会不会重试 |
|---|---|---|
| 429 | RATE_LIMIT |
✅ 退避重试,并读 retry-after 换算成 providerRetryAfterMs |
| 5xx | SERVER |
✅ |
| 连不上 / 超时 | TRANSPORT / TIMEOUT |
✅ |
| 402 积分不足 | QUOTA |
❌ 重试只是白烧一次请求 |
| 401/403 登录态被拒 | AUTH |
❌ 同上,且会提示去 App 里重新登录 |
| 流断在半截 | STREAM_CLOSED |
❌ 字节已经吐出去了,重放会让用户看到两段拼接的回答 |
策略本身保守:maxRetries=3、初始 1.5 秒、最长 20 秒、抖动 0.2 —— 猛重试只会把限流窗口拖得更长,而且每次重试都在替你烧积分。失败信息里带上游给的 gd_id 当请求号,方便对账。
撞到限流时你能做的:等几十秒(实测这个窗口很短,刚才顺序 3 次 + 并发 6 次全 200);或者这一轮先换别家的模型;反复触发就是账号配额到顶,去设置页看余额与近 24h 消耗。
已知边界
- 冷启动必须先有目录可列:DSH 的选择器「空分组直接隐藏」(
dsh-client-ui-model-selectionREADME 原文:Empty groups are hidden)。所以插件把上一次成功的模型目录写进~/.dsh/dumate-state.json的lastCatalog,listModels()在网络刷新还在飞的时候先用它顶上。tests/coldstart.test.mjs钉的是这件事本身 —— 第一帧必须在 500ms 内交得出非空目录(实测 2ms;没有缓存时退到内置的 22 行静态目录,同样非空)。以前这里写的是"0.8 秒内交出 22 个",那是三个互相打脸的数字之一,而且测试只打印耗时、从不断言,等于没钉住任何东西。 - 改了代码必须重启 DSH 才会加载新的 JS 世代;GUI 页面本身在选择器上会跟着
llm/adapters-updated/llm/models-updated重拉,不用刷新页面。 - 模式没热切换:改
mode/pollIntervalMs要重启 DSH。运行期热改只覆盖模型勾选、图片开关与显示名(那些落~/.dsh/dumate-state.json)。 - 网关 token 的寿命由上游
expired_at给(实测同一 token 会原样重复返回,本次剩 ~8 小时);插件在到期前 3 分钟换新,401 时作废重取,再失败就报「请在搭子 App 里重新登录」,不静默。 - 只支持个人版(BCE 登录)。企业版走
dumate-enterprise那套网关,未接。 - 模型的多模态标记取自上游
modalities.input,未经逐模型实测;图片输入可在面板里逐模型关。 - 同源接口
/api/dumate/state(只读)与/api/dumate/action(写入)带 Origin 校验:浏览器跨源请求被 403;不带 Origin 的本机进程能读——这类进程本来也读得到搭子自己的文件。
「选不中」怎么自查
/api/dumate/state 里多了一段 hostView,是插件去问宿主的结果,不是自己的推测:
"hostView": {
"providerCount": 12, // 宿主认到的供应商总数
"dumateListed": true, // dumate 在不在表里
"dumateName": "百度搭子 DuMate",
"models": ["glm-5", ...] // 宿主按 catalog 现在能列出的 id
}
/dumate doctor 也会把这段打出来。如果 dumateListed 是 false,问题在注册;是 true 而 models 为空,问题在目录;两者都正常而页面上看不见,就是页面还挂着旧的目录快照。
为什么 v0.1 时选择器里根本没有「百度搭子」
不是通道问题,是注册被自己拆掉了。cordis 的 ctx.effect(execute) 会立刻执行 execute,再把它返回的函数当作卸载时的 disposer。v0.1 写的是:
const registration = ctx.llm.registerAdapter([providerId], adapter);
ctx.effect(() => registration()); // ← 这个 arrow 一挂载就把 registration 调了
于是模型路由在挂载那一刻就被释放;而工具、命令、HTTP 面走的是别的注册路径,照常活着 —— 表现就是「积分能读、工具在列、模型选不到」。现在全仓统一成官方形状:
ctx.effect(function* () {
const registration = ctx.llm.registerAdapter([providerId], adapter);
yield () => registration(); // 卸载时才跑
});
对照实验(真 cordis):arrow 那种挂载当场就 bReleased=true;生成器那种挂载 cReleased=false、显式 dispose 后才 true。生命周期回归:node tests/lifecycle.test.mjs(假 ctx 走同一套语义,断言挂载后 providers=[dumate] + 两条路由在位 + 发过 llm/models-updated,卸载后全部释放),输出 PASS。
验证状态(2026-11-15,本机 Windows)
已实测:云端网关目录 43 个 + glm-5 非流式 200 + 流式 SSE + include_usage 生效;mode=gateway/auto/local 三条自检都 ok=true;积分余额、四个积分包、7 天消耗、今日签到状态都读通(这些是账号专属数字,不写进公开文档);勾选开关与 action=bogus 的报错路径;适配器离线 SSE 桩(消息映射 / StreamChunk 顺序 / usage 折算);生命周期 harness 与冷启动 harness(第一帧就交出 22 个模型)。
需要在 GUI 里确认:重启 DSH 后模型选择器出现「百度搭子 DuMate」分组并可选中、输入框胶囊渲染、真跑一轮对话。把搭子 App 完全退出后再跑一次才算证明「不开就能用」这条。
免责声明
- 本插件是独立的第三方项目,与百度、与 DeepSeek Harness 官方均无隶属、背书或赞助关系。「百度搭子 / DuMate」及其相关名称、商标归其权利人所有。
- 插件依赖搭子客户端的非公开接口,这些接口可能随时变更、限制或关闭,届时插件会失效且不一定能及时跟进。安装即表示你接受这一不确定性。
- 使用本插件产生的每一次模型调用都会真实消耗你自己账号的积分;每日签到会真实领取当日奖励。所有涉及花费或改变账号状态的动作都需要你显式触发或显式开启开关,插件不会自行发起。
- 因使用本插件导致的账号限流、功能受限、积分异常、数据丢失或其他后果,本项目的作者不承担责任。若你判断账号风险不可接受,请只使用官方桌面版客户端。
- 本插件按 MIT 许可证发布,按「现状」提供,不含任何明示或暗示的保证。
- 登录凭据(Cookie)的处理边界见 docs/PRIVACY.md:明文不落盘、不写日志、不回传页面;加密用的密钥与你的账号信息不会随包发布。
致谢
- dsh-connect-workbuddy —— 本插件的宿主接口用法(
registerAdapter/registerConfigurableProviders/registerModelDiscovery的注册顺序与settingsNs约定)是逐行读它的源码核对出来的;它的发布文档、隐私文档与测试纪律也是这个项目的参照对象。若干具体设计(写完回读校验、探测失败返回 null 而不是猜、版本围栏的上界写法、文案不得互相污染分类关键词)直接来自它的已知限制与变更记录。 - dsh-connect-trae —— 同源 HTTP 面与设置页分栏的组织方式参考。
- DeepSeek Harness 与其
@deepseek-ai/dsh-*包 —— 提供插件模型、模型目录与适配器契约。 - 百度搭子(DuMate) 桌面客户端 —— 本插件复用它在本机的既有登录态,不与其争用任何文件。
许可
MIT。见 LICENSE。本包没有第三方运行时依赖(不 import 任何 DSH 包,也不捆绑原生 SDK),原因见上文「为什么 v0.1 时选择器里根本没有『百度搭子』」。
No comments yet. Be the first to write one.