前言¶

在 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