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