前言¶

DeepSeek Harness (DSH) 的插件化架構允許開發者擴展其模型工具集。dsh-grok-image 插件旨在解決在 DSH 環境中直接使用 Grok Imagine 生成圖片的需求。它將 Grok Imagine 的訂閱端點能力註冊爲 DSH 的標準模型工具 image_gen，方便智能體開發與編排。

插件簡介¶

該插件由用戶 clarkzhao 維護，遵循 MIT 許可證。它針對 DSH 0.1.7-rc.2 版本開發，主要功能是將 Grok Imagine 的圖片生成能力接入 DSH 體系。

核心功能¶

1. 工具註冊：將 Grok Imagine 註冊爲 DSH 的模型工具 image_gen。
2. API 調用：走 Grok 訂閱端點 https://cli-chat-proxy.grok.com/v1/images/generations。
3. 模型配置：支持 grok-imagine-image-quality 模型，並允許配置。
4. 比例控制：支持多種圖片比例：auto、1:1、16:9、9:16、3:2、2:3。
5. 內聯與落盤：
   • 默認開啓 inline_image，將圖片內聯進對話。
   • 生成結果寫入 DSH 附件服務，支持 Web UI 直接渲染。
   • 同時在本地 outputDir（默認 ~/grok-images）落盤保存。
6. 成本記錄：用量記入 usage.log.jsonl。
7. AIRP 支持（可選）：若安裝了 dsh-airp，生成圖片可掛載到 /airp-media，工具回執中返回絕對 URL，支持 Markdown 渲染。

安裝與啓用¶

通過 DSH CLI 安裝插件：

dsh plugin --profile web add dsh-grok-image

安裝後，bundle 寫入 grok-image 並註冊 image_gen 工具。安裝完成後需要重啓 DSH 進程才能生效。

配置示例¶

在 DSH 的配置文件中添加以下內容：

- id: grok-image
  name: dsh-grok-image
  config:
    baseURL: https://cli-chat-proxy.grok.com/v1
    apiKeyEnv: GROK_SESSION_TOKEN
    proxy: http://127.0.0.1:7890
    model: grok-imagine-image-quality
    outputDir: ~/Workspace/grok-images
    usageLog: true

注意：憑據通過環境變量 GROK_SESSION_TOKEN 讀取。若未自動同步，需參考 dsh-llm-grok 文檔將 Grok CLI token 掛入 DSH。

使用限制¶

1. 功能範圍：當前僅實現了 image_gen，image_edit（圖生圖）與 video_gen 未實現。
2. 用戶權限：生成圖片依賴 Grok 訂閱端點，免費/X Basic 用戶可能會遇到零額度限制（這是 SuperGrok 專屬能力）。
3. 性能與超時：生成耗時可達 1-2 分鐘，工具超時設置爲 300 秒。
4. 模型兼容性：若當前模型適配器不支持圖片內容（如 deepseek），需將 inline_image 設爲 false，工具僅返回保存路徑。

結語¶

dsh-grok-image 插件爲 DSH 生態提供了接入 Grok Imagine 能力的標準入口。對於需要集成高級圖片生成的智能體開發場景，這是一個直接可用的工具。

• 倉庫地址：https://github.com/clarkzhao/dsh-grok-image
• 目錄頁面：https://www.skillhub.cn/plugins/clarkzhao/dsh-grok-image