dsh-imagegen：爲 DeepSeek Harness 提供繪圖能力的插件

在 DeepSeek Harness（DSH）的生態中，爲智能體添加多模態能力往往需要手動處理外部服務或複雜的集成。dsh-imagegen 插件通過註冊 generate_image 工具，直接將繪圖能力集成到對話流中，讓智能體可以在對話中請求並展示圖片。

插件介紹¶

這是一個面向 DeepSeek Harness 0.2.x 的圖像生成插件，由用戶 little-traincar 維護。它解決了智能體需要調用繪圖 API 並將結果展示在聊天界面中的需求。

核心能力¶

內聯渲染：生成的圖片會附加到對話中，直接渲染在聊天窗口，同時也提供同源的 /imagegen/<file> 鏈接作爲備選。
靈活配置：支持爲每個渠道配置模型 ID，支持別名和調用時的覆蓋。
開放提供商表：內置豆包 Seedream 和阿里雲 Qwen，兼容任何 OpenAI 兼容的 /images/generations 端點（包括網關、中繼或本地部署）。
無水印：默認發送 watermark: false，部分模型拒絕該字段時提供開關。
文字嵌入：提示詞中的文字會被逐字嵌入到圖片中，不會被改寫。
圖生圖：支持通過 URL、本地絕對路徑或 Data URI 傳入參考圖。
保存到磁盤：所有圖片默認保存到 outDir。
多候選與容錯：支持 supportsN 的渠道一次請求生成多張；部分請求失敗時，成功的圖片會被保留。

安裝與啓用¶

在 Desktop 模式下，需要先完全退出應用，再執行安裝命令：

dsh plugin --profile desktop add @little-traincar/dsh-imagegen

重新打開應用即可加載。

配置說明¶

安裝後，進入 Settings → imagegen。你需要爲使用的渠道配置 API Key。

內置提供商：插件內置了豆包和阿里雲 Qwen 的配置，只需填寫對應的 API Key。
自定義提供商：支持任何 OpenAI 風格的 POST <baseUrl>/images/generations 接口。在 Custom providers 字段填入配置，例如本地 Ollama：

{
  "local": {
    "baseUrl": "http://127.0.0.1:11434/v1",
    "model": "x/flux2-klein",
    "apiKeyOptional": true,
    "sendWatermark": false,
    "size": "1024x1024"
  }
}

模型 ID：模型 ID 可在 Settings → imagegen → Models 中逐個修改，或在 cordis.patch.yml 中統一配置。支持別名，調用時可指定 provider 和 model。

使用示例¶

在對話中直接輸入繪圖請求。智能體會調用 generate_image 工具，圖片會直接渲染在聊天窗口中。

例如：
“Draw a summer coffee-shop poster: retro magazine collage, cream yellow and coffee brown, portrait; headline ‘Summer Ice Cafe Festival’, subtitle ‘Half price for the second cup.’”

注意事項與卸載¶

該插件要求 DeepSeek Harness 版本爲 0.2.x（兼容 0.2.0-rc.2 和 0.2.1-alpha.1）。

卸載時，必須先完全退出應用，然後運行：

dsh plugin --profile desktop remove @little-traincar/dsh-imagegen

注意：卸載命令不會刪除已生成的圖片（位於 outDir）和配置文件中的 imagegen 段落，如需清理需手動處理。

dsh-imagegen 提供了一個靈活、無水印且兼容性好的繪圖方案，適合需要在對話流中直接輸出圖片的場景。更多細節可查看 GitHub 倉庫。