前言¶
DeepSeek Harness 通过插件机制扩展功能。此插件将 SuperGrok / X Premium 订阅直接集成到 DSH 中。它复用本地 ~/.grok-bridge/auth.json 中的令牌，因此不需要 xAI API 密钥。
核心功能¶
- 原生 OAuth 提供商，无需 API 密钥
- 复用本地 grok-bridge 令牌
- 支持 headless、web 和任何终端配置文件
- 支持设备码登录
- 自动刷新令牌（过期前 5 分钟和 HTTP 401 时）
- 支持模型：grok-4.7、grok-4.5、grok-4.3
安装与配置¶
安装前需确保环境满足：Node.js ≥ 22.19 和 DeepSeek Harness CLI。
dsh plugin --profile headless add dsh-llm-xai-oauth@latest
安装后需确认插件已加载（ID 为 llm-xai-oauth），否则 /model 路由可能不可用：
dsh --profile headless --dump-config | grep llm-xai-oauth
认证流程¶
执行登录命令，插件会尝试复用已存在的本地令牌：
npx dsh-llm-xai-oauth login
若本地无令牌或需强制重新登录：
npx dsh-llm-xai-oauth login --force
对于 Windows 桌面构建，由于控制台可能不可见，插件会自动在浏览器中打开一个本地页面来完成设备码授权。
Token 刷新机制¶
访问令牌有效期约 1 小时。如果 dsh 进程未运行，它不会刷新令牌。为确保长期运行，需启动独立的守护进程：
npx dsh-llm-xai-oauth daemon --install
该命令会创建用户级 systemd 服务，每分钟检查一次令牌并在过期前 5 分钟刷新。如果不想使用系统服务，也可以使用 cron 定期执行：
*/20 * * * * npx --yes dsh-llm-xai-oauth refresh >/tmp/dsh-xai-refresh.log 2>&1
使用示例¶
在任意配置文件中指定 xai 提供商和 grok-4.7 模型：
dsh --profile tui --provider xai --model grok-4.7
或直接使用默认配置：
dsh --profile headless --provider xai --model grok-4.7
注意事项¶
- 更新插件时必须使用
@latest，否则会固定在旧版本。 - Windows 桌面构建需要首次运行时的视觉引导。
- Token 刷新依赖于守护进程，如果 dsh 未运行且没有守护进程，Token 过期后会导致 401 错误。
- 默认模型配置位于
$DSH_HOME/settings.yaml，需设置为agent-default-model -> xai / grok-4.7。
