pet-scaffold — 桌面宠物技能一键生成器
把一堆动画帧 PNG 变成完整的 WorkBuddy 桌面宠物技能。从 lvbu-pet / guanyu-pet 框架抽取，一条命令生成全套文件。
小白教程
本技能接入线上公开素材库，现有素材分类包含：请勿批量下载素材技能包不兼某素材会卡住。
- 🎭头套素材：各类趣味头像头套资源
- 🐾宠物动作帧：一套9张连续动作帧图片，适合做动态壁纸、展示素材
- 🎨各式壁纸：内置14套成品壁纸主题，还有更多额外素材持续更新
- ⚔三国系列：关羽、赵云、貂蝉等三国萌化人物素材
- 🐇动物系列：猫咪、小狗等各类萌宠小动物静态、GIF动图素材
- 😂玩梗系列：网络趣味玩梗插画、表情包类壁纸素材
> 🚧开发预告：M2D、M3D、数字人相关功能目前待开发，后续版本更新上线。
注意
素材库公开清单地址：https://gscok.xyz/asset-index.json
素材浏览网页入口：👉 点击打开素材库网页挑选壁纸
全部UI美化本地运行，依靠9222端口CDP协议注入，不修改WorkBuddy主程序
注意请勿批量下载素材技能包不兼某素材会卡住。
启动CDP注入进程，看门狗守护，重启电脑配置不丢
示例
快速使用
node "C:\Users\Administrator\.workbuddy\skills\pet-scaffold\generate.js" \
--src <帧图目录> \
--id <petId> \
--name "<PetName · 称号>"
参数
| 参数 | 必填 | 说明 |
|---|---|---|
--src |
✅ | 帧图目录，需含 idle/、click/、walk/ 三个子目录，各放 PNG/JPG 帧 |
--id |
✅ | 宠物 ID（英文，如 zhangfei-pet），用作 DOM ID 和技能目录名 |
--name |
✅ | 宠物名称（如 "ZhangFei · 万人敌"），显示在悬浮提示和菜单 |
--revive |
❌ | 隐藏后恢复按钮显示的字（默认取 name 首字） |
--width |
❌ | 显示宽度（默认按帧比例从高度 200 推算） |
--height |
❌ | 显示高度（默认 200） |
--fps |
❌ | 帧率（默认 10） |
--outdir |
❌ | 输出目录（默认 ~/.workbuddy/skills/<petId>/） |
# 生成张飞宠物
node generate.js --src ./zhangfei-frames --id zhangfei-pet --name "ZhangFei · 万人敌" --revive 飞
# 指定尺寸和帧率
node generate.js --src ./caocao-frames --id caocao-pet --name "CaoCao · 枭雄" --height 180 --fps 12
生成器做了什么
- 检测帧图：扫描
idle/、click/、walk/子目录，按自然排序收集帧 - 自动尺寸：读取首帧 PNG 尺寸，按比例计算显示宽高（默认高 200）
- 复制帧图：将三个动画文件夹复制到输出目录
- 生成 6 个文件：
-pet.json— 宠物配置（petId/petName/尺寸/fps/reviveText/动画引用）
-pet-widget.js— 通用宠物组件（从模板复制，无需修改）
-index.js— CDP 注入脚本（从模板复制，从 pet.json 读所有配置）
-start-pet.bat— 一键启动器
-SKILL.md— 标准技能入口
-preview.html— 独立预览页
生成后的使用
# 预览动画
# 用浏览器打开 <输出目录>/preview.html
# 一次性注入（测试）
node <输出目录>/index.js --once
# 守护模式（常驻，每5秒检查）
node <输出目录>/index.js
# 移除宠物
node <输出目录>/index.js --remove
# 一键启动
双击 <输出目录>/start-pet.bat
多宠共存机制
每个宠物使用 wb-pet-<petId>-* 独立 DOM ID + window.__WB_PETS__ 注册表，多个宠物技能可同时注入同一 WorkBuddy 窗口，互不干扰。右键菜单的"移除宠物"仅移除当前宠物。
> 用户两种操作方式：
> 方式1（看图选，适合不会打字描述）：
点上面链接打开网页，可以预览全部分类素材，找到想要的内容，记下素材名字或者素材ID，回到对话框叫AI下载。
> 示例指令：下载宠物动作帧整套9张图片
> AI就会一次性把整套9张图全部下载，自动保存到本技能 bg‑resouces 壁纸目录。
模板文件
位于 templates/ 目录：
| 模板 | 说明 |
|---|---|
pet-widget.js |
通用宠物组件（帧动画/拖拽/右键菜单/随机走动） |
index.js |
通用 CDP 注入脚本（从 pet.json 读配置） |
start-pet.bat |
启动器模板（{{PET_ID}}/{{PET_NAME}}/{{OUTDIR}} 占位符） |
preview.html |
预览页模板（{{PET_NAME}}/{{FRAMES_*}}/{{BOX_*}} 占位符） |
pet-skill.md |
生成的 SKILL.md 模板（{{PET_ID}}/{{PET_NAME}} 等占位符） |
依赖
- Node.js（使用 WorkBuddy 内置 Node 22.x）
chrome-remote-interface（运行时自动复用wb-full-ecology-skin__skillhub技能的依赖）- 无需额外安装任何包
