前言¶
在 DeepSeek Harness 裏接 WorkBuddy、TRAE / TRAE CN、Qoder 等模型時，常見做法是手動填 OpenAI 兼容代理地址和 API Key，並在多個提供商之間切換配置。本機若已運行 AI-Toolkit 的本地代理，這些憑據和端口往往已在桌面應用與系統憑據庫裏維護，與 Harness 再抄一遍既重複，也容易和 AI-Toolkit 側不同步。
下面介紹社區插件 DSH Connect AI-Toolkit（倉庫 whyfail/dsh-connect-ai-toolkit）：在 DSH 中自動讀取本機 AI-Toolkit 的代理設置與密鑰，通過 GET /v1/models 發現可用模型，配置頁只保留「新會話默認模型」一項，把新會話默認值寫回 DSH 自帶的默認模型服務。
這是什麼¶
DSH Connect AI-Toolkit 由維護者 whyfail 發佈，在 SkillHub 社區目錄中歸類爲模型推理。插件供應商標識爲 ai-toolkit-connect，在 Harness 中顯示爲 AI-Toolkit（自動連接），可與已有的 ai-toolkit 通用代理配置共存。
它解決的是：Harness 與 AI-Toolkit 同機、同系統賬號運行時，免手工填寫代理 URL 與 API Key，並在插件設置裏爲之後的新會話選定默認模型；已有會話仍使用原模型，需在會話內自行切換。
核心功能¶
自動連接與憑據¶
插件只讀查詢當前用戶 ~/.ai-toolkit/ai-toolkit.db 中的本地代理端口，並通過操作系統憑據庫讀取代理 API Key。連接信息只保存在 DSH 宿主進程內存中，不寫入插件配置、不返回瀏覽器、不寫入插件日誌。賬號登錄、餘額與積分領取仍在 AI-Toolkit 的「積分與代理」中完成。
未安裝 AI-Toolkit、應用未打開或代理未開啓時，配置頁下拉框會說明如何恢復並提供下載鏈接；點擊下拉框可重新檢測。DSH 與 AI-Toolkit 應使用同一系統賬號、在同一臺機器運行；插件配置頁須在本機訪問該 DSH 宿主。
模型發現與界面¶
模型目錄來自 AI-Toolkit 代理的 GET /v1/models。連接正常時每 30 秒同步，斷線時檢查恢復；界面每 5 秒讀取宿主狀態。配置頁僅有一個「新會話默認模型」下拉框，選項保留完整模型 ID 與來源；全部模型仍出現在 DSH 會話自身的模型選擇器中，插件不會過濾目錄或改寫調用 ID。
選擇模型後會顯示對應平臺 Logo。提交後通過 DSH 公開的模型解析與默認模型服務保存並讀回確認；保存失敗或模型失效時會明確報錯。
推理與能力範圍¶
模型調用走 AI-Toolkit 的 OpenAI Chat Completions 代理，保留流式響應與 DSH 工具調用。目錄接口不包含積分餘額、價格倍率或完整能力參數，插件不展示或推斷這些數據。無元數據時使用明確的客戶端預算默認值：上下文 32,768 Token、最大輸出 4,096 Token，圖片輸入默認關閉。
插件不修改 AI-Toolkit 源碼、賬號記錄或代理配置；SQLite 使用只讀連接與 query_only。
安裝與啓用¶
兼容 DSH 0.2.1-rc.3 / 0.2.1-rc.5。先安裝桌面版 Harness 並至少打開一次；執行安裝命令前完全退出 Harness。公開安裝包當前版本見 Releases（資料中 package 版本爲 0.2.4）。須使用桌面版自帶的 CLI 管理 desktop profile；單獨通過 npm 安裝的 DSH CLI 不能管理該 profile。
macOS 桌面版¶
複製並在終端執行：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add "https://github.com/whyfail/dsh-connect-ai-toolkit/releases/latest/download/dsh-connect-ai-toolkit.tgz"
Windows 桌面版¶
已將 Harness 桌面版自帶 CLI 加入 PATH 時，在 PowerShell 執行：
dsh.cmd plugin --profile desktop add "https://github.com/whyfail/dsh-connect-ai-toolkit/releases/latest/download/dsh-connect-ai-toolkit.tgz"
命令完成後重新打開 Harness，在 插件 → dsh-connect-ai-toolkit 中啓用插件。
手動安裝包¶
也可直接下載安裝包，在 Harness 的 插件 → 添加插件 中填寫下載文件的絕對路徑，安裝並啓用。下載受限或沒有桌面 CLI 時適用此方式。版本記錄及 SHA-256 校驗文件見 Releases 頁面。
DSH 當前沒有網頁直接安裝協議；上述「一鍵安裝」指終端一條命令完成下載安裝，啓用仍由用戶在應用中確認。
典型用法¶
經過上面的安裝與啓用，可按 README 中的順序使用：
- 打開 AI-Toolkit，在「積分與代理」中連接賬號、同步模型目錄並開啓本地代理。
- 在 DSH 安裝並啓用本插件，打開 插件 → DSH Connect AI-Toolkit 配置頁。
- 在「新會話默認模型」中選擇模型；選擇結果會保存到 DSH 實際的默認模型配置，用於之後的新會話。
系統首次讀取憑據可能要求授權，允許後點擊下拉框重試。若憑據訪問被拒絕，插件會暫停自動授權重試；允許訪問後同樣通過點擊下拉框再試。
Web 側開發調試時，README 給出通過 CLI 添加本地 pack 的示例（路徑需改爲本機絕對路徑）：
dsh plugin --profile web add /absolute/path/dsh-connect-ai-toolkit-0.2.4.tgz
Electron 桌面的 desktop profile 由桌面應用管理，請通過桌面插件界面或上文桌面 CLI 安裝。
適用場景與注意¶
適合誰： 已在同一臺機器上使用 AI-Toolkit 本地代理，並希望在 Harness 裏用 WorkBuddy、TRAE / TRAE CN、Qoder 等經該代理暴露的模型，且只想維護「新會話默認模型」、不想重複填 URL 與 Key 的開發者。
運行與權限： 插件以當前 DSH 宿主進程權限運行，會讀取 ~/.ai-toolkit/ai-toolkit.db 與系統憑據庫。安裝前應自行查看倉庫源碼與 MIT 許可證（見 THIRD_PARTY_NOTICES.md）。
生態說明： DeepSeek Harness 的理念是「一切皆插件」；SkillHub 插件目錄 爲社區站點，與 DeepSeek / 幻方無官方從屬關係，不要將其等同於官方應用商店。
開發環境： 若從源碼構建，README 要求 Node.js 24.9 至 24.x；公開包通過 GitHub Releases 提供，尚未發佈到 npm。
結尾¶
DSH Connect AI-Toolkit 把本機 AI-Toolkit 代理與 Harness 的默認模型配置接在一起：自動發現模型、界面極簡，推理仍經 AI-Toolkit 調度。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
