前言¶
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 的服務條款,因使用本項目產生的任何後果(包括賬號受限、積分消耗等)由使用者自行承擔。倉庫不包含任何真實賬號或憑據。