dsh-grok-provider

简体中文 | English

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

非官方社区项目，与 xAI 或 DeepSeek Harness 官方无隶属关系。当前稳定版本为 0.1.3。项目不再发行预发行版；正式版缺陷通过新的递增稳定版本修复。

它解决什么问题

能力	当前实现
登录	调用官方 grok login --oauth 打开浏览器；插件不实现 OAuth grant
凭据	复用官方 CLI 的登录状态；插件不创建第二份 token 存储
模型	运行时读取账号可见的全部 Grok Build 模型，不维护静态模型白名单
对话	Responses 流式文本、reasoning、加密 reasoning replay、usage 与 finish reason
工具	将 function call 交回 Harness 权限层；Provider 本身不执行工具
账户面板	登录状态、每周/月额度、重置时间、动态模型能力与 reasoning 档位
界面	Web 设置页中英文切换；TUI 提供闭合的 /grok 命令

快速开始

1. 准备环境

• DeepSeek Harness 0.1.1-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

首次运行 Grok CLI 会打开浏览器登录。插件只支持官方默认的 ~/.grok（Windows 为 %USERPROFILE%\.grok）目录。

2. 安装 Provider

从 npm 安装已发布的精确版本：

dsh plugin --profile web add [email protected]
dsh web

3. 登录并选择模型

打开 设置 → Grok Build：

1. 点击“使用 Grok 登录”；
2. 在官方 Grok CLI 打开的浏览器页面完成授权；
3. 返回 Harness，刷新账户面板；
4. 在模型选择器中选择当前账号可见的 Grok 模型。

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

使用界面

Web 设置页展示：

• 当前登录状态及登录、取消、退出操作；
• 已使用/剩余额度和真实周期重置时间；
• 当前账号可见模型、上下文窗口、reasoning 档位、streaming 与 tool capability。

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

插件预览

账户额度与模型能力

Harness 模型选择器

Grok 对话上下文

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 精确版本：[email protected]
• GitHub 发行版与校验值：v0.1.3
• GitHub 社区发现：仓库已添加 DeepSeek Harness 官方推荐的 dsh-plugin 与 dsh Topics
• YukiRyou 受管来源：deepseek-yukiryou-plugin-catalog，跟随已验证的精确稳定版本，当前只标记已验证的 macOS arm64

出现在目录中不代表 xAI 或 DeepSeek Harness 官方背书。项目已向公共 awesome-dsh-plugin curated 目录提交收录 PR #3415，自动门禁已通过，仍需独立维护者评审后才能正式收录。

兼容性与范围

项目	0.1.3 状态
DeepSeek Harness	精确支持 0.1.1-rc.2
Node.js	>=24.19.0
macOS arm64	已完成真实网络与隔离 Harness 验收
Windows x64	代码与 Windows CI 支持；本次正式发布未完成独立真机验收
macOS x64 / Linux	不支持
Grok CLI	不锁完整版本；严格校验官方路径、login --oauth 能力与生产 OIDC 凭据契约
模型	当前账号目录中 backend 已被严格 codec 支持的全部模型

首版不包含图片输入、Web/X Search、任意文件下载、API Key 模式、多账号、企业 OIDC、ACP 或 Headless agent 封装。完整范围见产品需求。

工作原理

Harness UI / TUI
       │ 仅发送闭合操作与脱敏 DTO
       ▼
dsh-grok-provider Host
       ├── 官方 Grok CLI：login / models / logout
       ├── 固定 Models/Billing endpoint：目录与额度
       └── 固定 Responses endpoint：流式推理
                    │
                    ▼
              xAI Grok Build

模型 ID 来自运行时目录，不是硬编码列表。如果账号出现当前版本无法安全映射的新 backend，发现过程会失败关闭，而不是隐藏模型后宣称“全部支持”。

安全与隐私

…