小紫 图片处理插件

简介

小紫 图片处理插件 v1.0，跨平台本地图片工具（Windows / macOS / Linux）：

• resize 按宽/高/比例缩放
• compress 压缩体积（可调质量、限宽）
• convert 格式互转 png / jpg / webp / bmp 等
• info 查看尺寸、格式、文件大小
• 依赖 Pillow 一个库，本地处理不上传

典型流程：info 看原图 → resize/compress 处理 → convert 转目标格式

操作说明

resize 参数：

• width 指定宽度，高度等比（默认 keep_aspect=true）
• height 指定高度，宽度等比
• scale 比例如 0.5 表示 50%
• keep_aspect false 可强制拉伸到指定宽高

compress 参数：

• quality 1-100，默认 85（JPEG/WEBP）
• max_width 超出则先缩小再压，如 1920
• 不填 output 则自动命名 *_compressed.jpg

convert 参数：

• format：png / jpg / webp / bmp / tiff / gif
• 透明 PNG 转 JPG 自动白底

安装

1. 解压到 D:\xiaozi-plugins\文档处理\图片处理插件\
2. 复制 python/ 到本目录
3. 安装依赖：python\python.exe -m pip install Pillow
4. 测试：run.bat --action info --filepath D:\pics\test.jpg

命令行

run.bat --action info --filepath D:\pics\photo.jpg
run.bat --action resize --filepath D:\pics\photo.jpg --width 800
run.bat --action resize --filepath D:\pics\photo.jpg --scale 0.5
run.bat --action compress --filepath D:\pics\photo.jpg --quality 80 --max_width 1920
run.bat --action convert --filepath D:\pics\photo.jpg --format png
run.bat --action convert --filepath D:\pics\photo.png --format webp -o D:\pics\photo.webp

注册技能 image_tool

名称： image_tool

描述： 图片处理 v1.0，跨平台。resize/compress/convert/info缩放压缩转格式查信息。用户缩小图片、压缩、转png/jpg/webp时使用。需filepath。依赖Pillow。

脚本： D:\xiaozi-plugins\文档处理\图片处理插件\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {"type": "string", "enum": ["resize", "compress", "convert", "info"], "description": "操作类型"},
    "filepath": {"type": "string", "description": "输入图片路径"},
    "output": {"type": "string", "description": "输出路径"},
    "width": {"type": "string", "description": "resize宽度"},
    "height": {"type": "string", "description": "resize高度"},
    "scale": {"type": "string", "description": "resize比例0.5"},
    "keep_aspect": {"type": "string", "description": "保持比例"},
    "quality": {"type": "string", "description": "压缩质量1-100"},
    "max_width": {"type": "string", "description": "压缩最大宽度"},
    "optimize": {"type": "string", "description": "优化true/false"},
    "format": {"type": "string", "description": "convert格式png/jpg/webp"}
  },
  "required": ["action", "filepath"]
}

对话示例

常见错误

能力边界

与其他插件配合

• ocr_tool：处理后 OCR 识图
• 二维码插件：生成/处理二维码图
• file_convert：文档与图片流水线

详见包内 图片处理插件.md。