前言¶
DeepSeek Harness（DSH）支持通過插件擴展功能。dsh-openrouter-imagen-v2 是一個插件，它利用 OpenRouter 的圖像 API，在 DSH 內部提供了一個獨立的工作臺和一個供 Agent 調用的工具。它解決了需要在智能體流程中集成圖像生成能力的需求。
核心功能¶
該插件提供以下能力：
- 獨立工作臺：雙欄佈局，左側爲圖片區與歷史記錄，右側爲對話區，分隔條支持拖動。
- 兩種出圖方式：既可以在工作臺手動生成，也可以通過 Agent 調用工具生成。
- 提示詞處理：支持「直接出圖」（輸入即提示詞）或「讓 AI 寫提示詞」（默認使用
google/gemini-2.5-flash模型）。 - 參考圖支持：支持最多 4 張參考圖，支持文件選擇、粘貼或拖放。
- 模型管理：支持配置模型清單（最多 16 個），並可指定默認模型。
- 種子回填：生成後自動寫入實際使用的種子，便於復現。
- 生成記錄：保留最近 60 條記錄，支持按相同參數重新生成。
- 隨包 Skill：包含一個 skill，用於指導模型推導畫風與提示詞。
安裝與啓用¶
安裝前請確認 DeepSeek Harness 版本爲 0.2.x，且 Node.js 版本爲 ^22.19.0 或 >=24.0.0。
通過 Git 安裝：
dsh plugin --profile desktop add git+https://github.com/fancyui/dsh-openrouter-imagen-v2.git
安裝完成後重啓 DSH，在側欄「插件」組下即可找到「圖像生成」入口。
使用¶
工作臺操作¶
進入「圖像生成」工作臺後，默認參數爲：數量 1、質量 medium、背景 auto、寬高比 16:9、分辨率 1K。
- 提示詞模式：在右欄輸入描述，選擇「直接出圖」或「讓 AI 寫提示詞」。
- 參考圖：支持拖放或粘貼圖片，圖片僅隨當次請求發送，不寫入記錄。
- 種子：生成後種子會自動回填到輸入框，點擊「隨機」可清空。
設置配置¶
點擊右上角設置，可配置以下內容：
- 密鑰：配置 OpenRouter API Key，用於請求驗證與額度查詢。
- 模型：管理模型清單與默認模型。
- 高級：設置提示詞模型、保存目錄（默認爲
generated-images）、Provider 排序及附加請求體 JSON。
Agent 調用¶
Agent 可調用工具 openrouter_generate_imagen_v2 生成單張 PNG 圖片。
參數說明：
* prompt：必填，畫面描述。
* save_dir：可選，保存目錄（相對會話工作目錄）。
* file_name：可選，文件名主幹（擴展名固定爲 .png）。
* aspect_ratio、resolution、quality、background、model、seed：可選，未指定時使用工作臺設置。
固定行爲：
單次調用僅生成一張圖片。
注意事項¶
- 需要有效的 OpenRouter API Key。
- DeepSeek Harness 版本要求 0.2.x。
- 保存目錄限制在會話工作目錄內，越界會報錯。
- 密鑰不會通過任何接口返回原文。
- 分辨率檔位
512、1K、2K、4K爲名稱，不對應固定像素值。 - Agent 調用單次僅生成一張 PNG 圖片。
結語¶
該插件補充了 DSH 在模型推理方面的能力，使圖像生成成爲 DSH 生態的一部分。更多細節與源碼可參考下方鏈接。
