dsh-grok-provider

dsh plugin --profile web add dsh-grok-provider

dsh-grok-provider

[简体中文](README.md) | [English](README.en.md)

让 DeepSeek Harness 使用你已登录的官方 Grok Build 账号：动态模型发现、流式推理、图片输入、可选 Web/X Search、工具调用，以及账号额度与模型能力面板。

非官方社区项目，与 xAI 或 DeepSeek Harness 官方无隶属关系。本说明对应 dsh-grok-provider@1.0.6 制品；0.1.8 曾发布后撤回且版本号不可复用。

1.0.6 修复带透明通道的 WebP 图片在 Grok 请求前被拒绝的问题。透明 WebP 会在写入 Responses 请求前转码为 PNG，不透明 WebP 转码为 JPEG。

本 README 随 1.0.6 一起进入 npm tarball，下面的精确安装命令也固定为 1.0.6。上一份已完成供应链回读的版本为 1.0.5。

它解决什么问题

能力 · 当前实现

登录 · 调用官方 grok login --oauth；登录 URL 生成与外部浏览器打开均由官方 CLI 负责，插件不实现 OAuth grant

凭据 · 复用官方 CLI 的登录状态；插件不创建第二份 token 存储

模型 · 运行时读取账号可见的全部 Grok Build 模型，不维护静态模型白名单

对话 · Responses 流式文本、reasoning、加密 reasoning replay、usage 与 finish reason

图片 · 仅精确 grok-4.6 接收 Harness attachment 中有界的 JPEG/PNG/WebP 图片；WebP 在发送前转为 Grok 接受的 PNG/JPEG，grok-4.5 与其他模型保持 text-only

搜索 · 精确 grok-4.6 提供默认关闭的 Web/X Search；使用实时 settings service 保存开关

工具 · 将 function call 交回 Harness 权限层；Provider 本身不执行工具，关闭对应 Search 开关时保留本地 web_search / x_search

账户面板 · 登录状态、每周/月额度、重置时间、动态模型能力与 reasoning 档位

界面 · Web 设置页中英文切换；TUI 提供闭合的 /grok 命令

快速开始

1. 准备环境

• DeepSeek Harness 0.1.5-rc.2
• Node.js 24.19.0 或更高版本
• macOS arm64 或 Windows x64
• 官方 Grok Build CLI（支持 login --oauth，并使用官方默认 Grok home）

请从 Grok Build 官方文档 安装 CLI，并先确认：

grok --version
grok models

当网络可达且 OIDC discovery 成功时，首次运行 Grok CLI 会打开浏览器登录。插件只支持官方默认的 ~/.grok（Windows 为 %USERPROFILE%\.grok）目录。

2. 安装 Provider

安装精确版本：

dsh plugin --profile web add dsh-grok-provider@1.0.6
dsh web

3. 登录并选择模型

打开 设置 → Grok Build：

1. 点击“通过浏览器登录”；

2. 在官方 Grok CLI 打开的浏览器页面完成授权；

3. 返回 Harness，刷新账户面板；

4. 在模型选择器中选择当前账号可见的 Grok 模型。

插件不会接管登录页面，也不会要求粘贴 access token 或 refresh token。

使用界面

Web 设置页展示：

• 当前登录状态、Provider/Grok Build CLI 版本及登录、取消、退出操作；
• CLI 缺失或无效时的官方安装入口与“重新检测”操作；
• 已使用/剩余额度和真实周期重置时间；
• 当前账号可见模型、上下文窗口、reasoning 档位，以及图片输入、streaming 与 tool capability。
• 默认关闭且相互独立的 Web Search / X Search 开关，以及远端检索、额外用量、citation 和 prompt injection 风险提示。

当 protobuf-backed billing 返回完整的 weekly/monthly 周期但省略零值百分比时，页面会恢复为“已使用 0% / 剩余 100%”；其他不完整响应保持未知，不伪造额度。

Harness 0.1.5-rc.2 的 settings.section 没有插件图标字段。Provider 内嵌来自 @deepseek-ai/dsh-client-ui-primitives@0.1.0-rc.7、采用 MIT 许可的 IconThinkOutline16 路径几何；仅当设置对话框中的标签与 DOM 结构都精确且唯一匹配时，才用它显示 Grok Build 导航项，否则安全保留宿主齿轮。兼容层的观察器、标记和样式均随插件卸载清理。

插件预览

点击预览图可查看原图。

<table>

<tr>

<td colspan="3" width="50%" valign="top" align="center">

<a href=".github/assets/plugin-preview/image-input.png"><img src=".github/assets/plugin-preview/image-input.png" alt="Grok 4.6 分析 Harness 对话中的图片输入" width="100%"></a><br>

_{<strong>图片输入</strong> — Grok 4.6 直接分析 Harness 附件}

</td>

<td colspan="3" width="50%" valign="top" align="center">

<a href=".github/assets/plugin-preview/model-picker.png"><img src=".github/assets/plugin-preview/model-picker.png" alt="在 DeepSeek Harness 模型选择器中选择 Grok 4.6 或 Grok 4.5" width="100%"></a><br>

_{<strong>模型选择</strong> — 按当前账户能力选择 Grok 4.6 或 Grok 4.5}

</td>

</tr>

<tr>

<td colspan="4" width="66.67%" valign="top" align="center">

<a href=".github/assets/plugin-preview/grok-context.png"><img src=".github/assets/plugin-preview/grok-context.png" alt="Grok 4.6 对话的上下文统计与工具调用" width="100%"></a><br>

_{<strong>对话上下文</strong> — 查看上下文统计与工具调用}

</td>

<td colspan="2" width="33.33%" valign="top" align="center">

<a href=".github/assets/plugin-preview/account-dashboard.png"><img src=".github/assets/plugin-preview/account-dashboard.png" alt="Grok Build 账户额度、重置时间和动态模型能力" width="100%"></a><br>

_{<strong>账户面板</strong> — 额度、重置时间与动态模型能力}

</td>

</tr>

</table>

TUI 命令：

/grok status
/grok login
/grok cancel
/grok logout

这些命令不会进入模型上下文。退出操作需要二次确认，因为它会调用官方 grok logout，并影响共享同一 Grok home 的其他客户端。

更新与卸载

更新已安装版本：

dsh plugin --profile web update dsh-grok-provider
dsh web

卸载：

dsh plugin --profile web remove dsh-grok-provider
dsh web

卸载插件不会删除官方 Grok CLI，也不会直接修改或删除 auth.json。

项目来源与发现

• 本说明对应的 npm 精确版本：dsh-grok-provider@1.0.3
• 当前已完成回读的 GitHub Release：v1.0.3
• 发布证据：release commit 07ebd35c56348a1b3296bd46d1a69f5b0f430241，annotated tag object 7ec8a8a1086749e7ac1dfb0ef2bd50c821838363 peel 至该提交，final CI run 33378215345，Trusted Publisher run 33379149158 attempt 1。仓库所有者明确授权的唯一 tarball 含 77 个文件、267,403 bytes，unpacked size 829,862 bytes；SHA-1 为 6197c3d30ec1ef5f559371911d612f6236eee2f9，SHA-256 为 7f740c7258ab7eee0c96e1ddae3398b41a25e718cf267e244f8693c3c99aeb0d，SRI 为 sha512-kJgN0NKKV7Te3oAgbPnEua/EQCLnj5S0KWAWrhP0ixudJBepplRFARYHCxwxOwbG87bnX07Mz/dxCoBiphWhqQ==。冻结制品、GitHub Release asset 与 npm Registry tarball 逐字节一致，Registry 锁定安装通过 Host/client 加载且生产审计为 0 漏洞；本包公开 metadata 含 1 个 Registry signature、2 个 attestations，安装图为 11 个已验证签名包与 2 个 attested 包。SLSA provenance 精确绑定 release.yml、refs/tags/v1.0.3、release commit 与 publish run。
• npm 页面文档修正：1.0.1 tarball 内曾保留旧安装示例；已发布的 1.0.2 tarball 内，本 README 使用精确 @1.0.2 命令。已发布的 1.0.1 字节不会被覆盖。
• GitHub 社区发现：仓库已添加 DeepSeek Harness 官方推荐的 dsh-plugin 与 dsh Topics
• YukiRyou 受管来源：deepseek-yukiryou-plugin-catalog，当前仍锁定已完成真机验收的 dsh-grok-provider@0.1.0，且只标记 darwin-arm64

出现在目录中不代表 xAI 或 DeepSeek Harness 官方背书。项目已通过收录 PR #3415 进入公共 awesome-dsh-plugin 的 model 分类；该目录是仓库级发现入口，不承载精确 npm 版本或平台验收声明。

兼容性与范围

1.0.6 修复边界

• 修复 DSH 附件库把带透明通道的图片规范化为 image/webp 后，grok-4.6 在网络请求前失败的问题。
• 捕获阶段接受有界 WebP；透明 WebP 转为 PNG，不透明 WebP 转为 JPEG，Responses wire 不直接

…(truncated)