前言¶

DSH 的擴展方式偏向插件化：不同能力可以按 profile 安裝，而不是全部寫進主程序。對於 DSH Web profile，如果需要在頁面中處理外部 provider 的 OAuth 登錄入口，@edge-sky/dsh-oauth-adapter 是一個針對性組件。

下面介紹它的定位、安裝方式和適用邊界。先說明，它提供的是 OAuth 賬戶頁和 provider 登錄入口，不負責管理憑據或維護登錄狀態。

這是什麼¶

@edge-sky/dsh-oauth-adapter 是 edge-sky 維護的 DSH 插件，許可證爲 MIT。

它爲 DSH Web profile 提供 OAuth 賬戶頁，並通過 DSH Authorization Service 暴露 pi-ai 已有的 provider 登錄流程。由於 DSH 當前未掛載 ctx.authorization 服務，該插件會手動掛載該服務。

核心功能¶

該插件支持以下 provider 的 OAuth 登錄路徑：

1. OpenAI Codex：browser callback 或 device code。
2. GitHub Copilot：GitHub 或 GitHub Enterprise device code。
3. Anthropic：browser callback，並支持 manual code/redirect fallback。
4. Kimi For Coding：device code。
5. OpenRouter：browser PKCE callback。
6. xAI：device code。

需要注意，插件本身不管理 OAuth 憑據，也不維護登錄狀態。它解決的是在 DSH Web profile 中提供一個可操作 OAuth 登錄的賬戶頁。

安裝與啓用¶

先安裝到 DSH Web profile：

dsh plugin --profile web add @edge-sky/dsh-oauth-adapter

如果沒有直接安裝 dsh 命令，也可以使用：

npx @deepseek-ai/dsh plugin --profile web add @edge-sky/dsh-oauth-adapter

安裝完成後，啓動 DSH Web：

npx @deepseek-ai/dsh web

典型用法¶

1. 執行安裝命令，將 @edge-sky/dsh-oauth-adapter 安裝到 web profile。
2. 運行 npx @deepseek-ai/dsh web 啓動 DSH。
3. 在 DSH Web profile 的 OAuth 賬戶頁選擇需要登錄的 provider。
4. 根據 provider 支持的登錄路徑完成瀏覽器回調、device code 或手動 code/redirect 回退。

經過上面的步驟，即可在 Web profile 中使用該插件提供的 OAuth 賬戶頁。

適用場景與注意¶

適合使用 DSH Web profile，並希望把 pi-ai 已有 provider 登錄入口暴露到頁面中的開發者。

使用前需要注意：

1. 該插件只提供 OAuth 賬戶頁和登錄流程入口，不保存憑據，也不維護登錄狀態。
2. 資料中說明它只在 DSH 0.1.1-rc.2 上測試過；升級 DSH 版本前，應先做兼容性檢查。
3. 作爲 DSH 插件，它會隨當前 dsh 進程權限運行。安裝前應檢查源碼，並確認 MIT 許可符合內部要求。
4. DSH 社區目錄是獨立站點，不是官方應用商店。

鏈接¶

• GitHub：https://github.com/edge-sky/dsh-oauth-adapter
• 目錄頁：以 DSH 社區目錄站點檢索 @edge-sky/dsh-oauth-adapter 爲準