/install ai-desktop-pet
桌面宠物 Desktop Pet 🐾
AI驱动的3D桌面宠物 | Three.js程序化建模 | 情绪识别互动 | 狗/猫双模式
概述
一个可爱的3D桌面宠物,支持狗狗🐕和猫咪🐈两种模式。上传宠物照片自动提取毛色,根据用户的情绪文字做出不同反应,提供陪伴和安慰。
触发场景
- 用户说"打开桌面宠物"、"启动桌面宠物"、"显示宠物"
- 用户表达情绪需要安慰时
- 用户想和宠物互动玩耍时
核心功能
| 功能 | 说明 |
|---|---|
| 🐕🐈 双宠物模式 | 狗狗(垂耳圆润)/ 猫咪(尖耳胡须),一键切换 |
| 🎨 3D程序化建模 | 纯 Three.js 几何体构建,卡通材质+动态阴影 |
| 🎬 12种动画 | 跳跃/转圈/摇尾/坐下/趴下/跳舞/蹭蹭/装死/后空翻/踱步 |
| 💬 中文情绪识别 | 7种情绪关键词检测,自动映射对应动画 |
| 📷 照片取色 | 上传照片自动提取主色调,应用到3D宠物毛发 |
| ✨ 粒子特效 | 爱心/星星粒子迸发 |
| 🖱️ 完整交互 | 拖拽旋转/点击互动/双击/滚轮缩放 |
| 🪟 浮窗模式 | 弹出无边框窗口,宠物悬浮桌面 |
使用方式
启动宠物
直接打开宠物页面:
open C:\Users\PC\.workbuddy\skills\desktop-pet\index.html
或使用预览:
preview_url: file:///C:/Users/PC/.workbuddy/skills/desktop-pet/index.html
浮窗模式
index.html?mode=floating
API 接口
petAPI.setEmotion('happy') // 触发情绪反应
petAPI.doAction('dance') // 执行动作
petAPI.getStatus() // { emotion, pet }
petAPI.setColors({primary, secondary, dark})
情绪触发
支持的情绪及对应行为:
| 情绪 | 宠物行为 |
|---|---|
| 😊 开心 | 跳跃、转圈、摇尾巴 |
| 😢 伤心 | 趴下、蹭蹭、安慰 |
| 😰 焦虑 | 来回踱步、坐下 |
| 🎉 兴奋 | 连跳、跳舞、后空翻 |
| 🧘 平静 | 坐下、摇尾、蹭蹭 |
| 😴 孤独 | 趴下、踱步、安慰 |
| 😤 沮丧 | 踱步、趴下、坐下 |
动作命令
支持的动作:jump, spin, wag, sit, lie, dance, nuzzle, play_dead, backflip, pace
文件结构
desktop-pet/
├── SKILL.md # 本文件
├── index.html # 完整3D宠物应用 (37KB)
└── README.md # 使用说明
技术栈
- Three.js 0.157 (CDN ES Module)
- 原生 JavaScript
- 程序化几何体构建(零外部模型依赖)
- 自建 TWEEN 动画播放器
- Canvas 像素采样取色
依赖
无外部依赖。所有资源通过 CDN 加载:
- Three.js:
https://unpkg.com/[email protected]/build/three.module.js
注意事项
- 需要现代浏览器支持 WebGL
- 浮窗模式需要允许弹出窗口
- 照片取色功能在本地文件模式下可能受限(跨域),建议通过 HTTP 服务访问
- GitHub: https://github.com/bettermen/desktop-pet
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ai-desktop-pet - After installation, invoke the skill by name or use
/ai-desktop-pet - Provide required inputs per the skill's parameter spec and get structured output
What is AI桌面宠物?
🐾 AI-powered 3D desktop pet with emotion detection. Interactive dog/cat that reacts to your mood. Triggers: 桌面宠物, 宠物陪伴, 情绪安慰, desktop pet, virtual pet, 电子宠物. It is an AI Agent Skill for Claude Code / OpenClaw, with 36 downloads so far.
How do I install AI桌面宠物?
Run "/install ai-desktop-pet" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AI桌面宠物 free?
Yes, AI桌面宠物 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does AI桌面宠物 support?
AI桌面宠物 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AI桌面宠物?
It is built and maintained by bettermen (@bettermen); the current version is v1.0.0.