dsh-ronaldo-pet

⚙️ 配置

bundle 版的所有可调项集中在 host.js 顶部 CONFIG：

配置	默认值	说明
spritePath	/assets/spritesheet.webp	内置 C罗 精灵图（相对包目录，装好即用）
pollMs	500	Agent 状态轮询间隔
celebrateMs	4800	庆祝动画时长
failedMs	2600	失败动画时长

• 想换你自己的素材：把同名文件覆盖到 /assets/ 下即可（或直接改 spritePath/voicePath 指向其它文件）。
• 自定义导入：打开 DSH 设置 → ⚽ 桌宠，可从 codex 项目目录一键导入精灵图（读取 final/spritesheet-extended.webp/final/spritesheet.webp 与 pet_request.json），或手动填写任意 spritesheet 图片的绝对路径 + 行列/格宽格高/每行帧数；导入的宠物会出现在右下角并同样跟随 Agent 状态动画。
• 提示音平台差异：host.js 的 playCommand() 已按平台自动生成命令——Windows 上直接输出 PowerShell 语句（DSH 的 ctx.shell 就是 pwsh 执行器，命令文本会作为 PowerShell 代码执行，用 WPF MediaPlayer 播放 mp3）；macOS 输出 afplay；Linux 输出 ffplay -nodisp -autoexit（没有 ffplay 可改 paplay）。若机器上没有这些播放器，按平台改 playCommand() 即可。
  • ⚠️ 早期版本在 Windows 上把命令包成 powershell.exe -Command "…$m…" 再交给 DSH 的 pwsh 执行器，外层 PowerShell 会先把 $m 插值吃掉，导致「动画在跳、声音却没有」的静默失败；本版已改为直接执行 PowerShell 语句，不再嵌套。升级后请重启 dsh web。
• 想彻底静音：把 host.js 里的 playSystemVoice() 调用注掉即可。
• 这些配置同时支持通过 bundle patch 行传入（例如给插件行加 config: { pollMs: 800 }），默认值即上表。