refactor(skills): img-utils 改名 image-process;office 标记 required

- image-process:原名 img-utils 的 "utils" 没有边界,且和 image_task(AI 生成)
  只差一个语义,容易让模型把确定性处理当成生成能力。目录名即技能名
  (listSkills 取 e.name、skillDir 按名解析),同步 SKILL.md、run.py 注释与
  skills/README.md 的两处引用。
- office:加 required: true,避免模型绕过技能自己拼 libreoffice 命令。
This commit is contained in:
2026-10-21 17:22:07 +08:00
parent 3df3847b88
commit 69a1ee0bdf
5 changed files with 6 additions and 5 deletions
+420
View File
@@ -0,0 +1,420 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
image-process 技能主入口:用 Pillow 做确定性的图像处理(不含 AI 生成/语义修图)。
支持动作 action:
- info 查看图片信息(尺寸/模式/格式/体积)
- convert 格式转换(按 output 扩展名)
- resize 缩放(keep_ratio 默认保持宽高比)
- crop 裁剪(left/top/width/height)
- compress 压缩(quality;可选 max_dim 先缩长边)
- watermark 文字水印(text;中文需系统字体或 font 参数)
- slice 等分切片(rows/cols,默认 3×3,输出到独立目录)
- grid 多图拼图 contact sheet(input 为图片所在目录)
约定:输出绝不覆盖输入原图;相对路径由 Skill Manager 预先转成绝对路径。
"""
import json
import sys
from pathlib import Path
from PIL import Image, ImageDraw, ImageFont, ImageOps
IMAGE_EXTS = {'.jpg', '.jpeg', '.png', '.webp', '.bmp', '.gif', '.tif', '.tiff'}
POSITIONS = {
'tl': ('l', 't'), 'tc': ('c', 't'), 'tr': ('r', 't'),
'ml': ('l', 'm'), 'mc': ('c', 'm'), 'mr': ('r', 'm'),
'bl': ('l', 'b'), 'bc': ('c', 'b'), 'br': ('r', 'b'),
}
NAMED_COLORS = {
'white': (255, 255, 255), 'black': (0, 0, 0), 'red': (255, 0, 0),
'green': (0, 128, 0), 'blue': (0, 0, 255), 'yellow': (255, 255, 0),
'gray': (128, 128, 128), 'grey': (128, 128, 128), 'orange': (255, 165, 0),
'purple': (128, 0, 128), 'cyan': (0, 255, 255),
}
CJK_FONT_CANDIDATES = [
'/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc',
'/usr/share/fonts/truetype/wqy/wqy-microhei.ttc',
]
# Noto 只作最后兑底:Pillow(FreeType) 能读它的 CFF 轮廓,但 ttc 默认字型(索引 0)是 JP 字形,
# 中文水印会出日式写法;因此系统文泉驿(CJK_FONT_CANDIDATES)排在它前面。
NOTO_CJK_FALLBACK = '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc'
def to_int(v, default=0):
if v is None or v == '':
return default
try:
return int(v)
except (TypeError, ValueError):
raise ValueError('参数应为整数:%r' % (v,))
def to_bool(v, default=True):
if v is None or v == '':
return default
if isinstance(v, bool):
return v
if isinstance(v, str):
return v.strip().lower() in ('1', 'true', 'yes', 'y', 'on')
return bool(v)
def parse_color(s, default=(255, 255, 255)):
s = (s or '').strip().lower()
if not s:
return default
if s in NAMED_COLORS:
return NAMED_COLORS[s]
if s.startswith('#'):
h = s[1:]
if len(h) == 3:
h = ''.join(c * 2 for c in h)
if len(h) == 6:
try:
return tuple(int(h[i:i + 2], 16) for i in (0, 2, 4))
except ValueError:
pass
raise ValueError('无法识别的颜色:%s(支持 white/black/red/... 或 #RRGGBB)' % s)
def open_image(path):
"""打开图片并按 EXIF 方向摆正;返回 (img, 原始格式名)。"""
img = Image.open(str(path))
fmt = img.format or ''
img.load()
img = ImageOps.exif_transpose(img)
return img, fmt
def ensure_rgb(img):
if img.mode in ('RGBA', 'LA', 'P'):
return img.convert('RGB')
return img
def save_image(img, out_path, quality=None):
"""按输出扩展名保存;JPEG/WebP 用 quality,PNG 走 optimize。"""
p = Path(out_path)
p.parent.mkdir(parents=True, exist_ok=True)
fmt = (p.suffix or '').lstrip('.').upper()
q = to_int(quality, 90)
q = max(1, min(95, q))
if fmt in ('JPG', 'JPEG'):
ensure_rgb(img).save(str(p), format='JPEG', quality=q, optimize=True)
elif fmt == 'WEBP':
img.save(str(p), format='WEBP', quality=q)
elif fmt == 'PNG':
img.save(str(p), format='PNG', optimize=True)
elif fmt in ('BMP', 'GIF', 'TIFF', 'TIF', 'ICO'):
img.save(str(p))
else:
raise ValueError('不支持的输出扩展名:%s(支持 jpg/jpeg/png/webp/bmp/gif/tiff)'
% (p.suffix or '(无)'))
def default_out(input_path, tag):
"""缺省输出:同目录 <原名>_<tag><原扩展名>,不覆盖原图。"""
p = Path(input_path)
return str(p.parent / ('%s_%s%s' % (p.stem, tag, p.suffix if p.suffix else '.png')))
def ensure_different(src, dst):
if Path(src).resolve() == Path(dst).resolve():
raise ValueError('输出路径与输入相同:%s,不允许覆盖原图,请指定新的 output' % src)
def resample():
return getattr(Image, 'Resampling', Image).LANCZOS
# ---------- 各动作实现 ----------
def action_info(img, fmt, args):
w, h = img.size
lines = ['图片信息:']
lines.append('- 文件:%s' % args['_input'])
lines.append('- 尺寸:%dx%d 像素' % (w, h))
lines.append('- 色彩模式:%s' % img.mode)
lines.append('- 格式:%s' % (fmt or '未知'))
try:
kb = Path(args['_input']).stat().st_size / 1024.0
lines.append('- 文件大小:%.1f KB' % kb)
except OSError:
pass
return '\n'.join(lines)
def action_convert(img, fmt, args):
out = args.get('output')
if not out:
raise ValueError('convert 需要 output 参数(带目标扩展名,如 out.png)')
ensure_different(args['_input'], out)
save_image(img, out, quality=args.get('quality'))
return '格式转换完成:%s -> %s' % (args['_input'], out)
def action_resize(img, fmt, args):
w = to_int(args.get('width'))
h = to_int(args.get('height'))
keep = to_bool(args.get('keep_ratio'), True)
if not w and not h:
raise ValueError('resize 需要 width 或 height(至少一个)')
iw, ih = img.size
if keep:
if w and h:
scale = min(w / iw, h / ih)
nw, nh = max(1, round(iw * scale)), max(1, round(ih * scale))
elif w:
nw, nh = w, max(1, round(ih * (w / iw)))
else:
nw, nh = max(1, round(iw * (h / ih))), h
else:
if not (w and h):
raise ValueError('keep_ratio=false 时 width 与 height 都要提供')
nw, nh = w, h
img2 = img.resize((max(1, nw), max(1, nh)), resample())
out = args.get('output') or default_out(args['_input'], 'resized')
ensure_different(args['_input'], out)
save_image(img2, out, quality=args.get('quality'))
return '缩放完成:%dx%d -> %dx%d,输出 %s' % (iw, ih, img2.size[0], img2.size[1], out)
def action_crop(img, fmt, args):
iw, ih = img.size
left = to_int(args.get('left'))
top = to_int(args.get('top'))
width = to_int(args.get('width'), max(1, iw - left))
height = to_int(args.get('height'), max(1, ih - top))
if width < 1 or height < 1:
raise ValueError('crop 的 width/height 必须 >= 1')
left = max(0, left)
top = max(0, top)
right = min(iw, left + width)
bottom = min(ih, top + height)
if right <= left or bottom <= top:
raise ValueError('裁剪区域超出图片范围(图片 %dx%d)' % (iw, ih))
out = args.get('output') or default_out(args['_input'], 'cropped')
ensure_different(args['_input'], out)
save_image(img.crop((left, top, right, bottom)), out, quality=args.get('quality'))
return '裁剪完成:区域 (%d,%d)-(%d,%d),输出 %s' % (left, top, right, bottom, out)
def action_compress(img, fmt, args):
img2 = img
md = to_int(args.get('max_dim'))
if md > 0 and max(img2.size) > md:
img2 = ImageOps.contain(img2, (md, md), resample())
out = args.get('output') or default_out(args['_input'], 'compressed')
ensure_different(args['_input'], out)
q = to_int(args.get('quality'), 85)
try:
before = Path(args['_input']).stat().st_size
except OSError:
before = 0
save_image(img2, out, quality=q)
try:
after = Path(out).stat().st_size
except OSError:
after = 0
pct = (100.0 * after / before) if before else 0
return '压缩完成:%.1f KB -> %.1f KB(%.0f%%),输出 %s' % (before / 1024.0, after / 1024.0, pct, out)
def find_font(explicit):
"""字体查找:显式 font > 系统 wqy > Noto 兑底。"""
if explicit:
p = Path(explicit)
if not p.exists():
raise ValueError('指定的字体不存在:%s' % explicit)
return str(p)
candidates = list(CJK_FONT_CANDIDATES)
candidates.append(NOTO_CJK_FALLBACK)
for c in candidates:
if Path(c).exists():
return c
return None
def action_watermark(img, fmt, args):
text = (args.get('text') or '').strip()
if not text:
raise ValueError('watermark 需要 text 参数')
w, h = img.size
font_size = to_int(args.get('font_size'), max(14, w // 20))
font_size = max(8, min(400, font_size))
need_cjk = any(ord(ch) > 0x2E80 for ch in text)
font_path = find_font((args.get('font') or '').strip())
if font_path:
font = ImageFont.truetype(font_path, font_size)
elif need_cjk:
raise ValueError('中文水印缺少字体:请传 font 参数(TTF/TTC 路径),或确认系统已装文泉驿/Noto 字体')
else:
try:
font = ImageFont.load_default(size=font_size)
except TypeError:
font = ImageFont.load_default()
pos = (args.get('position') or 'br').strip().lower()
if pos not in POSITIONS:
raise ValueError('position 必须是 tl/tc/tr/ml/mc/mr/bl/bc/br 之一')
align_x, align_y = POSITIONS[pos]
margin = max(0, to_int(args.get('margin'), 20))
color = parse_color(args.get('color'), (255, 255, 255))
opacity = max(0, min(255, to_int(args.get('opacity'), 200)))
# 在透明层上画字再合成,保证半透明水印且边缘平滑
layer = Image.new('RGBA', (w, h), (0, 0, 0, 0))
draw = ImageDraw.Draw(layer)
bbox = draw.textbbox((0, 0), text, font=font)
tw, th = bbox[2] - bbox[0], bbox[3] - bbox[1]
if align_x == 'l':
ox = margin - bbox[0]
elif align_x == 'c':
ox = (w - tw) / 2.0 - bbox[0]
else:
ox = w - margin - bbox[2]
if align_y == 't':
oy = margin - bbox[1]
elif align_y == 'm':
oy = (h - th) / 2.0 - bbox[1]
else:
oy = h - margin - bbox[3]
draw.text((ox, oy), text, font=font, fill=color + (opacity,))
base = img.convert('RGBA')
composed = Image.alpha_composite(base, layer)
out = args.get('output') or default_out(args['_input'], 'watermarked')
ensure_different(args['_input'], out)
save_image(composed, out, quality=args.get('quality'))
return '水印完成(位置 %s,字号 %d,不透明度 %d):%s' % (pos, font_size, opacity, out)
def action_slice(img, fmt, args):
w, h = img.size
rows = to_int(args.get('rows'))
cols = to_int(args.get('cols'))
if rows and not cols:
cols = rows
if cols and not rows:
rows = cols
rows = max(1, min(20, rows or 3))
cols = max(1, min(20, cols or 3))
src = Path(args['_input'])
out_dir = Path(args.get('output')) if args.get('output') else src.parent / (src.stem + '_slice')
out_dir.mkdir(parents=True, exist_ok=True)
ext = src.suffix.lower()
if ext not in IMAGE_EXTS:
ext = '.png'
cw = max(1, w // cols)
chh = max(1, h // rows)
files = []
for r in range(rows):
for c in range(cols):
box = (c * cw, r * chh, min(w, (c + 1) * cw), min(h, (r + 1) * chh))
tile = img.crop(box)
name = '%s_%02d_%02d%s' % (src.stem, r + 1, c + 1, ext)
save_image(tile, str(out_dir / name))
files.append(str(out_dir / name))
return '切片完成:%d×%d 共 %d 块,输出目录 %s\n%s' % (cols, rows, len(files), out_dir, '\n'.join(files))
def action_grid(args):
in_dir = Path(args.get('input'))
if not in_dir.is_dir():
raise ValueError('grid 的 input 应为图片所在目录:%s' % in_dir)
out = args.get('output')
if not out:
out = str(in_dir / ('%s_grid.jpg' % (in_dir.name or 'images')))
imgs = sorted(
p for p in in_dir.iterdir()
if p.is_file() and p.suffix.lower() in IMAGE_EXTS
and not p.name.startswith('.')
and Path(p).resolve() != Path(out).resolve()
)
if not imgs:
raise ValueError('目录中没有可拼图的图片:%s' % in_dir)
n = len(imgs)
cols = to_int(args.get('cols'))
if not cols:
cols = max(1, int(n ** 0.5 + 0.999)) # 缺省近似正方形网格
cols = max(1, min(20, cols))
rows = (n + cols - 1) // cols
cell = max(50, min(2048, to_int(args.get('cell'), 800)))
pad = max(0, to_int(args.get('padding'), 10))
bg = parse_color(args.get('background'), (255, 255, 255))
sheet = Image.new('RGB', (cols * cell + (cols + 1) * pad, rows * cell + (rows + 1) * pad), bg)
placed = []
for i, p in enumerate(imgs):
try:
im, _ = open_image(p)
except Exception as e:
print('跳过无法读取的图片:%s(%s)' % (p, e))
continue
thumb = im.copy()
thumb.thumbnail((cell, cell), resample())
thumb = ensure_rgb(thumb)
x = pad + (i % cols) * cell + (cell - thumb.size[0]) // 2
y = pad + (i // cols) * cell + (cell - thumb.size[1]) // 2
sheet.paste(thumb, (x, y))
im.close()
placed.append(p.name)
if not placed:
raise ValueError('目录中的图片都无法读取:%s' % in_dir)
save_image(sheet, out)
return '拼图完成:%d/%d 张 -> %s(网格 %d×%d,每格长边 %dpx)' % (len(placed), n, out, cols, rows, cell)
ACTIONS = {
'info': action_info,
'convert': action_convert,
'resize': action_resize,
'crop': action_crop,
'compress': action_compress,
'watermark': action_watermark,
'slice': action_slice,
'grid': action_grid,
}
def main():
if len(sys.argv) != 2:
print("Usage: python3 run.py '<json_string>'", file=sys.stderr)
sys.exit(1)
try:
args = json.loads(sys.argv[1])
except json.JSONDecodeError as e:
print('参数不是合法 JSON:%s' % e, file=sys.stderr)
sys.exit(1)
action = (args.get('action') or '').strip().lower()
if not action:
print('Error: 缺少 action(可选:%s)' % '/'.join(sorted(ACTIONS)), file=sys.stderr)
sys.exit(1)
if action not in ACTIONS:
print('Error: 不支持的 action:%s(可选:%s)' % (action, '/'.join(sorted(ACTIONS))), file=sys.stderr)
sys.exit(1)
try:
if action == 'grid':
text = action_grid(args)
else:
input_path = (args.get('input') or '').strip()
if not input_path:
raise ValueError('缺少 input 参数')
if not Path(input_path).exists():
raise ValueError('输入文件不存在:%s' % input_path)
img, fmt = open_image(input_path)
try:
args['_input'] = input_path
text = ACTIONS[action](img, fmt, args)
finally:
img.close()
print(text)
except Exception as e:
print('Error: %s' % e, file=sys.stderr)
sys.exit(1)
if __name__ == '__main__':
main()