桌面宠物
@eduwork/dsh-desktop-pet 是独立维护、独立版本的 DSH 桌宠插件。内置小页（红、蓝）、大肥鱼、小花狮和花狮娘，提供形象选择、大小、状态气泡和空闲打盹。它与托盘、系统通知共用宿主的事项数据；点击桌宠可打开需要处理或已完成的会话。
使用
EduWork 桌面客户端随包提供插件，在“设置 → 桌面宠物”中开启即可，默认关闭。现有用户的开关、形象、大小和位置保持原有存储方式，拆分不会重置这些设置。
其他发行版可安装这个 npm 包并集成到兼容的桌面宿主：
npm install @eduwork/dsh-desktop-pet
宿主要求：兼容的 DSH 0.2 API 与 EduWork Electron 桌面桥接。 插件包含设置、动画和形象；透明悬浮窗口、点击穿透、拖拽和位置记忆由桌面壳提供。普通 Web 页面或尚未接入该桥接的 DSH 客户端，安装包本身不会获得桌面悬浮窗口能力。
使用方法和形象说明见桌面宠物指南。代码许可见 LICENSING.md（木兰 PSL v2 与历史 MIT）；各款美术素材的来源与许可见 skins/LICENSE。
宿主集成
- Host 注册 Cordis 服务
desktopServices，提供pet(request)；这是运行时注入的服务，不是插件需要从 npm 下载的依赖。 - 将包的 bundle 加入 DSH 组合。它使用稳定入口
eduwork-desktop-pet，默认enabled: false；已有 EduWork 产品配置会插入同一入口，无需重复添加。 - 桌面壳从安装后的包加载
lib/page/和skins/，继续使用原有通知事项及打开会话回调。设置页的“隐藏/显示”与壳菜单通过现有事件接线。 - 普通托盘和系统通知独立于桌宠开关，授权操作仍在应用内完成。
- 支持插件通知协议的通用提醒性质、待办状态和标签；业务插件通过通知服务接入，不直接控制桌宠。需要配套支持协议 1 的桌面壳。
服务接受两种请求：
{ action: 'configure', enabled, skin, frame, size, bubbles, sleep }
{ action: 'reset-position' }
返回对象包含 supported；宿主不支持时返回 { supported: false }。插件停用会发送关闭请求。接口实现与窗口约束见 desktop-services 和 Electron 桌宠窗口。
开发
在本包目录运行：
npm ci
npm run check
npm pack --ignore-scripts
构建仅生成设置页 lib/client.js，Host 模块与形象随包提供。测试默认使用本包锁定的真实 DSH 依赖；设置 EDUWORK_TEST_RUNTIME 为产品的 d 目录可检查装配后的 Runtime。
小页和小花狮由 scripts/build-page-skins.mjs 与 scripts/build-huashi-skin.mjs 生成；修改脚本后执行 npm run build:skins。大肥鱼使用 whale-girl 的 PNG 立绘。花狮娘由 Emily 创作，采用 CC BY-SA 4.0；JunieXD 使用 ChatGPT 生图适配的 WebP 精灵图沿用该许可，完整署名与改编说明见 素材许可。新形象通过 PR 内置，不提供形象包导入功能。