Overview
dsh-whale-bridge
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
* 依赖两个被串联插件的 DOM 契约(见 §1 的偏离说明):类名/文案变了就要同步改 `lib/client.js` 顶部常量。 * 朝向/歪头是靠往 pet-whale 的**内层 `svg` 写内联 `style.transform` / `style.transition`** 实现的;本插件"写"进别人 DOM 的地方只有两处,这是其一(只写这一枚子节点的这两个属性,退出假装工作或卸载时会删干净;不碰 `.pet-official` 的内联 style,也不碰 `data-facing`)。另一处是 §2 的样式表守护:给 `#pet-whale-style` 补 `data-plugin` 属性;只有它已经丢失、而桌宠根节点还在时,才会重注入一份同 id 的样式表。 * 原插件的两个互动动作会在**动画期间短暂盖掉**桥接的 transform(它们在**同一枚 `svg`** 上 animate,且都带 `animation` 优先级):`pw-squish`(戳一戳,0.42s,只写 `scale()`)和 `pw-rollTrick`(双击翻滚,0.65s,只有 `translate/rotate`)。桥接故意不加 `!important` —— 让用户的互动优先,动画结束自动回到朝向状态;`pw-swim` 跑在父级 `.pet-official` 上,与此正交,不受影响。 * 歪头只做**绕底部中央的侧倾(rotate)+ 仰角错觉(skewY)**,没有真正的 3D 透视;鲸鱼贴图是侧视的,`skewY` 值过大会显得被拉斜,所以 `pitchRatio` 默认压低到 `0.35`。 * 桥接只在**桌宠与挂件同时存在**时工作;其中一个被隐藏(贴图尺寸为 0)视为不存在,不做任何动作。 * 播报用的是挂件的默认序列(先余额、再台词),因此挂件自己的"每轮消耗/告警"气泡优先级不受影响。 ---
