前言¶

DeepSeek Harness (DSH) 的核心優勢在於其插件化架構。當需要在本地環境中接入外部免費模型時，通常需要維護額外的代理服務或子進程。kilo-zen2dsh 插件通過原生適配器的方式，直接在 DSH 內部實現了對 Kilo Gateway 和 OpenCode Zen 免費模型的訪問，無需額外的本地端口或進程開銷。

是什麼¶

kilo-zen2dsh 是一個由 Xyanxhu 維護的 DSH 插件，它註冊了兩個獨立的原生 LlmAdapter：
* kilo2dsh：連接 Kilo Gateway。
* opencode2dsh：連接 OpenCode Zen。

該插件旨在解決 DSH 用戶接入免費模型時的配置複雜度問題，同時提供模型元數據的自動補全和上下文限制的自動校準。

核心功能¶

1. 原生適配運行：插件以原生方式集成，不產生子進程，也不佔用本地端口。
2. 動態模型發現：利用 Kilo 的 isFree/is_free 標誌動態發現免費模型，兼容 kilo-auto/free 和 :free 後綴。
3. 獨立 Zen 支持：提供獨立的 OpenCode Zen 適配器 (opencode2dsh)，支持從公開的能力目錄 (models.opencode.ai/api.json) 獲取模型元數據（如上下文窗口、輸出限制等），提升可用性。
4. 模型篩選機制：默認只顯示文本輸出和具備工具能力的模型，適合 DSH 智能體交互場景。
5. 穩定性保障：內置啓動重試、定期刷新、7天磁盤緩存和健康快照機制。

安裝與啓用¶

使用官方提供的 npm 包名進行安裝：

dsh plugin --profile web add @huanx/kilo-zen2dsh

安裝完成後，請重啓 dsh web 服務。

使用方法¶

1. 打開 DSH 的模型選擇器。
2. 在 kilo2dsh (Kilo) 或 opencode2dsh (Zen) 提供商組中選擇模型。
3. 如果只希望使用 Kilo，或者 Zen 網關返回 anonymous-lane 429 錯誤，可在配置中設置 zenEnabled: false。
4. 若需使用帶認證的網關 Token，請顯式設置環境變量 upstreamApiKeyEnv。

注意事項¶

• Keyless 機制：Kilo 的免費請求在傳輸時會主動抑制 Authorization 頭，Zen 的匿名兼容車道使用 Bearer public 佔位符。二者均非認證或計費繞過方案。
• 上下文限制處理：適配器會合並不同來源的上下文限制聲明，並取其中最小的正值作爲限制，以防止請求過大導致的 400 錯誤。
• 模型類型：當前僅支持文本輸出和具備工具能力的模型。
• 環境要求：需要 Node.js 20 或更高版本。
• 認證配置：默認不啓用賬號 Token，如需使用，需在配置中顯式設置 upstreamApiKeyEnv 或 zenApiKeyEnv。

結尾¶

該插件解決了 DSH 環境下直接接入免費開源模型鏈路的痛點。更多技術細節與更新，可訪問插件目錄或查看源碼倉庫。