Passer au contenu principal
Z

dsh-vertex-sa

z5-bit/dsh-vertex-sa

Vertex AI Gemini provider using local service-account JSON, with a native model-settings card, custom model entries, and per-model concurrency and cooldown.

Installer

dsh plugin --profile web add github:z5-bit/dsh-vertex-sa

README

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 实现保持原样;补充了仓库元数据、安装说明、构建工具与可公开运行的测试。没有安装或复制其他作者的插件副本;改编部分的原始许可在第三方声明中保留。

Plugins associés