NyaDeskPet

基于 Live2D + AI Agent 的跨平台桌面宠物应用

---

完全开源的模块化桌宠框架，支持 Live2D 交互、内置 AI Agent。开箱即用，亦可高度定制。欢迎贡献插件、模型和功能！

移动端移植项目 NyaDeskPetAPP 同步开发中！

特性

🎭 AI 驱动 Live2D 模型

2026-02-15.19-01-40.mp4

• 透明无边框窗口，桌宠自然融入桌面
• AI 驱动的表情和动作，丰富生动的交互体验
• 触碰反应系统，按部位启用/禁用触碰交互
• TTS 驱动口型同步 & 流式音频播放

其他demo

🤖 内置 AI Agent

支持多个主流模型供应商	支持函数工具与MCP管理	插件化架构	支持自定义指令管理

🧩 插件体系

完整的插件管理	插件工作鉴权

上述演示工作的结果

文档

文档	说明
使用指南	安装、配置、运行使用指南
API 规范	WebSocket 消息协议
开发指南	架构设计、核心模块
前端插件开发	前端插件 WebSocket 协议与开发流程
Agent 插件开发	Agent 插件基类、工具注册、Handler 插件
更新日志	版本更新记录

快速开始

# 安装依赖
npm install

# 编译 TypeScript
npm run compile

# 开发启动
npm run dev:mac
npm run dev:linux
npm run dev:win

# 打包
npm run build:mac
npm run build:linux
npm run build:win

架构

分离式架构

前端与后端 Agent 通过 WebSocket 完全解耦。前端仅负责展示与交互，后端独立运行 Agent 服务器，任何 WebSocket 客户端均可接入。

内置 Agent 架构

内置 Agent 核心采用 Pipeline 架动设计，消息处理分为多个阶段（思考、工具调用、回复等），每个阶段可注册多个 Handler 插件，灵活定制 Agent 行为。

支持

如果喜欢这个项目，欢迎点个 Star ⭐！如有任何问题或建议，请提交 Issue 或 Pull Request。

或者💗赞助我💗

许可证

MIT License