116 lines
4.2 KiB
Markdown
116 lines
4.2 KiB
Markdown
# 01 · 系统要求与依赖
|
||
|
||
## 1. 跨平台支持一览
|
||
|
||
| 平台 | 是否支持 | 备注 |
|
||
|---|---|---|
|
||
| **Linux** (X11) | ✅ 主推 | 默认 `GDK_BACKEND=x11` 强制走 XWayland |
|
||
| **Linux** (Wayland / GNOME) | ⚠️ 部分 | 桌宠的"始终置顶"和"所有工作区可见"会失效（已知 bug） |
|
||
| **Linux** (Wayland / KDE) | ⚠️ 部分 | 同上 |
|
||
| **macOS** (Intel / Apple Silicon) | ✅ | 截图走系统能力；首次启动需要授权辅助功能/屏幕录制 |
|
||
| **Windows** 10/11 | ✅ | WebView2 已内嵌，理论无外部依赖 |
|
||
|
||
## 2. 三平台共同需要
|
||
|
||
| 依赖 | 最低版本 | 用途 |
|
||
|---|---|---|
|
||
| **Node.js** | 18+ | 构建前端 |
|
||
| **npm** | 9+ | 包管理 |
|
||
| **Rust** | 1.65+ | 编译后端 |
|
||
| **Cargo** | 随 Rust 一起 | Rust 构建 |
|
||
| **C/C++ 工具链** | — | Rust 编译需要（Linux: gcc / Windows: MSVC / macOS: Xcode CLT） |
|
||
|
||
> 💡 Rust 推荐通过 [rustup](https://rustup.rs) 安装；Node 推荐通过 [nvm](https://github.com/nvm-sh/nvm) 或 [fnm](https://github.com/Schniz/fnm) 安装。
|
||
|
||
## 3. 各平台额外的系统库
|
||
|
||
### 🐧 Linux（Debian / Ubuntu / Fedora / Arch）
|
||
|
||
**Debian / Ubuntu**：
|
||
```bash
|
||
sudo apt update
|
||
sudo apt install -y \
|
||
build-essential curl wget file libssl-dev \
|
||
libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev \
|
||
libwebkit2gtk-4.1-dev libsoup-3.0-dev \
|
||
libdbus-1-dev pkg-config \
|
||
imagemagick libnotify-bin
|
||
```
|
||
|
||
**Fedora**（项目开发环境）：
|
||
```bash
|
||
sudo dnf install -y \
|
||
gcc gcc-c++ make \
|
||
gtk3-devel libappindicator-gtk3-devel librsvg2-devel \
|
||
webkit2gtk4.1-devel libsoup3-devel \
|
||
dbus-devel pkgconf-pkg-config \
|
||
ImageMagick libnotify
|
||
```
|
||
|
||
**Arch / Manjaro**：
|
||
```bash
|
||
sudo pacman -S --needed \
|
||
base-devel \
|
||
gtk3 libappindicator-gtk3 librsvg \
|
||
webkit2gtk-4.1 libsoup3 \
|
||
dbus \
|
||
imagemagick libnotify
|
||
```
|
||
|
||
**说明**：
|
||
- `libappindicator` / `libayatana-appindicator3` — 系统托盘图标
|
||
- `webkit2gtk-4.1` — Tauri 在 Linux 的渲染后端（**必须是 4.1，不要装 4.0**）
|
||
- `imagemagick` — 提供 `convert` 命令，作为截图兜底（首选是 `xdg-desktop-portal`）
|
||
- `libnotify` / `libnotify-bin` — 提供 `notify-send` 命令，用于发送系统通知
|
||
- `xdg-desktop-portal` — 截图首选方式。**Fedora 41+ / Ubuntu 22+ 默认已装**，首次截图会弹授权对话框，授权后永久通过
|
||
|
||
### 🍎 macOS
|
||
|
||
| 依赖 | 用途 |
|
||
|---|---|
|
||
| Xcode Command Line Tools | C/C++ 编译 |
|
||
| `rustup` 装的 Rust | 后端编译 |
|
||
| （可选）iTerm2 / Terminal | 看日志 |
|
||
| （可选）`xcodegen` | 一般不需要 |
|
||
|
||
首次截图 macOS 会弹"屏幕录制"权限请求，到 **系统设置 → 隐私与安全性 → 屏幕录制** 给 EzVibeR+ 授权。
|
||
|
||
### 🪟 Windows
|
||
|
||
| 依赖 | 说明 |
|
||
|---|---|
|
||
| **Microsoft C++ 生成工具**（MSVC） | [下载](https://visualstudio.microsoft.com/visual-cpp-build-tools/)，安装时勾选"使用 C++ 的桌面开发" |
|
||
| **WebView2 Runtime** | Win11 已自带；Win10 可能需要，安装包内嵌 |
|
||
| **Git for Windows**（可选） | 拉代码用 |
|
||
|
||
## 4. 网络要求
|
||
|
||
| 用途 | 是否需要 | 备注 |
|
||
|---|---|---|
|
||
| 加载本地 Live2D 模型 | 否 | 模型目录全在本地 |
|
||
| 加载网络 Live2D 模型 | 是 | 走你填的 URL |
|
||
| LLM 对话 | **是** | 走你配的 API（OpenAI/Anthropic 或自部署网关） |
|
||
| 系统通知 | 否 | 本地发 |
|
||
| 自动更新检查 | 是 | 默认启用，可在配置里关 |
|
||
|
||
## 5. 硬件要求
|
||
|
||
| 项 | 最低 | 推荐 |
|
||
|---|---|---|
|
||
| CPU | 双核 1.5GHz | 四核+ |
|
||
| 内存 | 2 GB | 4 GB+ |
|
||
| 硬盘 | 500 MB（不含模型） | 2 GB+（含模型和会话） |
|
||
| 显卡 | 任意 | 集成显卡也能跑，Live2D 走 WebGL |
|
||
|
||
> 💡 你的 Live2D 模型文件**不包含在软件里**，需要自己提供。常见模型来源：[Live2D Cubism Samples](https://www.live2d.com/zh-CHS/download/sample-data/) / [模之屋](https://www.aplayz.com/) 等。一个普通模型 30-100 MB，复杂模型 200+ MB。
|
||
|
||
## 6. 端口
|
||
|
||
- Tauri 后端在 `tauri://` 内部协议
|
||
- 内嵌 axum 服务**随机**监听 `1024-65535` 之间的一个端口（启动时探测可用），用于给前端 webview 提供本地 Live2D 模型文件
|
||
- 不需要用户开放任何入站端口
|
||
|
||
---
|
||
|
||
下一步：[02-安装与运行.md](02-安装与运行.md)
|