Communitygithub.com

ZJU-REAL/Easel

通用图像处理加工:改尺寸/缩放、裁剪、补边适配平台尺寸、格式转换(png/jpg/webp)、压缩到目标大小、加文字或图片水印、圆角、多图拼接、生成缩略图、读图片信息。基于 image_ops.py 确定性处理。

Easel 是什麼?

Easel (image-editing) 是一个专为 AI 代理设计的确定性图像处理技能,通过调用 `skills/shared/scripts/image_ops.py` 脚本(基于 Pillow 库)对已有图片进行像素级操作。它支持七大类核心功能:缩放与裁剪、补边适配社交媒体比例(如 1:1、9:16)、格式转换与质量压缩、文字或图片水印添加、圆角处理、多图拼接(横向/纵向/网格)、以及生成缩略图和读取图片 JSON 信息。该技能明确与 card-* 系列技能划清界限——card-* 负责从 HTML 设计并渲染新图,而 Easel 只加工用户提供的现有图片文件,不做视觉设计或内容生成。使用时需指定图片路径和操作参数,所有命令均可通过 `-h` 查看帮助;支持平台尺寸参考文件 `references/platform-sizes.md`,且能根据用户 Profile 自动适配水印文字和输出比例。错误处理完善,包括文件不存在、裁剪越界、字体缺失等场景。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/openclaw/image-editing

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

影像處理加工

對既有圖片進行確定性處理:縮放/裁切/補邊/轉格式/壓縮/浮水印/圓角/拼接/縮圖。 所有操作透過 skills/shared/scripts/image_ops.py(純 Pillow),不隨意編寫腳本。

輸入

  • 一張或多張已存在的圖片檔案路徑(png/jpg/webp 等 Pillow 支援格式)
  • 目標操作與參數(尺寸、比例、品質、浮水印文字、拼接方式等)

輸出

  • 處理後的圖片檔案(路徑由使用者指定或預設寫入 outputs/主題名/)
  • 每條指令回顯 ✅ 路徑 (寬x高, 大小KB);info 輸出 json

邊界(與 card-* 劃清)

  • card-quote / card-xiaohongshu / poster-hero / comparison-card = 設計並渲染新圖(HTML→截圖)
  • image-editing = 加工既有圖片,不做視覺設計,不產生內容,只做像素級處理
  • 需要「從數據/文字產生圖」→ 使用 chart/infographic/card-*;本 SKILL 只處理現成的圖片檔案

執行步驟

  1. 確認輸入圖片存在、明確目標操作與參數
  2. 從專案根目錄執行 image_ops.py 對應子指令(見下方)
  3. 需要平台尺寸時,查詢 references/platform-sizes.md 取得推薦比例/像素
  4. 回報輸出路徑與尺寸;多步驟操作可串聯(例如先 resize 再 compress)

指令速查

腳本路徑統一為 skills/shared/scripts/image_ops.py,均支援 -h 查看參數。

# 縮放:依寬/高/百分比,--keep-ratio 在框內等比例不拉伸
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --percent 50
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080 --height 1440 --keep-ratio

# 裁切:座標裁 或 居中裁到指定尺寸
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --box 100,50,900,650
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --width 1080 --height 1080

# 補邊到目標比例(社群媒體適配核心):將任意圖 pad 成 1:1 / 9:16 / 16:9
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 9:16 --background "#ffffff"
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 1:1 --background "20,20,30"

# 格式轉換 png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85

# 壓縮:固定品質 或 逼近目標檔案大小上限(jpg/webp)
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --quality 80
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --max-kb 200

# 浮水印:文字(位置/透明度/字型大小/顏色,自動尋找系統中文字型)或圖片(右下角等)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@帳號名" --position bottom-right --opacity 0.5 --size 40
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --image logo.png --position bottom-right --scale 0.3 --opacity 0.8

# 圓角(輸出透明 png);--radius-percent 50 得到圓形
python skills/shared/scripts/image_ops.py round -i in.jpg -o out.png --radius 60
python skills/shared/scripts/image_ops.py round -i avatar.jpg -o out.png --radius-percent 50

# 多圖拼接:橫向/縱向/網格 NxM(列x行),--cell-width/height 統一儲存格
python skills/shared/scripts/image_ops.py collage -i a.jpg b.jpg c.jpg -o out.jpg --mode horizontal --gap 12
python skills/shared/scripts/image_ops.py collage -i 1.jpg 2.jpg 3.jpg 4.jpg -o out.jpg --grid 2x2 --gap 10 --cell-width 540 --cell-height 540

# 縮圖(最長邊像素)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256

# 讀取圖片資訊(json:尺寸/格式/比例/大小/透明通道)
python skills/shared/scripts/image_ops.py info -i in.jpg

領域知識:平台推薦尺寸

常用平台推薦請見 references/platform-sizes.md。高頻速記:

  • 小紅書直版圖文:1080×1440(3:4);小紅書影片/直版海報:1080×1920(9:16)
  • 朋友圈單圖 / 通用方圖:1:1(如 1080×1080)
  • 橫版金句/封面:16:9(如 1920×1080);微信公眾號首圖 900×383
  • 微博配圖:1:1 或 4:3;抖音/影片號封面:9:16(1080×1920)

適配思路:優先 pad(補邊不裁內容、不變形)保全畫面;追求滿版無邊則 crop 居中裁到目標比例; 僅需縮小體積用 resize/compress。

Profile 感知

  • 有 Profile:浮水印文字預設用帳號名/handle;輸出比例預設貼合帳號主平台(如小紅書號預設 1080×1440)
  • 無 Profile:依使用者明確參數執行,比例預設保持原圖,浮水印需使用者提供文字

相依性與錯誤處理

  • 相依性:Pillow(已安裝,python -c "import PIL" 可用),純標準庫無其他第三方
  • 腳本內建邊界檢查:檔案不存在 / 裁切框越界 / 非法比例或顏色 → 退出碼 2 並印出 ERROR:
  • 找不到系統中文字型時降級為 PIL 預設字型並顯示 WARN,可使用 --font 指定
  • 自我檢測:python skills/shared/scripts/image_ops.py --selftest

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ZJU-REAL/Easel

AI 视频生成:文生视频 / 图生视频 / 数字人首帧驱动。通过可插拔 provider(通义万相 Wan / 火山 Seedance / 快手可灵 / OpenAI 兼容)异步生成视频,用户自备 API key。当用户说 AI 视频生成、文生视频、图生视频、AI 生成视频、AI 短视频、让图片动起来、数字人视频、生成一段视频 时使用。与 video-strategy(选型/策略)、video-editing(剪辑处理)、clipify(切片)区别:本 SKILL 是从 0 用 AI 生成新视频。

ZJU-REAL/Easel

通用音频处理:音频剪辑/裁剪、格式转码(mp3/wav/m4a/aac)、音量归一化、从视频提取音轨、多段拼接、淡入淡出、变速(保音高)。当用户说“剪音频”“裁一段”“转成 mp3”“调音量/响度”“提取音轨/扒音频”“拼接音频”“淡入淡出”“加速/减速音频”“变速不变调”时使用。与 audio-denoise 的区别:audio-denoise 专做降噪,audio-editing 做除降噪外的通用音频操作(也内置 denoise 作为兜底)。

ZJU-REAL/Easel

一句话主题 → 成品短视频:自动串联 文案→配图/AI视频→配音→字幕→BGM→合成,把 Easel 制作层零件编排成一条'一键出片'流水线。**单条视频、口播/资讯向,画面默认逐句配图 + Ken Burns 缓动,需要动态时才逐段图生视频**。当用户说 一键生成视频、自动做短视频、主题生成视频、帮我做条视频、口播视频一条龙、自动出片、短视频一键生成 时使用。**有剧情/角色/对白/反转/多集的短剧改用 short-drama(每镜强制图生视频、不用静态图冒充);只写脚本用 video-script;只生成单个片段用 ai-video-gen。**

ZJU-REAL/Easel

自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。

ZJU-REAL/Easel

音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow 每图固定时长、柔和转场,本 SKILL 切换点由音乐节拍决定、硬切踩点带特效。

ZJU-REAL/Easel

Easel clipify: long English talk → punchline cuts → optional 16:9→9:16 face-pan/split → opus word-by-word ASS burn. Ships scripts + assets/preview.png. Part of 1.6k★ Easel suite.

ZJU-REAL/Easel

多角色对话配音:按 cast 和逐行对白为不同角色分配音色与情绪,合成多声线音轨和带角色名字幕。 当用户说“多角色/双人/剧本/对话配音、多人对白、不同角色不同声音、有声剧配音”时使用。 单一公共音色用 tts-voiceover;克隆本人音色用 voice-clone;整部短剧制作由 short-drama 编排。

ZJU-REAL/Easel

Easel video-highlights: CN/livestream highlight extract + stable static vertical reframe (sibling to clipify).

ZJU-REAL/Easel

>- 视频制作策略与工具选型:AI 视频生成模型对比、视频脚本结构设计、制作流程规划,覆盖产品演示/解说/社媒短视频场景。 当用户说"视频怎么做""视频选型""用什么工具做视频""视频制作流程""视频策略""视频系列规划"时使用。 和 video-script 的区别:video-strategy 做内容规划与工具选型,video-script 写具体某条视频的脚本。

相關技能