前言¶

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 仓库。