前言¶
DSH 的扩展方式强调插件化，第三方模型登录这类能力可以做成独立插件接入。dsh-oauth-api 面向的是这类场景：在 DeepSeek Harness 的 Web 管理界面里发起第三方 OAuth 登录，保存 token，并让对应 provider 的模型出现在官方模型选择器中。
下面介绍它支持哪些 provider，以及如何在本地完成安装、登录和验证。
这是什么¶
dsh-oauth-api 是一个 out-of-tree DeepSeek Harness plugin，用于第三方 OAuth login。
它被明确描述为 community plugin，不是官方 DeepSeek 产品，也不是上游 PR。仓库路径为 hahaha-taotao/dsh-oauth-api，package.json 中的 name 为 dsh-oauth。资料中未给出独立作者字段，本文按仓库路径引用。许可证为 MIT。
核心功能¶
安装后，插件会在 Web 界面中增加一个 Settings -> OAuth 登录 视图，每个 provider 显示一张卡片。
它支持以下四组 provider：
| 设置卡片 | 模型选择器分组 | 登录方式 | 推理接口 |
|---|---|---|---|
| Grok / xAI | xai-oauth |
Device code，认证端点 auth.x.ai |
https://api.x.ai/v1/responses |
| Codex / ChatGPT | codex-oauth |
Device code，认证端点 auth.openai.com/codex |
https://chatgpt.com/backend-api/codex |
| Claude Code | claude-oauth |
PKCE，打开授权 URL 后粘贴 code#state |
https://api.anthropic.com/v1/messages |
| Kimi Code | kimi-oauth |
Device code，认证端点 auth.kimi.com |
https://api.kimi.com/coding/v1 |
token 会保存在插件自己的 store 中：
$DSH_HOME/oauth/xai.json
$DSH_HOME/oauth/codex.json
$DSH_HOME/oauth/claude.json
$DSH_HOME/oauth/kimi.json
默认 $DSH_HOME 是 ~/.dsh。
插件还会暴露两个 Cordis 行：
dsh-oauth-host
dsh-oauth-client
安装与启用¶
先克隆仓库，安装依赖并构建本地包，然后把当前目录作为插件加入 web profile：
git clone https://github.com/hahaha-taotao/dsh-oauth-api.git
cd dsh-oauth-api
pnpm install
pnpm build
dsh plugin --profile web add .
启用后，可以检查当前 web profile 的配置，确认插件是否被识别：
dsh --profile web --dump-config
在输出中确认能看到下面两行：
dsh-oauth-host
dsh-oauth-client
典型用法¶
1、启动 Web UI：
dsh web
2、打开 Settings -> OAuth 登录，在目标 provider 卡片上点击 登录。
3、完成浏览器侧登录步骤：
- Grok / xAI、Codex / ChatGPT、Kimi Code：完成 device code 流程。
- Claude Code：打开授权 URL，然后粘贴
code#state。
4、在官方模型选择器中选择对应分组：
xai-oauth
codex-oauth
claude-oauth
kimi-oauth
登录成功不会自动改变当前默认模型。需要手动在官方模型选择器里选择对应的 provider 分组。
如果使用 Grok，并且推理时提示 scope 缺失，可以重新登录一次。Grok token 需要 api:access scope。
适用场景与注意¶
适合以下场景：
- 在 DSH 的
webprofile 中统一发起第三方 OAuth 登录。 - 把 Grok / xAI、Codex / ChatGPT、Claude Code、Kimi Code 的 token 保存在插件本地 store 中。
- 通过官方模型选择器切换到对应的
*-oauth分组。
使用注意：
- 这是社区插件，不是官方 DeepSeek 产品，也不是上游 PR。
- 社区插件目录是独立站点，不等同于官方应用商店。
- 插件会以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- token 只保存在这个插件的 store 中，默认路径位于
~/.dsh/oauth/。 - 登录成功不等于切换默认模型，需要在模型选择器中选择对应 provider 分组。
相关链接¶
- GitHub 仓库：
https://github.com/hahaha-taotao/dsh-oauth-api - 插件目录线索页（未验证）：
https://www.skillhub.cn/plugins/hahaha-taotao/dsh-oauth-api
