petdex宠物异常时需终端诊断：先用curl验证sidecar服务存活，再检查pets目录下pet.json和spritesheet.webp是否齐全，最后清空runtime缓存、发送sigusr2重载配置并重启宠物开关。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你发现Hermes桌面端宠物没有显示、卡在某个动作不切换、气泡文字空白或动画撕裂时，需要一套精准的终端级诊断路径来定位是配置缺失、服务未响应还是资源加载失败。
确认Sidecar服务是否存活
打开终端，执行：
curl -s http://localhost:7777/health | jq .status
如果返回 【error: command not found】，说明未安装 jq，改用：
curl -s http://localhost:7777/health | grep -q '"status":"ok"' && echo "alive" || echo "dead"
返回 dead 表示 Sidecar 服务未启动。此时不要重启应用，先检查进程：
ps aux | grep sidecar | grep -v grep
若无输出，说明服务崩溃或未被 init 命令拉起——这通常发生在首次安装后未运行 npx petdex init，或手动 kill 过相关进程。
验证宠物资源是否完整加载
方法一：检查本地宠物目录结构
ls -l ~/.petdex/pets/$(npx petdex select --current 2>/dev/null)
必须存在 【pet.json 和 spritesheet.webp】 两个文件，缺一则渲染中断。常见原因是 npx petdex install boba 执行中途断网，导致只下载了 JSON 没拉取精灵图。
方法二：直接请求宠物元数据接口
curl -s "http://localhost:7777/pet/current" | jq '.name,.state,.bubble'
若返回空对象或 404，说明 Petdex CLI 与 Hermes Agent 的状态同步已断裂，需重置当前宠物：
npx petdex select → 用方向键选中当前宠物 → 回车确认
强制刷新渲染上下文
第一步：清空运行时缓存
rm -f ~/.petdex/runtime/state.json ~/.petdex/runtime/bubble.json
第二步：触发 Sidecar 重载配置
kill -SIGUSR2 $(pgrep -f "sidecar/server.js")
第三步：在 Hermes 桌面端设置中关闭再开启「宠物」开关（路径：设置 → 外观 → 宠物）
注意：SIGUSR2 信号仅对 Node.js 进程有效，若 pgrep 无输出，请先执行 npx petdex init 确保 Sidecar 已注册为守护进程。
