DSH Connect Trae Models

多账号 Trae 模型池插件：把本机所有 Trae 登录态聚合成 DeepSeek Harness 里的一个模型供应商， 请求在账号池内自动容错换号，并配套手动/自动签到、模型倍率显示、账号使用方式切换（自动轮转 + 手动钉号）与可选模型配置页面。

装上之后，模型选择器里会出现两个分组：Trae Connect Models（国内版） 和 Trae Connect Models（国际版）（provider id connect-trae-models / connect-trae-models-global）。

和单账号连接插件的区别：dsh-connect-trae 是「一次一个账号」。本插件把多账号当默认情况 —— 不挑号、不手动导入，本机 Trae 所有历史登录快照全部收进一个共享池，对外用一个 provider 分组， 池内自动容错。

---

功能

一、多账号池：自动换号，也手动钉号

池子走自动发现：Trae 桌面端每次登录都会在本机留下一个带令牌的快照，本插件扫描 四个 Trae edition × 三个平台 + CLI home 的候选路径，把每个账号都收进池。所以 多账号 = 在 Trae 客户端里换着登几次，之后点卡片上的「重新检测账号」或重启 DSH，新号就自动进池。

探测的客户端（凭据只读，插件从不索要你的密码）：

Edition	macOS / Linux	Windows（取自 product.json 的 win32DirName）
国内	Trae CN	Trae CN / trae-cn
国际	Trae	Trae
SOLO 国内	TRAE SOLO CN	TRAE SOLO CN / trae-solo-cn
SOLO 国际	TRAE SOLO	TRAE SOLO

另加 CLI 令牌文件（$HOME/.trae-cn/trae-jwt-token、$HOME/.trae/trae-jwt-token）作为兜底候选。

账号使用方式（自动） —— 卡片上「账号使用方式」下拉，五种：

方式	行为	适合
优先（默认）	一直打同一个号，直到被限流或积分耗尽才换下一个	单号额度大、想尽快用完一个
轮换	连续请求依次轮过每个号，花费均摊	多个号额度差不多，想均匀消耗
均衡	随机，按闲置时长加权	有一个号不稳定时，不让它把整池拖住
粘性	一个对话固定一个账号，新对话才换	想保住 prompt 缓存命中率（上游缓存按账号隔离，对话中途换号会整段作废）
到期优先	先花快要过期的积分	有临期积分包，别让它作废

账号使用方式（手动） —— 对话栏积分面板里点「切换用户」钉住某个账号，或点 「使用自动轮转」取消钉选。钉选只改本机派活顺序，不改上游状态、不写凭据；钉到一个 不在池里的账号会被拒绝（否则请求会一直等一个永远不会被派活的号）。

自动与手动的关系：手动钉号只影响「下一次该谁上」，不关掉自动容错。钉住的号一旦 被限流、欠费或登录失效，shim 会在同一个请求内换号重试，429 不会以「对话失败」的形式 到达用户。

二、签到：手动与自动

手动签到：卡片每个账号行一个「立即签到」按钮，四态区分得很死：

状态	按钮	含义
可领取	可点	「可签到领 N 积分」
账号级已领	禁用	这个账号今天的奖励已到账
设备级已用	禁用	这台机器用掉了今天的名额（很可能是为别的账号用的）
活动未开启	禁用	上游当前关闭签到活动

账号级与设备级刻意分开。didCheckedIn（设备级）当成「今天签过了」是一个已发生过的缺陷—— 切换账号后按钮变灰，而新账号其实一分未得。

自动签到：卡片「积分自动化」区一个总开关（写进 settings，改完立即生效）+「立即运行」。 默认关闭；开启后按北京时区的小时表跑（默认 9，可改成多个小时）。

• 只自动签到这一件事。其它 Trae 奖励需要客户端里的真实活动，插件不假装能做。
• 不跳过冷却中的账号：签到走独立的 pay/ug 端点，不该被对话路由的 429 连坐。只跳过 用户手动禁用和 ai 区域的账号。
• 每日收益有账本：今日赚到多少、逐账号明细、触发过的时段数，都会写进 automationEarnings。

三、模型与倍率

• 模型名册优先取上游网关的实时列表；上游离线时回退内置静态名册，保证 provider 永不为空（国内 4 个 + 国际 7 个模型）。卡片上会标明当前名册是「来自网关」还是「内置回退」。
• 倍率画进模型名：DeepSeek-V4-Pro · x0.08 这种写法，和 Trae 自家选择器一致。 卡片「模型管理」区逐模型显示 x{倍率}，multiplier === 0 的显示「免费」。
• 模型管理：逐模型开关「启用」、打开「图像输入」、设「上下文预算」（上限只能是上游 宣告的原生窗口，绝不虚构更大的数）。保存只影响当前区域，另一个标签页各自一份。
• 上下文窗口每个模型都必有值——缺了会让 DSH 以 INVALID_MODEL_CONTEXT 拖垮整条路由。

四、积分包到期提醒

三种状态刻意分开，不把「还没看」当成「马上到期」：

情况	展示
有包 ≤3 天到期	橙色「N 天后到期 · 剩 M 积分」，合计旁另加汇总徽标
有包 3 天以后到期	弱色只报到期时间（不告警）
所有包都已过期	灰显最近一笔「已于 … 过期」
没有任何带 end_time 的包	明说「没有带截止时间的积分包」，绝不误报

---

安装

前置条件：装好 Trae 客户端并登录（插件复用它存在本机的登录态，从不索要密码）。 多账号 = 在客户端里换着登几次。

方式一：从 npm 安装（发布后可用）

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

推荐 npm：需要拉取的依赖只有插件自己（1 个包，几秒搞定）。从 GitHub 源码装会连带装 开发依赖（构建器、测试框架等几百个包），慢得多。

方式二：从本地源码安装（开发者）

dsh plugin --profile desktop add /absolute/path/to/dsh-connect-trae-models

本地路径必须是绝对路径（宿主会拒绝相对路径）；file: 与 link: 前缀都等价于绝对路径。 这种装法是软链到工作目录，改完 pnpm build 再重启 DSH 就生效，不需要反复重装。 dsh plugin add 用的是包名，不是目录名。

方式三：从 Git 仓库安装

dsh plugin --profile desktop add github:<owner>/dsh-connect-trae-models

也接受 gitlab: / bitbucket: / gist: 简写、完整 git URL、https:// 仓库地址， 以及 .tgz / .tar.gz tarball。注意：插件的 .gitignore 故意不忽略 lib/， 构建产物随源码提交，所以从仓库装不需要任何安装期脚本，也不会弹 pnpm 那句「构建脚本被拦截」。

手动注册 bundle（一般用不到）

dsh plugin add 会自动把带 dsh.bundle.patch 的包装进 profile 的 bundles。 只有在你手工编辑过 profile、或装的是一个不带 bundle 元数据的包装时才需要手动补：

# 编辑 ~/.dsh/profiles/desktop/package.json，
# 在 "dsh" → "profile" → "bundles" 数组末尾加上 "dsh-connect-trae-models"，然后重启 DSH

Web / TUI profile 同样可用（--profile web / --profile dsh-tui）。

本地构建

npx pnpm@11 install --config.confirmModulesPurge=false --config.minimumReleaseAge=0
pnpm build        # tsdown：lib/index.js（宿主 ESM）+ lib/client.js（浏览器 CJS）
pnpm typecheck    # 宿主侧 + 客户端侧 tsc --noEmit
pnpm test         # vitest run，322 项

改了 src/ 记得重新 pnpm build——lib/ 是提交物，用户拿到的是构建产物，不是源码。

装完之后

• 模型选择器里出现 Trae Connect Models（国内版） 与 Trae Connect Models（国际版） 两个分组。
• 设置面板：从侧边栏的设置入口打开（宿主自有入口，位置随 DSH 版本而定），导航里选 Trae Models 那一栏（row.navLabel）。能看到池健康、每个账号的令牌/积分/签到/冷却状态， 还有「重新检测账号」「清除所有冷却」按钮。
• 对话栏积分面板：显示当前账号可用积分，点开可钉号。

---

配置

配置走插件设置节（命名空间 connect-trae-models），在设置面板里改完立即生效、不用重启。

字段	说明	默认
authFile	覆盖 Trae 凭据文件路径（自动探测失灵时救急）	自动探测
cooldownMs	单账号 429 冷却时长（毫秒）	60000
distribution	账号使用方式：priority / round-robin / balanced / sticky / expiry	priority
disabledAccountIds	不参与轮转的账号（等同卡片上的启用开关）	空
creditReserves	每账号保留积分（用完就停派活，留给手动签到）	空
modelSelectionCn / modelSelectionGlobal	逐区域的模型选择（启用 / 图像 / 上下文预算）	全部启用
automation.enabled	自动签到总开关	false
automation.checkinHours	自动签到的北京时区小时表	[9]

也可以直接写进 ~/.dsh/profiles/desktop/package.json：

{
  "connect-trae-models": {
    "cooldownMs": 120000,
    "distribution": "sticky",
    "automation": { "enabled": true, "checkinHours": [9, 20] }
  }
}

两个区域绝不开花：国内版与国际版走不同的网关，账号和积分都不通用。两个 provider 各服务各的名册，ai 账号绝不会被国内名册播种。一个区域没登录时，另一侧照常工作。

---

架构

五件套，数据流为「发现 → 分桶 → 换号 → 路由 → 自动化」：

Trae 桌面 / CLI 凭据
      │  auth.ts · paths.ts · decrypt.ts · identity.ts · refresh.ts   ← 发现层
      ▼
   pool.ts   多账号池（每区域一份冷却 / 积分 / 绑定账本）
      │  acquire(modelId, region, conversationKey) → 一个健康账号
      ▼
   shim.ts   回环 OpenAI 端点（同一请求内换号重试）
      │  POST /v1/chat/completions → 上游 chatStream
      ▼
  adapter.ts  pi-ai 路由（两个 provider 各一）
      │
      ▼
  DSH LLM seam  →  模型选择器（catalog.ts）

模块	职责	关键不变量
pool.ts	收集全部 Trae 账号，按区域（cn / ai）分桶，维护冷却与积分账本，按 5 种方式派发账号	冷却分「整账号」（欠费/登录被拒）与「模型级」（429）两类；region 绝不串区
shim.ts	本机回环 HTTP 端点，把 pi-ai 的 OpenAI 请求转发到上游；在同一请求内换号重试	随机端口 + 进程内 secret（常量时间比较）+ Host/Origin 回环校验；池空时给可操作的错误而非笼统 401
adapter.ts	把 shim 装配成两个 pi-ai provider	每模型 contextWindow 必有值；显示名带倍率后缀仅供展示，不影响路由与 wire 解析
catalog.ts	模型目录：上游实时名册 + 静态回退 + 用户选择/预算	上游离线时回退名册；窗口绝不虚构（预算只能抬到上游宣告的 Max）
scheduler.ts	签到自动化（唯一的可自动写操作）	默认关闭；不跳过冷却账号；只跳过用户禁用与 ai 区域账号
web-status.ts	卡片后端：状态、重扫账号、清冷却、签到、模型保存、启停账号、钉号、立即跑自动化	每个写端点都校验回环 Origin；钉到不存在的账号返回 404

装配入口是 src/index.ts 的 apply()：inject = ['llm', 'settings']，装配 core → 注册两个 provider/adapter → 挂 settings 卡片 → 应用一次已保存配置 → 后台播种目录 → 注入本机身份（deviceId 是签到 x-device-id 的判定量）→ 启动调度器。每一步失败都只影响 它自己，绝不阻断其余部分：模型路由必须在离线上游下也能立起来。

设置卡片兼容两条宿主线路：0.1.5 的 settings.installSection 与 0.1.7 的 settings.configure({auto})（后者把编辑广播成 loader/volatile-update 事件）。两条都探测， 只认一条会让另一个版本上线卡片静默消失。

---

已知限制

• 国内版与国际版是两套完全独立的账号体系，不能共享账号或积分，也不能交叉派活。
• 只有签到能自动化。Trae 的其它奖励需要客户端里的真实活动，插件不伪造。
• SOLO edition 的 Windows 目录拼写依据是随包发布物的 product.json；Trae CN / trae-cn 这两个拼写在真机上的命中情况只在本机验证过，装了对应版本的用户欢迎回报。
• 凭据只驻内存。src/ 里对文件系统的操作只有 readFile（读 Trae 快照）与 readFile（读 应用自身 storage 取设备身份），没有任何写入：不写 Trae 的凭据文件，也不落盘自己的 token 副本。 刷新得到的新 token 只活在进程内，退出即丢（下次启动重新从 Trae 快照读 + 刷新）。
• 上游的排队长度不可控：实测热门模型晚高峰排队 300+ 位、request_wait_in_queue 持续 6~10 分钟，所以流读取挂起的空闲上限放宽到 15 分钟，避免「快排到了却被本地误杀」。

免责声明

本插件是你自己账号的自动化工具，不提供任何账号、额度或付费服务。请遵守 Trae 的服务条款， 仅在你有权访问的账号上使用。风险自担。

许可证

MIT（见 LICENSE）。