dsh-imagegen

English | 简体中文

这是一个面向 DeepSeek Harness 的通用生图插件，不绑定具体服务商。插件会注册 image_generate Agent 工具，并支持：

• Gemini 兼容的 generateContent 接口
• image2 / OpenAI 兼容的 /images/generations 接口
• Base64 图片和远程图片 URL 两种响应形式
• 在 DSH 插件设置页中动态配置
• API 凭据脱敏，不向页面回显
• 输出路径限制在当前工作区内
• 图片文件大小限制

安装

从 GitHub 直接安装到 DSH Web profile：

dsh plugin --profile web add github:ZhaoJun233/dsh-imagegen

本地开发时可改为链接当前检出目录：

dsh plugin --profile web add link:C:\path\to\dsh-imagegen

安装或更新插件代码后，需要重启 DSH Web Host。

配置

打开 设置 → 插件 → 插件配置 → 生图服务，填写以下内容：

• 协议：auto、gemini 或 image2
• API URL
• API Key 或保存 Key 的环境变量名
• 鉴权请求头和可选前缀
• 默认模型
• image2 默认质量
• 工作区内的默认输出目录

API Key 输入框是只写字段。设置接口会移除 secret 字段，页面不会读取或回显已经保存的 Key。

公开源码中的 URL 默认为空。首次使用前必须填写实际接口地址和凭据。

Gemini 兼容配置示例

{
  "protocol": "gemini",
  "url": "",
  "apiKeyEnv": "IMAGEGEN_API_KEY",
  "apiKeyHeader": "x-goog-api-key",
  "apiKeyPrefix": "",
  "defaultModel": "your-image-model"
}

填写基址时，插件会按需自动拼接 /v1beta/models/{model}:generateContent。

image2 兼容配置示例

{
  "protocol": "image2",
  "url": "",
  "apiKeyEnv": "IMAGEGEN_API_KEY",
  "apiKeyHeader": "Authorization",
  "apiKeyPrefix": "Bearer ",
  "defaultModel": "gpt-image-2",
  "defaultQuality": "medium"
}

填写基址时，插件会按需自动拼接 /images/generations。插件请求 b64_json，同时兼容返回可下载图片 URL 的服务。

Agent 工具

image_generate 支持以下参数：

• prompt：必填，生图提示词
• model：临时覆盖默认模型
• aspect_ratio：宽高比
• image_size：Gemini 兼容接口的分辨率等级
• size、quality：image2 兼容接口的尺寸和质量
• output_path：当前工作区内的相对输出路径