使用本地服务账号 JSON 接入 Vertex AI Gemini,提供原生模型设置卡片、自定义模型配置以及按模型的并发与冷却控制。
安装
# Release 预构建包
dsh plugin --profile web add "https://github.com/Z5-Bit/dsh-vertex-sa/releases/download/v0.1.4/dsh-vertex-sa-0.1.4.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Z5-Bit/dsh-vertex-sa
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
A DeepSeek Harness model provider for Vertex AI Gemini using local Google service-account JSON. Includes a native model-settings card, custom Gemini model entries, streaming/tool/image conversion, and per-model concurrency with shared rate-limit cooldown.
MIT licensed. Protocol conversion and image helpers include attributed adaptations; see THIRD_PARTY_NOTICES.md.
English guide · Releases · Security
通过本地 Service Account JSON 在 DSH 中使用 Vertex AI Gemini 模型。新安装默认提供 Gemini 4 Carbon 和 Gemini 4 Hydrogen,思考强度均为 HIGH。
安装与更新
在 DSH 中粘贴 GitHub 链接安装(推荐,无需 Git)
进入 DSH 的“插件 → 添加插件”,直接粘贴下面这个完整的 GitHub Release 地址,不要在输入框里加 dsh plugin add:
https://github.com/Z5-Bit/dsh-vertex-sa/releases/download/v0.1.4/dsh-vertex-sa-0.1.4.tgz
这是预构建安装包,不需要安装 Git、不需要 npm 账号,也不需要本地编译。DSH 会使用自己提供的包管理器安装。
如果网络无法访问 GitHub Release 附件域名,可改用同版本的 GitHub 归档链接(也不需要 Git,归档中包含预构建文件):
https://github.com/Z5-Bit/dsh-vertex-sa/archive/refs/tags/v0.1.4.tar.gz
使用 DSH 命令行时,等价命令为:
dsh plugin add https://github.com/Z5-Bit/dsh-vertex-sa/releases/download/v0.1.4/dsh-vertex-sa-0.1.4.tgz
使用裸仓库地址(需要 Git)
https://github.com/Z5-Bit/dsh-vertex-sa 和 github:Z5-Bit/dsh-vertex-sa 都会被 DSH/pnpm 识别为 Git 仓库,这条路径要求运行 DSH 的电脑能执行 git --version。公开仓库无需 GitHub 账号或 SSH 密钥。
如果提示 ERR_PNPM_GIT_RESOLVE_FAILED,且后面写着 'git' 不是内部或外部命令 / git: not found,请改用上面的 .tgz 或 .tar.gz 链接。也可以从 Git 官方网站 安装 Git 并加入 PATH,然后完全退出 DSH(包括托盘)再启动。仅添加 .git 后缀、升级 pnpm 或切换 SSH 都不能修复“找不到 git 命令”。
仓库包含预构建的 index.js / client.js,没有安装期脚本。GitHub 安装路径是否要求构建审批以宿主版本为准。
使用 ZIP 或本地目录
图形界面也可从 Release 下载 ZIP:
- 将插件解压到固定目录,确认目录内直接包含 package.json。
- 在 DSH 的“插件 → 添加插件”中填写该目录的绝对路径,安装并启用。
- 完全退出 DSH(包括托盘)后重新启动。
更新时,退出 DSH,将新版内容覆盖到原插件目录,再重新启动。插件运行期间,也可通过“添加插件”填写新版同名目录进行更新。
配置服务账号
进入“设置 → 模型 → Vertex AI · Service Account → 编辑”。
- 选择 Service Account JSON 文件,或填写文件的绝对路径。
- Google Cloud 项目可留空,默认使用密钥中的项目 ID。使用其他项目时需填写目标项目。
- 选择模型支持的区域,默认 global。
- 点击“保存配置”,选择模型并点击“测试连接”。
- 在对话模型选择器中选择 Carbon 或 Hydrogen。
服务账号需要具有目标项目的调用权限,项目需启用 Vertex AI API、计费和所选模型访问权限。连接检测检查认证及模型端点,生成请求的可用性以实际调用为准。
模型管理
| 设置 | 用途 |
|---|---|
| 添加模型 | 选择 Carbon、Hydrogen、Argon、Flash 预设,或填写自定义 Gemini 模型 ID |
| 上下文窗口 | 模型可处理的上下文容量 |
| 最大输出 Token | 单次生成预算,包含思考、工具参数和回答 |
| 思考参数 | 使用模型默认值,或启用 LOW、MEDIUM、HIGH 档位 |
| 默认思考档位 | 新配置默认 HIGH,可按模型调整 |
| 支持图片输入 | 允许通过 DSH 附件发送图片 |
Carbon 和 Hydrogen 预设的上下文窗口为 1,048,576 Token,单次输出预算为 65,536 Token。已保存的模型列表和明确设置的参数继续使用;升级后可从“添加模型”中添加 Hydrogen。
网络与并发
“连接与高级设置”提供以下选项。
- auto:优先使用代理环境变量,其次读取 Windows 系统代理。
- direct:直接连接 Google。
- HTTP(S) 代理地址:使用指定代理,例如 http://127.0.0.1:7890。
- 同模型并发请求上限:默认 2,可设置为 1 至 16。
- 流式空闲超时:控制等待网络响应的时间。
限流请求会按照服务端等待提示和有限重试策略处理,同模型请求共享冷却时间。排队期间可以取消请求。
常见问题
| 现象 | 处理方式 |
|---|---|
| 安装失败:找不到 git 命令 | 使用上面的 GitHub .tgz / .tar.gz 地址;裸仓库安装需要 Git 在 DSH 的 PATH 中 |
| 下载安装包超时 | 确认能访问链接和其重定向域名;Release 下载不通时可尝试版本归档链接,或下载 ZIP 后从本地目录安装 |
| 无法读取密钥 | 检查文件路径、JSON 类型及读取权限 |
| 401 / 403 | 检查密钥、项目权限、计费和模型访问资格 |
| 404 | 检查模型 ID 和区域 |
| 429 | 等待重试,检查项目速率和可用容量,必要时降低并发 |
| 达到输出上限 | 检查最大输出预算和思考档位 |
| 连接超时 | 检查网络、代理及超时设置 |
| 缺少 DSH 接口 | 按提示更新插件后重新启动 DSH |
DSH 版本范围为 0.2.2-rc.1 至 0.3.0 之前,启动时检查所需接口。更新及验证记录见 CHANGELOG.md。
数据与许可
配置保存密钥文件路径,私钥由本机读取,访问令牌缓存在内存中。请长期保留密钥文件和插件目录。
许可见 LICENSE 和 THIRD_PARTY_NOTICES.md。
开发与验证
开发环境使用 Node.js 24 LTS 和 npm。插件声明的最低运行版本为 Node.js 22.19.0。官方 DSH 包由宿主提供,发布包通过 peerDependencies 声明;开发依赖固定到用于回归的 0.2.2-rc.3。
npm ci --ignore-scripts
npm run verify
npm test
npm run build
npm run build 将验证构建写入 .build/,不会静默覆盖已审核的发布 bundle。发布维护者确认变更后可运行 node scripts/build.mjs --write 更新根目录 bundle 和第三方声明。npm pack --ignore-scripts 生成可供 DSH 安装的 .tgz。
测试使用模拟 HTTP、动态生成的测试密钥及隔离的插件配置,不读取真实服务账号,也不发起 Google 模型生成。测试和构建产物不进入安装包。DSH 原生版本范围与 npm peer 的预发布匹配规则不同:目前回归使用 0.2.2-rc.1/rc.2/rc.3;新的预发布元组应验证后显式加入 peer 范围。
网络安装回归通过真实 DSH 插件管理器和 pnpm,在隔离 profile 中验证裸仓库安装,以及 PATH 中没有 Git 时的 Release/版本归档安装。手动运行:npm run test:install -- --release --without-git 或 npm run test:install -- --source https://github.com/Z5-Bit/dsh-vertex-sa。需要网络;不会读取真实 DSH 配置或服务账号。
安全与数据流
私钥保留在用户选择的原始 JSON 文件内,配置只保存路径;Google OAuth 访问令牌缓存在进程内存。模型请求会把用户提交的消息、工具内容及选定图片通过 HTTPS 发送至配置的 Google Vertex AI 端点。连接检测使用 countTokens,不生成回答。不要上传真实凭证、日志或聊天历史到 Issues。
此仓库发布准备以本地 dsh-vertex-sa 0.1.3 包为基础,运行 bundle 和 src 实现保持原样;补充了仓库元数据、安装说明、构建工具与可公开运行的测试。没有安装或复制其他作者的插件副本;改编部分的原始许可在第三方声明中保留。
链接
同类插件
Ebony-Vinyl/dsh-our-free-model★ 77208
为 dsh 接入免费模型车道(含 DeepSeek V4.1 Flash、Kimi K3 等),无需登录、注册或填写 API Key,并提供本地 OpenAI 兼容网关、降级路由与用量看板。
dingminhua/dsh-connect-workbuddy★ 1681
将本机登录的 WorkBuddy 模型(国内版与国际版)接入 DSH,每次刷新按上游目录读取每个模型的积分倍率,支持逐模型图片输入开关、带自动换号的账号池、手动每日签到,以及卡片与输入框里的只读积分胶囊读数。
Alice-Marx/dsh-model-router★ 966
为 DeepSeek Harness 规划有依赖的工作包,将其分配给已配置的模型 API 或支持的厂商 CLI,并提供费用预览。
V1ki/dsh-plugin-subscriptions★ 618
把 ChatGPT(Codex)、Claude、Grok 订阅当作 DeepSeek Harness 的 LLM 提供方:设置页登录、模型目录、用量展示,以及 image_generate、video_generate 与 x_search 工具。
XDTrees/dsh-workbuddy-xdpool★ 541
把本机 WorkBuddy 桌面 App 登录过的所有账号自动并入 DSH 模型池:多账号轮换自动容错、实时积分,模型目录按模型标注积分倍率与限时免费 / 夜间折扣。
XDTrees/dsh-xdpool★ 541
把本机 WorkBuddy 桌面 App 登录过的所有账号自动并入 DSH 模型池:多账号轮换自动容错、429 冷却、实时积分,模型目录按模型标注积分倍率与限时免费 / 夜间折扣,扫码登录 13 家厂商,聚合免费额度渠道。账号重启不丢。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。