前言¶

DeepSeek Harness（DSH）支持通過插件擴展模型推理能力。開發者在使用免費模型時，常遇到服務端門禁問題：OpenCode Zen 的免費模型直接請求會被 403 拒絕，必須通過真實的 OpenCode 進程發起請求。本插件通過在隔離環境中運行官方 OpenCode 二進制，並提供 OpenAI 兼容端點，解決了這一直連問題。

這是什麼¶

本插件將 OpenCode 的免費模型（big-pickle、LongCat、MiMo、Nemotron、Space Bunny 等）接入 DSH 的模型選擇器。這些模型以 opencode-xdbridge 分組顯示。同時，它在設置 → OpenCode-XD 中提供了一個可視化的交互面板。

核心功能¶

• 連接模型：將 OpenCode 免費模型接入 DSH 模型選擇器。
• 可視化面板：在設置 → OpenCode-XD 提供狀態監控和交互入口。
• 運行時管理：下載並運行官方 OpenCode 二進制，支持自動下載、斷點續傳和完整性校驗。
• 端點轉換：提供本地 OpenAI 兼容端點轉換。
• 狀態監控：提供狀態指標和模型詳情面板。
• 安全隔離：本地動作零執行（權限攔截），隔離運行時環境。
• 可用性檢測：支持模型可用性檢測，分爲不穩定（超時/限流）和不可用（鑑權/額度）。
• 自動壓縮：上下文長度自動壓縮，防止無效請求。

安裝與啓用¶

1. 確保環境滿足依賴：需要 Node.js (>=22.19.0 或 >=24.0.0) 和 DSH (>=0.1.1-rc.1)，以及 @deepseek-ai/cordis、@deepseek-ai/dsh-llm 等依賴。
2. 執行安裝命令：

    dsh plugin --profile <profile> add dsh-opencode-xdbridge

3. 重啓 DSH。

典型用法¶

1. 使用模型：重啓後，在模型選擇器中找到 opencode-xdbridge 分組，直接選擇模型進行對話。
2. 管理面板：在設置 → OpenCode-XD 中打開交互面板，查看服務狀態、模型列表和詳情。
3. 配置路徑：在 settings.yaml 中配置 dataDir、binaryPath 或 runtimeVersion，或使用環境變量 OPENCODE_BINARY_PATH 指定運行時路徑。

適用場景與注意¶

• 權限要求：運行時需要 {'*':'ask'} 權限，插件會在本地拒絕所有審批請求，僅允許轉發給 DSH。
• 上下文處理：插件不會直接報告模型的原始窗口，而是報告一個可用預算：(聲明窗口 - 輸出預留) * (1 - 15% 安全餘量)。這有助於 DSH 提前觸發壓縮，避免因窗口過大導致的無效請求。
• 下載與緩存：首次啓動約下載 57 MB 運行時（緩存），支持斷點續傳。
• 失敗分類：檢測失敗分爲“不穩定”（超時/限流，保留在列表中）和“不可用”（鑑權/額度，移除），避免因偶爾的超時誤刪可用模型。

結尾¶

該插件通過橋接官方運行時，讓 DSH 用戶能夠訪問 OpenCode 免費模型，並提供了一套可視化的管理工具。完整的源代碼和文檔位於 GitHub。