dsh-connect-trae

<h1 align="center">dsh-connect-trae</h1> <p align="center"><b>把本机登录的 Trae 模型接入 DeepSeek Harness，并提供用量/积分概览与每日签到领取。</b></p>

<a href="README.en.md">English</a> · <a href="#安装">安装</a> · <a href="#工作原理">工作原理</a> · <a href="#模型覆盖范围">模型覆盖范围</a> · <a href="CHANGELOG.md">更新日志</a> · <a href="https://github.com/dingminhua/dsh-connect-trae/issues">问题反馈</a>

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

支持 macOS、Windows 与 Linux：CI 在 ubuntu-latest 与 windows-latest 上跑完整 typecheck / 测试 / 构建；Windows 侧的目录探测、应用版本头与锁行为均有针对性处理，详见 Windows 说明。

除每日签到领取外，插件的所有查询都是只读的、不消耗额度；签到领取也只在你点击按钮时才发生。

功能特性

• 双供应商并行接入 —— 国内版注册为 DSH 的 trae provider（DeepSeek-V4-Flash、DeepSeek-V4-Pro 等），国际版注册为 trae-global（Gemini / GPT / MiniMax 阵容），两边模型同时出现在 DSH 模型选择器里：不同会话可以各选一边，互不干扰。
• 可单独关闭任一版本 —— 两个 tab 各带一个勾选（默认都勾选）：取消勾选即把该版本的供应商整个从 DSH 模型选择器撤掉（不是只藏起 tab），并且不再发起任何请求；重新勾选即恢复，账号、目录、勾选与上下文预算全部保留。用不到国际版就把国际版关掉即可。
• 插件卡片 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 模型；只读查询不消耗额度。
• 每日签到领取 —— 国内版卡片上一键领取当日签到积分（按钮显示每日奖励，该账号已领取则显示「今日已领取」并禁用）；这是插件里唯一会改变账号状态的操作，由你主动点击触发。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/* 只读接口（国际账号走其自有网关的订阅状态端点）；每日签到领取是其中唯一的写操作，走 POST /trae/api/v2/ug/checkin_credits/claim，需要携带本机安装的设备号（x-device-id，与聊天通道同源）。该设备号也正是签到「每台设备每天一次」的判定依据，所以换账号不会重置当天名额。刷新得到的 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 通道后，插件才能支持。

…