charmoji

---
name: charmoji
description: 微信表情开放平台静态表情投稿全流程 SOP —— 一张 IP 正面照进，整套可提交素材出。覆盖 IP 命名与简介文案、9 情绪选题、museav 中台批量出图、240×240 表情图 / 750×400 详情页横幅 / 240×240 封面 / 50×50 聊天面板图标切图、透明背景与白描边机检、含义词字数校验、赞赏三件套、付费表情（10 微信豆）、审核红线与高频拒因；上架后还能一条命令出 1080×1920 竖版推广视频（合成走 reel-kit）。触发词：微信表情、表情包、表情专辑、表情投稿、提交表情、表情形象、微信表情开放平台、sticker、表情审核、含义词、赞赏引导图、付费表情、微信豆、表情封面、聊天面板图标、表情推广视频、表情包宣传片、表情串成视频。
metadata:
  version: "1.3.0"
  updated: "2026-08-28"
  scope: "静态表情 + 动态表情（透明 GIF）+ 竖版推广视频（合成委托 reel-kit）；视频号特效仅归档规范，流水线不覆盖"
  source: "https://sticker.weixin.qq.com/cgi-bin/mmemoticon-bin/readtemplate?t=guide/index.html#/makingSpecifications"
---

# 微信表情投稿 SOP（静态表情）

**输入：一张 IP 正面照。输出：一个能直接往平台表单里填的目录。**
零美术基础也能跑完 —— 出图、切图、校验、文案全部有脚本兜着，不需要打开 PS。

**静态表情**（PNG）走本文；**动态表情**（透明 GIF）的完整方案在 `references/animated.md`
（1-bit 透明的取舍、图生视频→抽帧→逐帧抠图→合成的四步流水线、哪种 IP 适合做动图）。
两者不能混在同一套专辑里 —— 官方要求同套统一动/静。视频号特效规范见 `references/specs.md` 第三节。

```
SKILL_DIR=~/.claude/skills/charmoji
```

## 数据模型：形象唯一，系列多套

微信那边是两个独立配置，且是一对多：

```
表情形象（唯一）              表情系列 / 专辑（多套）
名称 · 简介 · 头像 · 图标  ──┬── 系列 A：表情图 8~24 张 + 封面 + 横幅 + 含义词
                          ├── 系列 B：另一套，复用同一个形象
                          └── 系列 C：...
```

所以本地也照这个分两处存，**按「能不能再生」决定备份策略**：

```
~/.wechat-stickers/ips/<形象>/          ← 形象配置 + 原始画稿，丢了画不回来 → git 备份
├── ip.yml            名称/简介/系列清单/待办
├── ip.png            正面照母版（出图垫图用，多套系列形象才不漂）
├── ip-reverse.txt    读图 prompt（一个形象只读一次）
├── 形象头像-<名>.png   240×240 透明
├── 形象图标-<名>.png   50×50 透明
└── source/           原始画稿池，多套系列都从这里挑图

~/.wechat-stickers/albums/<形象>/<序号>-<系列名>/   ← 产物，可再生 → 不进版本库
├── 表情图/01-开心.png … NN-xxx.png
├── 封面图-<形象>.png · 聊天图标-<形象>.png · 详情页横幅-<系列>.jpg
├── album.yml · submit.md
└── raw/              切图前的中间件

~/.wechat-stickers/outbox/                      ← 待上传中转，用完即弃
```

### 分层契约（新增任何配置前先对照这张表）

| 层 | 位置 | 放什么 |
|---|---|---|
| 全局依赖 | `~/.wechat-stickers/bgm/` 等**白名单**目录 | 跨形象复用且不可再生的（如配乐原曲） |
| 形象级 | `ips/<形象>/ip.yml` | 名称·简介·母版·画稿·已挂系列·待办 |
| 系列级 | `albums/<形象>/<系列>/album.yml` | 专辑文案·含义词·附加信息·推广文案·**平台状态** |

**不要新建旁挂目录。** 一套系列的所有配置都在它自己的 `album.yml` 里 ——
推广文案曾被放进旁挂的 `captions/`、平台状态曾被写进 `ip.yml`，
两次都是「改哪个文件就往哪写」的就近落盘，攒起来就是配置散落一地。

`scripts/lint.sh` 会检查数据根下有没有未登记的目录（白名单外一律 FAIL）——
要加新位置得先改白名单，这个动作本身迫使人重新想一遍分层。

**所有数据在一个根下**（`~/.wechat-stickers`），git 只版本化 `ips/` ——
分层依据是「能不能再生」，不是「哪个更重要」。`~/Pictures/表情包系列` 是
指向 `albums/` 的软链，Finder 里照样浏览。可用 `STICKER_HOME` / `STICKER_ALBUMS` 覆盖。

**代码也只有一份**：这个 skill 目录本身就是 git 仓库
（`github.com/webkubor/charmoji-sticker-skill`），`~/dev/github/agent/charmoji`
是指向它的软链。早先是两份副本靠手动 rsync 同步，结果漂了 8 个文件才发现。
⚠️ Claude Code **不跟随 symlink 加载 skill**，所以真目录必须在 `~/.claude/skills/` 下，
反过来做会导致 skill 直接消失。

## 最快路径

```bash
# 形象只建一次
python3 $SKILL_DIR/scripts/ip.py add 团子 ~/Desktop/正面照.png --desc "简介，≤80 字" \
    --source ~/Desktop/团子画稿          # 原始画稿一并收进库
python3 $SKILL_DIR/scripts/ip.py sync    # 备份到私有仓库

# 之后每出一套系列，一条命令（目录自动放对位置、序号自动递增）
$SKILL_DIR/scripts/new_album.sh --ip 团子 --series 日常
$SKILL_DIR/scripts/new_album.sh --ip 团子 --series 打工     # 第二套，自动变 02-打工

# 随时看全局
python3 $SKILL_DIR/scripts/ip.py list          # 每个形象几套系列、每套什么状态
python3 $SKILL_DIR/scripts/ip.py show 团子      # 单个形象逐项核对
python3 $SKILL_DIR/scripts/ip.py page          # 生成 HTML 面板并打开（缩略图一览）

# 上架后要发朋友圈/视频号（可选，见 Step 8）
python3 $SKILL_DIR/scripts/make_promo.py <系列目录>
```

`new_album.sh` 幂等：同名系列反复跑会复用同一个目录，不会新建一堆空壳。
第一次跑生成 `album.yml` 停下让你填文案，填完再跑同一条命令就继续往下走。

下面是每一步在做什么、以及为什么这么定 —— 出问题时看这里。

---

## Step 1 · 把形象存进 IP 库（一次，之后长期复用）

```bash
python3 $SKILL_DIR/scripts/ip.py add <形象名> <正面照> --desc "简介，≤80 字"
python3 $SKILL_DIR/scripts/ip.py list        # 有哪些形象
python3 $SKILL_DIR/scripts/ip.py show 团子    # 完善进度 + 待办 + 已挂专辑
python3 $SKILL_DIR/scripts/ip.py sync        # 备份到私有 GitLab 仓库
```

**为什么要有 IP 库**：官方的「表情形象」是账号级资产（自己的名称/简介/头像/图标），
一个形象可以挂多套专辑；封面图、横幅、含义词才是专辑级的。混在一起必然出现
「同一个 IP 两套专辑简介不一致」「两个形象用了同一张头像」这类会被打回的问题。
而且官方有三条跨形象的硬约束，只有集中存放才查得了：

- 同一作者的形象名不得重复 → `ip.py add` 直接拒绝重名
- 不同形象不得用同一张头像/图标 → 注册时按差分哈希比对已有形象，太像就警告
- **一套作品只能挂一个形象，改归属只有 1 次机会** → `new_album.sh` 会校验
  `album.yml` 里的 `ip_name` 与 `--ip` 一致，不一致直接拦下

**库在哪**：默认 `~/.wechat-stickers/`，用环境变量 `STICKER_HOME` 覆盖。结构：

```
~/.wechat-stickers/ips/<形象名>/
├── ip.png            正面照母版 —— 出图垫图用这张，多套专辑形象才不会漂
├── ip-reverse.txt    读图逆向的英文 prompt，一个形象只读一次（省时间省配额）
├── 形象头像-<名>.png   240×240 透明，形象主页用
├── 形象图标-<名>.png   50×50 透明
└── ip.yml            名称 / 简介 / 已挂专辑 / 待办
```

**备份不是可选项**：形象母版丢了，整条形象合集就断了（表情图丢了还能重出）。
`ip.py sync` 把整个库推到私有 GitLab 仓库，图片与元数据一起版本化；
换机恢复就是 `git clone <仓库> ~/.wechat-stickers`。首次 sync 会自动建仓。

对正面照的要求只有一条：**角色正面、完整、你拥有版权**。手绘扫描、AI 出的、自家宠物照都行；
别拿他人作品或知名 IP 垫图 —— 那属于审核明文禁止的「权利所属不明」。

照片型（真宠物照）和插画型都能投，但差别要知道：
**照片型的表情图可以不透明，插画型建议透明** —— 而两者的**封面图与聊天面板图标都必须透明背景**，
这是官方明文，没有例外。照片型要做封面就得先抠图（`museav remove-bg <file>`，默认 birefnet 模型，白色/低对比主体也能抠干净）。

## Step 2 · 写 IP 文案（5 分钟，先写再出图）

复制模板改字：

```bash
mkdir -p ~/Desktop/my-album && cp $SKILL_DIR/templates/album.yml ~/Desktop/my-album/
```

七个字段的写法、命名反面例子、9 情绪选题表、含义词与台词的区别，全在
`references/ip-design.md` —— **给小白看的部分主要是这一篇**。

最容易错的一条先讲：**含义词是用户在表情面板里搜的词，不是画面里的台词**。
画面写「555…我没事」，含义词要写「我没事」（≤4 字、无标点、同套不重复）。

先写文案再出图，因为文案里的 9 个情绪就是出图的 prompt 清单。

## Step 3 · 批量出图（一条命令，约 3 分钟）

```bash
$SKILL_DIR/scripts/gen_album.sh --ip ~/Desktop/ip.png --out ~/Desktop/my-album
```

脚本做三件事：`museav reverse` 把 IP 外形逆向成英文 prompt（这是整套风格一致的锚）→
按 9 个情绪并发出图（`--ref` 垫图 + `--transparent` 透明 PNG）→ 顺手出一张横幅底图。

常用参数：`--count 8`（8~24 张任意数量都合规，8 张最省）、
`--emotions "开心,委屈,好困,..."`（换题材整组换，别混搭）、`--style "水彩风"`、`--jobs 3`（并发）。

出图会偶发失败（上游超时/审核拦截），单张自动重试一次。**重跑只补缺失的那几张**，
已出的直接跳过 —— 补 2 张不会重烧 8 次配额。要整套重出加 `--regen`。

出图不满意就重跑单张，别将就 —— **整套差异不足是第一大拒因**，宁可多出几张挑。
横幅要求和表情图正好相反（不透明、有场景、无任何文字），所以它单独出、单独裁。

**没有 museav 的路径**：自己画好或已有图，放进 `<目录>/raw/`（8~24 张，任意尺寸，按文件名排序），
横幅底图命名 `banner-src.png`。切图会自动跳过 `banner-src.*` / `ip.*` / `00-*` 这类非表情图文件。

## Step 4 · 切图（一条命令，秒级）

出图是 1240×1269 这种随机尺寸，必须切成规格尺寸 —— 直接传超规格图，
**平台不会拒，会静默压缩裁剪**，主体被裁掉才发现就晚了。

```bash
python3 $SKILL_DIR/scripts/fit_assets.py ~/Desktop/my-album/raw ~/Desktop/my-album \
  --cover ~/Desktop/my-album/raw/01.png \
  --icon  ~/Desktop/my-album/raw/01.png \
  --banner ~/Desktop/my-album/raw/banner-src.png
```

自动完成：抠白底 → 裁掉多余留白 → 等比缩放居中贴透明画布 → 压到体积上限。
封面取正面半身/全身（官方明确「避免只使用头部图片」），图标自动取头部正面并留 12% 边
（铺满四角会被判成「正方形边框、生硬直角」）。

## Step 5 · 机检（FAIL 必须清零）

```bash
python3 $SKILL_DIR/scripts/check_assets.py ~/Desktop/my-album --copy ~/Desktop/my-album/album.yml
```

逐项判定格式 / 尺寸 / 体积 / 透明背景 / 白描边 / 锯齿 / 留白比例 / 张数 /
**画面两两相似度** / 文案字数与含义词重复。三级结果：`FAIL` 必改、`WARN` 人工确认、`OK` 通过。
退出码等于 FAIL 条数，可以直接串进脚本。

几条判定的分寸（都是实测调出来的，别当成过严去绕过）：

- **白描边**：只有「轮廓明显比主体内部更白」才判 FAIL。白猫、雪人这类白色系角色不会被误报。
- **相似度**：先裁到主体再算差分哈希 —— 否则大片白底会把 8 张不同表情算成同一张。
  距离 <6/64 判 FAIL，6~10 判 WARN。**用 AI 出图几乎必然出现几条 WARN** ——
  垫图保证了形象一致，代价是姿势也跟着一致（都是正面坐姿，只有表情和手位在变）。
  实测一套 8 张就有 3 对落在 WARN 区（距离 6、10、10）。
  对策是在情绪里绑姿势/视角（站起来、侧身、躺着、只露头），默认情绪列表已经这么写了。
  ⚠️ **这个对策本身没跑通对照实验** —— 改完后连续几轮都撞上出图中台的频次限制，
  没拿到可比的一套。所以它是「对症的推断」，不是「已验证的结论」，
  真值请自己跑一次对比 WARN 条数。
- **透明背景**：封面/图标 FAIL，表情图 WARN（照片型可忽略），横幅/赞赏图反过来，透明才 FAIL。

## Step 6 · 填表提交（照着 submit.md 抄）

机检通过后自动生成 `submit.md` —— 平台表单每个字段填什么、传哪张图，一行一项：

```bash
python3 $SKILL_DIR/scripts/make_submit.py ~/Desktop/my-album   # new_album.sh 会自动跑
```

素材按**形象名 + 含义词中文命名**，打开文件夹就知道哪张是哪张，不用对编号映射：

```
团子日常/
├── 表情图/01-开心.png … 08-无语.png   240×240  ≤500KB  ← 按编号顺序传
├── 封面图-团子.png                    240×240  ≤500KB  透明
├── 聊天图标-团子.png                   50×50   ≤100KB  透明
├── 详情页横幅-团子日常.jpg              750×400 ≤500KB  不透明·无文字
├── album.yml                         文案（名称/介绍/版权/含义词）
├── submit.md                         提交清单 ← 照着这个填表
└── raw/                              出图原件（不提交，留档用）
```

不传 `--copy album.yml` 时退回英文命名（`main_240/01.png`、`cover_240.png`…），
机检与清单脚本两套都认。

投稿入口（路径分两套 CGI 前缀，猜必 404，全部记在 `references/platform.md`）：

```
首页/登录  https://sticker.weixin.qq.com/cgi-bin/mmemoticonwebnode-bin/pages/home
注册       https://sticker.weixin.qq.com/cgi-bin/mmemoticonwebnode-bin/pages/signup
```

登录只有「微信扫码」和「账号密码」两种，扫码这步 agent 代不了 ——
用 `ego-browser` 的 `handOffTaskSpace` 把浏览器交还给人。

**唯一不可逆的一步在这里**：作品挂到表情形象后，只有 **1 次**改到其他形象的机会
（且要先从原形象删除再加到新形象）。挂之前把形象确认清楚 —— 形象合集是拿关联推荐流量的入口。

## Step 7 · 归档与通知

素材母版按全局约定上 R2（`cs image upload`），**不要往 picx 加新图**。
桌面目录只当临时切图区。投稿结果用 `cs notify` 广播。

---

## Step 8 · 推广视频（可选，上架后发朋友圈 / 视频号）

把整套表情串成 1080×1920 竖版视频，版式对齐官方秒剪模板：

```bash
python3 $SKILL_DIR/scripts/make_promo.py <系列目录>                   # 配乐默认「儿童轻快」
python3 $SKILL_DIR/scripts/make_promo.py <系列目录> --sec 1.8         # 张数多时压缩每张停留
python3 $SKILL_DIR/scripts/make_promo.py <系列目录> --voice narrator  # 加配音，镜长由念白决定
```

**文案真源是 `album.yml` 的 `captions` 段**，写「什么时候发这张」而不是重复画面文字，
传播力更强。配乐传配乐库别名（`reel bgm` 看清单），出片时会打印授权。

出视频的能力在 **[reel-kit](https://github.com/webkubor/reel-kit)**（`reel` 命令），
`make_promo.py` 只负责读 `album.yml` 拼参数，不含合成逻辑。**要改版式去改 reel-kit 的
`templates/*.html`** —— 丢一个 HTML 进去就是一个新版式，不用改本 skill 的代码。

> 前置（首次）：`cd ~/dev/github/devtool/reel-kit && pnpm install && npm link`，另需 ffmpeg + Chrome。
> 用 `--voice` 还需 voxcraft 已注册音色，见 reel-kit README。
>
> `museav slideshow` 已于 2026-08-28 下线，出片能力收敛到 reel-kit 一处，别再找 museav。

---

## 变现（可选，有前置条件，别等提交时才发现）

**赞赏**：需艺术家资料审核通过 + 绑定微信号/商户号 + 无违规，提交时要带引导语（5~15 字）、
引导图 750×560、致谢图 750×750（都不透明、≤500KB）。用 emoji 素材二创的作品**不能开赞赏**。

```bash
python3 $SKILL_DIR/scripts/fit_assets.py ~/Desktop/my-album \
  --reward-guide raw/banner-src.png --reward-thanks raw/02.png
```

**付费**：需至少 1 套已上架 + 近三个月无违规；价格固定每套 10 微信豆不可自定义；
免费↔付费**双向不可转**；付费与特效作品**不可在其他平台重复投稿**；
个人号一旦申请，身份信息不可再改、不可升企业号。细则见 `references/specs.md` 第六节。

## 审核红线速查

整套差异不足（最高频）· 纯文字表情缺创意 · 权利不明（二次创作/同人/拼接素材）·
真人肖像未授权 · 与微信官方作品雷同 · 画面出现二维码/联系方式/社交账号/银行账户 ·
受限题材（医疗药品烟酒金融虚拟币枪支、国旗国歌国徽人民币政府文件；军旗党旗团徽需授权书）。

全文与 AI 出图的额外注意事项见 `references/audit.md`。

## 文件索引

| 文件 | 用途 |
|---|---|
| `references/specs.md` | 官方制作规范全文（表情/形象/特效/艺术家/赞赏/付费）— **数字真源** |
| `references/audit.md` | 官方审核标准全文 + 高频拒因清单 |
| `references/ip-design.md` | IP 命名 / 简介 / 情绪选题 / 含义词写法（小白主要看这篇） |
| `references/platform.md` | **平台地图**：真实 URL、登录方式、账号前置条件（路径猜不出来，别拼） |
| `references/animated.md` | **动态表情**：透明 GIF 的 1-bit 约束、四步流水线、IP 适配判断 |
| `references/pitfalls.md` | 开发本 skill 时踩过的坑：中文 bash 三坑、CLI 输出通道、图像机检误报 |
| `templates/album.yml` | 文案模板，可被机检脚本解析 |
| `scripts/ip.py` | **IP 库**：注册形象 / 完善进度 / 跨形象约束校验 / HTML 面板 / 备份到私有仓库 |
| `scripts/page_tpl.py` | 面板的样式与渲染（被 `ip.py page` 调用） |
| `scripts/new_album.sh` | **一键入口**，幂等：文案 → 出图 → 切图 → 机检 → 清单 |
| `scripts/lint.sh` | 脚本门禁：把 pitfalls 里踩过的坑变成能跑的检查 |
| `scripts/gen_album.sh` | 一张正面照 → 整套原图（museav 出图中台） |
| `scripts/fit_assets.py` | 源图 → 合规尺寸素材（仅依赖 PIL） |
| `scripts/check_assets.py` | 素材 + 文案机检，退出码 = FAIL 数 |
| `scripts/make_gif.py` | 透明 PNG 序列 → 240×240 透明 GIF，自适应压到 500KB |
| `scripts/make_submit.py` | 生成 `submit.md` 提交清单（字段 → 值/文件对照） |
| `scripts/make_promo.py` | 整套表情 → 1080×1920 竖版推广视频；只拼参数，合成走 [reel-kit](https://github.com/webkubor/reel-kit) |

规范是动态文档，官方会改。数字以 `references/` 为准，若与平台当前页面冲突，**以平台页面为准**并回来更新本 skill。