DeepSeek Harness (DSH) 遵循“一切皆插件”的理念。在 Web profile 场景下，DSH 虽然内置了 pi-ai 集成，但没有提供原生的 OAuth 登录入口。开发者若需接入第三方 AI 服务（如 GitHub Copilot、Kimi 等），通常需要手动处理复杂的授权流程。dsh-oauth-adapter 为 DSH Web profile 补全了这一功能，将现有的登录流程标准化。
这是什么¶
dsh-oauth-adapter 是一个由 edge-sky 维护的插件，旨在为 DSH Web profile 提供一个统一的 OAuth 账户页面。它通过 DSH Authorization Service 暴露了现有的提供商登录流程。DSH 拥有 OAuth 凭据和登录状态，该插件负责在 Web 界面展示授权选项，并将模型配置存储在 dsh-oauth-adapter.modelStore 中。
核心功能¶
该插件支持多个主流 AI 服务提供商，并针对不同的认证流程提供了适配：
- 多提供商支持：
- OpenAI Codex：支持浏览器回调或设备代码登录。
- GitHub Copilot：支持 GitHub 或 GitHub Enterprise 的设备代码登录。
- Anthropic：支持浏览器回调，并在失败时提供手动代码输入或重定向回退。
- Kimi For Coding：支持设备代码登录。
- OpenRouter：支持浏览器 PKCE 回调。
- xAI：支持设备代码登录。
- 授权回退机制：当宿主环境未提供
ctx.authorization时，该插件会挂载授权回退页面，确保登录流程不中断。 - 状态存储：登录状态与模型配置由 DSH 统一管理，配置存储在
dsh-oauth-adapter.modelStore中。
安装与启用¶
安装前请确保环境满足以下要求：
* Node.js：^22.19.0 或 >=24.0.0
* 依赖检查：@deepseek-ai/cordis >=4.0.4 <5，@deepseek-ai/dsh-authorization >=0.2.0-rc.2 <0.3.0-0
针对 DSH 0.2.0-rc.2 的安装命令如下：
dsh plugin --profile web add @edge-sky/dsh-oauth-adapter
对于 DSH 0.1.2-rc.1 到 0.1.5-rc.1，请使用 0.1.3 系列的适配器发布版本；对于 DSH 0.1.1-rc.2，请使用 @edge-sky/dsh-oauth-adapter@0.1.2-rc.0。
安装完成后，启动 Web profile 即可使用：
npx @deepseek-ai/dsh web
适用场景与注意¶
- 适用对象：需要在 Web 界面中集成多种第三方 AI 服务（如 Copilot、Kimi 等）的开发者，或需要统一管理 DSH 登录状态的用户。
- 权限风险：该插件以当前 DSH 进程的权限运行，涉及 OAuth 凭据与登录状态。安装前请务必检查源码与许可证（MIT）。
- 版本兼容性：插件对 DSH 版本有特定要求，安装前请确认当前 DSH 版本与插件版本是否匹配。
