前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。當需要在 Harness 中接入 xAI 的 Grok Build 模型時，手動維護配置或 Token 管理較爲繁瑣。社區開發者維護了 dsh-grok-provider，旨在讓 DSH 直接複用官方 Grok CLI 的登錄狀態，實現動態模型發現與流式推理。
這是什麼¶
這是一款社區插件，許可證爲 MIT，由 yoshino-xiao7 維護。它作爲 DeepSeek Harness 的 Build Provider，提供了官方 CLI 瀏覽器 OAuth 登錄、動態模型發現、流式推理、圖片輸入（需 grok-4.6）、工具調用以及賬戶額度面板功能。
前置條件¶
使用前需滿足以下環境要求：
- DeepSeek Harness 版本
0.1.5-rc.2 - Node.js
24.19.0或更高版本 - 安裝官方 Grok Build CLI（支持
login --oauth，並使用默認目錄~/.grok）
安裝與啓用¶
在終端執行以下命令安裝精確版本 1.0.6，並啓動 Web 界面：
dsh plugin --profile web add dsh-grok-provider@1.0.6
dsh web
登錄流程¶
啓動 Web 界面後，進入 設置 -> Grok Build。點擊“通過瀏覽器登錄”，插件會調用官方 CLI 生成登錄 URL 並在瀏覽器中打開，完成 OAuth 授權後即可。插件不接管登錄頁面，也不要求粘貼 access token 或 refresh token。
核心功能¶
- 動態模型發現：運行時讀取賬號可見的全部 Grok Build 模型，不維護靜態白名單。
- 流式推理：支持 Responses 流式文本、reasoning 及 usage 統計。
- 圖片輸入：僅
grok-4.6支持，支持 JPEG/PNG/WebP。透明 WebP 會在發送前自動轉碼爲 PNG 或 JPEG，不透明 WebP 轉爲 JPEG。 - 搜索與工具：默認關閉 Web/X Search，需在設置中開啓。工具調用交回 Harness 權限層處理。
- 賬戶面板：顯示登錄狀態、每週/月額度、重置時間及模型能力。
TUI 使用¶
在 TUI 中使用以下命令進行操作：
/grok status
/grok login
/grok cancel
/grok logout
注意事項¶
這是一個非官方社區項目，與 xAI 或 DeepSeek Harness 官方無隸屬關係。插件僅支持官方默認的 ~/.grok 目錄。依賴項包括 @deepseek-ai/cordis 4.0.2 等。
適用場景¶
適合需要在 Harness 中管理 Grok Build 賬號和模型能力的開發者。項目位於 GitHub。
