HEYTEA-Style Doodle Poster

heytea-style

把一张生活照片变成手绘图文海报、风味小怪兽、小怪兽与真实产品互动的融合海报，或能在 macOS / Windows 桌面运行的手绘桌宠。

非官方开源视觉研究与创作工具，与喜茶不存在合作、授权或官方归属关系。

效果一：图文海报

同一张照片可以生成两种独立构图。带字版突出歪扭手绘标题；无字版不只是删掉文字，而是改用微型小人的动作讲故事。

原始照片	A. 带字海报	B. 无字海报

照片上传后的三个入口

只上传照片、还没说明用途时，Skill 会先确认主体是否清晰且唯一，然后只提供三个选择：

1. 生成带字版海报
2. 生成不带字海报
3. 生成一张风味小怪兽

如果你已经说清楚要哪种产物，Skill 会直接开始，不重复提问。“两套海报都要”仍然支持，但不会因此增加第四个默认入口。

效果二：生成风味小怪兽

风味小怪兽先作为一张静态身份稿生成，此时不检查运行器。只有你明确确认形象以后，才会继续询问：制作融合海报、制作可运行桌宠，或两者都做。

原始照片	A. 写实卡通桌宠（明确请求时）	B. 风味小怪兽
输入提供主体、色彩和材料信息	原主体直接成为角色，保留轮廓与关键结构	原图提供色彩、配料、材质及包含、沉积和覆盖关系，容器不再充当身体

确认后的 canonical monster 会同时锁定融合海报和桌宠动作中的身体、脸、2+2 肢体、颜色、材质与风味标记。

效果三：小怪兽与原产品互动

小怪兽身份确认后，可以重新回到原始产品照片中。原产品继续保持真实的摄影质感；怪兽锁定身体、表情、两手两腿、颜色和材质，只调整姿势，通过一个明确动作与产品产生联系。

融合海报不是把怪兽简单贴在产品旁边。每张图只选择一个主要动作，例如投、扶、抱、探、推或尝，让接触点、视线和动作轨迹共同完成一个小故事。

这个例子使用“投”：小怪兽把代表风味的黄色色块投回饮品。原产品负责真实质感，怪兽负责动作，两者形成清楚的因果关系。

效果四：让小怪兽在桌面动起来

动作预览	实际桌面尺寸

怎么使用

在 Codex 中上传图片，然后直接描述需要的效果：

把这张照片做成图文海报，两套都出。
把这杯饮料做成一只风味小怪兽。
这个小怪兽我确认，接着做带字和无字两张融合海报。
把这杯饮料做成写实卡通桌宠。

小怪兽身份确认前不会自动生成海报或动作。可运行桌宠仍会经过两次人工确认：先确认角色形象，再确认动作或行为；只有角色确认且用户选择继续桌宠时才检查运行环境，动作通过后才会导出透明角色包与启动入口。

安装 Skill

git clone https://github.com/Hchen1218/heytea-style.git ~/.codex/skills/heytea-doodle-poster
cd ~/.codex/skills/heytea-doodle-poster
python3 -m pip install -r requirements.txt

重新打开 Codex 后即可使用。完整工作边界见 SKILL.md，风格、流程和角色包协议见 references/。

桌宠运行器

运行器只安装一次，之后每只桌宠通过轻量角色包导入。风味小怪兽使用 schema v3，需要运行器 3.1.0 或更高版本。

在角色身份已确认、并选择继续制作可运行桌宠后，进行只读环境预检：

python3 scripts/desktop_pet.py doctor --json --required-schema 3
python3 scripts/desktop_pet.py install --json-plan

检查安装计划并明确同意后，再执行：

python3 scripts/desktop_pet.py install --yes

升级已有运行器需要额外添加 --upgrade。若 npm/Electron 下载因网络失败，加上 --mirror 走 npmmirror。源码未变时会复用本地 dist/ 已打包产物，跳过 npm ci 和 electron-builder。check_desktop_pet_environment.py / install_desktop_pet_runtime.py 是统一 CLI 的 shim。工具会保留用户目录中的旧版本备份，不会静默替换系统目录应用、绕过系统安全提示或开启登录自启。

不要直接打开 assets/desktop-pet-runtime/src/renderer/index.html；透明置顶、托盘、角色导入和桌面物理依赖 Electron 主进程。

两条桌宠产品线

两个版本会编译成同一种内部行为模型，共用窗口、物理、托盘和交付链路。已有 v2 角色包无需迁移。

python3 scripts/desktop_pet.py pack examples/desktop-pet/pink-green-drink

python3 scripts/desktop_pet.py pack examples/desktop-pet/pink-green-flavor-monster-v3

python3 -m pip install -r requirements-dev.txt
python3 -m json.tool evals/evals.json >/dev/null
python3 -m unittest discover -s tests -v
python3 -m py_compile scripts/*.py

cd assets/desktop-pet-runtime
npm ci
npm test
npm run pack:mac   # macOS
npm run pack:win   # Windows

.
├── SKILL.md                         # Skill 入口与权限边界
├── references/                      # 风格、工作流与角色包协议
├── scripts/                         # 构建、校验、交付与环境工具
├── tests/                           # Python 工具测试
├── assets/desktop-pet-runtime/      # Electron 通用运行器
├── assets/examples/                 # README 自制示例
├── examples/desktop-pet/            # 可校验的 v2 / v3 角色包
└── private-assets/reference-cutouts # 研究参考素材

授权与素材边界

• 代码与运行器采用 MIT License。
• 仓库自制示例采用 CC BY 4.0；具体范围见 ASSET-NOTICE.md。
• private-assets/reference-cutouts/ 是第三方视觉研究参考，不属于 CC BY 授权，也不能视为官方素材。
• 用户应确认自己拥有上传图片及生成结果所需的使用权。
• 未获授权时，请勿加入官方 Logo、吉祥物、包装标识或合作声明。