mcpField
C
convert-image-to-jpg

convert-image-to-jpg

github.com/tiangong-ai创意与媒体1136 次安装1 周前更新
代码仓库

关于 convert-image-to-jpg

此技能将单张本地图片或目录中的图片转换为 JPG，并可设置 DPI、质量及覆盖行为。它使用 Python 标准库脚本，并优先调用 magick，缺少时尝试 macOS 的 sips。

主要功能

  1. 01转换单张图片或递归处理目录
  2. 02设置 JPG 的 DPI 与质量
  3. 03保留目录输入的相对结构
  4. 04支持覆盖输出与预览计划
  5. 05使用 magick 或 macOS sips

适用场景

  1. 01批量将图片目录转换为 JPG
  2. 02统一已有 JPG 的名称或 DPI
  3. 03转换前检查输出文件计划

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tiangong-ai/agent-skills --skill convert-image-to-jpg

安装后在 Claude Code 中输入/convert-image-to-jpg确认已加载。

详细介绍

将图像转换为 JPG

核心目标

  • 将一个本地图像或本地图像目录树转换为 .jpg。
  • 默认将 JPG DPI 元数据设为 96，也可使用调用方提供的值。
  • 输入路径为目录时，保留相对目录结构。

必需工具

  • 使用 scripts/convert_to_jpg.py。
  • 仅依赖 Python 标准库模块。此技能无需安装 Python 软件包。
  • 如果已安装 magick，优先使用它。
  • 如果 magick 不可用，则回退到 macOS sips。
  • 如果两种后端都不存在，则停止并报告缺少的依赖项。

快速入门

  1. 将一个文件转换到指定的 JPG 路径：
python3 scripts/convert_to_jpg.py \
  --input-path /path/to/image.heic \
  --output-path /path/to/output.jpg
  1. 使用自定义 DPI 递归转换目录：
python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --dpi 300
  1. 原位重写现有输出，或替换之前运行生成的文件：
python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --overwrite
  1. 预览转换计划，但不写入文件：
python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --dry-run

行为

  • 将目录输入视为递归输入，并在输出目录树中保留相同的相对子目录。
  • 单文件的 --output-path 若没有 .jpg 或 .jpeg 后缀，则将其视为目录。
  • 同样转换 .jpg 和 .jpeg 输入。可用此功能规范化输出名称或重写 DPI 元数据。
  • JPG 默认质量为 95。
  • 如果源格式支持多帧，例如 GIF 或 TIFF，则使用第一帧或第一页。
  • 如果两个源文件会映射到同一个目标 .jpg，则拒绝执行有歧义的目录转换。
  • 必要时，使用 --extra-extension .ext 添加不常见的扩展名。

主要参数

  • --input-path：源文件或源目录
  • --output-path：输出 JPG 文件路径或输出目录
  • --dpi：JPG 输出的目标 DPI 元数据，默认为 96
  • --quality：JPG 质量，范围为 1 到 100，默认为 95
  • --backend：auto、magick 或 sips
  • --extra-extension：要纳入目录扫描的额外后缀
  • --overwrite：替换现有输出
  • --dry-run：打印计划，但不转换文件
  • --limit：限制快速检查时处理的文件数量

脚本

  • scripts/convert_to_jpg.py

评论

支持 Markdown