想把桌面上的线条小狗、水獭Boba或自定义宠物,调整到刚刚好嵌入屏幕右下角的呼吸感留白区域,既不遮挡Dock栏,也不挡住通知中心?很多人试过默认的“外观→宠物”滑块,但它的可调范围非常有限。直接修改底层配置文件才是最佳方案——改完后三秒内就能看到效果。
具体来说,关键就在当前宠物目录下的 pet.json 文件中的 scale 值,取值范围通常是 0.7 到 1.8,支持小数点后两位(比如 1.35)。保存文件之后,无需重启应用,Petdex 会在 3 秒内自动重新加载精灵图。批量修改时可以用 sed 命令或者 HTTP API(范围 0.3~2.0),超出限制会报错。

进入宠物配置目录
打开终端,执行以下命令:cd ~/.petdex/pets/$(npx petdex current | jq -r '.name')
这条命令会跳转到当前正在使用的宠物目录,例如 boba 或你自己命名的 pet-name。如果系统提示 command not found jq,请先运行 brew install jq,或者用 npx json -f ~/.petdex/runtime/state.json | grep name 来替代。
修改缩放参数
用文本编辑器打开 pet.json:open -e pet.json
找到其中的 scale 字段,默认值为 1.0。改成 0.7 会让宠物变小,改成 1.8 则明显放大。需要特别留意的是:scale 值如果超过 2.5,宠物可能超出屏幕边界且无法拖回,必须重启 Petdex 才能恢复。
保存文件后,无需任何额外操作——Petdex 会在 3 秒内自动监测到变化并重新加载精灵图。
验证缩放是否生效
回到桌面,观察宠物的动作帧是否按比例缩放:idle 状态下的轻微晃动幅度、wa ving 时爪子的摆动范围、jumping 的弹跳高度,都会同步变化。如果气泡文字(bubble.json)没有随着宠物同步缩放,说明你修改的是旧版 pet.json——务必要确认 cd 进入的是当前 active 的宠物目录,而不是 ~/.petdex/pets/boba 的原始模板。
批量调整多只宠物缩放(高级)
方法一:用 sed 批量处理所有宠物
for d in ~/.petdex/pets/*/; do [ -f "$d/pet.json" ] && sed -i '' 's/"scale": [0-9.]\+/"scale": 1.2/' "$d/pet.json"; done
方法二:通过 HTTP API 实时调节(需 Sidecar 正常运行)
curl -X POST http://localhost:7777/api/v1/pet/scale -H "Content-Type: application/json" -d '{"scale":1.4}'
API 调用后会立即生效,同时该数值会写入当前宠物的 pet.json,下次启动依然保留。需要提醒的是:此接口仅接受 0.3~2.0 范围内的数值,超出范围会返回 400 错误且不修改任何文件。
