whale-girl

使用

你做什么 / 发生什么	宠物表现
拖拽宠物	被斜向拉扯（drag）
点击菜单 🍗 喂食 / 🎾 玩耍	啃咬/抛接球（eat/play）→ 开心（joy）
空闲 ≥60s	打盹（sleep）；互动时醒过来（wake）
任务完成 / 升级 / 称号 / 回合完成	举手欢呼（celebrate）
任务失败 / 请求出错	惊吓（error）→ 失落（disappointed）
新会话开始	挥手欢迎（welcome）
任一会话运行/思考中	沉思陪伴（think，偶尔 working 工作姿态）
等待批准	期待等待（wait）
周期游走	散步（walk）
常态	待机（idle，随机眨眼/转身）

完整状态机（优先级/转换语义/触发源）见 docs/state-machine.md。

配置

参数经宿主 settings 配置，/settings.yaml 的 whale-girl: section（或设置 UI）修改后热生效免重启：

whale-girl:
  enabled: true      # 网页端渲染开关（与桌面伴侣并存时设 false 关闭网页端宠物，避免双宠物）
  size: 110          # 宠物尺寸 px（64–160）
  opacity: 1         # 常态透明度（0.2–1）
  walk:
    enabled: true    # 游走开关
  sleepAfterMs: 60000

完整配置项清单与语义层（XP/称号）封闭说明见 lib/src/config.mjs。语义层不可配（改 XP/称号阈值会破坏积累账本一致性）。