前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在使用 New API 等第三方服务时,开发者通常面临 API Key 管理分散、模型路由配置繁琐的问题。dsh-oauth-newapi 插件通过 OAuth 协议对接 New API 站点,解决了账号认证与模型路由自动注册的痛点,将 New API 整合进 DSH 的 Model Center。
是什么¶
这是一个由 hrhgit 维护的 Model Provider 类插件。它作为一个 OAuth 提供方存在,负责在 DSH 中管理 New API 的账号、分组、令牌,并自动发现模型、注册模型路由。
核心功能¶
- New API OAuth 提供方:支持通过 OAuth 方式登录兼容的 New API 站点。
- 账号与权限管理:支持账号配置、分组管理以及令牌选择。
- 模型发现与路由:自动发现 New API 上的模型,并通过
modelEntryRegistry服务将模型路由注册到 DSH 的 Model Center。 - 安全存储:利用 DSH 的 host authorization 服务管理凭据生命周期。OAuth 凭据和 New API 令牌仅存储在主机拥有的凭据/状态存储中,不会写入
localStorage。 - 交互流支持:支持协议和模型选择流。
安装与启用¶
插件托管于 GitHub。由于未提供官方安装命令,建议通过以下方式获取:
git clone https://github.com/hrhgit/dsh-oauth-newapi.git
或通过 DSH 生态目录进行安装。启用后,在 DSH 的 Model Center 中配置即可。
典型用法¶
插件通过 settings.modelCenter.entry 槽位向 Model Center 注册条目。使用时,首先通过 OAuth 登录 New API 站点,随后在界面中选择目标分组和令牌。插件将自动发现该令牌下的可用模型,并将其作为路由条目添加到 DSH 的模型中心中,使其可直接被调用。
需要注意的是,已登录的账号作为直接 Base URL/API Key 提供方的“兄弟条目”存在,保留其特定的分组、令牌、发现机制、协议和模型选择流。
适用场景与注意¶
- 适用场景:需要统一管理 New API 实例,希望通过 OAuth 方式在 DSH 中进行身份验证和模型调用的开发者。
- 运行环境:Node.js 引擎要求为
^22.19.0 || >=24.0.0。 - 安全注意:插件仅将非敏感的浏览器草稿(如站点字段、模型搜索)存储在作用域/版本化键中。敏感的 OAuth 凭据和令牌严格存储在主机存储中。
- 开源协议:MIT 许可证。使用前请检查源码。
结尾¶
该插件为 DSH 生态中接入 New API 提供了一种标准化的 OAuth 解决方案,兼顾了安全性与易用性。更多配置细节可参考 GitHub 仓库中的 README.zh-CN.md。