前言¶
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。
