前言¶
DeepSeek Harness (DSH) 通過插件機制擴展功能。dsh-jimeng 是一個插件，用於將火山方舟（Volcengine Ark）的即夢（Seedream）圖片生成模型接入 DSH。它解決了在 DSH 對話中直接調用外部繪圖 API 的需求，讓智能體具備生成圖片的能力。
該插件由用戶 Quqing-future 維護，採用 MIT 許可證。
核心功能¶
插件提供兩種生圖方式，並包含完整的配置與交互功能：
- 對話工具：支持
generate_image（文生圖）和image_to_image（圖生圖）工具。在對話中直接調用即可，圖片會落盤並直接顯示在對話消息內。 - 圖生圖支持：支持 1-10 張參考圖，支持本地路徑、URL 或 Data URL 格式。
- 設置面板：提供手動生圖面板，可在設置 → 「即夢生圖」分區中操作。
- 模型選擇：內置常見 Seedream 模型下拉列表，支持「檢測可用模型」按鈕自動探測生圖模型，也支持自定義輸入。
- 可配置項：可編輯 API Key、baseUrl、文生圖/圖生圖模型、默認尺寸、水印開關、保存目錄等，配置持久化。
- 圖片落盤：生成的圖片自動保存到
~/.dsh/jimeng-images/。 - 安全機制：API Key 僅在服務端存儲，前端僅接收掩碼後的 host，不會暴露明文 Key。
安裝與啓用¶
通過命令行安裝插件：
dsh plugin --profile web add link:G:\DSHJob\plugins\dsh-jimeng
或者手動安裝：將 "dsh-jimeng": "file:G:/DSHJob/plugins/dsh-jimeng" 加入 web profile 的 package.json dependencies，並在 dsh.profile.bundles 中添加 "dsh-jimeng"，最後執行 pnpm install。
使用方式¶
安裝並重啓 DSH Web Host 後，有兩種使用方式：
- 對話生圖：直接在對話中輸入指令，例如「幫我畫一隻鯨魚」，AI 會自動調用
generate_image工具。 - 手動生圖：進入設置頁面，找到「即夢生圖」分區，手動填寫 prompt 或選擇參考圖進行生成。
注意事項¶
- API Key 獲取：Key 需從火山方舟控制台獲取，請注意區分「API Key」和賬號級的 AccessKey/SecretKey（AK/SK）。
- 模型版本：Seedream 3.0 的文生圖和圖生圖是不同模型；4.0 起模型統一，可同時用於文生圖和圖生圖。
- 圖生圖限制：單次參考圖上限爲 10 張（服務端限制），插件在本地會進行攔截，超限請求不會發送。
- 運行環境：需要 Node.js >= 20 以及 DeepSeek Harness 0.1.x。
生態與鏈接¶
該插件遵循 DSH 「一切皆插件」的理念，可接入任何兼容 OpenAI /images/generations 接口的服務（如硅基流動或自定義中轉）。
