前言¶

在 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。