3.2 KiB
3.2 KiB
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 提醒规则（开托盘菜单进入） |
| 系统托盘 | 桌宠窗口最小化时的入口 |
| 提醒中心 | 聊天面板里一个特殊的"伪会话"，所有提醒自动汇聚到这里 |
阅读顺序建议
- 01-系统要求与依赖.md — 先看你的平台能不能跑
- 02-安装与运行.md — 开发模式和生产构建
- 03-首次启动配置.md — 必备：模型 + LLM
- 04-桌宠窗口使用.md — 主界面所有功能
- 05-聊天功能.md — 多会话、搜索、导出
- 06-健康提醒.md — 定时提醒怎么用、怎么改
- 07-LLM对话.md — 接哪家 LLM、怎么填 Key
- 08-数据存储与备份.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 → 最快跑起来（开发模式）。