maodie-pet 是一款桌面宠物应用。它把 Live2D 角色放在桌面上,提供互动、状态养成、聊天、动作表情和生活场景等功能,适合作为常驻桌面的陪伴工具。
当前版本为测试版,近期暂无更新计划。
- 桌面宠物:在桌面显示 Live2D 角色,支持拖动、显示/隐藏和基础交互。
- 状态面板:查看金币、今日收入、点击、按键、工作时长和角色状态。
- 养成系统:包含心情、清洁、饱食度、亲密度等属性变化。
- 桌面行为:支持鼠标追逐、散步、待机反馈等陪伴行为。
- 动作与表情:可以触发内置动作、表情和自定义动画。
- 聊天窗口:提供对话记录和桌面陪伴聊天入口。
- 生活中心:物品购买、宠物装饰、互动数据查看。
- 设置窗口:支持模型、行为、热键、工作收益和界面相关配置。
- 系统托盘:提供快速打开、隐藏和退出等常用操作。
- 鼠标悬停在桌面宠物附近会显示普通菜单,可快速打开抚摸、背包、聊天、生活中心和状态等入口。
- 右键点击桌面宠物会打开右键菜单,可进入动作 / 表情、动画编辑、生活中心、设置,或退出应用。
- 如果开启了桌面装扮,菜单会显示在装扮之上;右键菜单层级最高,适合在装饰较多时使用。
- 从右键菜单进入“动画编辑”,窗口内分为“动作 / 表情预览”和“独立动作配置”两个页面。
- 在“动作 / 表情预览”里可以查看当前 Live2D 模型自带的参数、动作和表情;选择动作或表情后,可在右侧修改显示名称、设置待机动作或绑定事件。
- 参数分组支持双击改名:在参数页双击左侧分组标签,输入新名称后按 Enter 或点击别处保存,按 Esc 取消。
- 在“独立动作配置”里,先新建分类,再在分类下新增动作;动作名称、FPS、分类、播放方式和待机设置都在右侧属性区修改。
- 自定义分类通过分类标题右侧的“重命名”按钮改名;自定义动作可以复制、删除、批量导出或批量删除。
- 轨道参数可以双击添加到时间轴,也可以拖拽到时间轴;时间轴上的关键帧用于控制参数随帧变化。
- 修改完成后点击“保存动作”才会写入当前模型配置;删除动作或分类前会提示确认,部分编辑可用 Ctrl+Z 撤销。
- 事件绑定用于决定“发生某个交互时播放哪个动作或表情”。例如“被点击”可以绑定一个惊讶动作,“投喂”可以绑定吃东西动作,“开心”可以绑定高兴表情。
- 内置动作、内置表情和自定义动作都可以绑定事件;在动画编辑里选中目标后,在右侧“事件绑定”下拉框选择事件即可。
- 一个事件同一时间只能绑定到一个目标。把事件绑定到新的动作 / 表情时,旧绑定会被排除,避免同一事件触发多个反馈。
- 点击已经添加的事件标签可以移除绑定。
- 常见可绑定事件包括:出现、隐藏、被点击、被拖拽、打开菜单、被摸摸、投喂、聊天、开始干活、干活中、干活结束、开始散步、停止散步、开心、难过、生气、安心、得意和疲惫。
- 从普通菜单或右键菜单进入“生活中心”,可以查看状态、互动数据、物品和装扮。
- 在装扮页可以为当前模型配置背景和前后景装饰;装饰分为宠物后方和宠物前方两层。
- 编辑装饰时可选中图层调整位置、缩放和旋转;导入背景或装饰后建议回到主窗口检查显示效果。
- Tauri 2
- Vue 3
- Vite
- Pinia
- Pixel UI
- PixiJS / Live2D
- Rust
安装依赖:
yarn install启动开发环境:
yarn tauri:dev运行前端开发服务:
yarn dev运行测试:
yarn test本项目基于 MIT License 开源,详见 LICENSE。








