Stamp Edge

邮票风格边框 Skill

把图片处理成邮票样式:默认直接在原图四周边缘打半圆锯齿孔洞(无白边),底部柔和投影,输出真透明背景 PNG(孔洞与四周 alpha=0),可直接当贴纸/素材叠加使用。需要白色纸边时加 margin 选项。

使用方式

直接运行本目录下的脚本(依赖 Pillow):

python3 ~/.agents/skills/stamp-edge/stamp_effect.py <输入图> <输出图.png>          # 无白边 + 透明背景(默认)
python3 ~/.agents/skills/stamp-edge/stamp_effect.py <输入图> <输出图.png> margin   # 加白边
python3 ~/.agents/skills/stamp-edge/stamp_effect.py <输入图> <输出图.png> bg       # 浅灰白背景

选项可组合,如 margin bg。

• 输入:任意常见格式截图/图片(PNG/JPG 等)
• 输出:PNG;默认 RGBA 真透明,加 bg 参数则为浅灰白底成品图
• 输出文件默认建议存到 ~/Desktop/,文件名用内容语义命名(如 analytics_stamp.png)

拼合集图(stamp_sheet.py)

多张邮票生成后,用本目录下的 stamp_sheet.py 拼成一张合集:等宽列瀑布流,每张邮票撑满列宽、无留白,列高自动贪心均衡:

python3 ~/.agents/skills/stamp-edge/stamp_sheet.py ~/Desktop/stamp_grid.png *_stamp.png                 # 默认 4 列深色底
python3 ~/.agents/skills/stamp-edge/stamp_sheet.py ~/Desktop/sheet.png --cols 3 --bg "#f5f2ea" -- *_stamp.png     # 自定义列数/底色

• --cols:列数(默认 4);--bg:背景色 hex(默认 #0e0e0e 近黑,配投影效果好;米白纸面风用 #f5f2ea);--colw:列宽 px(默认 780)
• 邮票默认真透明背景,直接叠任意底色;排完后用 ReadMediaFile 读回确认效果
• 注意:贪心均衡会打乱传入顺序以平衡列高,这是预期行为

工作流

1. 从用户消息中定位输入图片路径(用户粘贴的图片通常在 ~/.kimi-code/files/ 下取最新文件)
2. 运行脚本生成邮票图(默认:无白边、透明背景;用户明确要白边时加 margin)
3. 用 ReadMediaFile 读回成品确认效果(透明背景可先在脚本外套棋盘格预览验证)
4. 告知用户输出路径

可调参数(脚本顶部)

用户要求"孔更密/更疏、白边更宽、投影更淡"等时,改对应参数重跑即可,不要重写脚本。

注意事项

• 投影是半透明灰色,叠深色背景无压力;叠纯白背景会看到淡影(正常设计)
• 微信等平台直接发图会把透明 PNG 压成 JPG 丢失透明,需要保透明时提醒用户以文件形式发送
• 批量处理多张图时,逐张调用脚本,不要改脚本去支持批量