dsh-xai

English | 中文

在 DeepSeek Harness 里用 SuperGrok / X Premium 订阅登录 xAI，调用 Grok。不需要 XAI_API_KEY，也不需要改 dsh 源码。

这是一个独立的 dsh bundle，会提供：

• Settings 或 CLI 里的 SuperGrok / X Premium OAuth，并自动刷新 token
• 一次性导入 ~/.grok/auth.json（Grok CLI）。不会改写那个文件
• 登录或导入后请求 GET https://api.x.ai/v1/models，模型列表按当前账号收窄；拉失败则用安装目录兜底
• 流式、工具调用、reasoning、compaction 走 dsh 原有 LLM 服务

内置目录里的 xai（API Key）路由不会被动。本插件注册的是 xai-oauth，两条路可以并存。

安装

不用先自己 clone。 dsh plugin add 会按 GitHub 地址把包装进当前 profile。

dsh plugin --profile web add github:MirDie/dsh-xai
dsh web

用 npx 起的 Web、PATH 里没有 dsh 时，把前面的 dsh 换成 npx @deepseek-ai/dsh：

npx @deepseek-ai/dsh plugin --profile web add github:MirDie/dsh-xai
npx @deepseek-ai/dsh web

不要写 npm dsh 或在家目录里写 pnpm dsh。npx 只是临时跑一次，不会安装全局 dsh 命令。

打开 设置 → xAI Grok → 使用 SuperGrok 登录。插件会走 device-code，打开验证链接，你在浏览器里批准即可。无头 / SSH 可以用 CLI：

dsh plugin --profile web exec dsh-xai login
dsh plugin --profile web exec dsh-xai import
dsh plugin --profile web exec dsh-xai status
dsh plugin --profile web exec dsh-xai logout

新会话默认选 xai-oauth / grok-4.5。dsh 里已经存过的默认模型仍然优先。

设置页可以勾选要出现在模型选择器里的模型。名称形如 xai-oauth / grok-4.5。登录后如果选择器还是空的，更新插件并重启 dsh web。

只有在改这个插件本身时，才需要把仓库拉到本地，再用路径安装：

git clone https://github.com/MirDie/dsh-xai.git
dsh plugin --profile web add ./dsh-xai

凭证

dsh 的登录和 Grok CLI 是分开的：

• 凭证写在 $DSH_HOME/.xai-oauth-auth.json（默认 ~/.dsh）
• 写入是原子的，refresh 会跨本机 dsh 进程加锁
• 浏览器状态和报错里不会带回 token
• import 只复制一次 ~/.grok/auth.json，从不写回那个文件

xAI 的 refresh token 会轮换。导入之后，dsh 下一次刷新可能让 Grok CLI 掉线，需要再跑一次 grok login。卸掉插件不会删除 dsh 凭证；要删请用设置页或 logout。

兼容说明

• 对话、工具、reasoning 走 pi-ai 的 xAI 提供商（openai-completions / openai-responses）。
• 部分 SuperGrok 档位会出现「浏览器登录成功，推理 HTTP 403」。这是 xAI 侧权限，不是 token 过期。这种情况请改用目录里的 xai + XAI_API_KEY。
• 文件系统、shell、skills、MCP、子代理、权限、附件、compaction 仍由当前 dsh profile 提供。

开发

npm install
npm run check

许可证

Apache-2.0