DSH Grok Subscription

简体中文 · English

用 Grok Build 订阅，在 DSH 里编程、看图、切换推理档位。

复用官方 Grok Build CLI 登录会话，在 DeepSeek Harness 中选模型、带图提问、查看每周额度。 无需另配 xAI 按量计费 API Key。

功能 · 安装 · 日常使用 · 界面预览 · 使用指南 · 更新与卸载

功能

| 能力 | 使用体验 | | --- | --- | | 复用订阅登录 | 在设置页发起 CLI / 设备码登录，或拉取已有 Grok CLI 会话，无需手动粘贴 token | | 模型目录同步 | 登录后优先读取账号模型目录；读取失败时可使用内置目录，未登录时不显示模型 | | 推理档位 | 在模型菜单中选择可用档位，通常包含 low / medium / high / xhigh，默认优先使用 high | | 图片输入 | 支持的模型可接收粘贴或附加的图片；设置页可检查当前运行通路与附件能力 | | 每周额度 | 输入框徽章和设置页展示服务端返回的用量；额度接口为实验性，读取失败不编造数字 | | 会话续期与更新 | 临近过期或认证拒绝时尝试通过官方 CLI 续期；设置页也可检查插件版本 | | 凭据不返回浏览器 | access token 仅在 Host 侧使用；订阅失败不会静默改用其他付费模型路由 |

安装

需要 DeepSeek Harness、运行在同一台机器上的官方 Grok Build CLI，以及当前具有 Grok Build 使用资格的 SuperGrok / X Premium 账号。订阅名称本身不保证访问资格，以账号实际授权为准。

尚未安装 DSH，可查看 DSH 官方说明。版本要求与 CLI 路径说明见 安装与兼容性。

1. 安装插件

在桌面版打开 设置 → 插件，在安装输入框里填入包名 dsh-grok-subscription 并安装，然后完全退出并重启桌面应用。仅刷新页面不会重新加载 Host 中的适配器。

2. 登录订阅

打开 设置 → Grok 订阅，点击 CLI 登录 或 设备码登录，按浏览器和面板提示授权。已经运行过 grok login，可直接点击 从 Grok CLI 拉取。

本插件依赖官方 Grok Build CLI 管理登录与续期，不是免 CLI 的方案。请勿粘贴 XAI_API_KEY，也不要把 auth.json 或 token 发到聊天、截图和公开 Issue 中。

3. 选择模型

在模型选择器中选择账号可用的 Grok 模型。按需要调整推理档位，开始对话或编程；模型旁的徽章显示成功读取到的每周余量。

设置 → 插件 会列出已安装插件与版本，插件自己的 设置 → Grok 订阅 页也有版本卡片。要固定版本，在安装框里填入完整的 包名@版本，例如 [email protected]。

界面安装失败时（例如 profile 目录权限异常），可以对桌面版 profile 手动执行等价操作（pnpm ≥ 11）：

cd "$HOME/.dsh/profiles/desktop"    # Windows: cd "$env:USERPROFILE\.dsh\profiles\desktop"
pnpm add --save-exact --config.minimumReleaseAge=0 [email protected]

dsh plugin --profile desktop … 会被拒绝：桌面版 profile 由 Electron 应用独占。CLI 路径、登录方式与故障排查见 完整使用指南。

日常使用

选模型与推理档位。 登录后目录会刷新；以模型菜单提供的档位为准。目录读取失败时的内置列表不代表额外授予模型权限。

带图提问。 在支持图片的模型下粘贴或附加图片。当前实现为 grok-4.7、grok-4.7-build-fast、grok-4.6 声明图片输入，不为 grok-4.5 声明；这指的是读取图片，不是生成图片。详见 图片输入。

查看每周额度。 选择 grok-build 路由后，徽章展示成功读取的剩余比例；悬停或点击查看重置时间。完整信息在设置页查看，额度读取失败本身不会阻止聊天。

界面预览

账号设置截图中的身份与时间为演示数据。用量截图仅说明界面，不代表任何账号的固定额度。

使用指南

完整使用指南 包含安装与兼容性、CLI 登录、模型目录、图片输入、额度限制、网络排查和本地开发。

常用入口：登录与凭据 · 图片输入 · 故障排查 · 参与贡献。

更新与卸载

更新： 在 设置 → 插件 的安装框里重新填入 dsh-grok-subscription（或 dsh-grok-subscription@版本）安装即可覆盖；插件自己的设置页也有版本卡片与「更新插件」按钮。完成后完全退出并重启桌面应用。

桌面版由 Electron 应用独占 desktop profile，dsh plugin --profile desktop … 会被直接拒绝，因此桌面版的「更新插件」由插件在该 profile 目录中用 DSH 自带的 pnpm 安装精确版本；1.1.1 之前该按钮在桌面版必然失败，手动步骤见更新与登出。

卸载： 在 设置 → 插件 里移除 dsh-grok-subscription，或在该 profile 目录执行 pnpm remove dsh-grok-subscription，然后重启桌面应用。卸载不会删除其他插件、整个 profile 或 Grok CLI 的 auth.json，也不等于从官方 CLI 登出；清理范围见 更新与登出。

常见问题

模型列表为空？ 先确认官方 Grok CLI 已完成订阅登录，再在设置页点击「从 Grok CLI 拉取」。只有 API Key 的 CLI 配置不等于订阅登录。

登录或请求超时？ 检查 DSH 所在机器能否连接账号与订阅服务，以及启动环境的代理设置。网络、登录状态和服务端异常都可能导致失败，不要直接认定为额度耗尽。见 故障排查。

更新后不能带图？ 完整重启桌面应用，检查模型是否在图片支持列表，以及设置页的「运行通路」是否显示官方 pi-ai 且附件能力可用。若显示「不可用」，说明宿主缺少 pi-ai 适配器。

边界与支持

本项目是社区插件，与 DeepSeek、xAI 无隶属或背书关系。模型访问、推理档位和订阅额度由账号与服务端决定；本插件不授予额外权益。

用量面板依赖未公开的订阅计费接口，属于实验性能力，可能因上游变化而不可用。凭据不返回浏览器不代表离线运行：模型请求仍发送到 Grok 订阅服务。

安全说明见 SECURITY.md，问题反馈见 Issues。不要公开登录文件、token、原始账号响应或完整登录回调。

本地开发

git clone https://github.com/BaronCyrus/dsh-grok-subscription.git
cd dsh-grok-subscription
npm ci
npm test
npm run build

lib/ 是已提交的构建产物，修改 src/ 后应重新构建，不要手动编辑。开发与验证要求见 CONTRIBUTING.md。

License

MIT