name: image-processing
description: |
对图片进行处理，支持在图片中插入配文。
两种配文模式：底部边框式（像画框一样）和内部贴纸式（类似小红书效果）。
使用 PIL/Pillow 实现，支持中文和 Emoji。
user-invocable: false
allowed-tools:
- Read
- Write
- Edit
- Bash
metadata:
author: writing-skill
version: '1.0.0'

图片处理 Skill

你是一个图片处理助手，负责为配图添加文字标注和装饰效果。

核心能力

1. 底部边框式配文：在图片下方添加独立的文字区域，类似画框效果
2. 内部贴纸式配文：在图片内部添加带背景的文字标签，类似小红书贴纸效果
3. 中文支持：使用 Windows 系统自带的微软雅黑字体
4. Emoji 支持：使用 pilmoji 库渲染 Emoji 表情

使用方式

模式 1：底部边框式配文

在图片下方添加白色/深色背景的文字区域：

python scripts/image_processor.py input.jpg output.jpg --mode frame --text "这是配文 🎉"

效果示例：

┌────────────────────┐
│                    │
│      原图片         │
│                    │
├────────────────────┤
│  这是配文 🎉        │
└────────────────────┘

参数：

• --mode frame：边框模式
• --text：配文内容（支持中文和 Emoji）
• --bg-color：背景颜色（默认 white，可用 black、#RRGGBB）
• --text-color：文字颜色（默认 black）
• --font-size：字体大小（默认 32）
• --padding：内边距（默认 20）

模式 2：内部贴纸式配文

在图片内部指定位置添加带背景的文字标签：

python scripts/image_processor.py input.jpg output.jpg --mode sticker --text "重点！" --position bottom-right

效果示例：

┌────────────────────┐
│                    │
│      原图片    ┌───┤
│               │重点│
└───────────────┴───┘

参数：

• --mode sticker：贴纸模式
• --text：配文内容
• --position：位置，可选 top-left、top-right、bottom-left、bottom-right、center
• --bg-color：标签背景色（默认 #FFE4B5，浅橙色）
• --text-color：文字颜色（默认 #333333）
• --font-size：字体大小（默认 28）
• --opacity：背景透明度 0-255（默认 230）
• --radius：圆角半径（默认 10）
• --margin：距边缘距离（默认 20）

批量处理

处理多张图片：

python scripts/image_processor.py ./images/*.jpg --output-dir ./output --mode frame --text "配文"

字体配置

脚本会按以下顺序查找中文字体：

1. C:/Windows/Fonts/msyh.ttc - 微软雅黑
2. C:/Windows/Fonts/simhei.ttf - 黑体
3. C:/Windows/Fonts/simsun.ttc - 宋体
4. 系统默认字体（可能不支持中文）

如需使用自定义字体：

python scripts/image_processor.py input.jpg output.jpg --font "C:/MyFonts/custom.ttf" --text "配文"

颜色参考

常用颜色值：

与其他 Skill 配合

1. 使用 图片搜索 Skill 找到合适的配图
2. 使用本 Skill 添加配文
3. 在 通用写作 Skill 中引用处理后的图片

注意事项

1. 图片格式：支持 JPG、PNG、WEBP 等常见格式
2. 输出格式：根据输出文件扩展名自动选择格式
3. Emoji 渲染：需要安装 pilmoji 库
4. 字体权限：确保对字体文件有读取权限