DSH 插件市场DSH Plugin Hub

MirDie/dsh-xai

插件Plugin 原生Native ⭐ 2 NOASSERTION cat_label.grokcat_label.grokcat_label.xaicat_label.xai

xAI Grok SuperGrok / X Premium OAuth，用于DeepSeek Harness

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-xai 是 DSH 插件，通过 xAI 设备码 OAuth 登录 SuperGrok 或 X Premium，无需 API Key 或改源码；支持自动刷新令牌、一次性导入 Grok CLI 凭据，并按账号拉取模型，保留流式、工具调用、推理与压缩。适合想用订阅账号在 DSH 中调用 Grok 时使用。注意：部分套餐登录后推理仍可能被 xAI 返回 403。

dsh-xai is a DSH plugin that signs in to SuperGrok or X Premium via xAI device-code OAuth, requiring no API key or source patch. It adds automatic token refresh, optional one-time Grok CLI credential import, account-specific model listing, and supports streaming, tool calls, reasoning, and compaction through DSH. Use it when accessing Grok with a subscription. Caveat: some tiers may log in but still receive HTTP 403 on inference due to xAI entitlement restrictions.

在 GitHub 查看View on GitHub

强烈推荐Recommended 发给你的 DSH 安装Send to your DSH 
请帮我了解并安装插件：【dsh-xai】【https://github.com/MirDie/dsh-xai】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install 

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

把 MirDie/dsh-xai 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.3 KB · 缓存于 2026-08-27 05:41:57 · 3.3 KB

dsh-xai

English | 中文

Use a SuperGrok or X Premium subscription in DeepSeek Harness through xAI's device-code sign-in — no XAI_API_KEY required, and no dsh source patch required.

This is an independent dsh bundle. It adds:

  • SuperGrok / X Premium OAuth from the dsh Settings panel or a standalone CLI, with automatic token refresh
  • optional one-shot import of ~/.grok/auth.json (Grok CLI). The Grok file is never written
  • after login or import, GET https://api.x.ai/v1/models narrows the picker to the signed-in account; the installed catalog is the fallback
  • streaming, tool calls, reasoning, and dsh compaction through the normal LLM service

The catalog xai API-key route stays untouched. This plugin registers xai-oauth so both can coexist.

Install

You do not need to clone this repository first. dsh plugin add fetches the package into the profile:

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

If you started the UI with npx and have no dsh on PATH, use the same package as the CLI:

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

Do not run npm dsh or pnpm dsh from your home directory. npx does not install a global dsh command.

Clone only when you are changing this plugin:

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

Open Settings → xAI Grok → Sign in with SuperGrok. The plugin starts xAI's device-code flow, opens the verification URL, and polls until you approve. Headless / SSH hosts can use the CLI instead:

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

The bundle selects xai-oauth / grok-4.5 for new agents. A model already saved in dsh settings still takes precedence.

The Settings page can choose which account models appear in the composer picker (xai-oauth / <id>). After updating the plugin, restart dsh web if the picker is still empty.

See INSTALL.md / INSTALL.zh.md for the full runbook.

Credentials

dsh keeps this login separate from the Grok CLI:

  • credentials are stored at $DSH_HOME/.xai-oauth-auth.json (~/.dsh by default)
  • writes are atomic and token refresh is locked across local dsh processes
  • browser status and diagnostics never return token values
  • import copies ~/.grok/auth.json once and never writes that file

xAI refresh tokens rotate. After import, the next dsh refresh may invalidate Grok CLI until you run grok login again. Removing the bundle does not delete the dsh credential; use the account page or logout.

Compatibility notes

  • Chat, tool calls, and reasoning ride pi-ai's xAI provider (openai-completions / openai-responses).
  • Some SuperGrok tiers have been seen to accept the browser login and then reject inference with HTTP 403. That is an xAI entitlement gate, not a stale token. Use XAI_API_KEY on the catalog xai route in that case.
  • Filesystem, shell, skills, MCP, subagents, permissions, attachments, and compaction still come from the active dsh profile.

Development

npm install
npm run check

License

Apache-2.0

渲染基于仓库 MirDie/dsh-xai 的 README.md。 在 GitHub 查看原文 →

相关推荐Related

← 上一个 Prev dsh-code-review 下一个 Next dsh-mobile-access →