前言¶
DeepSeek Harness (DSH) 的插件生態允許用戶擴展模型接入能力。dsh-vertex-argon 是一款針對 Google Gemini 4 Argon 模型的插件適配器，它提供 Google Vertex AI 和 Google Gemini Developer API 的雙通道接入支持。該插件修復了內置 pi-ai 適配器在誤傳 thinkingBudget 參數時導致的 HTTP 400 錯誤，並原生支持三種思考層級、思維摘要、v1beta1 長文本續傳以及帶簽名的多輪工具調用回放。
插件簡介¶
- 名稱：dsh-vertex-argon
- 所有者：higekibaka
- 類別：模型推理
- 許可證：MIT
- 簡介：Google Vertex AI & Gemini API Dual-Route Gemini 4 Argon Plugin for DeepSeek Harness (DSH)
安裝方法¶
在本地環境安裝該插件，需確保 DeepSeek Harness 版本滿足要求（0.1.7-rc.2, 0.2.0-rc.1, 或 0.2.0-rc.2）且 Node.js 版本爲 ^22.19.0 或 >=24.0.0。
方式一：使用 CLI 安裝
dsh plugin --profile web add dsh-vertex-argon
方式二：在 DSH 聊天框中安裝
直接在 DSH 會話中輸入以下指令：
請用 plugin_manager 的 install_bundle 安裝 dsh-vertex-argon
配置與使用¶
插件支持雙通道配置，用戶需根據實際需求選擇或同時配置。
通道 A：Google Vertex AI¶
- 在 Google Cloud 控制台獲取服務賬號 JSON 密鑰文件。
- 在系統環境變量中設置
GOOGLE_APPLICATION_CREDENTIALS，指向該 JSON 文件路徑。 - 在 DSH 模型選擇器中選擇
Vertex Argon → Gemini 4 Argon (Vertex AI)。
通道 B：Google Gemini API¶
- 在 DSH 設置中配置
GOOGLE_API_KEY。 - 在模型選擇器中選擇
Vertex Argon → Gemini 4 Argon (Gemini API)。
核心功能¶
該插件在參數處理和長文本生成上進行了優化：
- 原生思考層級：支持
LOW、MEDIUM、HIGH三檔思考層級，不再使用易導致錯誤的thinkingBudget參數。 - 思維摘要：開啓
includeThoughts: true，支持流式解析並展示思維鏈。 - 長文本續傳：啓用
v1beta1長解碼續傳機制，支持跨 64K 分段零延遲續傳。 - 工具調用簽名：保持
provider/model與thoughtSignature簽名全鏈路一致，確保多輪工具調用正常。 - 參數淨化：自動剝離
temperature、topP、topK等無效採樣參數。 - 自動檢測：自動檢測雙通道配置，無需手動修改 YAML 配置文件。
設置頁面配置¶
進入 DSH 設置 -> Vertex Argon，可實時調整以下配置項：
| 配置字段 | 說明 |
|---|---|
reasoning |
默認思考檔位（low/medium/high） |
longDecode |
是否啓用 v1beta1 長解碼續傳 |
maxTokens |
最大輸出預算，開啓長解碼後最高可設爲 524,288 |
contextWindow |
輸入、思考與輸出共享的總上下文窗口 |
已知兼容性問題¶
在使用 Google 通道代理時，該插件與 billion-context 存在已知兼容性問題，需等待上游修復或通過配置規避。
- HTTP 400 錯誤：
billion-context在向user消息追加壓縮提醒時，可能導致parts順序異常，觸發 Vertex AI 報錯。 - 簽名片段過濾：流式響應中獨立的
{ thoughtSignature }片段可能被 Google loop adapter 過濾，影響長鏈路推理連貫性。
