dsh-imagedit：DeepSeek Harness 本地圖像處理與平滑生圖插件

前言¶

DeepSeek Harness (DSH) 的插件體系旨在解決特定場景下的自動化問題。在圖像處理領域，模型生成的圖像往往存在背景不乾淨、邊緣鋸齒或形狀破碎等問題。dsh-imagedit 插件提供了一套確定的本地圖像編輯管線，既能進行精確的摳圖、裁剪、調色等操作，也能通過 generate_image 工具優化生圖提示詞，減少生成斷裂形狀的瑕疵。

插件介紹¶

名稱：dsh-imagedit
維護者：bbbz123
分類：工作流
許可：MIT

本插件集成了基於 flood-fill 的快速摳圖與基於 rembg 的 AI 摳圖兩種模式，支持 Sprite Sheet 生成與多格式導出。

核心功能¶

插件主要包含以下能力：

• 摳圖：支持 remove_bg: quick（基於泛洪填充，無需模型，速度快）或 remove_bg: rembg（AI 模式）。
• 基礎操作：trim（修剪）、flip h/v（翻轉）、rotate（旋轉）、padding（填充）、canvas WxH（畫布縮放居中）。
• 調色：調整亮度、對比度和飽和度。
• 濾鏡：模糊與銳化。
• 修飾：圓角、邊框（寬度與顏色）、自動方向校正（EXIF）。
• 批量處理：支持 JSON manifest 配置、遞歸目錄處理、精靈圖生成與 sprites.json 輸出。
• 導出：PNG（自動使用 oxipng/pngquant 壓縮）、JPEG、WebP（可設置質量）。

安裝與啓用¶

1. 安裝插件：

    dsh plugin --profile web add github:bbbz123/dsh-imagedit

重啓 `dsh web` 後，工具欄會出現 `image_edit` 工具。

2. 調整 Python 解釋器（如需）：
   設置環境變量 DSH_IMAGEDIT_PYTHON 指向目標解釋器。

典型用法¶

1. Agent 工具調用¶

Agent 可以通過結構化參數調用 image_edit。例如生成一個帶背景的圖標：

{
  "input": "gen/sword.png",
  "remove_bg": "quick",
  "bg_color": "auto",
  "canvas": "256x256",
  "padding": 16,
  "formats": ["png", "webp"]
}

2. CLI 命令行執行¶

插件同時也提供 CLI skill，適用於本地批處理：

# 單圖處理：快速摳圖 + 畫布調整
python scripts/asset_pipeline.py run --input item.png --remove-bg-quick auto --canvas 256x256 --padding 16 --out-dir output/images/edited

# 組合編輯：旋轉、翻轉、調色、圓角、邊框
python scripts/asset_pipeline.py run --input item.png --rotate 90 --flip h --brightness 1.1 --saturation 1.2 --rounded 30 --border "4,#FF0000" --exports png jpg --out-dir output/images/edited

# 批量處理目錄
python scripts/asset_pipeline.py batch --dir ./photos --rotate 90 --exports jpg

# 生成精靈圖
python scripts/asset_pipeline.py batch --manifest manifest.json

推薦工作流¶

結合 dsh-draw 或 image_generate 進行生成，再通過 image_edit 進行後處理，是獲取高質量資源圖的標準流程：

dsh-draw / image_generate (prompt: "flat solid white background, no shadows")
  → image_edit (remove_bg: quick, canvas, padding)
  → batch manifest with "sheet" for sprite atlas

環境依賴¶

• Python 3.10+
• Pillow（必需）
• rembg（可選，僅用於 AI 摳圖）
• oxipng / pngquant（可選，用於 PNG 壓縮）

注意事項¶

• 插件以當前 DSH 進程的權限運行。
• 安裝前建議檢查源碼與許可證。
• generate_image 工具會自動在提示詞後追加平滑後綴，以修正 GPT-image-2 的生成瑕疵。

相關資源¶

• GitHub 倉庫：https://github.com/bbbz123/dsh-imagedit
• 插件目錄：https://www.skillhub.cn/plugins/bbbz123/dsh-imagedit