前言¶

DeepSeek Harness (DSH) 採用插件化架構，旨在爲開發者提供靈活的 LLM 集成能力。接入 Grok Build 需要處理複雜的 OAuth 認證流程，包括管理刷新令牌和同步訪問令牌。手動維護這些步驟不僅繁瑣，還存在安全風險。這個插件通過連接 Grok Build CLI 的本地會話和 DSH 的憑據服務，實現了認證狀態的複用與同步。

這是什麼¶

這是一個託管 Cordis bundle。由 shaomingbo 維護。它讀取 Grok Build 的本地會話，將刷新令牌處理委託給官方 grok 二進制文件，僅將訪問令牌同步到 DSH 的憑據服務，併爲 Grok Build 訂閱代理 provision pi-ai 路由。

核心功能¶

• 託管 Cordis bundle。
• 讀取 Grok Build 的本地會話。
• 將刷新令牌處理委託給官方 grok 二進制文件。
• 僅將短命訪問令牌同步到 DSH 的憑據服務。
• 爲 Grok Build 訂閱代理 provision pi-ai 路由。
• 不包含、上傳或提交任何令牌。

安裝與啓用¶

在安裝前，請確保環境滿足以下要求：
- Node.js 22.19 或更高版本
- DSH 安裝了 dsh-llm-pi-ai 適配器
- 已安裝官方 Grok Build CLI 並完成登錄

安裝命令如下：

npx --yes github:shaomingbo/dsh-grok-build-auth-bridge#v0.1.0

該命令會將包及其 Cordis bundle 添加到 ~/.dsh/profiles/web/package.json，並運行 pnpm install。安裝完成後，請重啓 dsh web。

典型用法¶

在登錄 Grok Build CLI 後，可以通過以下命令驗證狀態並安裝插件：

grok update
grok login
grok models
npx --yes github:shaomingbo/dsh-grok-build-auth-bridge#v0.1.0

重啓 dsh web 後，插件會自動創建路由。你需要在 DSH 的設置中配置以下參數（不會覆蓋現有提供者）：
- Provider: grok-build
- Model: grok-4.6
- Protocol: OpenAI Responses
- Endpoint: https://cli-chat-proxy.grok.com/v1

適用場景與注意¶

• Unix 系統安全：插件會拒絕讀取 ~/.grok/auth.json 如果該文件對組或其他人可訪問。請使用 chmod 600 ~/.grok/auth.json 確保權限。
• 環境變量干擾：如果父環境導出了 GROK_BUILD_ACCESS_TOKEN，它會遮蔽 DSH 的可寫憑據存儲區。在啓動 DSH 前請取消設置該變量。
• 權限風險：插件以 DSH 進程權限運行。在安裝前，建議檢查源碼以確認其行爲符合預期。
• MIT 許可證：該插件遵循 MIT 許可證。

短結尾¶

該插件通過複用官方 CLI 的安全機制，簡化了 DSH 中 Grok Build 的接入流程。通過委託刷新邏輯和僅同步訪問令牌，它在便利性與安全性之間取得了平衡。更多細節可查閱社區目錄或 GitHub 倉庫。