前言¶

在 DeepSeek Harness（DSH）里做智能体时，常见需求是：根据一句描述生成一张图，同时把外部生图网关的 baseUrl、模型名、API Key 管理起来。dsh-image-gen 是一个 DSH 插件，把这类调用收敛为命令、对话触发或工具调用。下面介绍它的定位、安装、配置和使用边界。

这是什么¶

dsh-image-gen 是 hoyyang/dsh-image-gen，定位是 DeepSeek Harness 的通用 AI 生图插件。它接入 OpenAI 兼容生图网关（OpenAI Images API 形状），支持一句话出图。

许可证：MIT，署名 MIT © 2026 Hoy Yang。

它适合需要让 DSH 智能体按描述调用外部生图网关，同时希望统一配置入口和默认安全行为的场景。

核心功能¶

• 提供 /dsh-image-gen 命令，用于一句话出图。
• 支持直接对话触发生图。
• 提供工具 dsh_image_gen，可手动或脚本化调用。
• 提供 dsh_image_gen_config 用于检查配置。
• 接入 OpenAI 兼容生图网关，网关需具备 OpenAI Images API 形状；返回 URL 而非 b64_json 的网关暂不支持。
• 支持设置页可视化配置 baseUrl、模型、API Key，保存后即时生效。
• 支持环境变量、profile 配置、本地文件等配置方式。
• 支持 --size 与 --quality 参数。
• 默认行为：密钥仅存本机、出图目录权限 0700、错误自动脱敏、不写日志。
• 单次调用只生成一张图；失败不自动重试。

安装¶

在可用的 dsh 环境中执行：

dsh plugin --profile web add github:hoyyang/dsh-image-gen

GitHub 仓库地址：

https://github.com/hoyyang/dsh-image-gen

插件会以当前 dsh 进程权限运行。安装前建议检查源码、许可证，以及即将填入的网关地址、密钥来源和出图目录是否符合本机策略。

配置¶

需要配置的核心字段是：baseUrl、模型、API Key。

设置页¶

在设置页中找到 dsh-image-gen，填入网关 baseUrl、模型名和 API Key，保存后即时生效。

环境变量¶

export DSH_IMAGE_BASE_URL="<baseUrl>"
export DSH_IMAGE_MODEL="<model>"
export DSH_IMAGE_API_KEY="<apiKey>"

环境变量改完需重启 dsh。

profile 配置¶

支持通过 profile 配置提供插件配置，适合已有 profile 管理的场景。

本地文件¶

适合无 UI 的 profile。本地配置文件权限须 0600：

cat > ~/.dsh/dsh-image-gen.json <<'EOF'
{
  "baseUrl": "<baseUrl>",
  "model": "<model>",
  "apiKey": "<apiKey>"
}
EOF
chmod 600 ~/.dsh/dsh-image-gen.json

使用¶

命令¶

/dsh-image-gen 一只趴在窗台上的橘猫
/dsh-image-gen 一只趴在窗台上的橘猫，午后阳光，油画风格
/dsh-image-gen <描述> [--size=1024x1536] [--quality=high]

对话¶

在对话中直接说：

帮我生成一张 xx 的图

工具¶

• 使用 dsh_image_gen 手动或脚本化调用。
• 使用 dsh_image_gen_config 检查配置。

行为边界¶

• 生图网关独立配置，不影响 DeepSeek Harness 的聊天模型路由。
• 单次调用只生成一张图。
• 调用是付费且非幂等的：超时或网络歧义失败后不会自动重试，需要手动发起。
• 密钥仅存本机；出图目录权限 0700；错误自动脱敏、不写日志。
• 返回 URL 而非 b64_json 的网关暂不支持。

结尾¶

dsh-image-gen 的价值在于把 DSH 智能体接入 OpenAI 兼容生图网关这件事拆成命令、对话、工具和配置检查几个入口，同时把密钥、目录权限和日志边界写进默认行为。GitHub 仓库：https://github.com/hoyyang/dsh-image-gen。