# EzVibeR+ 用户手册

> 版本对应：1.0.0（package.json）/ main 截至 2026-06-19

EzVibeR+ 是一个**桌面 Live2D 桌宠**应用：透明、置顶的窗口里养一个 Live2D 模型，可以跟它说话、让它帮你记聊天、到点提醒你喝水伸展。本手册面向**最终用户**，不涉及源码和开发细节。

## 这个软件能干什么

- 🐾 **桌宠常驻** — 透明窗口一直浮在桌面，Live2D 模型会随"情绪"切换动作和表情
- 💬 **和 AI 对话** — 接 OpenAI（含 OpenAI 兼容服务）或 Anthropic Claude，聊家常、问问题、附带截图分析都行
- 🗂 **多会话存档** — 每个对话独立存盘，刷新重启不丢；自动起标题、全文搜索、Markdown/JSON 导出
- 🔔 **健康提醒** — 定时到点弹气泡 + 系统通知（喝水/伸展/早安/晚安…），还能自定义规则
- 📸 **点击截图 → AI** — 鼠标点一下桌宠身体，整屏截图直接发给模型看
- 🎭 **情绪引擎** — 长时间没交互会自动变困；跟它互动会变开心；情绪状态会驱动模型微表情
- 🛠 **托盘控制** — 显示/隐藏、配置、健康提醒、退出

## 系统组成一览

| 部件 | 说明 |
|---|---|
| 桌宠窗口 | 主界面：Live2D 模型 + 右侧聊天面板 |
| 配置中心 | 模型路径 / LLM / 模型能力展示 |
| 健康提醒 | CRUD 提醒规则（开托盘菜单进入） |
| 系统托盘 | 桌宠窗口最小化时的入口 |
| 提醒中心 | 聊天面板里一个特殊的"伪会话"，所有提醒自动汇聚到这里 |

## 阅读顺序建议

1. [01-系统要求与依赖.md](01-系统要求与依赖.md) — 先看你的平台能不能跑
2. [02-安装与运行.md](02-安装与运行.md) — 开发模式和生产构建
3. [03-首次启动配置.md](03-首次启动配置.md) — 必备：模型 + LLM
4. [04-桌宠窗口使用.md](04-桌宠窗口使用.md) — 主界面所有功能
5. [05-聊天功能.md](05-聊天功能.md) — 多会话、搜索、导出
6. [06-健康提醒.md](06-健康提醒.md) — 定时提醒怎么用、怎么改
7. [07-LLM对话.md](07-LLM对话.md) — 接哪家 LLM、怎么填 Key
8. [08-数据存储与备份.md](08-数据存储与备份.md) — 数据放在哪、怎么迁移
9. [09-常见问题FAQ.md](09-常见问题FAQ.md) — 已知问题和坑

## 重要提示

⚠️ **本软件仅供个人学习使用，禁止商用或非法用途。**（见仓库根目录的 `README.md`）

⚠️ **截图功能依赖系统组件**：Linux 需要 `xdg-desktop-portal`（默认装）或 ImageMagick（`convert` 命令）；macOS / Windows 由 Tauri 自带的 WebView 截图能力提供（实测使用 Portal 优先策略）。

⚠️ **改 LLM Provider / API Key 后需要重启** — LLM 客户端在启动时一次性创建，运行中改配置不生效（这是已知限制，下方有详细说明）。

⚠️ **Linux 桌面环境** 强烈建议在 **X11 下运行**（默认会自动设置 `GDK_BACKEND=x11`），Wayland/GNOME 下置顶和"所有工作区可见"会失效。需要在 Wayland 下测试时，启动前执行 `EZVIBE_FORCE_WAYLAND=1`。

---

如果你只是想先跑起来看效果，跳到 [02-安装与运行.md → 最快跑起来（开发模式）](02-安装与运行.md)。