DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Z5-Bit /

Z5-Bit/dsh-vertex-sa

Verified

Vertex AI Gemini provider for DeepSeek Harness using local service-account JSON, with model settings and per-model request coordination.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@ffecfa97

dsh-vertex-sa

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:

  1. 将插件解压到固定目录,确认目录内直接包含 package.json。
  2. 在 DSH 的“插件 → 添加插件”中填写该目录的绝对路径,安装并启用。
  3. 完全退出 DSH(包括托盘)后重新启动。

更新时,退出 DSH,将新版内容覆盖到原插件目录,再重新启动。插件运行期间,也可通过“添加插件”填写新版同名目录进行更新。

配置服务账号

进入“设置 → 模型 → Vertex AI · Service Account → 编辑”。

  1. 选择 Service Account JSON 文件,或填写文件的绝对路径。
  2. Google Cloud 项目可留空,默认使用密钥中的项目 ID。使用其他项目时需填写目标项目。
  3. 选择模型支持的区域,默认 global。
  4. 点击“保存配置”,选择模型并点击“测试连接”。
  5. 在对话模型选择器中选择 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 实现保持原样;补充了仓库元数据、安装说明、构建工具与可公开运行的测试。没有安装或复制其他作者的插件副本;改编部分的原始许可在第三方声明中保留。

—/ 5

No ratings yet

Verified DSH bundle

Commit ffecfa97a2a4

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout