前言¶
DeepSeek Harness (DSH) 採用插件化架構。內置的 pi-ai 通道提供了 GitHub Copilot 支持，但 Web 界面缺少設備碼登錄入口，導致通過網頁管理 Copilot 賬號與模型列表較爲不便。本插件複用 DSH 內置通道，通過 Web 設置頁補充設備碼登錄/註銷功能，並預置路由與管理模型列表的能力，讓用戶無需手動維護 API Token 即可使用 Copilot。
核心功能¶
- 設備碼登錄 / 註銷：通過網頁 + 設備碼流程完成授權，憑據由 DSH 內置憑據庫託管，支持註銷。
- 預置提供方路由：安裝後，Models 頁面自動出現
GitHub Copilot路由。 - 模型目錄兜底：首次登錄自動填充模型列表，之後僅追加不覆蓋已定製的列表。
- 管理模型列表：提供勾選式管理界面，支持新增、保留、刪除模型條目。
- 多語言支持：跟隨 DSH 設置自動切換中英文。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add @inventec/dsh-copilot-auth
安裝完成後，需重啓 DSH Web 並刷新頁面。
典型用法¶
- 打開 設置 → GHC設置（英文界面爲 GHC Settings，位於 Models 之後），點「授權登錄」。
- 在 https://github.com/login/device 輸入頁面顯示的設備碼（可一鍵複製）完成授權；SSO 組織賬號必須對組織點 Authorize，跳過則登錄不生效。
- 回到設置頁看到「已登錄」：首次登錄自動填充模型目錄，到 Models 頁選擇
GitHub Copilot路由即可使用。
重要說明¶
- 路由前綴：URL 前綴
/copilot-auth硬編碼，不可配置。 - 目錄更新策略：模型目錄採用「只增不更新」策略，合併只補充本機未見過的條目，上游對已有 ID 的元數據修正不會同步。
- 併發與恢復：併發保護爲宿主單進程內 mutex，不支持多實例/多進程操作同一目錄；等待超時後，舊預覽與配置意圖失效，需重新預覽或顯式結束舊意圖。
- 版本兼容：依賴 DSH rc 版本，實測兼容
0.1.7-rc.2至0.2.0-rc.1/rc.2，peer 依賴@deepseek-ai/cordis@^4.0.2。 - 安全性：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
結語¶
該插件通過 Web 界面補齊了 DSH 內置 Copilot 通道的使用體驗。完整文檔與源碼見下方鏈接。
