名称: slack-gif-creator 描述: 用于创建Slack优化的动画GIF的知识和工具。提供约束、验证工具和动画概念。当用户请求为Slack创建动画GIF时使用，如“为我制作一个X做Y的GIF用于Slack。” 许可证: 完整条款在LICENSE.txt中

Slack GIF 创建器

一个工具包，提供用于创建Slack优化的动画GIF的实用工具和知识。

Slack 要求

尺寸:

表情符号GIF: 128x128 (推荐)
消息GIF: 480x480

参数:

帧率: 10-30 (较低则文件大小更小)
颜色: 48-128 (较少颜色 = 较小文件大小)
时长: 表情符号GIF保持在3秒以内

核心工作流程

from core.gif_builder import GIFBuilder
from PIL import Image, ImageDraw

# 1. 创建构建器
builder = GIFBuilder(width=128, height=128, fps=10)

# 2. 生成帧
for i in range(12):
    frame = Image.new('RGB', (128, 128), (240, 248, 255))
    draw = ImageDraw.Draw(frame)

    # 使用PIL基本图形绘制动画
    # (圆形、多边形、线条等)

    builder.add_frame(frame)

# 3. 保存并优化
builder.save('output.gif', num_colors=48, optimize_for_emoji=True)

绘制图形

处理用户上传的图像

如果用户上传图像，考虑他们是否希望：

直接使用 (例如，“动画化这个”、“将其分割成帧”)
作为灵感使用 (例如，“制作类似这样的东西”)

使用PIL加载和处理图像：

from PIL import Image

uploaded = Image.open('file.png')
# 直接使用，或仅作为颜色/样式的参考

从零开始绘制

当从零开始绘制图形时，使用PIL ImageDraw基本图形：

from PIL import ImageDraw

draw = ImageDraw.Draw(frame)

# 圆形/椭圆形
draw.ellipse([x1, y1, x2, y2], fill=(r, g, b), outline=(r, g, b), width=3)

# 星形、三角形、任意多边形
points = [(x1, y1), (x2, y2), (x3, y3), ...]
draw.polygon(points, fill=(r, g, b), outline=(r, g, b), width=3)

# 线条
draw.line([(x1, y1), (x2, y2)], fill=(r, g, b), width=5)

# 矩形
draw.rectangle([x1, y1, x2, y2], fill=(r, g, b), outline=(r, g, b), width=3)

不要使用: 表情符号字体 (跨平台不可靠) 或假设此技能中存在预打包的图形。

使图形看起来更好

图形应看起来精致和有创意，而不是基本。方法如下：

使用更粗的线条 - 始终为轮廓和线条设置 width=2 或更高。细线条 (width=1) 看起来粗糙和不专业。

添加视觉深度：

为背景使用渐变 (create_gradient_background)
叠加多个形状以增加复杂度 (例如，一个星形内部有一个较小的星形)

使形状更有趣：

不要只画一个普通的圆形 - 添加高光、环或图案
星形可以有发光效果 (在后面绘制更大、半透明的版本)
结合多种形状 (星形 + 火花、圆形 + 环)

注意颜色：

使用鲜艳、互补的颜色
添加对比度 (浅色形状上的深色轮廓、深色形状上的浅色轮廓)
考虑整体构图

对于复杂形状 (心形、雪花等)：

使用多边形和椭圆形的组合
仔细计算点以实现对称
添加细节 (心形可以有高光曲线，雪花有精细的分支)

要有创意和详细！一个好的Slack GIF应看起来精致，而不是像占位符图形。

可用实用工具

GIFBuilder (`core.gif_builder`)

组装帧并优化为Slack：

builder = GIFBuilder(width=128, height=128, fps=10)
builder.add_frame(frame)  # 添加PIL图像
builder.add_frames(frames)  # 添加帧列表
builder.save('out.gif', num_colors=48, optimize_for_emoji=True, remove_duplicates=True)

验证器 (`core.validators`)

检查GIF是否符合Slack要求：

from core.validators import validate_gif, is_slack_ready

# 详细验证
passes, info = validate_gif('my.gif', is_emoji=True, verbose=True)

# 快速检查
if is_slack_ready('my.gif'):
    print("准备就绪！")

缓动函数 (`core.easing`)

平滑运动而非线性：

from core.easing import interpolate

# 进度从0.0到1.0
t = i / (num_frames - 1)

# 应用缓动
y = interpolate(start=0, end=400, t=t, easing='ease_out')

# 可用选项: linear, ease_in, ease_out, ease_in_out,
#           bounce_out, elastic_out, back_out

帧辅助函数 (`core.frame_composer`)

常见需求的便利函数：

from core.frame_composer import (
    create_blank_frame,         # 纯色背景
    create_gradient_background,  # 垂直渐变
    draw_circle,                # 圆形辅助函数
    draw_text,                  # 简单文本渲染
    draw_star                   # 五角星
)

动画概念

抖动/振动

通过振荡偏移对象位置：

使用 math.sin() 或 math.cos() 与帧索引
添加小的随机变化以增加自然感
应用于x和/或y位置

脉冲/心跳

有节奏地缩放对象大小：

使用 math.sin(t * frequency * 2 * math.pi) 实现平滑脉冲
对于心跳：两个快速脉冲然后暂停 (调整正弦波)
在基础大小的0.8到1.2之间缩放

弹跳

对象落下并弹起：

使用 interpolate() 与 easing='bounce_out' 实现着陆
使用 easing='ease_in' 实现落下 (加速)
通过每帧增加y速度应用重力

旋转

围绕中心旋转对象：

PIL: image.rotate(angle, resample=Image.BICUBIC)
对于摇摆：使用正弦波作为角度而非线性

淡入/淡出

逐渐出现或消失：

创建RGBA图像，调整alpha通道
或使用 Image.blend(image1, image2, alpha)
淡入: alpha从0到1
淡出: alpha从1到0

滑动

将对象从屏幕外移动到位置：

起始位置：帧边界外
结束位置：目标位置
使用 interpolate() 与 easing='ease_out' 实现平滑停止
对于超调：使用 easing='back_out'

缩放

缩放和定位以实现缩放效果：

缩放进入: 从0.1到2.0缩放，裁剪中心
缩放退出: 从2.0到1.0缩放
可添加运动模糊以增加戏剧性 (PIL过滤器)

爆炸/粒子爆发

创建向外辐射的粒子：

生成具有随机角度和速度的粒子
更新每个粒子: x += vx, y += vy
添加重力: vy += gravity_constant
随时间淡出粒子 (减少alpha)

优化策略

仅当要求使文件大小更小时，实施以下方法之一：

更少的帧 - 降低帧率 (10而非20) 或缩短时长
更少的颜色 - num_colors=48 而非128
更小的尺寸 - 128x128 而非480x480
移除重复帧 - remove_duplicates=True 在save()中
表情符号模式 - optimize_for_emoji=True 自动优化

# 表情符号的最大优化
builder.save(
    'emoji.gif',
    num_colors=48,
    optimize_for_emoji=True,
    remove_duplicates=True
)

哲学

此技能提供：

知识: Slack的要求和动画概念
实用工具: GIFBuilder、验证器、缓动函数
灵活性: 使用PIL基本图形创建动画逻辑

它不提供：

固定的动画模板或预制的函数
表情符号字体渲染 (跨平台不可靠)
内置于此技能中的预打包图形库

关于用户上传的注意事项: 此技能不包括预构建的图形，但如果用户上传图像，使用PIL加载和处理它 - 根据他们的请求解释他们是否希望直接使用或仅作为灵感。

要有创意！结合概念 (弹跳 + 旋转、脉冲 + 滑动等) 并使用PIL的全部功能。

依赖项

pip install pillow imageio numpy