前言¶
DeepSeek Harness (DSH) 核心提供了授權服務和憑證存儲,但缺少用於交互式登錄流程的 UI(例如設備碼、外部 URL、文本/機密/選擇提示)。dsh-model-account-login 插件填補了這一空白,爲 ChatGPT、Claude 等 llm-pi-ai 登錄流程提供持久化的授權界面。
插件定位¶
這是一個 Cordis composition plugin,由開發者 hongbaiqi 維護。它將 Host 端的授權服務橋接到私有 JSON-RPC 通道,並在 Web 端提供設置面板,管理登錄嘗試的狀態機。
核心功能¶
插件分爲 Host 端和 Web 客戶端兩部分:
-
Host 端
- 橋接官方
authorization服務到私有 JSON-RPC 通道/model-account-login。 - 使用
AttemptRegistry跟蹤每次登錄嘗試的狀態:running(運行中)、authorized(已授權)、cancelled(已取消)、failed(失敗)。 - 通過
credentials和settings持久化登錄結果。
- 橋接官方
-
Web 客戶端
- 在設置頁面註冊「Model Accounts」面板,每條登錄流程顯示爲一張卡片,包含已登錄/路由啓用狀態。
- 提供操作按鈕:登錄、重新登錄、退出、啓用/禁用路由。
- 進行中的登錄會展開內聯面板,展示通知、外部 URL、設備碼以及文本/機密/選擇提示。
安裝與啓用¶
這是一個 Cordis composition plugin,需要將其掛載到 DSH 的 host composition 中。
- 使用隨包附帶的
cordis.patch.yml文件進行掛載:
# cordis.patch.yml (bundled)
- insert:
- id: model-account-authorization
name: '@deepseek-ai/dsh-authorization'
inject: [credentials]
- id: model-account-login
name: 'dsh-model-account-login'
inject: [authorization, credentials, settings, connection]
- Web 客戶端入口通過
package.json中的dsh.client聲明,掛載 host row 後會自動加入 Web 模塊圖。
環境要求¶
- Node.js:>= 20
- Peer Services:需要 DSH 部署提供以下服務(版本需匹配):
@deepseek-ai/cordis^4.0.1@deepseek-ai/dsh-authorization^0.1.1-rc.2@deepseek-ai/dsh-credentials^0.1.1-rc.2@deepseek-ai/dsh-settings^0.1.1-rc.2@deepseek-ai/dsh-client-connection/dsh-client-runtime/dsh-client-ui-settings^0.1.1-rc.2react^18.2.0
注意事項¶
- 源碼狀態:當前倉庫僅發佈編譯產物(JS + 類型聲明),TypeScript 源碼尚未公開。
- 存儲位置:憑證存儲在
llm-pi-aiscope,設置存儲在llm-pi-ainamespace。
總結¶
該插件爲 DSH 提供了一套完整的模型賬號交互式登錄解決方案。通過持久化的 UI 和狀態管理,開發者可以在重啓後保持會話,並在設置頁統一管理不同模型的登錄路由。