前言¶
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 过滤，影响长链路推理连贯性。
