把热门表情包里的猫，换成你家猫。静态图和 GIF 都行，由 即梦 CLI 驱动。
| 原图（meme） | 我家猫 | 替换后 |
 |
 |
 |
演示图：左边是黑猫剪影在巷子里走的原图，中间是用户的猫照片，右边是 mycat-meme 输出——同一条巷子、同一姿势、同一光影，但猫被换成了与第二张照片里相似的黑白花猫。一次调用，约 60-90 秒。
| 原 GIF | 我家猫 | 替换后 |
 |
|
 |
v0.2.1 GIF 流水线：把原 GIF 的首帧 + 你家猫照片 + 原 GIF 转的 mp4（动作参考）一次性丢给即梦
multimodal2video（Seedance 2.0 fast），让模型同时拿到场景、外观、动作三种参考，输出 mp4 后转回 GIF。整个过程约 4-6 分钟，一次调用。v0.2 时是先 image2image 替换首帧再 multimodal2video，结果模型容易在视频步骤把猫"褪色"成剪影。v0.2.1 砍掉了 image2image 中转步骤，直接让多模态模型自己分配三个 reference 的权重，剪影/暗色场景的猫现在也能稳定输出新猫的毛色花纹。
一个 Python CLI，输入一张猫咪表情包 + 一张你家猫的照片，输出一张"由你家猫主演"的同款表情包。底层完全调用即梦 CLI 的 image2image，所以效果跟着即梦走。
这个项目本身只是个胶水层，真正干活的是即梦 CLI。你必须先把即梦 CLI 装好并登录，才能用 mycat-meme。
# 见即梦 CLI 官方仓库的安装说明
# 安装完之后:
dreamina login --headless # 跟着提示登录
dreamina user_credit # 验证登录成功并查看积分pip install mycat-meme
# 或者从源码安装:
git clone https://github.com/BENZEMA216/mycat-meme.git
cd mycat-meme
pip install -e .mycat-meme replace <表情包.png> <我家猫.jpg> -o <输出.png>完整选项：
mycat-meme replace [OPTIONS] MEME CAT
Replace the cat in MEME with the cat photo in CAT, write to -o OUT.
Options:
-o, --output PATH Where to write the result. [required]
--style [default] Prompt style. [default: default]
--poll-seconds INTEGER Max seconds to wait inline. [default: 180]
--help Show this message.
mycat-meme replace-gif <表情包.gif> <我家猫.jpg> -o <输出.gif>强烈推荐加 --description（-d）描述你家猫的品种和毛色，否则模型容易默认产出通用橘虎斑短毛猫：
mycat-meme replace-gif meme.gif my-cat.jpg -o out.gif \
-d "金色长毛小奶猫，蓬松长毛，圆脸幼态"完整选项：
mycat-meme replace-gif [OPTIONS] GIF CAT
Replace the cat in GIF with the cat photo in CAT, write to -o OUT.gif.
Options:
-o, --output PATH Where to write the result GIF. [required]
-d, --description TEXT Short description of your cat (breed / fur
length / color). Strongly recommended — without
it the model reverts to a generic orange tabby
regardless of your reference photo.
Example: "金色长毛虎斑小奶猫，蓬松长毛，圆脸幼态"
--model [seedance2.0fast|seedance2.0|seedance2.0_vip|seedance2.0fast_vip]
dreamina seedance video model. [default: seedance2.0fast]
--duration INTEGER Output length in seconds (4-15). Defaults to ceil(input).
--fps INTEGER Output GIF frame rate. [default: 15]
--max-width INTEGER Output GIF max width in pixels. [default: 600]
--poll-seconds INTEGER Max seconds to wait for the video task. [default: 600]
--help Show this message.
ffmpeg is required for the GIF pipeline (brew install ffmpeg).
为什么需要 --description？ 实测发现 multimodal2video 有个怪脾气：就算把你家猫的照片放在第一位，prompt 写得再严厉，模型还是会默认输出一只"通用橘虎斑短毛猫"。只有在 prompt 里明确写出品种/毛色 keywords 才能锁住特征。托管版（v1.0）会自动做这一步，CLI 版让你手动描述最可靠也最省钱。
懒得自己写？直接 copy 下面这些模板里最接近你家猫的那条：
| 猫种 | --description 模板 |
|---|---|
| 金渐层小奶猫 | "金色长毛虎斑小奶猫，蓬松长毛，圆脸幼态，大眼睛" |
| 银渐层 | "英国短毛猫，银渐层，灰色短毛，圆脸，大眼睛" |
| 蓝白英短 | "英国短毛猫，蓝白双色，圆脸，耳朵小" |
| 黑猫 | "全身黑色短毛猫，黄色眼睛" |
| 全白猫 | "全身白色短毛猫，蓝色眼睛" |
| 橘猫 | "中华田园橘猫，橘黄色虎斑短毛，圆脸，胖" |
| 狸花 | "中华田园猫，灰色虎斑狸花纹，短毛" |
| 三花 | "中华田园猫，三花色（黑白橘），短毛，母猫" |
| 奶牛 | "中华田园奶牛猫，黑白双色短毛，圆眼睛" |
| 布偶 | "布偶猫，海豹色长毛，蓝色眼睛，面具脸" |
| 美短虎斑 | "美国短毛猫，经典银虎斑纹，短毛，大圆眼" |
| 暹罗 | "暹罗猫，米色身体，深棕色面具耳朵四肢，蓝色眼睛" |
原理：中文品种/颜色 keywords 能强力 anchor 住 multimodal2video 的外观权重，远胜于"请严格按照参考图"这种空话。越具体越好（毛色 + 毛长 + 品种 + 年龄 + 脸型）。
Q: 为什么不用 Stable Diffusion / Midjourney？
A: 因为这个项目的目的之一是让大家用即梦 CLI。如果你想换底层模型，可以 fork 这个 repo 替换 dreamina.py。
Q: 支持 GIF 吗？
A: 支持。v0.2 加了 mycat-meme replace-gif 命令，基于即梦 multimodal2video（Seedance 2.0）。需要本地装 ffmpeg。
Q: 替换后的猫不太像我家猫怎么办？ A: v0.1 走的是"形象/风格替换"路线，目标是让结果"看起来像一只跟你家猫长得很像的猫"，而不是像素级身份还原。如果你需要后者，等后续版本。
Q: 这个项目本身收钱吗？ A: 不收。但调用即梦 CLI 会消耗你即梦账号的积分。
- ✅ v0.1 开源 CLI 静态图替换（
mycat-meme replace） - ✅ v0.2 开源 CLI GIF 替换（
mycat-meme replace-gif，基于 Seedance 2.0） - ✅ v0.2.1 GIF 流水线重构：单次 multimodal2video 调用 + 强 prompt
- ✅ v0.2.2 三大修复：(1) 小 GIF（<640²）的尺寸约束归一化、(2) 下载 IncompleteRead 重试、(3) 新增
--description让模型保留品种级特征
后续路线图：
- v0.3 自动 VLM 描述生成（接 Claude vision API），免去
--description手写 - v1.0 托管站（中文圈，微信登录 + 微信支付）
- v1.1 用户上传自己的表情包库
MIT. See LICENSE.
- 即梦 CLI — 干所有的脏活
- 所有原版表情包的创作者