前言¶
在 DeepSeek Harness 的生態中，開發者常需要將圖像生成能力集成到對話流或工作流中。傳統的做法通常涉及跳轉至外部工具或手動拼接 API 請求。爲了在 DSH 環境內直接完成圖像的生成、編輯與導出，需要一種能與對話上下文緊密耦合的解決方案。dsh-image-gen 插件提供了這一能力，它將圖像生成工具集成進 DeepSeek Harness，讓模型在對話中直接輸出圖片，同時提供了一套完整的圖像處理與設計工具鏈。
插件介紹¶
該插件由 GooDAnDReaDY 維護，屬於「聯網工具」類別。它是一個基於 FAL 隊列 API 的 generate_image 工具，核心價值在於將圖像生成能力下沉到 DSH 的對話界面中。圖片會直接在對話內聯顯示，模型既可以接收圖片鏈接（適配任意聊天模型），也可以直接接收圖片內容（需配合 dsh-vision-bridge 或視覺模型）。插件支持多種可插拔提供者，包括 FAL 隊列、OpenAI 兼容 API 以及 ChatGPT/Grok 訂閱。
核心功能¶
插件內置了圖像處理與生成的一站式工具箱：
-
圖像編輯與處理
- 支持圖像放大與背景移除。
- 支持圖像混合與矢量化。
- 提供圖像對比度檢查，並支持將圖片轉換爲 CSS 漸變。
- 支持提取設計令牌。
-
生成與變體控制
- 變體工作臺：提供連續的創造力/去噪強度調節滑塊（範圍 0.05 至 0.95），以及預設快捷按鈕，用於微調生成結果。
- 智能縱橫比裁剪：支持 1:1、16:9 等多種社交與響應式畫面的無損比例裁剪。
- 風格預設：內置精選風格預設，簡化提示詞設置。
-
導出與資產管理
- 項目資源包導出：可自動生成 SVG Favicon、PWA 圖標套件、Manifest 文件以及 OpenGraph 社交卡片預覽。
- 原生側邊欄畫廊：在 DSH 右側原生側邊欄中展示歷史生成記錄，支持查看元數據、複製提示詞及導出鏈接。
- 交互式診斷：提供實時連接測試，支持對 FAL.ai、ComfyUI、Automatic1111 等提供者進行 Ping 測試與狀態監控。
安裝與啓用¶
在安裝前，請確保你的環境滿足依賴要求。插件以當前 DSH 進程權限運行，建議在安裝前檢查源碼與許可證。
前置條件
* Node.js >= 20
安裝命令
dsh plugin add @goodandready/dsh-image-gen@latest
插件依賴以下 DSH 核心組件作爲 Peer Dependencies：
* @deepseek-ai/cordis
* @deepseek-ai/dsh-tools
* @deepseek-ai/dsh-attachment
* @deepseek-ai/dsh-credentials
* @deepseek-ai/dsh-settings
* @deepseek-ai/dsh-llm
* @deepseek-ai/schemastery
典型用法¶
安裝完成後，該插件會自動注入 generate_image 工具及相關操作。以下是幾種典型的工作流：
1. 微調圖像變體
在對話中，可以使用變體工作臺對生成的圖像進行細微調整。通過拖動創造力/去噪強度滑塊（例如在 0.25 或 0.65 的預設位置），或在對話框內直接調用工具，對原圖進行風格化重繪或細節修正。
2. 準備響應式素材
需要爲 Web 項目生成適配不同屏幕的圖片時，使用 smart_crop_image 工具，選擇 auto_focus 或 rule_of_thirds 策略，即可快速獲得 16:9、9:16 等無損比例的裁剪圖，無需手動調整畫布。
3. 生成應用資源
在開發 PWA 或網頁時，可以直接要求插件導出資源包。工具會自動生成 icon-192.svg、icon-512.svg、manifest.webmanifest 等文件，減少手動切圖與配置的時間。
適用場景與注意¶
- 適用人羣：前端開發者、AI 應用創作者、UI/UX 設計師。
- 運行權限：插件運行在當前 DSH 進程上下文中，涉及文件讀寫與網絡請求，請確保安裝來源可信，並遵守系統權限設置。
- 技術棧：需要 Node.js 20 及以上環境，且需正確配置上述核心依賴。
總結¶
goodandready/dsh-image-gen 將圖像生成與處理能力深度整合進 DeepSeek Harness，通過 FAL 隊列 API 等多種提供者，實現了從生成、編輯到資產導出的全流程自動化。它不僅提供了豐富的設計工具，還通過原生側邊欄畫廊和交互式診斷優化了使用體驗。
