dsh-tap：DeepSeek Harness 的 CodeBuddy Provider Bundle

前言¶

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在本地開發智能體時，若要接入 CodeBuddy (copilot.tencent.com) 的模型能力或使用其訂閱配額，通常需要自行處理認證、協議轉換和流量轉發。dsh-tap 插件通過本地 Loopback Tap Bridge，將這些操作封裝在本地進程內，作爲 DeepSeek Harness 的統一 Provider Bundle。

這是什麼¶

dsh-tap 是一個由 taikaikaikai-pixel 維護的非官方插件包。它將 CodeBuddy 網關集成到 DSH 中，提供模型調用、工具調用（網絡搜索、生圖）以及訂閱配額接入（TraeWork CN）的統一入口。

核心功能¶

模型清單與能力¶

插件啓動時會從網關的 /v3/config 端點動態同步模型目錄。默認模型爲 deepseek-v3。支持 18+ 模型，涵蓋 DeepSeek、智譜 GLM、Moonshot Kimi、MiniMax、騰訊混元以及自動路由。

多模態支持：12 個模型支持圖片輸入。
思考強度：多數模型支持可調的 reasoningEfforts（思考強度），可在設置卡中調節。

TraeWork CN 訂閱接入¶

v0.8.3 版本起，插件內置 TraeWork CN（訂閱額度）通道。
- 認證方式：使用自持的 ECDSA P-256 設備密鑰進行 OAuth 設備流授權，不依賴官方 IDE 憑據。
- 本地網關：在本地（127.0.0.1）運行翻譯網關，將 OpenAI 協議轉換爲 Trae 雲端協議。
- 模型提取：從本機 TRAE SOLO CN 的緩存數據庫中提取模型列表，自動同步進 DSH 選擇器。

工具集成¶

插件將 CodeBuddy 的工具註冊到 DSH 的 ctx.web 和 ctx.tools 中。
- 網絡搜索與抓取：集成 web_search 和 web_fetch 工具，用於聯網查詢。
- 圖片生成：集成 image_generate 工具，基於混元模型生圖。

OpenAI 兼容上游¶

支持通過 API Key 連接火山引擎 Ark、阿里雲百鍊等 OpenAI 兼容註冊表。

典型用法¶

1. 啓用 TraeWork CN 訂閱¶

進入 DSH 設置卡 → 插件配置 → CodeBuddy → TraeWork CN（訂閱額度）分區。
- 啓用通道。
- 點擊“登錄”進行瀏覽器授權。
- 模型將自動出現在對話模型選擇器中。

2. 配置圖片輸入橋¶

在 ~/.dsh/settings.yaml 中配置 describe-image 流式橋：

describe-image:
  baseURL: http://127.0.0.1:3901/v2
  model: glm-5v-turbo
  apiKeyEnv: CODEBUDDY_API_KEY
  apiStyle: chat-completions

3. 使用 API Key¶

通過環境變量 CODEBUDDY_API_KEY 提供憑據，或在設置卡中手動管理 Key。

注意事項¶

非官方與 BYOC：插件爲社區維護的非官方項目，BYOC（自帶密鑰）。
安全與隱私：插件文件本身不含密鑰，Token 僅存儲在 ~/.dsh/ 本地目錄。OAuth 模式下的剩餘額度爲估算值。
權限要求：插件需以當前 DSH 進程的權限運行，安裝前建議檢查源碼。

總結¶

dsh-tap 解決了在 DSH 中直接使用 CodeBuddy 模型和工具的集成問題，特別是通過本地網關透明地接入 TraeWork CN 訂閱額度。對於需要豐富模型列表和多模態能力的開發者，這是一個實用的補充方案。