dsh-pet

配置

在 profile 的 cordis.patch.yml 中覆盖默认配置（cordis.patch.yml 必须是顶层 YAML 数组，每个元素是一个 patch entry）：

- insert:
  - id: dsh-pet
    name: dsh-pet
    config:
      idleMs: 3000
      scale: 1
      fpsScale: 1
      injectOverlay: true
      overlayRoute: /dsh-pet

配置项	类型	默认值	说明
idleMs	number	3000	完成/出错后多久恢复待机（ms，500–600000）
scale	number	1	浮层尺寸倍数（0.5–3）
fpsScale	number	1	动画播放速度倍速（0.25–4，作用于全部状态的全局乘数，不覆盖各行 rowFps 的相对节奏）
injectOverlay	boolean	true	是否把浮层注入 3080 页面；设为 false 则只提供 /dsh-pet/ 弹窗页
overlayRoute	string	/dsh-pet	同源路由前缀，所有资源挂在其下
enabled	boolean	true	是否显示桌宠；也可在设置面板里开关（最终写入 pet/user-config.json）
spriteFile	string	doraemonsprite.webp	精灵图文件名（相对于 pet/ 目录）
sprite	object	见下方	精灵图网格与状态映射配置（支持部分覆盖，深合并默认值）

sprite 配置结构：

sprite:
  cols: 8          # 网格列数（每行帧数上限）
  rows: 9          # 网格行数（动画状态数）
  fps: 8           # 默认帧率（可被 rowFps 逐行覆盖）
  rowFrames: { 0: 6, 1: 8 }   # 可选：逐行帧数（缺省用 cols）
  rowFps:    { 8: 12 }        # 可选：逐行帧率（缺省用 fps）
  stateRows:                  # dsh 状态 -> 网格行号
    idle: 0
    thinking: 8
    working: 1
    waiting: 3
    failed: 5
    completed: 4

默认精灵图（doraemonsprite.webp，9 行 × 8 列）的动画布局：

行号	dsh 状态	默认帧数	默认帧率	含义
0	idle	6	6	待机
1	working	8	12	向右奔跑
2	（未映射）	8	12	向左奔跑
3	waiting	4	5	挥手
4	completed	5	8	开心
5	failed	9	10	晕倒/失败
6	（未映射）	6	10	跳跃
7	（未映射）	7	9	大笑
8	thinking	6	8	思考