DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」，允许通过社区代码扩展功能。dsh-grok-subscription 是一个社区插件，它解决了在 DSH 环境中调用 Grok Build 的接入问题。该插件不依赖 xAI 官方的按量计费 API Key，而是直接读取用户现有的 SuperGrok 或 X Premium 账号的订阅资格。插件由开发者 BaronCyrus 维护，采用 MIT 许可证。
核心功能¶
该插件主要提供以下能力：
- 订阅登录：支持通过设备码登录，或直接读取本地的
auth.json文件。登录与续期由插件在 Host 侧自动完成，不依赖grok命令行工具。 - 模型目录同步：登录后优先从账号模型目录读取可用模型；若读取失败，可使用内置目录。
- 推理档位选择：在模型菜单中选择可用档位（如 low / medium / high / xhigh），默认优先使用 high。
- 图片输入：在支持的模型下支持粘贴或附加图片。
- 每周额度查看：在输入框徽章或设置页展示服务端返回的每周余量。
- 会话续期与更新：当认证即将过期或被拒绝时，自动使用 refresh token 续期。
- 凭据安全：access token 仅在 Host 侧使用，不会返回到浏览器环境。
安装¶
在桌面版 DeepSeek Harness 中执行以下步骤：
- 打开 设置 → 插件。
- 在安装输入框中填入包名
dsh-grok-subscription并点击安装。 - 完全退出并重启桌面应用，使插件生效。
日常使用¶
安装并登录后，可按以下方式操作：
- 登录与选模型：打开 设置 → Grok 订阅，点击 登录 或 读取已保存的会话。登录成功后，在模型选择器中会显示账号可用的 Grok 模型。点击模型旁的箭头，可选择具体的推理档位。
- 带图提问：在支持图片输入的模型下（如
grok-4.7、grok-4.7-build-fast等），直接粘贴或拖拽图片到输入框。 - 查看额度：选择
grok-build路由后，输入框旁会显示每周剩余额度的徽章。悬停或点击可查看详细信息。
注意事项¶
- 账号要求：使用前需拥有具有 Grok Build 使用资格的 SuperGrok 或 X Premium 账号。
- 依赖关系：无需安装 grok 命令。
- 安全性：凭据仅 Host 侧使用，不会返回浏览器。请勿公开登录文件、token 或原始账号响应。
- API 稳定性：用量面板依赖未公开的实验性接口，若上游变化，该功能可能不可用。
- 独立性：该项目与 DeepSeek、xAI 无隶属或背书关系。
总结¶
dsh-grok-subscription 为 DSH 用户提供了使用 Grok Build 的便捷入口，支持模型切换、图片输入及额度监控。作为社区插件，其功能依赖于账号权限与服务端接口，更新与维护由开发者独立负责。
