前言¶

DeepSeek Harness (DSH) 采用插件化架构。在接入 xAI Grok 时，开发者通常需要处理订阅授权、模型路由以及配置管理。本插件提供了独立的 Grok 订阅 OAuth 提供者与 Web 配置界面。它与内置的 xai console API-key 路由并存，不覆盖原生配置，专注于订阅级别的管理与 Web UI 交互。

核心功能¶

该插件实现了以下核心能力：

• 独立路由与配置：提供独立的 grok 路由和 llm-grok 设置命名空间。
• 订阅登录：通过 Host 拥有的 PKCE 流程与 auth.x.ai 交互，会话存储于 $DSH_HOME/grok-oauth。
• 模型管理：支持官方 grok-4.6 和 grok-4.5 模型，可通过 Web 界面重排、编辑或删除模型目录。
• 上下文与思考：上下文窗口用作 DSH 压缩预算，支持默认思考配置。
• 订阅使用量：在 Grok 卡片中显示订阅额度使用情况。
• 服务端搜索工具：集成 web_search 和 x_search，但非 ctx.web 提供者。
• 图片生成（可选）：在安装 dsh-model-switch v0.4.x 后，提供可选的 grok_image_gen 图片生成功能。

安装与启用¶

安装前需确保已安装 dsh-llm-providers-ui 以显示 LLM 提供者卡片。

dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.9/dsh-llm-providers-ui-0.2.9.tgz
dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-llm-grok/releases/download/v0.3.17/dsh-llm-grok-0.3.17.tgz
dsh web

配置与使用¶

1. 登录：打开 Settings -> LLM Providers -> Grok，点击 Sign in with xAI。系统将启动 Host 拥有的 PKCE 流程，会话仅存储于 Host 本地。
2. 模型目录：卡片显示当前账户的模型列表。你可以折叠目录，编辑默认思考配置，或调整上下文窗口（默认为 500,000 tokens）。
3. 搜索：聊天请求会自动包含服务端搜索工具。注意搜索结果不作为 ctx.web 提供者，且服务端返回的推理项为加密格式。
4. 图片生成（可选）：若安装了 dsh-model-switch v0.4.x，可在设置中启用 grok_image_gen 功能，用于调用 Grok Imagine。

技术细节与注意¶

• 依赖关系：Web UI 卡片依赖 dsh-llm-providers-ui。若在 Headless 模式或无 UI 的 Web 环境下，路由 grok 仍可工作，但 Providers 页面和卡片会被省略。
• 权限与存储：插件不读取 ~/.grok/auth，也不声明 apiKeyEnv。这意味着 Models 页面上的 Grok 行不会显示 “missing-API-key” 徽章。
• 兼容性：已验证兼容 DSH 0.1.2-alpha.4, 0.1.2-rc.1, 0.1.5-rc.1, 和 0.1.5-rc.2 版本。
• 重试策略：默认最大重试 8 次，支持可配置的退避策略。

总结¶

dsh-llm-grok 为 DSH 提供了标准化的 Grok 订阅接入方案，通过 Web 界面解决了复杂的订阅授权和模型目录管理问题。对于需要使用 Grok 订阅且重视配置可视化的用户，该插件提供了不侵入原生路由的替代方案。

GitHub 仓库 | 插件目录