wechat-sticker-maker

# 微信表情包制作工具 (WeChat Sticker Maker)

本 Skill 旨在帮助用户快速将设计好的网格拼图（如六宫格、九宫格、十二宫格）自动裁剪并生成符合微信表情开放平台规范的素材。

## 核心功能

*   **自动裁剪**：支持 2x3, 3x2, 3x3, 3x4, 4x3 等多种网格布局。
*   **智能去底**：支持一键自动移除背景（需开启 `--remove-bg` 参数）。
    *   *注意*：本 Skill 内置的去底功能基于 `rembg` (U2Net)，对于简单背景效果尚可，但对于复杂边缘（如发丝、半透明区域）处理可能不如 Photoshop 或专业在线修图工具完美。建议优先生成透明背景的原图，或手动精修后再使用本工具切图。
*   **规范转换**：
    *   **表情主图**：统一调整为 **240x240** 像素 (PNG)。
    *   **聊天页图标**：统一调整为 **50x50** 像素 (PNG)。
*   **含义词生成**：自动生成 `meta.txt` 文件，预留“含义词”填写位置，方便批量管理。
*   **信息模板生成**：自动生成 `info.txt` 文件，包含【表情名称】、【表情介绍】、【一句话简介】的填写模板及字数限制提示。
*   **候选素材生成**：自动提取第1张表情，生成符合规范的【头像/封面图候选】(240x240) 和 【聊天页图标候选】(50x50)。
*   **自动命名**：按照微信规范自动编号 (01, 02, ...)。

## 使用指南

### 1. 快速开始 (Quick Start)

无需手动安装依赖，直接运行脚本即可。工具会自动创建虚拟环境 (`.venv`) 并安装所需依赖。

```bash
# 基本用法：自动处理并生成
./skills/wechat-sticker-maker/scripts/run.sh /path/to/your/grid_image.png

# 常用选项：
# - 自动去底 (需要网络下载模型)
./skills/wechat-sticker-maker/scripts/run.sh /path/to/image.png --remove-bg

# - 指定布局 (例如 3x3)
./skills/wechat-sticker-maker/scripts/run.sh /path/to/image.png --layout 3x3

# - 指定输出目录
./skills/wechat-sticker-maker/scripts/run.sh /path/to/image.png --output ./my_stickers
```

### 2. (可选) 手动安装

如果您希望手动管理环境：

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r skills/wechat-sticker-maker/requirements.txt
python3 skills/wechat-sticker-maker/scripts/make_stickers.py ...
```

### 3. 输出结果

脚本将在输出目录下生成三个文件夹和更多文件：
*   `main/`: 存放 **表情主图** (240x240)
*   `icon/`: 存放 **表情缩略图标** (50x...

# WeChat Sticker Maker (微信表情包制作助手)

这是一个专为 Agent 流程设计的 Skill，旨在将设计好的网格拼图（如九宫格、六宫格）高效转换为符合[微信表情开放平台](https://sticker.weixin.qq.com/)提交规范的完整素材包。

## 🧩 核心原理

本 Skill 基于 Python 的图像处理库 `Pillow` 构建，核心处理流程如下：

1.  **智能布局探测 (Layout Detection)**:
    *   脚本会根据输入图片的**宽高比 (Aspect Ratio)** 自动推断网格布局。
    *   例如：宽高比接近 1:1 识别为 **3x3 (九宫格)**；接近 2:3 识别为 **3x2 (六宫格)** 等。
    *   也支持通过参数强制指定布局（如 `2x3`, `3x4`）。

2.  **精确切分 (Precision Slicing)**:
    *   根据计算出的行列数，使用浮点数坐标运算，精确地将原图切割为独立的单元格，避免累积误差。

3.  **AI 智能去底 (AI Background Removal)**:
    *   (可选) 集成 `rembg` 库，利用 U2-Net 模型对输入图片进行高精度背景移除，无需手动抠图。

4.  **规范化处理 (Normalization)**:
    *   **主图生成**: 将切片统一缩放至微信要求的 **240x240** 像素，输出为 PNG 格式。
    *   **图标生成**: 同步生成 **50x50** 像素的缩略/聊天页图标。
    *   **候选素材**: 自动提取第一张表情作为“表情专辑封面”和“聊天页图标”的候选图。

4.  **元数据脚手架 (Metadata Scaffolding)**:
    *   自动生成 `meta.txt`: 预填充文件列表，留出“含义词”填写位。
    *   自动生成 `info.txt`: 提供符合字数限制的“名称”、“简介”模板。

## � 目录结构

Skill 的文件组织结构如下：

```text
skills/wechat-sticker-maker/
├── README.md               # 本说明文档
├── SKILL.md                # Agent Skill 定义及规范引用
├── requirements.txt        # Python 依赖 (Pillow)
└── scripts/
    └── make_stickers.py    # 核心处理脚本
```

运行脚本后，生成的**输出目录**结构如下：

```text
sticker_output/
├── cover_candidate.png     # [候选] 专辑封面/头像 (240x240)
├── chat_icon_candidate.png # [候选] 聊天页图标 (50x50)
├── info.txt                # 专辑信息模板 (名称/简介)
├── meta.txt                # 含义词填写表
├── main/                   # 表情主图目录 (01.png, 02.png...)
└── icon/                   # 聊天图标目录 (01.png, 02.png...)
```

## 💡 最佳实践...