DeepSeek Harness (DSH) 是一個基於插件化架構的智能體開發框架。接入外部模型通常需要編寫適配器或尋找現成方案。OpenCode Zen 提供了免費檔模型，但官方接入方式較爲繁瑣，且通常需要管理 Key。dsh-connect-opencode-free 插件旨在解決這個問題。它把 OpenCode Zen 的免費檔接入 DSH，無需 Key，並提供了可視化的管理界面。
核心功能¶
免 Key 接入 OpenCode Zen 免費檔
認證固定爲 Bearer public。爲了通過免費檔校驗，適配器會僞裝成 OpenCode CLI（特定的 User-Agent、x-opencode-session 會話 id，以及 bash/read 工具名）。注意，bash/read 是真實可執行的工具，不是佔位符，模型調用時會實際執行這兩個工具。
雙源模型發現
實時合併兩個數據源：opencode.ai/zen/v1/models（此刻真實存在哪些 id）與 models.dev/api.json 的 opencode 段（哪些免費、上下文多大、支持什麼能力）。任一源不可達仍沿用上次結論，一次網絡抖動不會讓模型憑空消失。
設置頁一鍵管理
在設置頁可以搜索、逐個啓停、全部啓用/停用。同時顯示公共額度的限流狀態與恢復時間。
三檔使用規則
默認僅使用公共額度。另外兩檔（公共優先 / 私有優先）需要先通過 Key 校驗才能選用。這允許用戶在需要時靈活切換計費來源。
一鍵寫入 Provider
把當前免費模型列表寫入 llm-pi-ai.providers.opencode-zen，方便在 DSH 的 Provider 管理中直接調用。
安裝與啓用¶
本插件是 DSH cordis 插件包，通過 profile 的 package.json 接入。
方式一：npm 安裝（推薦）
1. 進入目標 profile 目錄（如 ~/.dsh/profiles/<profile-name>/）。
2. 在 package.json 的 dependencies 中加入：
"dsh-connect-opencode-free": "^0.4.0"
- 在
dsh.profile.bundles數組中加入包名：
"dsh-connect-opencode-free"
- 在該 profile 目錄執行安裝：
pnpm install
- 重啓 dsh（如
dsh web），打開「設置 → OpenCode 免費模型」即可使用。
方式二：從源碼運行（開發態）
1. clone 本倉庫到本地。
2. 在 profile 的 package.json 的 dependencies 中用 link: 指向源碼絕對路徑：
"dsh-connect-opencode-free": "link:/absolute/path/to/dsh-connect-opencode-free"
- 同樣在
dsh.profile.bundles數組中加入包名。 - 執行
pnpm install，重啓 dsh。
依賴要求：Node ≥ 18，且宿主提供 @deepseek-ai/dsh-llm（peer 範圍 >=0.1.7-rc.1 <0.3.0）。
典型用法¶
- 打開「設置 → OpenCode 免費模型」。
- 點擊「一鍵同步」，獲取當前可用的免費模型列表。
- 根據需要配置三檔額度策略（默認爲
publicOnly）。 - 配置完成後，點擊「一鍵寫入 provider」，將模型列表寫入 Harness 的配置中。
注意事項¶
- OpenCode Zen 是第三方公開服務，其可用性、模型清單與限流策略由其運營方決定。
- 認證固定爲
Bearer public。 - 瀏覽器半邊產物由
scripts/build.mjs生成，開發態運行前需先構建。
該插件爲 DSH 用戶提供了一種便捷接入 OpenCode Zen 免費模型的方式，適合需要低成本調用大模型且對 Key 管理敏感的場景。
