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 版本與插件版本是否匹配。
