DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」，允許通過社區代碼擴展功能。dsh-grok-subscription 是一個社區插件，它解決了在 DSH 環境中調用 Grok Build 的接入問題。該插件不依賴 xAI 官方的按量計費 API Key，而是直接讀取用戶現有的 SuperGrok 或 X Premium 賬號的訂閱資格。插件由開發者 BaronCyrus 維護，採用 MIT 許可證。
核心功能¶
該插件主要提供以下能力：
- 訂閱登錄：支持通過設備碼登錄，或直接讀取本地的
auth.json文件。登錄與續期由插件在 Host 側自動完成，不依賴grok命令行工具。 - 模型目錄同步：登錄後優先從賬號模型目錄讀取可用模型；若讀取失敗，可使用內置目錄。
- 推理檔位選擇：在模型菜單中選擇可用檔位（如 low / medium / high / xhigh），默認優先使用 high。
- 圖片輸入：在支持的模型下支持粘貼或附加圖片。
- 每週額度查看：在輸入框徽章或設置頁展示服務端返回的每週餘量。
- 會話續期與更新：當認證即將過期或被拒絕時，自動使用 refresh token 續期。
- 憑據安全：access token 僅在 Host 側使用，不會返回到瀏覽器環境。
安裝¶
在桌面版 DeepSeek Harness 中執行以下步驟：
- 打開 設置 → 插件。
- 在安裝輸入框中填入包名
dsh-grok-subscription並點擊安裝。 - 完全退出並重啓桌面應用，使插件生效。
日常使用¶
安裝並登錄後，可按以下方式操作：
- 登錄與選模型：打開 設置 → Grok 訂閱，點擊 登錄 或 讀取已保存的會話。登錄成功後，在模型選擇器中會顯示賬號可用的 Grok 模型。點擊模型旁的箭頭，可選擇具體的推理檔位。
- 帶圖提問：在支持圖片輸入的模型下（如
grok-4.7、grok-4.7-build-fast等），直接粘貼或拖拽圖片到輸入框。 - 查看額度：選擇
grok-build路由後，輸入框旁會顯示每週剩餘額度的徽章。懸停或點擊可查看詳細信息。
注意事項¶
- 賬號要求：使用前需擁有具有 Grok Build 使用資格的 SuperGrok 或 X Premium 賬號。
- 依賴關係：無需安裝 grok 命令。
- 安全性：憑據僅 Host 側使用，不會返回瀏覽器。請勿公開登錄文件、token 或原始賬號響應。
- API 穩定性：用量面板依賴未公開的實驗性接口，若上游變化，該功能可能不可用。
- 獨立性：該項目與 DeepSeek、xAI 無隸屬或背書關係。
總結¶
dsh-grok-subscription 爲 DSH 用戶提供了使用 Grok Build 的便捷入口，支持模型切換、圖片輸入及額度監控。作爲社區插件，其功能依賴於賬號權限與服務端接口，更新與維護由開發者獨立負責。
