SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场cli-anything-gimp

cli-anything-gimp

设计与创作

查看项目

更新于 10-15 16:31

技能介绍

cli-anything-gimp 是一个有状态的命令行图像编辑界面，构建在 Pillow 之上，专为需要在无图形界面环境下创建和操作图像的 AI 智能体与高级用户设计。

用途 该工具用于通过命令行完成图像编辑与合成任务，支持项目化管理、图层操作、画布调整、滤镜应用、媒体分析与导出渲染，适合自动化图像处理流程和智能体调用。

安装与前置条件 安装命令：pip install cli-anything-gimp 前置条件：Python 3.10+；推荐安装 GIMP 以支持原生批量渲染，但在 GIMP 不可用或存在延迟绘制操作时，分层合成仍可通过内置 Pillow 路径渲染。

主要能力 命令组包括：

  • 项目（Project）：new、open、save、info、profiles、json，用于创建、打开、保存项目及查看信息与画布配置。
  • 图层（Layer）：new、add-from-file、list、remove、duplicate、move、set、flatten、merge-down，支持创建、添加、列出、删除、复制、移动、设置属性（名称、不透明度、可见性、模式、偏移量，负偏移量可自然接受）、展平和向下合并。
  • 画布（Canvas）：info、resize、scale、crop、mode、dpi，用于查看信息、调整尺寸（不缩放内容）、等比缩放内容、裁剪、设置颜色模式与 DPI。
  • 滤镜（Filter）：list-available、info、add、remove、set、list，用于列出可用滤镜、查看详情、添加/移除滤镜、设置参数及列出图层滤镜。
  • 媒体（Media）：probe、list、check、histogram，用于分析图像文件、列出项目引用的媒体文件、检查文件是否存在及显示直方图分析。
  • 导出（Export）：presets、preset-info、render，用于列出导出预设、查看预设详情及渲染项目为图像文件（延迟绘制操作在渲染时应用）。
  • 会话（Session）：status、undo、redo、history，用于查看会话状态、撤销/重做及查看历史。
  • 绘制（Draw）：text、rect，用于在图层上绘制文本（转换为文本图层）或矩形（存储为绘制操作，渲染时应用）。

使用方式 基本命令示例： cli-anything-gimp --help cli-anything-gimp cli-anything-gimp project new -o project.json cli-anything-gimp --json project info -p project.json

REPL 模式：不带子命令调用时进入交互式 REPL 会话，支持 Tab 补全和历史记录。

导出示例： cli-anything-gimp --project myproject.json export render output.png --overwrite

分层合成工作流示例： cli-anything-gimp --project poster.gimp-cli.json layer set 0 offset_x -48 cli-anything-gimp --project poster.gimp-cli.json layer set 0 offset_y 24 cli-anything-gimp --project poster.gimp-cli.json draw text --layer 0 --text "Launch Night" --x 96 --y 120 --size 72 --color "#f6f1e8" cli-anything-gimp --project poster.gimp-cli.json export render output.png --overwrite

状态管理 CLI 维护会话状态，包括：撤销/重做（最多 50 级历史）、项目持久化（以 JSON 保存/加载项目状态）、会话跟踪（跟踪修改与变更）。

输出格式 所有命令支持双输出模式：人类可读（默认，表格、颜色、格式化文本）与机器可读（--json 标志，结构化 JSON 供智能体消费）。

面向 AI 智能体的建议 程序化使用时：始终使用 --json 标志获取可解析输出；检查返回码（0 成功，非零错误）；失败时解析 stderr 获取错误信息；所有文件操作使用绝对路径；导出操作后验证输出存在；在偏移、绘制、混合模式或滤镜更改后，应审查渲染输出而非仅信任保存的项目状态。

适用场景 适用于需要无 GUI 图像编辑的自动化流程、AI 智能体图像处理任务、批量渲染与分层合成等场景。

限制 延迟绘制操作（draw text、draw rect）在渲染时应用，应审查导出的图像而非仅项目 JSON；对于含延迟绘制操作的项目，即使安装了 GIMP，Pillow 渲染路径也是稳定的默认选择。

更多信息 完整文档见包内 README.md，测试覆盖见 TEST.md，方法论见 cli-anything-plugin 的 HARNESS.md。版本 1.0.0。