@local/dsh-grok-xai
使用 SuperGrok 或 X Premium 订阅登录 xAI，并在 DeepSeek Harness 中使用 Grok 模型。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:TuDouPn/dsh-grok-xai#33a5cc2ebfd288bb273a7f95f66e93b09c50c6d8Grok Xai 以 @local/dsh-grok-xai 发布，当前版本为 1.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
在 DeepSeek Harness（DSH）里使用 SuperGrok / X Premium 订阅登录 xAI，直接调用 Grok 模型，并查看订阅用量、实时模型、上下文和价格。
非官方项目。 本项目与 xAI、SpaceXAI、DeepSeek、Anysphere 均无隶属关系。订阅用量接口来自 Grok CLI 的未公开端点，可能随 xAI 更新而变化；请自行评估使用风险，并遵守 xAI 的服务条款。
截图：套餐、本周订阅用量、实时模型、上下文、价格和推理强度。
已经在 DSH 里？ 直接把这句话发给 Agent：
安装这个 DSH 插件并启用：https://github.com/TuDouPn/dsh-grok-xai.git
llm-pi-ai/xai 记录。xai 提供商写入 llm-pi-ai，Grok 模型出现在输入框的模型菜单。api.x.ai/v1/models 读取，不再依赖 pi-ai 的内置目录；支持手动刷新并同步。/v1/models/{id} 的 capabilities.reasoning_effort，不猜测档位；不支持的模型不会出现无效选项。dsh web）。llm-pi-ai、authorization、credentials、configEditor、webServer 服务。基础 Web profile 默认具备。0.2.1-rc.2（Desktop）。其他版本如 API 有变化，可能需要适配。有两种方式。推荐直接在 DSH 里给 Git 地址，不需要先 clone。
复制仓库地址：
https://github.com/TuDouPn/dsh-grok-xai.git
在 DSH 当前 profile 的会话里，把下面这句话发给 Agent：
请把这个 Git 仓库作为 DeepSeek Harness 插件安装到当前 profile 并启用：
https://github.com/TuDouPn/dsh-grok-xai.git
安装前先检查它是不是一个 DSH bundle；安装后确认 bundle 已启用，并告诉我 Grok 卡片在哪里打开。
DSH 会：
package.json，确认包含 dsh.bundle.patch；plugin_manager 的 install_bundle 从 Git 安装到当前 profile；dsh.profile.bundles 并启用；@local/dsh-grok-xai。安装过程可能需要一次批准（danger-full-access 或 approval）。完成后：
这种方式安装的是 Git 快照。更新时让 DSH 重新安装同一地址，或在 Plugins 页面更新；它不会跟随你本地目录的
git pull。如果当前 DSH 版本的安装器不支持 Git 地址，会提示无法解析；改用方式二克隆后安装即可。
适合要改代码或跟进 main 分支的情况。
git clone https://github.com/TuDouPn/dsh-grok-xai.git
cd dsh-grok-xai
在 DSH Web 中安装
/Users/you/code/dsh-grok-xai。如果界面只接受包名或 URL，改用下面的 Agent 方式。让 DSH Agent 安装
把 /绝对路径/dsh-grok-xai 作为本地 bundle 安装到当前 profile，并启用它。
Agent 会调用 plugin_manager 的 install_bundle，target 指向该目录。
本地安装是链接方式，不要移动或删除克隆目录，否则 profile 中的依赖会失效。安装会修改当前 profile，影响该 profile 的所有会话。
进入 设置 → 模型，滚动到页面底部的 Grok（xAI 订阅） 卡片。
@local/dsh-grok-xai，且已启用；Git URL 安装：让 DSH 重新安装同一地址，或在 Plugins 页面执行更新。
本地 clone 安装：
git pull
然后在 Plugins 中重新启用该 bundle，或重启 DSH。Host 代码更新后，仅刷新页面不一定加载新的 Host 模块。
llm-pi-ai 中的 xai 提供商配置；如不再使用，可在 设置 → 模型 删除该提供商，或从 profile 的 cordis.patch.yml 中移除 providers.xai。| 操作 | 作用 |
|---|---|
| 登录 SuperGrok / X Premium | 启动一次 xAI 设备码登录 |
| 取消登录 | 取消当前设备码轮询 |
| 刷新 | 重新读取订阅用量和实时模型 |
| 刷新并同步模型 | 读取 /v1/models 与每个模型的 /v1/models/{id} 能力，写入 llm-pi-ai |
| 退出登录 | 删除 DSH 凭证库中的 llm-pi-ai/xai 记录，不影响 xAI 账号 |
登录后如果模型菜单没有立即刷新，切换一次页面或重启 DSH。模型列表写入 profile 后会在后续会话中保持。
cli-chat-proxy.grok.com/v1/settings 的 subscription_tier_display，例如 SuperGrok Plus。cli-chat-proxy.grok.com/v1/billing?format=credits，与 Grok CLI 显示的周期用量一致。模型表的数据来自：
GET https://api.x.ai/v1/models — 模型 ID、上下文长度、输入/输出/缓存价格、长上下文阈值。GET https://api.x.ai/v1/models/{id} — capabilities.reasoning_effort、默认推理强度等。价格单位是 USD / 100 万 tokens。卡片显示基础输入/输出价格；悬停行可看缓存输入、长上下文价格和完整模型 ID。价格是 xAI 的实时返回值，本文档中的快照可能过期。
当前快照（以卡片实时值为准）：
| 模型 | 上下文 | 输入 | 输出 | 缓存输入 | 长上下文（>200K） |
|---|---|---|---|---|---|
| Grok 4.20 Reasoning / Non-reasoning / Multi-Agent | 1M | $1.25 | $2.50 | $0.20 | $2.50 / $5.00 |
| Grok 4.3 | 1M | $1.25 | $2.50 | $0.20 | $2.50 / $5.00 |
| Grok 4.5 | 500K | $2.00 | $6.00 | $0.30 | $4.00 / $12.00 |
| Grok 4.6 | 500K | $2.00 | $6.00 | $0.50 | $4.00 / $12.00 |
| Grok 4.7 | 500K | $2.00 | $6.00 | $0.50 | $4.00 / $12.00 |
| Grok Build 0.1 | 256K | $1.00 | $2.00 | $0.20 | $2.00 / $4.00 |
xAI 的模型接口不返回“最大输出 tokens”。同步后的配置中，已知模型复用 pi-ai 目录的元数据，未知模型使用路由的保守默认值。
同步模型时，插件会逐个请求 /v1/models/{id}，只使用 xAI 声明的 capabilities.reasoning_effort：
| 模型 | 可选推理强度 | 说明 |
|---|---|---|
| Grok 4.3 | off / low / medium / high / xhigh | off 映射到 API 的 none |
| Grok 4.5 / 4.6 / 4.7 | low / medium / high / xhigh | 不支持 none |
| Grok 4.20 Reasoning | 固定，无强度选项 | API 拒绝 reasoningEffort |
| Grok 4.20 Non-reasoning | 非推理 | 无强度选项 |
| Grok 4.20 Multi-Agent | 固定，无强度选项 | xAI 未声明可切换档位 |
| Grok Build 0.1 | 固定，无强度选项 | API 拒绝 reasoningEffort |
“固定”只表示没有可切换档位，不表示关闭推理。Grok 4.20 Reasoning / Multi-Agent 仍会按模型默认方式推理；强行写死
low/medium/high反而可能触发 400。
flowchart LR
U[用户] --> UI[DSH Web UI<br/>设置 → 模型]
UI --> C[client.js<br/>Grok 卡片]
C -->|同源 JSON<br/>/grok-auth/*| H[index.js<br/>Host 半]
H -->|ctx.authorization| A[DSH authorization<br/>llm-pi-ai/xai]
A --> S[(DSH 凭证库)]
H -->|ctx.configEditor| P[llm-pi-ai 配置<br/>providers.xai]
H -->|Bearer access token| X[xAI<br/>/v1/models<br/>/v1/models/{id}]
H -->|Bearer access token| B[Grok CLI proxy<br/>/v1/billing<br/>/v1/settings]
P --> M[模型菜单]
index.js 注册 /grok-auth/* 同源 JSON 路由；启动设备码登录、读取用量和模型、写回 llm-pi-ai 配置。client.js 注册到 settings.models.footer，渲染登录、用量、模型表和同步操作。authorization / credentials 管理；插件只读取 access token 用于 xAI 请求，不返回、不记录。providers.xai.models，所以模型菜单使用 xAI 返回的列表，而不是内置目录。| 接口 | 用途 | 说明 |
|---|---|---|
GET https://api.x.ai/v1/models | 实时模型列表 | 过滤出可对话模型 |
GET https://api.x.ai/v1/models/{id} | 模型能力与价格 | capabilities.reasoning_effort 用于推理校准 |
GET https://cli-chat-proxy.grok.com/v1/billing?format=credits | 订阅用量 | Grok CLI 使用的未公开端点 |
GET https://cli-chat-proxy.grok.com/v1/settings | 套餐、默认模型、能力开关 | 未公开端点 |
x-ratelimit-* 响应头 | RPM/TPM 限流窗口 | 仅真实推理响应携带，当前未展示 |
GET /v1/api-key | — | 订阅 OAuth 返回 401，不可用 |
GET /v1/usage | — | 返回 404，xAI 无公开 usage 端点 |
本插件不依赖 Grok Bot 或任何 Anysphere 运行时；它走 DSH 自带的 pi-ai xAI 适配器和 xAI OAuth。
authorization / credentials 写入 llm-pi-ai/xai；插件只把 access token 放进 Authorization: Bearer 请求头。/grok-auth/* 路由要求请求的 Origin 与 Host 一致；没有跨站 CORS 接口。~/.dsh/.credentials.yaml、访问令牌、refresh token 或完整请求头。发现安全问题请按 SECURITY.md 私下报告，不要开公开 issue。
/v1/models 不提供最大输出 tokens；配置使用 pi-ai 目录或路由默认值。0.2.1-rc.2 验证；其他版本的 UI/服务接口可能不同。| 现象 | 处理 |
|---|---|
模型请求报 Provider is not configured: xai | 还没完成订阅登录；在卡片登录，或确认 llm-pi-ai/xai 凭证存在 |
| 卡片显示「已登录」但模型不可用 | 确认 设置 → 模型 中有 xAI (Grok) 提供商；没有就点「添加 xAI 提供商」 |
报 UNSUPPORTED_REASONING_EFFORT | 点「刷新并同步模型」；或选择该模型支持的档位 |
| 用量显示「订阅凭证已过期」 | 退出登录后重新登录；插件会自动续期，续期失败才需要重登 |
| 模型菜单没有新模型 | 点「刷新并同步模型」；同步会覆盖 xai 提供商的模型列表 |
| 验证码过期 | 重新点「登录 SuperGrok / X Premium」获取新代码 |
| 卡片不出现 | 确认 bundle 已启用；刷新页面；必要时重启 DSH |
| 安装时报路径错误 | 使用克隆目录的绝对路径；确认 package.json 存在且包含 dsh.bundle.patch |
| 文件 | 作用 |
|---|---|
index.js | Host 半：/grok-auth/* 路由、OAuth 设备码、用量、模型同步、配置写入 |
client.js | Client 半：settings.models.footer 卡片、用量面板、模型表 |
cordis.patch.yml | 安装时插入 grok-xai 插件行 |
locale/*.json | 插件标题与描述（中文 / English） |
icon.svg | 插件图标 |
docs/grok-bot-capabilities.md | Grok Bot 能力与可接入面的调研笔记 |
README.en.md | English README |
LICENSE | MIT |
node --check index.js
node --check client.js
插件没有构建步骤、没有 npm 依赖。修改后，把目录重新安装为本地 bundle，或重启 DSH 让 Host 模块重新加载。Client 半在 Web 页面中通过 HMR 更新；如果没生效，刷新页面。
包名使用 @local/ 前缀是为了把它当作本地 bundle 安装；如果要发布到 npm，请同时修改 package.json 的 name、cordis.patch.yml 中的 name，并重新安装 bundle。
Host 半注册了以下同源路由。它们只返回状态和统计，不返回令牌：
| 路由 | 方法 | 作用 |
|---|---|---|
/grok-auth/state | GET | 登录/提供商状态、设备码通知 |
/grok-auth/sign-in | POST | 启动设备码登录 |
/grok-auth/cancel | POST | 取消登录 |
/grok-auth/sign-out | POST | 删除本地 OAuth 记录 |
/grok-auth/add-provider | POST | 重试添加 xai 提供商 |
/grok-auth/observability | GET | 套餐、用量、实时模型、已解析推理档位 |
/grok-auth/sync-models | POST | 读取实时模型能力并写入配置 |
本项目的运行时不依赖 Grok Bot。Grok Bot（com.anysphere.sand）是独立的桌面 Agent，没有公开的本地 API/CLI；它和本插件共享的只是 xAI 账号与订阅。
Grok Bot 的 Hooks、Deep Link、MCP 连接器等可接入面，以及可移植能力清单，见 docs/grok-bot-capabilities.md。这部分目前是调研和路线图，不在本插件的运行时内。
欢迎 issue 和 PR。请先阅读 CONTRIBUTING.md。
~/.dsh/.credentials.yaml 或其他个人数据。README.en.md 和 CHANGELOG.md。node --check index.js 和 node --check client.js。MIT © 2026 dsh-grok-xai contributors