概览
dsh-llm-grok-oauth
README / ZH
插件文档
dsh-llm-grok-oauth
DeepSeek Harness 插件:在「设置 → 模型」中通过 Grok 账号登录,
使用 SuperGrok / X Premium+ 订阅调用模型,无需 xAI API Key。
English · 简体中文
DSH 内置的 Grok 配置仅支持填写 API Key。本插件在同一页面增加账号登录,登录入口位于:
设置 → 模型 → Grok (xAI 订阅)
安装
本机需已安装 DeepSeek Harness 与 pnpm。未将 dsh 加入 PATH 时,使用 npx:
npx @deepseek-ai/dsh plugin --profile web add github:wangyaominde/dsh-llm-grok-oauth
已安装 dsh 命令时:
dsh plugin --profile web add github:wangyaominde/dsh-llm-grok-oauth
安装完成后须重启 dsh web。客户端模块仅在进程启动时加载,未重启则设置页不会出现登录按钮。
pnpm 若提示缺少 @deepseek-ai/cordis 等 peer 依赖,可忽略。这些包由 DSH 运行时提供,不需要装进插件目录。
使用
打开 设置 → 模型,在 Grok (xAI 订阅) 中点击 使用 Grok 账号登录。默认走网页授权,不要求安装官方 Grok CLI。
- 点击登录后,在打开的浏览器中完成 xAI 授权。确认代码由 xAI 按本次登录签发,各台电脑、各次点击均不相同。
- 返回会话,在输入框模型列表中选择 Grok 模型。若当前会话仍指向 DeepSeek,请新建会话后再发送。
本机进程需要能够访问 https://auth.x.ai 和 https://cli-chat-proxy.grok.com。登录、模型目录和对话走同一套代理(HTTPS_PROXY 或 macOS 系统代理)。若浏览器能打开而登录或发消息仍失败,请为启动 dsh web 的环境设置代理后重试。
若本机已通过官方 Grok CLI 登录,将静默复用 ~/.grok/auth.json,不打开浏览器。未安装 CLI 时不会要求执行 grok login。
退出登录位于同一条目,立即清除本插件中的登录状态,不会删除官方 Grok CLI 的登录文件。再次点击登录前,不会自动复用 CLI 会话。若旧版本点击退出后立刻又显示已登录,或登录成功但对话报 TRANSPORT,请更新到 0.2.10 并完全退出后重启 dsh web。
环境要求
| 项目 | 要求 |
|---|---|
| DeepSeek Harness | 0.1.0-rc.6 及以上 |
| 账号 | SuperGrok 或 X Premium+ |
| 官方 Grok CLI | 不是必需。仅在本机已登录时复用该会话 |
| xAI API Key | 不需要 |
与 API Key 配置的关系
| 本插件 | DSH 内置 Grok 配置 | |
|---|---|---|
| 入口 | 设置 → 模型 | 设置 → 模型 |
| 认证方式 | Grok 账号登录 | 填写 API Key |
| 计费 | SuperGrok / X Premium+ 订阅 | xAI API 余额 |
两者可同时存在。本插件不写入、不覆盖已保存的 API Key。
卸载
npx @deepseek-ai/dsh plugin --profile web remove dsh-llm-grok-oauth
卸载后须重启 dsh web。
