本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-aemeath-pet

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:culture-flask/dsh-aemeath-pet

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 🎬 全部 11 种动画（待机 / 左右移动 / 挥手 / 跳跃 / 失败 / 等待 / 工作 / 检查 / 两向注视），帧布局与 Codex Pet V2 图集一致（1536×2288，8×11 格，每格 192×208）
• 🐾 右击菜单：停靠角落 / 自由摆放、大小（小·中·大）、隐藏、重置位置；拖拽可随意移动
• 💬 跟随 DSH 语言的中/英气泡文案（locale 命名空间 dsh-aemeath-pet）
• 🏃 随时随机表演：向左/右斜向奔跑（running-left / running-right，含垂直分量）、原地工作（running）、跳跃（jumping）— 停靠和自由摆放模式下都会出现
• 💾 偏好（启用 / 缩放 / 位置）持久化在 localStorage

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后桌宠不显示怎么办？

重启 dsh web 并在浏览器端执行 Cmd/Ctrl+Shift+R 硬刷新，旧版 Service Worker 会缓存缺失的精灵图路由。插件只对 web profile 生效，不要装到其它 profile。

桌宠数据存在哪里？会随账号同步吗？

偏好（是否启用、缩放、停靠或自由摆放的位置）只写到当前浏览器的 localStorage，键名 dsh-aemeath-pet.prefs，不联网也不跨设备同步。卸载插件后清掉该键即可。

桌宠会挡住页面上其它按钮吗？

不会。根容器固定为 pointer-events: none，只在画布、菜单和「爪印」按钮上重新启用指针事件；CSS 把 z-index 设为最高层级但不会拦截下层交互。

鼠标点击 / 拖拽会触发什么？

单击会播放挥手动画并随机说一句「嗨～」或「我在哦～」；按住拖拽超过 5 像素则进入自由摆放模式，松开后位置会写回 localStorage。右键打开大小、停靠、隐藏、重置等菜单。

素材加载失败会怎样？

画布保持空白，桌宠会弹出「素材加载失败啦…」气泡提示。这是 host 半的服务路由 /aemeath-pet/spritesheet.webp 不可达或 lib 资源未安装导致。

这是官方插件吗？素材能商用吗？

不是。爱弥斯角色出自《鸣潮》（Kuro Games），精灵图源自 aemeath-codex-pet R2（Apache-2.0）和 B 站「Neuro音乐」的动态；插件代码本身是 Apache-2.0，但角色形象与原始美术素材权利归原作者，仓库不授予额外的商业使用许可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.0.1
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则