dsh-connect-trae

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

一个独立的 DeepSeek Harness (DSH) bundle 插件。它把本机已登录的 Trae 中国区账号接到 DSH 的模型选择器：模型负责生成结构化工具调用，bash / read / write / edit 等工具由 DSH 本地执行；同时提供只读的 Work/通用积分与模型管理界面。

功能特性

Trae 模型接入 —— 把本机登录的 Trae 模型注册为 DSH 的 trae provider，模型选择器出现 DeepSeek-V4-Flash、DeepSeek-V4-Pro 等。
倍率内嵌模型名 —— 模型名称按 Trae 自身菜单的格式显示积分倍率（如 GLM-5.2 · x0.79），倍率随目录刷新更新。
DSH 本地工具循环 —— 通过 Trae llm_utils_chat 获取待执行的结构化 tool_calls，交由 DSH 自带的本地工具执行，再将工具结果回传模型。
中国区多账号切换 —— 自动发现 Trae CN 与 TRAE SOLO CN 本地登录账号，支持重新读取 Token 列表并选择账号；Token 不写入 DSH 设置。
只读积分与模型管理 —— 插件设置面板可分别查看 Work 积分与 DSH 可使用的通用积分，并刷新/启用 Trae 模型；只读查询不消耗积分。
安全 loopback shim —— 随机端口 + 进程内随机 secret，真实 Trae token 不交给 pi-ai。

工作原理

▼
text
复制代码
DSH PiAiAdapter
  -> 安全 loopback shim
  -> TraeSoloBridge
  -> https://trae-api-cn.mchost.guru/api/agent/v3/llm_utils_chat
  -> Trae SSE / pending function_call
  -> OpenAI SSE tool_calls
  -> DSH 本地执行工具并回传结果

用量概览走 https://api.trae.cn/trae/api/v2/pay/* 与 /trae/api/v2/ug/* 只读接口。

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

安装

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

▼
sh
复制代码
dsh plugin --profile desktop add dsh-connect-trae

或直接通过 npm 安装：

▼
sh
复制代码
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。

开发

▼
sh
复制代码
pnpm install
pnpm run check   # typecheck + test + build

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

▼
sh
复制代码
dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-connect-trae

致谢

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

第三方开源依赖

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

许可证

dsh-connect-trae

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

功能特性

Trae 模型接入 —— 把本机登录的 Trae 模型注册为 DSH 的 trae provider，模型选择器出现 DeepSeek-V4-Flash、DeepSeek-V4-Pro 等。

倍率内嵌模型名 —— 模型名称按 Trae 自身菜单的格式显示积分倍率（如 GLM-5.2 · x0.79），倍率随目录刷新更新。

DSH 本地工具循环 —— 通过 Trae llm_utils_chat 获取待执行的结构化 tool_calls，交由 DSH 自带的本地工具执行，再将工具结果回传模型。

中国区多账号切换 —— 自动发现 Trae CN 与 TRAE SOLO CN 本地登录账号，支持重新读取 Token 列表并选择账号；Token 不写入 DSH 设置。

只读积分与模型管理 —— 插件设置面板可分别查看 Work 积分与 DSH 可使用的通用积分，并刷新/启用 Trae 模型；只读查询不消耗积分。

安全 loopback shim —— 随机端口 + 进程内随机 secret，真实 Trae token 不交给 pi-ai。

工作原理

▼
text
复制代码

DSH PiAiAdapter -> 安全 loopback shim -> TraeSoloBridge -> https://trae-api-cn.mchost.guru/api/agent/v3/llm_utils_chat -> Trae SSE / pending function_call -> OpenAI SSE tool_calls -> DSH 本地执行工具并回传结果

用量概览走 https://api.trae.cn/trae/api/v2/pay/* 与 /trae/api/v2/ug/* 只读接口。

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

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。