前言¶

DeepSeek Harness (DSH) 採用插件化架構。在接入 xAI Grok 時，開發者通常需要處理訂閱授權、模型路由以及配置管理。本插件提供了獨立的 Grok 訂閱 OAuth 提供者與 Web 配置界面。它與內置的 xai console API-key 路由並存，不覆蓋原生配置，專注於訂閱級別的管理與 Web UI 交互。

核心功能¶

該插件實現了以下核心能力：

• 獨立路由與配置：提供獨立的 grok 路由和 llm-grok 設置命名空間。
• 訂閱登錄：通過 Host 擁有的 PKCE 流程與 auth.x.ai 交互，會話存儲於 $DSH_HOME/grok-oauth。
• 模型管理：支持官方 grok-4.6 和 grok-4.5 模型，可通過 Web 界面重排、編輯或刪除模型目錄。
• 上下文與思考：上下文窗口用作 DSH 壓縮預算，支持默認思考配置。
• 訂閱使用量：在 Grok 卡片中顯示訂閱額度使用情況。
• 服務端搜索工具：集成 web_search 和 x_search，但非 ctx.web 提供者。
• 圖片生成（可選）：在安裝 dsh-model-switch v0.4.x 後，提供可選的 grok_image_gen 圖片生成功能。

安裝與啓用¶

安裝前需確保已安裝 dsh-llm-providers-ui 以顯示 LLM 提供者卡片。

dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.9/dsh-llm-providers-ui-0.2.9.tgz
dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-llm-grok/releases/download/v0.3.17/dsh-llm-grok-0.3.17.tgz
dsh web

配置與使用¶

1. 登錄：打開 Settings -> LLM Providers -> Grok，點擊 Sign in with xAI。系統將啓動 Host 擁有的 PKCE 流程，會話僅存儲於 Host 本地。
2. 模型目錄：卡片顯示當前賬戶的模型列表。你可以摺疊目錄，編輯默認思考配置，或調整上下文窗口（默認爲 500,000 tokens）。
3. 搜索：聊天請求會自動包含服務端搜索工具。注意搜索結果不作爲 ctx.web 提供者，且服務端返回的推理項爲加密格式。
4. 圖片生成（可選）：若安裝了 dsh-model-switch v0.4.x，可在設置中啓用 grok_image_gen 功能，用於調用 Grok Imagine。

技術細節與注意¶

• 依賴關係：Web UI 卡片依賴 dsh-llm-providers-ui。若在 Headless 模式或無 UI 的 Web 環境下，路由 grok 仍可工作，但 Providers 頁面和卡片會被省略。
• 權限與存儲：插件不讀取 ~/.grok/auth，也不聲明 apiKeyEnv。這意味着 Models 頁面上的 Grok 行不會顯示 “missing-API-key” 徽章。
• 兼容性：已驗證兼容 DSH 0.1.2-alpha.4, 0.1.2-rc.1, 0.1.5-rc.1, 和 0.1.5-rc.2 版本。
• 重試策略：默認最大重試 8 次，支持可配置的退避策略。

總結¶

dsh-llm-grok 爲 DSH 提供了標準化的 Grok 訂閱接入方案，通過 Web 界面解決了複雜的訂閱授權和模型目錄管理問題。對於需要使用 Grok 訂閱且重視配置可視化的用戶，該插件提供了不侵入原生路由的替代方案。

GitHub 倉庫 | 插件目錄