DeepSeek Harness (DSH) 的理念是「一切皆插件」。本文介紹的 dsh-plugin-grok 是一個開發者預覽插件，它利用本地的 Grok Build CLI，爲模型提供文本、圖像和視頻生成的能力。它不通過原始 HTTP 調用 Imagine，而是直接執行本地的 grok 二進制文件。
插件概況¶
- 插件名稱：
dsh-plugin-grok - 維護者：
toolazytoname - 分類：模型推理
- 許可證：MIT
- 核心價值：將本地的 Grok Build CLI 驅動爲 DSH 的工具，支持文本、圖像和視頻生成。
安裝與啓用¶
在 Web profile 下安裝該插件：
dsh plugin --profile web add github:toolazytoname/dsh-plugin-grok
安裝後需要重啓 dsh web 並強制刷新瀏覽器。
如果 pnpm 版本 >= 10 阻止了 git 的 prepare 腳本，可以在對應的 profile 配置中允許構建：
# 在 ~/.dsh/profiles/web/pnpm-workspace.yaml
allowBuilds:
dsh-plugin-grok: true
或者直接從本地檢出目錄安裝：
dsh plugin --profile web add /absolute/path/to/dsh-plugin-grok
前置條件¶
使用此插件前，需要滿足以下條件：
- 本地環境：安裝 Grok Build CLI，確保
grok命令在PATH中（通常位於~/.grok/bin/grok）。 - 認證方式：提供以下其中一種（官方 CLI 優先級如下）：
grok login：SuperGrok 或 grok.com 的會話，會寫入~/.grok/auth.json。如果兩者同時存在，此方式優先。XAI_API_KEY：從 console.x.ai 獲取的密鑰。
- 網絡代理：在中國大陸使用時，需設置環境變量
https_proxy或HTTPS_PROXY（例如 Clash 的混合端口http://127.0.0.1:7891），插件會轉發這些變量。
核心功能¶
該插件爲模型暴露了三個工具：
grok_ask：用於文本處理，包括代碼審查、規劃和編寫。底層調用grok --prompt-file … --always-approve。grok_imagine_image：用於生成或編輯靜態圖像。底層調用grok，限制工具集爲image_gen和image_edit。grok_imagine_video：用於生成視頻片段。底層調用grok，限制工具集爲image_gen和image_to_video。Grok 原生不支持文本生成視頻，該插件通過先生成靜態圖再轉視頻的方式實現。
如果缺少 grok、未提供認證、提示詞爲空、命令非零退出或媒體運行後無法解析路徑，所有操作都會失敗。
典型用法¶
可以通過 CLI 測試插件狀態和功能：
# 查看插件狀態
npx dsh-plugin-grok status
# 文本生成
npx dsh-plugin-grok ask "summarize this repo"
# 圖像生成
npx dsh-plugin-grok image "a red cube on a table" --ratio 1:1
# 視頻生成
npx dsh-plugin-grok video "slow cinematic push-in" --duration 6 --resolution 480p
注意事項與限制¶
- 配額消耗：使用
grok login的用戶消耗 SuperGrok/coding-plan 配額；使用 API Key 的用戶消耗 console 積分。 - 生成速度：圖像和視頻生成速度較慢。
- 視頻生成機制：視頻是先生成靜態幀再動畫化，並非原生文本生成視頻。
- 進程隔離：每次工具調用都會啓動一個本地的
grok進程，不使用 ACP 或grok agent stdio包裝器。 - 開發狀態：DeepSeek Harness 處於開發者預覽階段，Cordis 的
apply+ctx.tools.register接口可能會發生變化。 - 許可證：MIT License。
