前言¶
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。
