前言¶

在 DeepSeek Harness（DSH）中接入一个 LLM Provider，常见工作不止是把 baseURL 配好，还要处理模型列表、协议差异、上下文窗口、输出限制、推理控制，以及凭据刷新。DSH 的理念是“一切皆插件”；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不能理解成官方应用商店。

下面介绍 OpenSaozi/dsh-xai-catalog。它是一个面向 DeepSeek Harness 的 xAI and Grok Coding Plan LLM Provider 模型目录插件，目标是在 DSH 中接入可用的 Grok 模型，并提供 Grok 4.6 的已核实配置预设。

这是什么¶

OpenSaozi/dsh-xai-catalog 由 OpenSaozi 的 GitHub 仓库提供，许可证为 MIT。它是一个独立集成，不与 xAI、DeepSeek 或 pi-ai 维护者存在隶属或背书关系。Grok 及相关模型名称是各自权利人的商标。

这个插件解决的问题很具体：让持有 xAI API key 或 xAI subscription 的用户，在 DeepSeek Harness 中使用 Grok 4.6 的 coding 和 reasoning 能力。

核心能力¶

根据已核实资料，该插件主要提供以下能力：

1. 查询 xAI /models endpoint，动态展示当前账号可用的 Grok 模型。
2. 提供 Grok 4.6 的已核实配置预设，包括 context windows、output limits 和 reasoning controls。
3. 注册自己的 xai adapter：grok-4.3 和 grok-build-0.1 使用 Chat Completions；grok-4.5 和 grok-4.6 使用 Responses。
4. 通过 XAI_OAUTH_CREDENTIAL 读取 JSON credentials，复用 pi-ai 的 built-in xAI OAuth handler 刷新过期 token，并通过 Harness credential service 写回轮换后的凭据。
5. 将 OAuth JSON 保持在 Cordis configuration 和 logs 之外；只有 handler-derived access token 会作为 request-level auth override 到达 exported PiAiAdapter。
6. 不注入额外 prompts、headers、token overhead 或 transport alterations。

这里需要区分“模型可用”和“协议细节可用”。xAI /models endpoint 能证明某个模型 ID 对当前账号可用，但不直接证明 protocol、context capacity、modalities 或 reasoning controls。新的模型 ID 需要维护对应的 descriptor 后才会被暴露。

安装与启用¶

安装时需要指定 DSH profile 和要安装的 commit revision。先替换命令中的 <profile> 和 <commit-sha>，再执行下面的命令：

dsh plugin --profile <profile> add github:OpenSaozi/dsh-xai-catalog#<commit-sha>

这一步将已评审的修订版本安装到指定的 DeepSeek Harness profile 中。

仓库中包含 dsh.bundle patch 和 prebuilt runtime artifacts，因此安装流程不要求本地构建。

安装后的 bundle 会提供如下 Cordis configuration：

- id: model-catalog-xai
  name: '@deepseek-ai/dsh-model-catalog-xai'
  config:
    oauthCredentialEnv: XAI_OAUTH_CREDENTIAL
    baseURL: https://api.x.ai/v1
    displayName: xAI

这段配置说明了插件的入口标识、凭据环境变量、baseURL 和展示名称。

典型用法¶

这个插件适合已经完成 xAI 凭据准备的用户。使用流程大致如下：

1. 准备一个可写入 DSH profile 的环境。
2. 使用上面的安装命令安装指定 commit。
3. 确保 XAI_OAUTH_CREDENTIAL 指向已经存储的 xAI JSON credential 引用。
4. 在 DeepSeek Harness 的模型选择中查看由插件暴露的 Grok 模型。
5. 选择 Grok 4.6 进行 coding 或 reasoning 相关任务。

凭据刷新会在插件挂载时触发，也会在 XAI_OAUTH_CREDENTIAL 变化时触发。如果 refresh 失败或未通过认证，插件会保留 maintained catalog 并记录错误，不会把模型列表替换成空数据。

需要注意，这个插件不提供 login UI。它会读取已经存储在 XAI_OAUTH_CREDENTIAL 中的凭据并自行刷新；重新登录仍然需要部署侧把 pi-ai 的 xAI handler result 写回该引用。

适用场景与注意¶

适合的使用者画像比较明确：已有 xAI API key 或 xAI subscription，并且希望在 DeepSeek Harness 中使用 Grok 4.6 的 coding 和 reasoning 能力。

使用前建议注意以下几点：

1. 这是一个独立集成，不代表 xAI、DeepSeek 或 pi-ai 的官方产品、官方目录或官方背书。
2. 插件以当前 dsh 进程权限运行；安装前应检查源码、依赖范围和 MIT 许可证。
3. 新模型 ID 不会仅凭 xAI /models 返回就自动获得完整协议配置；需要维护对应 descriptor。
4. 凭据安全模型依赖 XAI_OAUTH_CREDENTIAL 的部署方式；插件本身不负责登录 UI。
5. Grok、grok-4.3、grok-4.5、grok-4.6、grok-build-0.1 等名称应保持原有大小写，避免误写成其他模型。

结尾¶

OpenSaozi/dsh-xai-catalog 的价值在于把 xAI / Grok 的模型目录、协议适配、Grok 4.6 配置预设和凭据刷新集中到一个 DSH 插件里，降低在 DeepSeek Harness 中接入 Grok 的配置复杂度。

当前已核实资料未给出目录页 URL，因此这里不列出目录页地址。仓库地址如下：

https://github.com/OpenSaozi/dsh-xai-catalog