前言¶
DeepSeek Harness (DSH) 遵循“一切皆插件”的理念,將本地模型接入工作流是常見需求。上游插件 dsh-connect-trae 在處理 Trae 本地環境(如未安裝、未登錄或端口不可用)時,迴環 shim 綁定失敗會導致 Harness 啓動失敗,表現爲 fatal load failure,這會阻塞整個工作流。
dsh-connect-trae-plus 是上游 v2.0.4 的加固分支(fork),由 HaydenSmith1121 維護。它保留了 Trae 側的協議、憑據處理和區域拆分邏輯,僅修復了啓動穩定性問題。本插件將本地已登錄的 Trae 模型(支持國內版與國際版)接入 DSH,並提供只讀的用量概覽與模型管理界面。
核心功能¶
本插件在 DSH 中提供了雙供應商並行接入能力,並針對區域隔離做了優化:
- 雙供應商並行接入:國內版註冊爲
trae,國際版註冊爲trae-global。兩個供應商獨立運行,互不干擾,可在不同會話中同時使用。 - 插件卡片 Tab 切換:設置卡片支持國內版/國際版獨立管理。每個 Tab 擁有獨立的賬號選擇、目錄、勾選狀態與上下文預算,切換不會影響另一側的運行時狀態。
- 倍率內嵌模型名:模型名稱按 Trae 菜單格式顯示積分倍率(如
GLM-5.2 · x0.79),刷新目錄後自動更新。 - DSH 本地工具循環:通過 Trae 的
llm_utils_chat獲取結構化的tool_calls,由 DSH 本地執行bash、read、write等工具,再將結果回傳模型。 - 安全 loopback shim:每個區域使用獨立的隨機端口和進程內 secret,真實 Trae Token 不會直接交給 pi-ai。
- 只讀用量與模型管理:國內版可查看 Work 積分與通用積分,國際版可查看訂閱狀態。這些查詢是隻讀的,不會消耗額度。
模型覆蓋範圍¶
插件目前提供的是 Trae SOLO 通道的模型,如 DeepSeek-V4-Flash-Official、GLM-5.3、Qwen3.8-Max 等。
以下 4 個模型目前來自 TraeCode(Trae IDE)通道,尚未開放到 SOLO 通道,本插件暫不支持:
deepseek-v4.1-flashglm-5.3-flashkimi-k2.8-previewqwen3.8-flash
安裝與啓用¶
推薦使用 DSH 插件命令進行安裝。安裝、更新或卸載 bundle 後,需重啓對應的 DSH 進程。
dsh plugin --profile desktop add dsh-connect-trae
適用場景與注意事項¶
- 場景:需要在 DSH 中使用本地 Trae 模型進行工具調用,或需要監控 Trae 賬號的積分/訂閱狀態。
- 權限與隔離:插件以當前 DSH 進程權限運行,Token 不會寫入 DSH 設置,而是存儲在本地加密目錄中。
- Windows 限制:Windows 默認未安裝
sqlite3,Raw Chat 能力探測會失敗並安全回退。Raw Chat 默認關閉,不影響主流程。 - 分支維護:這是加固分支。如果你不需要容錯加固,可使用上游包;若上游採納了等效修復,本分支應退役。
結語¶
dsh-connect-trae-plus 解決了上游插件在環境異常時導致 Harness 無法啓動的問題,同時保持了 Trae 官方協議的兼容性。通過雙區域並行管理與安全隔離機制,它爲本地模型接入提供了一個穩定的基礎設施。