--- 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 `，默认 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。