dsh-llm-grok-oauth

---

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。

1. 点击登录后，在打开的浏览器中完成 xAI 授权。确认代码由 xAI 按本次登录签发，各台电脑、各次点击均不相同。
2. 返回会话，在输入框模型列表中选择 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。

许可

MIT