前言¶
DeepSeek Harness (DSH) 采用插件化架构。对于想要使用 Trae (SOLO CN) 桌面版订阅模型但无法直接通过 API 访问的用户,dsh-trae-connect 插件提供了一种连接方案。它将 Trae 的预设模型通过 OpenAI 兼容端点暴露给 DSH,使得模型选择器中会出现 Trae 分组,并可直接进行对话。
核心功能¶
该插件通过一个回环 shim 实现了 Trae 与 DSH 之间的协议转换:
-
OpenAI 兼容接口
插件提供标准的/healthz、/v1/models和/v1/chat/completions接口,使 DSH 能够将其识别为标准的 OpenAI 兼容服务。 -
协议翻译
Trae 的上游接口返回 SSE 事件,插件负责将其翻译为 OpenAI 格式的chat.completion.chunk,确保 DSH 能正确解析流式响应。 -
安全隔离与凭据读取
Shim 仅绑定在127.0.0.1的随机端口,并使用 32 字节的随机 bearer token 进行验证。插件不直接读取宿主系统的加密凭据,而是读取宿主侧导出的明文凭据快照(默认路径$DSH_HOME/trae/),仅以只读方式加载,不会修改 DSH profile 当前的默认模型设置。
安装与依赖¶
安装前请确保环境满足以下要求:
- DSH 核心:需匹配
0.1.5/0.1.6/0.1.7alpha 线。 - Node.js:版本需在
^22.19.0或>=24.0.0。 - 前置条件:已安装并登录 Trae (SOLO CN) 桌面版,且已通过宿主侧脚本导出凭据快照。
执行以下命令安装插件:
dsh plugin --profile web add github:yembors64632/dsh-trae-connect
注意:Desktop / TUI 界面请将
--profile替换为desktop或tui。
使用场景与注意事项¶
本插件旨在实现个人自用方案,仅供学习与研究。
- 环境依赖:插件是照着原作者机器环境写死的,容器无法直接访问宿主的 macOS 目录。凭据必须由宿主侧脚本解密并导出为明文快照,插件只读这些快照。
- 版本兼容:DSH 核心版本不匹配会导致插件启动失败,需仔细核对版本号。
- 上游风险:Trae 的 API 为私有实现,接口变更可能导致插件失效。
- 许可与免责:项目采用 MIT 许可证。使用者需自行遵守 Trae 的服务条款,因使用本项目产生的任何后果(包括账号受限、积分消耗等)由使用者自行承担。仓库不包含任何真实账号或凭据。