做一只宠物
把素材目录转成宠物包 zip,用户在「设置 → 宠物 → 导入」里选它。脚本在 scripts/ 下。
支持(按目录内容自动识别,一个目录只放一种):
- clawd-on-desk 主题:theme.json + assets/
- 图片:GIF / APNG / WebP / PNG,一个文件一个动画;文件名自动认状态 (idle、thinking、working、error、done、sleep、walk、poke、drag、tickle 等中英文)
- 逐帧目录:walk/01.png、hello_01.png,目录或前缀即动画名
- Aseprite 导出:JSON + 图集 PNG,按 frameTags 分动画
- 单张图片:做一只静态待机
没认出来的动画自动进待机小剧场,不会浪费。
步骤
拿到素材目录(用户给链接就 git clone --depth 1,给 zip 就解压)。目录里没有 theme.json 也没有图片就停下,说清楚支持什么。
缺依赖才装:python3 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple Pillow numpy
转:
python3 <scripts>/pet_theme_convert.py --input <目录> --out /tmp/pet-pack --id <id> --input-name <名字> [--source <链接>]像素画(小图、硬边)自动保持尺寸锐利绘制;其它素材自动用 144 画布平滑绘制。 想强制锐利加 --crisp。
校验,必须 PASS:
python3 <scripts>/pet_pack_check.py /tmp/pet-pack/<id> --compat-reactions打包:
cd /tmp/pet-pack/<id> && python3 -m zipfile -c <输出路径>/<id>.zip pack.json *.png手机输出到 /sdcard/Download/DSH-Go/。
收尾:告诉用户导入路径,作者与授权显示在宠物页底部;只做自用转换,第三方素材 (尤其 CC BY-NC-SA 同人作品)不要打包进发行版或市场。
边界
- 一个目录只识别一种素材,混放请分开。
- 整张精灵表请先拆帧或导出 Aseprite JSON。
- 状态靠文件名匹配;都没认出来时第一张当待机,其余进小剧场。
- 不手改生成的 pack.json,不跳过校验,不把用户素材上传。