前言¶
在 DSH 裏接 xAI 模型，常見做法是配置 XAI_API_KEY，走內置 xai API 路由按密鑰計費。若你已有 xAI SuperGrok 或 X Premium 訂閱，更希望把訂閱額度用在本地對話裏，而不是單獨再開一套 API Key，就需要一條「登錄訂閱、映射成模型路由」的通路。
社區插件 dsh-xai-auth（維護者 pzyyll，分類：模型推理）通過 cli-chat-proxy 完成 OAuth 登錄，在 DSH 中提供 xai-supergrok/... 模型路由；內置 xai 路由保持不變，無需 XAI_API_KEY。
這是什麼¶
dsh-xai-auth 是 DeepSeek Harness 的插件：登錄 xAI SuperGrok（或 X Premium）訂閱後，將訂閱能力以 xai-supergrok 模型路由 暴露給 DSH 對話。倉庫已包含預構建入口 dist/index.js，從 GitHub 安裝時無需本地構建。
- 目錄頁：https://www.skillhub.cn/plugins/pzyyll/dsh-xai-auth
- 源碼：https://github.com/pzyyll/dsh-xai-auth
- 許可證：MIT（package 版本 0.1.0）
核心功能¶
下面能力均來自項目 README，安裝後可在插件頁操作。
- Sign in / Sign out：OAuth 登錄與本地憑據清除；Sign out 只刪本地憑據，不會在 xAI 側撤銷 token。
- xai-supergrok 模型列表：對話裏可選
xai-supergrok/...模型；插件頁 Refresh models 刷新列表。 - Usage：展示訂閱額度與賬單相關信息；讀取結果緩存 2 分鐘。選中
xai-supergrok模型時，聊天輸入區也會顯示剩餘額度百分比。 - 可選 API 端點：設置環境變量
GROK_OAUTH_USE_API_URL=1時，改用https://api.x.ai/v1，而不是默認的 cli-chat-proxy。
說明：列表裏展示的模型價格是短上下文 API 價，不是訂閱用量；訂閱以 Usage 爲準。
安裝與啓用¶
依賴 dsh >=0.2.0 <0.3.0。默認 profile 已包含插件所需服務。
從 GitHub 安裝（將 <profile> 換成你的 profile 名）：
dsh plugin --profile <profile> add github:pzyyll/dsh-xai-auth
倉庫自帶 dist/index.js，無需執行 build。
若從本地目錄安裝（在插件父目錄執行）：
dsh plugin --profile <profile> add ./dsh-xai-auth
本地二次構建需 mise，在包目錄內執行 mise trust、mise install，再 mise exec -- pnpm install --frozen-lockfile 與 mise exec -- pnpm run build（開發文檔要求 Node.js >=24.9.0）。
典型用法¶
- 打開 Plugins → dsh-xai-auth → Sign in。
- 在驗證頁打開鏈接並輸入代碼完成授權。
- 在對話中選擇
xai-supergrok/...模型開始聊天。
若在授權過程中刷新了頁面，需要重新點 Sign in。
適用場景與注意¶
適合：已有 SuperGrok 或 X Premium 訂閱、希望在 DSH 內統一選模型對話，且不想維護 XAI_API_KEY 的開發者。
注意：
- 插件在 當前 dsh 進程權限 下運行，安裝前請自行審閱源碼與 MIT 許可證。
- DSH 社區插件目錄（SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝來源以 GitHub 倉庫說明爲準。
- 需要繼續用 API Key 走官方
xai路由時，本插件不替換該路徑，兩者可並存。
結尾¶
dsh-xai-auth 把 xAI 訂閱登錄接到 DSH，通過 xai-supergrok 路由使用 SuperGrok，並可在插件頁查看用量。詳情與更新見 SkillHub 目錄頁 與 GitHub 倉庫。
