在 DeepSeek Harness 中配置 Google Gemini
在 DSH 中配置 Google Gemini，从 Google AI Studio 创建 API Key，选择内置 Google 服务商并保存凭据。列出原生协议、端点、环境变量与模型选择步骤，说明 Google 路由与自定义 OpenAI 兼容端点的区别。测试后按认证响应和目录排查密钥、账号或模型不可用的问题。
本页内容
下面的 endpoint、协议和环境变量来自 Provider 官方文档或当前上游 Provider 源码。模型目录会变化，模型选择时以你当前 DSH 版本实际显示的 ID 为准。
开始前
先确认 DSH 已经启动（桌面端直接打开 DSH Desktop，或在终端通过 npx @deepseek-ai/dsh web 启动，默认 Web UI 地址是 http://127.0.0.1:3080）。如果 DSH 本身没有启动，先看启动排查。
不要把真实 Key 写进仓库、截图、Prompt 或公开报错信息。
获取 Google Gemini API Key
打开 Gemini API Keys，登录后创建 Key，并在离开页面前复制保存。
如果使用 YAML，变量名必须与下表的 apiKeyEnv 完全一致；变量名不是 Key 本身。
在 DSH 中添加服务商
进入 Settings → Models。如果当前目录里有 Google Gemini，选择 Add provider，再粘贴 API Key 并保存。
在 Add provider 中选择 Google。DSH 已安装的 Provider 使用 Google 原生 Generative AI 协议，应使用内置卡片，不要把原生路由硬塞进自定义 Provider 表单。
官方 Provider 指南说明，模型和服务商修改会在下一次请求生效。保存后直接创建新会话测试。
核对当前路由值
| 路由 | Provider ID | apiKeyEnv | Base URL | API |
|---|---|---|---|---|
| Google / Gemini、内置 | google | GEMINI_API_KEY | https://generativelanguage.googleapis.com/v1beta | google-generative-ai |
不要把不同区域、不同套餐或不同协议的 Key 与 Base URL 混在一起。表格里的内置路由只在你的 DSH 版本实际提供该目录时使用。
选择模型
从模型选择器的 Google 分组中选择 Gemini。Google AI Studio 的 Key 规则和模型会变化，排查 DSH 前先在 AI Studio 确认 Key 状态。
如果模型不在选择器里，不要连续猜模型名。对 OpenAI-compatible 自定义路由使用 Fetch available models；失败时再根据服务商返回的真实 ID 手动添加。
内置目录没有时：创建自定义 Provider
自定义 Provider 表单目前提供 OpenAI Completions、OpenAI Responses 和 Anthropic Messages，不等同于 Google 原生路由。
发送一次安全测试请求
选择测试工作区，创建新会话，选中刚配置的模型，然后发送：
只回复“Google Gemini 已连接”，不要修改文件，也不要运行命令。看到正常回答后，再进行需要读文件或执行工具的任务。这样可以把凭据/路由问题与工具权限问题分开。
常见错误
MISSING_CREDENTIAL
回到 Settings → Models 保存 Key；如果使用 YAML，确认 apiKeyEnv 对应的变量在 DSH 启动前已经存在。
UNKNOWN_MODEL
使用当前 Provider 下真实存在的 Model ID；不要把显示名称、别名或旧教程里的名称当成 ID。
401 / authentication failed
自定义 Provider 表单目前提供 OpenAI Completions、OpenAI Responses 和 Anthropic Messages，不等同于 Google 原生路由。
Fetch available models 为空或失败
先检查当前表单中的 Base URL、协议和 Key。如果服务商没有兼容的模型列表接口，确认模型 ID 后手动添加。
模型切换后仍像在用旧模型
已经发过请求的 Session 会保留自己的模型记录。创建新会话再验证切换结果。