前言¶

在 DeepSeek Harness（DSH）里接 Grok，常见做法是自备 xAI API Key，或在配置里手写提供商与模型目录。若你已有 SuperGrok 或 X Premium 订阅，更希望像 Grok 官方客户端一样用订阅账号登录、看周期用量，并在模型菜单里选实时返回的 Grok 模型，就需要一条「订阅 OAuth + pi-ai 同步」的插件路径。

下面介绍社区插件 dsh-grok-xai（维护者 TuDouPn，GitHub 仓库 TuDouPn/dsh-grok-xai）。它是 非官方 实验性 DSH bundle：通过 xAI 设备码登录，把凭证写入 DSH 凭证库，同步 api.x.ai 的模型列表与推理能力，并从 Grok CLI 使用的代理端点读取套餐与用量。插件在 SkillHub 目录归类为「模型推理」；仓库当前版本为 1.3.0（MIT），README 标明在 DSH 0.2.1-rc.2（Desktop）上开发验证。

这是什么¶

dsh-grok-xai 在 DSH Web UI 的 设置 → 模型 页面底部增加 Grok（xAI 订阅） 卡片：完成订阅登录后，自动向 llm-pi-ai 写入 xai 提供商与实时模型配置，对话输入框的模型菜单即可选择 Grok。卡片还可展示套餐名、本周/本月用量百分比、分项、重置时间、预付余额，以及各模型的上下文窗口与价格（悬停可看缓存输入、长上下文价格与完整模型 ID）。

与「只填 API Key」相比，本插件强调 订阅登录、不需要 API Key，模型列表来自 GET https://api.x.ai/v1/models，推理强度按各模型 /v1/models/{id} 返回的 capabilities.reasoning_effort 校准，而不是猜测档位。用量与套餐数据来自 cli-chat-proxy.grok.com 的未公开端点（与 Grok CLI 一致），xAI 可能随时调整，使用前请自行评估风险并遵守 xAI 服务条款。

核心功能¶

资料中已核实的能力如下。

• 设备码 OAuth：凭证由 DSH authorization / credentials 管理，记录为 llm-pi-ai/xai；访问令牌临近过期时在写锁内用 refresh token 续期。
• 一键接入模型：登录后同步模型到 providers.xai.models，模型菜单使用 xAI 实时列表，而非 pi-ai 内置目录；支持「刷新并同步模型」。
• 订阅用量与套餐：例如套餐显示名 SuperGrok Plus；Host 内缓存 60 秒，可手动刷新。
• 推理强度：仅展示 xAI 声明的可选档位；不支持切换的模型不会出现无效选项（详见仓库 README「推理强度」表）。
• 实现形态：Host（index.js）与 Client（client.js）为普通 JavaScript，无构建步骤、无第三方 npm 运行时依赖；通过 cordis.patch.yml 以 bundle 形式注入 DSH。

环境要求¶

安装前确认当前 profile 具备带 Web UI 的 DSH（Desktop 或 dsh web），且已启用 llm-pi-ai、authorization、credentials、configEditor、webServer（基础 Web profile 默认具备）。你需要有效的 SuperGrok 或 X Premium 订阅。

安装与启用¶

README 推荐在 DSH 内用 Git 仓库地址安装，无需事先 git clone。仓库地址：

https://github.com/TuDouPn/dsh-grok-xai.git

在当前 profile 的会话里，把下面整段发给 DSH Agent（与 README 一致，可按需补一句「安装后告诉我 Grok 卡片在哪里打开」）：

请把这个 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 安装，并在 Plugins 页面显示 @local/dsh-grok-xai。过程可能需要一次批准（如 danger-full-access 或 approval）。

验证安装：

1. Plugins 页面可见 @local/dsh-grok-xai 且已启用；
2. 打开 设置 → 模型，滚动到页面底部可见 Grok（xAI 订阅） 卡片。

若安装器不支持 Git 地址，README 提供「克隆目录绝对路径 + Plugins 安装 bundle」的备选方式；本地链接安装后不要移动或删除克隆目录。

升级：Git URL 安装时在 Plugins 重新安装同一地址或执行更新；本地 clone 则 git pull 后重新启用 bundle 或重启 DSH（Host 更新后仅刷新页面可能不够）。

卸载：建议先在卡片 退出登录；在 Plugins 移除 bundle。卸载不会自动删除 llm-pi-ai 里的 xai 提供商，不再使用时可在 设置 → 模型 或 cordis.patch.yml 中自行清理。

典型用法¶

1. 打开 设置 → 模型，在底部 Grok（xAI 订阅） 卡片点击 登录 SuperGrok / X Premium。
2. 在浏览器打开卡片给出的 xAI 验证链接，输入一次性设备码并确认。
3. 回到 DSH，卡片显示已登录后会同步实时模型列表。
4. 在对话输入框的模型菜单中选择 Grok 模型。

卡片常用操作：

登录后若模型菜单未更新，可切换页面或重启 DSH。

适用场景与注意¶

适合谁：已有 SuperGrok / X Premium 订阅、希望在 DSH 里用同一套订阅凭证对话 Grok，并希望在设置页查看用量与实时定价的开发者。

权限与安全：插件以当前 DSH 进程权限运行；安装前应阅读仓库源码与 MIT 许可证。OAuth 令牌不经插件日志或页面返回；/grok-auth/* 要求同源 Origin。billing/settings 为未公开端点，行为可能变化。

已知限制（摘自 README）：xAI 不提供与订阅 OAuth 配套的公开 /v1/usage；/v1/api-key 对订阅令牌返回 401。模型接口不返回「最大输出 tokens」，未知模型使用保守默认。状态为 experimental。

生态说明：SkillHub（plugins/TuDouPn/dsh-grok-xai）为社区插件目录，与 DeepSeek、xAI 无官方从属；DSH 本身奉行「一切皆插件」，本仓库亦明确与 xAI、DeepSeek、Anysphere 无隶属关系。

结尾¶

dsh-grok-xai 把 SuperGrok / X Premium 订阅登录、Grok 实时模型同步和订阅用量展示收进 DSH 的模型设置页，适合不想单独维护 xAI API Key、又要在 Harness 里选 Grok 的场景。更完整的接口表、推理强度对照、故障排查与路线图见 GitHub README。

• 目录页：https://www.skillhub.cn/plugins/TuDouPn/dsh-grok-xai
• 仓库：https://github.com/TuDouPn/dsh-grok-xai