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
自定义 composition 的 reasoning 默认值
xai-oauth 插件支持可选的、作用于整条路由的 reasoning 默认值。它适合自定义 Cordis composition，例如需要固定请求某一思考档位的 ACP leaf：
- id: llm-xai-oauth
name: dsh-xai
config:
reasoning: high
可选值为 off、minimal、low、medium、high、xhigh 和 max；单个模型可能只支持其中一部分。插件的 grok-4.6 目录项支持 high。
不填写 reasoning 时，会保留 pi-ai 的 provider 默认行为。这个选项不会在设置页增加控件，也不会按 agent 或每次请求选择档位；这些场景可以继续不设置路由默认值。
凭证
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
