# LingLingPet

**Repository Path**: lyzmzcom/LingLingPet

## Basic Information

- **Project Name**: LingLingPet
- **Description**: 灵灵桌面精灵 - 会聊天/识别心情/危机守护的桌面宠物：PyQt5桌面端 + FastAPI后端代理 + Flutter手机端。朋友双击exe即用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 灵灵 · 会陪你聊天的桌面精灵 🐾

> 一只飘在桌面上的 Q 版魔幻像素小精灵。透明、置顶、可拖拽；会呼吸眨眼、能被摸被抱，
> 还内置**心理陪伴引擎**——识别情绪、共情安慰、教你 4-7-8 呼吸和 5-4-3-2-1 着陆法，
> 断网也能陪你，联网后（接 Kimi / OpenAI 兼容模型）聊得更聪明。

<p align="center">
  <img src="desktop_pet/preview/preview_character.png" width="180" alt="灵灵形象"/>
  <img src="desktop_pet/preview/preview_scene.png" width="360" alt="桌面场景"/>
</p>

---

## 🎁 朋友想直接用？（Windows，最简单）

**不用装任何东西，双击就能玩：**

1. 点开本仓库右侧的 **[Releases](../../releases)**（发布）栏目
2. 下载最新版的 **`LingLingPet.exe`**
3. 双击运行 —— 桌面上就会出现一只灵灵，可以拖动、抚摸、双击聊天！

> 💡 exe 已内置一切，无需安装 Python，离线就能陪聊。
> 极少数老电脑若提示缺 `vcruntime140.dll`，装一下「Microsoft Visual C++ 2015–2022 Redistributable」即可。

**想让灵灵更聪明（联网大脑）？** 打开灵灵的「⚙️ 设置」，填：
| 字段 | 填这个 |
|---|---|
| API 地址 | `https://api.moonshot.cn/v1` |
| 模型名 | `moonshot-v1-8k` |
| API Key | 你在 [platform.moonshot.cn](https://platform.moonshot.cn) 生成的 `sk-...` |

保存后，聊天窗口顶栏显示「🌐 Kimi 在线」就说明连上了。不填也能用离线陪伴模式。

---

## 📦 这个项目有三部分

| 目录 | 是什么 | 谁需要 |
|---|---|---|
| **`desktop_pet/`** | 电脑桌宠本体（Python + PyQt5），打包成 `LingLingPet.exe` | 普通用户直接下 exe 用 |
| **`backend/`** | 轻量后端代理（FastAPI），持有 API Key，手机端不用存密钥 | 想做手机版的人 |
| **`mobile/`** | 手机 App（Flutter，一套代码出 iOS + 安卓） | 想做手机版的人 |

手机版详细说明见 **[MOBILE_GUIDE.md](MOBILE_GUIDE.md)**。

---

## 🖥️ 开发者：从源码运行桌宠

需要 **Python 3.8+**：

```bash
cd desktop_pet
pip install pyqt5
python main.py
```

启动后：**拖动**移动、**轻抚**冒爱心、**点击**卖萌、**长按**转圈、**双击**开聊天；
右下角系统托盘图标可进入 聊天 / 换形象 / 小游戏 / 抱一下 / 切换主题 / 设置。

### 自己重新打包 exe

```bash
pip install pyinstaller
cd desktop_pet
pyinstaller LingLingPet.spec --noconfirm
# 生成 dist/LingLingPet.exe
```

---

## 📱 开发者：构建手机版

手机版是 Flutter 工程，本仓库只含 `lib/` 源码和 `pubspec.yaml`，需要你本地生成平台工程：

```bash
# 1) 先跑起来后端代理（持有 Kimi Key）
cd backend
pip install -r requirements.txt
export MOONSHOT_API_KEY="sk-你的密钥"   # Windows PowerShell: $env:MOONSHOT_API_KEY="sk-..."
uvicorn main:app --host 0.0.0.0 --port 8000
# 或一键部署到 Render 免费层（见 backend/README.md 的 render.yaml）

# 2) 构建手机 App
cd mobile
flutter create --platforms=android,ios .   # 生成 android/ 与 ios/ 目录
flutter pub get
flutter run                                  # 连上手机即可运行
```

- **安卓 APK**：任意装了 Flutter 的电脑都能编（`flutter build apk`）
- **iOS 包**：必须在 **macOS + Xcode** 上编译签名（苹果平台限制）
- **iOS 悬浮窗**：苹果不允许第三方常驻悬浮，iPhone 上灵灵是「打开 App 即陪伴」；安卓可后续做悬浮聊天球

---

## ✨ 功能一览

| 功能 | 说明 |
|---|---|
| 默认形象 | 魔幻紫调 Q 版像素精灵，纯 canvas 逐像素绘制，会眨眼、冒星光 |
| 触摸互动 | 抚摸冒爱心、点击卖萌、长按转圈、双击开聊天、拖拽移动 |
| 换形象 | 上传照片 → 一键变像素风伙伴（自动记忆） |
| 心理陪伴 | 离线心理学话术引擎：情绪识别 + 共情 + 呼吸/着陆法 + 危机关怀，断网也能用 |
| 联网增强 | 接 Kimi / OpenAI 兼容接口，联网更聪明，断网自动回退离线 |
| 解闷小游戏 | 记忆翻牌、拍泡泡、2048，全部离线可玩 |
| 主题 | 白天 / 夜晚 / 跟随系统，平滑切换 |

---

## 📄 License

[MIT](LICENSE) — 随便用、随便改，附带原许可声明即可。

汪！祝你（和你朋友）养得开心 💎🐾