dsh-connect-trae

dsh plugin --profile web add dsh-connect-trae

<p align="center">

<img src="docs/assets/dsh-connect-trae-usage-card.png" width="860" alt="dsh-connect-trae settings panel" />

</p>

<h1 align="center">dsh-connect-trae</h1>

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

<p align="center">

<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>

</p>

<p align="center">

<a href="https://www.npmjs.com/package/dsh-connect-trae"><img src="https://img.shields.io/npm/v/dsh-connect-trae?style=flat-square&label=npm&color=cb3837" alt="npm version"></a>

<a href="https://www.npmjs.com/package/dsh-connect-trae"><img src="https://img.shields.io/npm/d18m/dsh-connect-trae?style=flat-square&label=downloads&color=cb3837" alt="npm downloads"></a>

<a href="https://github.com/dingminhua/dsh-connect-trae/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/dingminhua/dsh-connect-trae/ci.yml?branch=main&style=flat-square&label=tests" alt="test status"></a>

<a href="LICENSE"><img src="https://img.shields.io/github/license/dingminhua/dsh-connect-trae?style=flat-square" alt="MIT license"></a>

<a href="https://github.com/dingminhua/dsh-connect-trae/stargazers"><img src="https://img.shields.io/github/stars/dingminhua/dsh-connect-trae?style=flat-square" alt="GitHub stars"></a>

<a href="https://dshfind.com/plugins/dingminhua/dsh-connect-trae"><img src="https://dshfind.com/api/badge/dingminhua/dsh-connect-trae" alt="dshfind plugin"></a>

</p>

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

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

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

边界：本插件不与任何其它插件联动。 账号、凭据、模型目录、账号池与设置命名空间都只属于本插件；trae 失败不会借用别的插件的账号或额度，反之亦然。理由与具体含义见[与其它插件的关系](#与其它插件的关系)。

功能特性

• 三供应商并行接入 —— 国内版注册为 DSH 的 trae provider（DeepSeek-V4-Flash、DeepSeek-V4-Pro 等），企业版注册为 trae-enterprise，国际版注册为 trae-global（Gemini / GPT / MiniMax 阵容），三边模型同时出现在 DSH 模型选择器里：不同会话可以各选一边，互不干扰。
• 企业版是独立计费通道，不是国内版的别名 —— 同一张 CN 凭据若属于 tob_online 租户，会被两个网关同时服务：消费池（扣个人积分）与租户池（扣企业额度）。同一模型、两种付费方，所以「谁付钱」由你显式选，插件不替你猜。trae 永不碰企业网关；trae-enterprise 不回落，被拒绝就如实报错，不会悄悄改用个人额度重跑。企业版默认关闭——纯个人账号用不了企业池，默认放开等于塞一条一用就失败的 provider。
• 可单独关闭任一面板 —— 三个 tab 各带一个勾选（国内版与国际版默认勾选，企业版默认不勾）：取消勾选即把该面板的供应商整个从 DSH 模型选择器撤掉（不是只藏起 tab），并且不再发起任何请求；重新勾选即恢复，账号、目录、勾选与上下文预算全部保留。用不到国际版就把国际版关掉即可。
• 设置页 tab 切换 —— 设置页顶部为「国内版 / 企业版 / 国际版」三个 tab，各含独立的账号选择、用量概览与模型管理；每个 tab 的账号、目录、勾选与未保存草稿完全隔离——在一个 tab 里切账号或刷新模型，不会触碰另一边的运行时目录与会话。国内版与企业版共用同一份 CN 凭据池，但各有各的账号绑定与模型勾选：两个池的名录并不相同（DeepSeek-V4.1-Flash 只有企业池列），所以勾选互不覆盖。
• 卡片内再按「账号 / 模型 / 诊断」分栏（学自同族 dsh-connect-workbuddy）—— 上面那排地区是作用域（这张卡片讲的是哪个供应商），这一排是同一张卡片里的分栏：账号栏管「谁在服务、还剩多少、签到与账号池」，模型栏管「勾哪些模型、图片输入、上下文预算、保存」，诊断栏只读地列出面板名、供应商 id、服务账号、两种令牌到期时间、目录/已启用模型数、账号池与签到支持与否，以及本面板最近一次报错的原文。4.4.7 起诊断栏还多一行「损坏副本留存」：读不出来、因此被改名留存的账号副本会在这里被点名（连同它曾经保存了几个账号）——被顶掉的账号「去哪了」这个问题，从此不用再去 ~/.dsh 里翻文件名；未登录那一屏也会显示同一条通知，因为账号消失之后用户落地的正是那一屏。分栏的理由是提交语义不同：账号改动点一下即生效，模型改动是草稿、必须点「保存」——一列长页会把保存按钮放到离它要保存的东西三屏之外。切栏不重新拉取、不丢未保存的模型草稿、账号池日志也不重建；未登录时不出分栏，那一屏说明不会被看不见的 tab 藏起来。模型栏把所有模型一次性铺开，没有内层滚动条——不再是一个套在滚动页面里的小窗口，唯一滚动的就是卡片自己那一页。
• 账号池：自动选号 + 失败换号（默认关闭） —— 本机读完几个账号后，「该用谁的额度」可以交给插件按规则排序：先排除不可用的（凭据被拒、套餐不覆盖、账号已不存在、限流未到重试时间、额度耗尽），再在可用账号里优先快到期的那点额度（与其放着过期，不如先花掉），最后才比总额、token 新鲜度，并以账号 id 兜底成全序（同样的输入永远得到同样的顺序，不会在两行之间来回抖）。三个面板各有各的池：国内版与企业版共用同一份 CN 凭据，但企业版只挑租户账号、国内版不会漂到租户号上。开着池时，发请求前先按上面的顺序选中一个账号，并且真实请求失败会换下一个账号重试（最多 3 个）——只有账号级失败才换（401 凭据被拒、额度耗尽、限流、上游 5xx）；模型 id 写错、请求本身不合法不换号，因为那不是账号的问题，换号只会把同一个错误烧两遍、还冤枉一个没机会服务的账号。换号失败的真相会写进池的探针记录，下一次排序直接把它排到后面，而每一次结论都能在卡片上看到：可用 / 限流 / 额度耗尽 / 凭据被拒 / 套餐不覆盖 / 上游不提供 / 本次未测出，以及「什么时候可以重试」。关掉池就回到严格绑定，不会有任何残留 override。卡片里的「全部测速」会把每个成员按目标模型各测一次，结果边跑边显示（一行一个答案，不等整批跑完），并落盘成下次排序的依据。

> 池是显式选择：默认关闭。它不会替你在没打开池的情况下换账号——「换账号等于换人计费」，所以这件事只能由你点头。池打开后卡片会明确写出当前是谁在付费（Host 报告的是「下一个真正发送请求的账号」，不是保存的那个绑定）。

• 倍率内嵌模型名 —— 模型名称按 Trae 自身菜单的格式显示积分倍率（如 GLM-5.2 · x0.79），倍率随目录刷新更新。
• 活动优惠徽标 —— Trae 把促销规则发在目录里（activity_discount：折扣比例、原价、闲时时段与时区），插件按当前时钟判定后，在模型名旁边画一枚胶囊：5 折 / 闲时 5 折 / 限时 5 折，悬停写明原价、现价与时段。判定放在渲染时刻而不是解析时刻，所以夜间折扣不会在第二天早上继续挂着；上游说「此刻没打折」就不画，不从倍率反推，也不给没有结束时间的活动编「限时」。这是纯提示：不改请求、不改计费，国际区（订阅制）没有这项数据因此不显示。详见 [docs/PROMO_BADGE.md](docs/PROMO_BADGE.md)。同一枚胶囊也画在 DSH 的模型选择器里（宿主 conversation.input.model.label 插槽），挑模型时就能看见——毕竟徽标画在设置卡片里时，你已经选完了。选择器里倍率只出现一次：名字里已有的目录倍率会被拆出来，有折扣时换成折后价（与卡片同一套时钟判定，同一份数据），打开选择器不会额外触发上游读。
• DSH 本地工具循环 —— 通过 Trae llm_utils_chat 获取待执行的结构化 tool_calls，交由 DSH 自带的本地工具执行，再将工具结果回传模型。
• 文生图（trae_draw_image） —— 把登录账号的 Trae 文生图能力接进会话：模型画一张图，插件把图片字节一起取回来、写进会话目录再显示给你。默认关闭、按面板单独开——生图真实消耗积分（实测 CN 个人版 1920x1920 一张约 8.8），所以它和识图那种「让不让看图」的开关不同，只能由你点头。协议、尺寸边界、取图那两步，以及为什么「取图」那条 GET 其实是又一次生成，见下方「[文生图](#文生图trae_draw_image)」。
• 国内国际双区域自动识别 —— 自动发现 Trae CN / TRAE SOLO CN / Trae / TRAE SOLO 四个本地安装的登录账号；区域由凭证自带的 userRegion 声明自动判定（host 后缀与 edition 标签兜底），无需手动指定。**美国区（userRegion: "US" / *.traeapi.us）目前「识别但不接入」**：插件不会把 US 凭据当成新加坡区发出去，而会在账号面板明确写「美国区（US）暂不支持」并点名账号，同时说明重新登录不会改变结果（issue #66）。
• 目录与勾选按面板隔离 —— 三个面板各一套模型目录、勾选、图片开关与上下文预算，各自读各自的槽位。名录从该面板所钉的那条网关读取——原本钉在企业池的客户端去读消费池名录，会永远发现不了自己池的独占模型。
• 识图能力跟随 Trae 自身的标注 —— Trae 把某个模型标为 multimodal 时，插件直接按多模态对外声明，无需你在卡片上逐一手勾（issue #16）。判据是「你手动勾选的 ∪ Trae 标注多模态的」：Trae 明确标 false 或未标注的模型保持纯文本，你可以照旧手动为它们打开图片输入。卡片上被自动开启的那一行显示为已勾选且只读，并说明原因。详见下方「图片输入（识图）」。
• 多账号切换

…(truncated)