前言¶

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