dsh-connect-trae

把本机登录的 Trae 模型接入 DeepSeek Harness，并提供只读的用量/积分概览。

English · 安装 · 工作原理 · 模型覆盖范围 · 更新日志 · 问题反馈

一个独立的 DeepSeek Harness (DSH) bundle 插件。它把本机已登录的 Trae 账号（国内版与国际版均支持）接到 DSH 的模型选择器：模型负责生成结构化工具调用，bash / read / write / edit 等工具由 DSH 本地执行；同时提供只读的用量概览（国内版 Work/通用积分、国际版订阅状态）与模型管理界面。国内版与国际版是两个并行的供应商（trae / trae-global），可同时使用；插件设置卡片以 tab 区分两者，方便统一管理。

⚠️ 这是加固分支（fork）· 2.0.4-dsh.1

本包派生自 dingminhua/dsh-connect-trae v2.0.4 （commit 9c7c113），由 HaydenSmith1121/dsh-plugin-collection 维护。Trae 侧的一切均未改动——协议、凭据、区域拆分、目录、设置卡片都是上游的成果。

差异只有一处：本插件自身出问题时，不再牵连整个 Harness。 上游 2.0.4 把两个 provider、 模型目录发现、可配置目录与 teardown 注册全放在同一条 then 链里，且该链中的失败没有被观察： 回环 shim 绑定失败（Trae 未安装 / 未登录 / 端口不可用）时两个 provider 会一起静默消失， 日志只有一句不提区域、不提原因的 loopback shim failed; providers not registered； 而该链里任何其它抛出（例如 HMR 重载后 ctx.effect 落在已消失的 fiber 上）会留下未捕获拒绝， 被 DSH 的 fail-loud 处理器变成 fatal load failure 并 exit 1 —— 也就是「装了 Trae 插件 之后 Harness 起不来」。本分支让启动就绪状态可被观察（不抛异常、不挂起）、每个区域各自降级并 报出区域与真实原因、任何路径都不再产生未捕获拒绝。机制、修复清单、测试与复现方式见 FORK.md。

源码在本仓库：HaydenSmith1121/dsh-connect-trae-plus； 装出来的 tarball 由插件集合仓库托管。三个仓库怎么分工、怎么发新版见 CONTRIBUTING.md。

如果你不需要这个加固，直接装上游包即可；若上游采纳了等效修复，本分支应退役。

功能特性

• 双供应商并行接入 —— 国内版注册为 DSH 的 trae provider（DeepSeek-V4-Flash、DeepSeek-V4-Pro 等），国际版注册为 trae-global（Gemini / GPT / MiniMax 阵容），两边模型同时出现在 DSH 模型选择器里：不同会话可以各选一边，互不干扰。
• 插件卡片 tab 切换 —— 设置卡片顶部为「国内版 / 国际版」两个 tab，各含独立的账号选择、用量概览与模型管理；每个 tab 的账号、目录、勾选与未保存草稿完全隔离——在一个 tab 里切账号或刷新模型，不会触碰另一边的运行时目录与会话。
• 倍率内嵌模型名 —— 模型名称按 Trae 自身菜单的格式显示积分倍率（如 GLM-5.2 · x0.79），倍率随目录刷新更新。
• DSH 本地工具循环 —— 通过 Trae llm_utils_chat 获取待执行的结构化 tool_calls，交由 DSH 自带的本地工具执行，再将工具结果回传模型。
• 国内国际双区域自动识别 —— 自动发现 Trae CN / TRAE SOLO CN / Trae / TRAE SOLO 四个本地安装的登录账号；区域由凭证自带的 userRegion 声明自动判定（host 后缀与 edition 标签兜底），无需手动指定。
• 目录与勾选按区域隔离 —— 国内版与国际版各一套模型目录、勾选、图片开关与上下文预算，两个供应商各自读各自的槽位。
• 多账号切换 —— 支持重新读取 Token 列表并选择账号；Token 不写入 DSH 设置。
• 只读用量与模型管理 —— 国内版查看 Work 积分与通用积分，国际版查看订阅/试用状态；刷新/启用 Trae 模型；只读查询不消耗额度。
• 安全 loopback shim —— 每区域一个随机端口 + 进程内随机 secret，真实 Trae token 不交给 pi-ai。

工作原理

DSH PiAiAdapter（每个 provider 一套）
  -> 安全 loopback shim（每区域一个随机端口 + 进程内随机 secret）
  -> TraeSoloBridge
  -> 国内版 https://trae-api-cn.mchost.guru/api/agent/v3/llm_utils_chat
  -> 国际版 https://coresg-normal.trae.ai/api/agent/v3/llm_utils_chat
  -> Trae SSE / pending function_call
  -> OpenAI SSE tool_calls
  -> DSH 本地执行工具并回传结果

国内版与国际版各持一套完整的运行时栈——凭据 store、模型 catalog、wire 映射、上游客户端、回环 shim、adapter——按凭证自带的区域声明隔离可见账号，所以两个区域的账号可以同时在线、同时被不同会话使用。

用量概览走 https://api.trae.cn/trae/api/v2/pay/* 与 /trae/api/v2/ug/* 只读接口（国际账号走其自有网关的订阅状态端点）。刷新得到的 token 按区域存放在 $DSH_HOME/.trae-auth.cn.json 与 $DSH_HOME/.trae-auth.ai.json（两个账号同时在线互不覆盖；旧的单文件 .trae-auth.json 作为迁移来源保留读取）。

详见 docs/IMPLEMENTATION_PLAN.md、docs/SOLO_ROUTE_DECISION.md、docs/USAGE_API_RESEARCH.md。

模型覆盖范围

插件提供的是 Trae SOLO 通道的模型（DeepSeek-V4-Flash-Official、DeepSeek-V4-Pro-Official、GLM-5.3、GLM-5.2、Kimi-K3、MiniMax-M3、Qwen3.8-Max、Doubao-Seed-* 等），国内版与国际版均走这条通道。

以下 4 个模型目前来自 TraeCode（Trae IDE）通道，尚未开放到 SOLO 通道，因此本插件暂不支持：

模型
deepseek-v4.1-flash
glm-5.3-flash
kimi-k2.8-preview
qwen3.8-flash

这 4 个模型只在 Trae IDE 客户端内可用，插件侧没有可调用的通道。需要等官方把它们开放到 SOLO 通道后，插件才能支持。

注意区分：GLM-5.3 是支持的（走 SOLO 通道），但 glm-5.3-flash 不支持——两者是不同的模型。

如果你现在就要用这 4 个模型，请直接在 Trae IDE 本体中使用。

安装

推荐使用 DSH 插件命令安装 npm 已发布版本：

dsh plugin --profile desktop add dsh-connect-trae

或直接通过 npm 安装：

npm install dsh-connect-trae

安装、更新或卸载 bundle 后，需要重启对应的 DSH 进程。

Windows 说明

• 账号数据目录：插件读取 %APPDATA%\Trae CN / %APPDATA%\TRAE SOLO CN 下的 User\globalStorage\storage.json（与安装目录无关）。目录名与 macOS 一致，无需额外配置；若目录名对不上，可用插件配置项 authFile + edition 直接指定完整路径。
• 应用版本头：插件从安装目录 <LOCALAPPDATA>\Programs\<AppName>\resources\app\product.json 读取 appVersion，随请求发送 x-app-version / x-ide-version；读不到时这些头不发送（与旧版行为一致）。
• Raw Chat 探测（已知限制）：model-cache 依赖 sqlite3 命令行，Windows 默认未安装，Raw Chat 能力探测会失败并安全回退。Raw Chat 默认关闭，不影响主流程。
• 排查指引见 docs/WINDOWS_TOKEN_PROBE.md。

开发

pnpm install
pnpm run check   # typecheck + test + build

本地开发用 link: 安装到 desktop profile（改码后重启 DSH Desktop 生效）：

dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-connect-trae

致谢

• Wang-JQ77/dsh-trae-api（MIT）— Trae 认证、会话和模型协议研究的参照实现。

第三方开源依赖

本项目参考的与 Trae 接入直接相关的开源项目，以及它们的许可证与合规说明，见 THIRD_PARTY_NOTICES.md。引入新的 Trae 相关外部依赖或复用其他项目代码时，请同步更新该文件并遵守对应许可证要求。

许可证

本项目采用 MIT 许可证，版权归属：Copyright (c) 2026 LaoDing。