DSH Keys Manager

English | 简体中文

DSH Keys Manager 是一个 DeepSeek Harness 插件，把一个提供商 API key 变成托管密钥池。它扩展而非替换 Models 页面：提供商、模型和模型选择器都在原处，只有 API key 来源移到管理器之后。

功能

密钥池与路由

• 每个提供商可配多把 key，每把有别名和健康状态。
• 一把 key 粘滞绑定到会话，新会话按轮询选择；请求失败先在同一把 key 上重试，再换到另一把。
• 指数升级的冷却恢复，上限七天。

账户与登录

• 七家 pi-ai OAuth 提供商可以以账户身份入池，而不必粘贴 key。
• 另有两条通过本插件自带的登录客户端入池：Kilo 与 Z.AI Coding Plan。
• 随附七条传输路由，服务随附 pi-ai 无法支持的提供商：Cursor、Devin、两条 Google 路由、Factory Droid 与两条 GitLab Duo 路由。

界面

• 插件详情页上提供可搜索的 Keys Manager 页面。
• 既有 Models 提供商卡片内出现"由 Keys Manager 托管"徽标。
• 额外内置提供商以普通 llm-pi-ai 路由安装——共 35 个，清单见提供商覆盖。

快速开始

安装

桌面版或 Web 版打开 插件 → 添加插件，填入 dsh-keys-manager 并点击 安装，然后选择 立即启用。这与下面的 CLI 路径装的是同一个已发布包，包内已含构建好的产物。

dsh plugin --profile web add dsh-keys-manager

一次安装得到两个 bundle：dsh-keys-manager 与 llm-omp-transports；两者都要启用——管理器负责凭据与路由，传输组件负责七条路由的线协议。安装后刷新 Web 页面，让浏览器侧代码被取到。

git clone https://github.com/btspoony/dsh-keys-manager
cd dsh-keys-manager
pnpm i
dsh plugin --profile web link .

使用

接管提供商并添加 key

1. 搜索提供商。打开 Plugins → 密钥管理 → 查看（英文 locale 下显示为 Plugins → Keys Manager → View），管理器渲染在插件详情页上。既有 DSH 提供商排在前面；插件同时附带精选的额外提供商目录，见提供商覆盖。
2. 接管提供商。对既有提供商，管理器导入当前解析出的凭据、把 broker 引用写进提供商档案，并把原 key 留在凭据存储里，以便停止接管时还原。
3. 用别名添加更多 key。每把 key 都以自己的引用存进 Harness 凭据存储；管理器状态文档从不包含 key 字面量。
4. 在三点菜单中管理 key：重命名、暂停/恢复、删除。key 行显示状态、最近使用，以及冷却中的恢复时间。
5. 在设置卡片中调整重试次数（1–3）、基础冷却与恢复宽限。

账户与登录

支持原生 OAuth 登录的提供商有两种入池方式：添加密钥保存静态 API key，添加账户则执行提供商的 OAuth 登录流程，把结果作为账户行存进同一个池。九条路由以账户身份入池：七条走 pi-ai 自己的流程，kilo 与 zai 走插件自带的客户端（设备码、粘贴 zcode:// 跳转），后两者签发的是静态凭据，只能靠重新登录续期。

API key 构成选择环——会话粘滞、轮询选择、重试切换与冷却都作用在该提供商的 key 之间；每个提供商由一条被投影的 OAuth 授权服务，账户行上的计数只反映该账户自身的成功与失败。按账户排名是后续工作。被投影的授权失败时，该账户进入冷却，池回落到它的 key；仅有 OAuth 的路由则停止服务，直到手动重新登录。

muse-code 不需要传输，也不需要自己的账户行：随附 pi-ai 的 meta 路由（openai-responses 走 https://api.meta.ai/v1）已提供它，该一致性检查是静态的，首次真实调用属于手动冒烟检查，详见已知限制。

传输路由

随附 pi-ai 无法支持的提供商由配套的 dsh-llm-omp-transports 组件提供：

• 每条路由只有一条授权，位于 llm-omp-transports/<route>——没有 key 池，也没有按账户轮换。登录在 Keys Manager 页面的 传输账户（Transport accounts）区块完成。
• 模型在构建传输包时由固定的 @oh-my-pi/[email protected] 表生成，客户端均为非官方实现。依赖前请阅读传输包文档与其已知限制。

选择与故障策略

配置与数据

管理器元数据位于：

$DSH_HOME/keys-manager/state.json

权限为仅属主可读写。内容包含别名、凭据引用、健康计数、会话绑定和提供商接管事实。API key 字面量只存在于 Harness 凭据存储；账户行同理，授权挂在它的 grantRef 之下，状态里只有非敏感元数据（邮箱、账户 ID、过期时间）。文件通过临时文件加重命名原子写入。

每个受管提供商档案的 apiKeyEnv 指向 broker 引用，例如 KEYSMGR_ZAI_CODING_CN_3FA2C1。Host 凭据层按请求用该会话选中的 key 应答这个引用。Models 页面视该档案为已配置；直接写 broker 引用会被拒绝并指向管理器。

提供商覆盖

四组，一个池：

• DSH 内置 —— 随附 DSH pi-ai 目录的路由。集合随你安装的 DSH 版本而定，因此以 Models 页面为准；其中四个不在单 key 池管理范围内（见下）。
• 插件扩展内置 —— 本插件以普通 llm-pi-ai 路由新增的 35 条。
• OAuth 账户 —— 9 条以账户而非粘贴 key 入池的路由：七条走 pi-ai 自己的流程，kilo 与 zai 由插件自带的客户端登录。
• 传输路由 —— 7 条随附 pi-ai 无法支持、由 dsh-llm-omp-transports 服务的路由。

其余 DSH 目录路由都提供 API key 凭据；你在档案里自己声明的路由（自定义 / Custom）与内置路由一样入池。

文档

英文版本：README.md · Development · Release · Known limits。

许可证

基于 MIT 许可证 发布。