157 lines
5.3 KiB
Markdown
157 lines
5.3 KiB
Markdown
# 08 · 数据存储与备份
|
||
|
||
## 1. 数据都存在哪
|
||
|
||
### 1.1 主配置
|
||
|
||
| 平台 | 路径 |
|
||
|---|---|
|
||
| Linux | `~/.live2D/live2d.conf.json` |
|
||
| macOS | `~/.live2D/live2d.conf.json` |
|
||
| Windows | `%USERPROFILE%\.live2D\live2d.conf.json` |
|
||
|
||
> ⚠️ **注意 Linux 大小写**：是 `.live2D`（大写 D），不是 `.live2d`。代码写死。
|
||
|
||
文件大致结构（见 [03-首次启动配置.md §5](03-首次启动配置.md)）。
|
||
|
||
### 1.2 会话数据
|
||
|
||
存在 Tauri 提供的**系统 app-data 目录**：
|
||
|
||
| 平台 | 路径 |
|
||
|---|---|
|
||
| Linux | `~/.local/share/com.ezviber.plus/sessions/` |
|
||
| macOS | `~/Library/Application Support/com.ezviber.plus/sessions/` |
|
||
| Windows | `%APPDATA%\com.ezviber.plus\sessions\` |
|
||
|
||
子目录结构：
|
||
|
||
```
|
||
sessions/
|
||
├── _index.json ← 会话索引（标题/消息数/时间）
|
||
├── 2026-06-19_153500/ ← 会话 id = 创建时间戳
|
||
│ ├── chat.jsonl ← 消息流（一行一条 JSON）
|
||
│ └── images/
|
||
│ ├── <uuid>.png ← 截图原图（给 LLM 多模态）
|
||
│ └── <uuid>.jpg ← 截图压缩预览（给聊天气泡）
|
||
├── 2026-06-19_180200/
|
||
│ ├── chat.jsonl
|
||
│ └── images/
|
||
└── __reminders__/ ← 提醒中心（特殊 id）
|
||
├── chat.jsonl
|
||
└── images/ ← 一般为空
|
||
```
|
||
|
||
### 1.3 数据库
|
||
|
||
**`ezvibe_memory.db`**（SQLite，向量记忆）
|
||
|
||
| 平台 | 路径 |
|
||
|---|---|
|
||
| 全部 | **`<工作目录>/ezvibe_memory.db`** ⚠️ |
|
||
|
||
> ⚠️ **坑**：这个路径是相对当前工作目录的，**不是 app-data 目录**。如果你用 `cd /tmp && /opt/ezviber-plus/live2d` 启动，db 就会在 `/tmp/ezvibe_memory.db`。
|
||
>
|
||
> 实际影响不大——RAG embedder 是 `DummyEmbedder`，数据库几乎是空的。
|
||
|
||
### 1.4 模型缩放 / 位置
|
||
存在主配置的**每个 URL 下**（嵌套对象）：
|
||
```jsonc
|
||
{
|
||
"https://...shizuku.model.json": {
|
||
"position": { "x": 100, "y": 200 },
|
||
"scale": { "x": 1.0, "y": 1.0 }
|
||
}
|
||
}
|
||
```
|
||
|
||
## 2. 数据迁移
|
||
|
||
搬家 / 换电脑 / 重装系统的标准流程：
|
||
|
||
```bash
|
||
# 1. 旧机器：备份
|
||
tar -czf ezviber-backup.tgz \
|
||
~/.live2D/ \
|
||
~/.local/share/com.ezviber.plus/ # Linux
|
||
# ~/Library/Application\ Support/com.ezviber.plus/ # macOS
|
||
# %APPDATA%\com.ezviber.plus\ # Windows
|
||
|
||
# 2. 同步到新机器
|
||
|
||
# 3. 新机器：解压到对应路径
|
||
tar -xzf ezviber-backup.tgz -C ~/
|
||
|
||
# 4. 装好 EzVibeR+ 之后启动一次
|
||
```
|
||
|
||
> ⚠️ **聊天里的图片用相对路径**（`sessions/.../images/xxx.png`），所以**只要保证两台机器的 `app-data` 绝对路径一致**（如都在 `~/.local/share/com.ezviber.plus/`），图片就能正常显示。**改了用户名就坏**。
|
||
|
||
## 3. 启动时 GC（自动清理）
|
||
|
||
每次启动会**异步**跑一次图片孤儿 GC：
|
||
|
||
1. 扫所有 `<app_data>/sessions/<id>/images/*.png|jpg|jpeg` → 候选集合 A
|
||
2. 扫所有 session 的 `chat.jsonl` → 引用集合 R（只取 `imagePath` / `imagePngPath` 的文件名）
|
||
3. `A - R` = 孤儿
|
||
4. 删孤儿 + 打印日志
|
||
|
||
**保守策略**：
|
||
- 单个 session 读 jsonl 失败 → 该 session 的所有图片**保留**（宁可漏删不误删）
|
||
- 只动 `.png / .jpg / .jpeg`，其他扩展名不动
|
||
- GC 失败只 `warn`，不阻断启动
|
||
|
||
日志格式（终端看）：
|
||
```
|
||
启动 GC: 扫描 42 张,引用 35 张,删除 7 张孤儿,释放 1234567 字节
|
||
```
|
||
|
||
## 4. 删除某条消息 / 整个会话
|
||
|
||
- **整个会话**：聊天面板点 🗑 → 整个目录（含 jsonl 和 images）都删
|
||
- **单条消息**：当前**不支持** UI 操作
|
||
- **绕过 UI 直接删**（高级）：
|
||
- 删整个会话：删 `<app-data>/sessions/<id>/` 目录 + 手动编辑 `_index.json` 移除该条目
|
||
- 删某条消息：用文本编辑器打开 `chat.jsonl`，删对应行（保持一行一条 JSON 的格式）
|
||
- 改完**重启**软件让索引重读
|
||
|
||
## 5. 备份建议
|
||
|
||
| 频率 | 备份什么 | 工具 |
|
||
|---|---|---|
|
||
| 每周 | `~/.live2D/live2d.conf.json` | 任何同步盘 |
|
||
| 每次重要对话后 | 导出会话（`⬇ MD` 或 `⬇ JSON`） | 内置导出 |
|
||
| 每月 | 整个 `app-data` 目录 | 任何备份工具 |
|
||
| 跨机器 | 同上 + 复制 `model_dir` | rsync / 同步盘 |
|
||
|
||
> 💡 **最稳的备份**是定期用「⬇ MD / ⬇ JSON」导出关键会话，文件名自带时间戳和会话标题，永久可读。
|
||
|
||
## 6. 隐私 & 安全
|
||
|
||
- 所有数据**只在本地**——不传给任何第三方
|
||
- LLM 调用按你配的 provider 走（你用哪家就是哪家，**没中间商**）
|
||
- `live2d.conf.json` 里的 `llm_api_key` 是**明文**存盘的，注意文件权限
|
||
- Linux/macOS：`chmod 600 ~/.live2D/live2d.conf.json`
|
||
- 截图保存在 `app-data/sessions/<id>/images/`，**全屏内容都包括**——如果你截了敏感页面，记得手动删
|
||
|
||
## 7. 完全卸载
|
||
|
||
```bash
|
||
# Linux
|
||
rm -rf ~/.live2D/
|
||
rm -rf ~/.local/share/com.ezviber.plus/
|
||
|
||
# macOS
|
||
rm -rf ~/.live2D/
|
||
rm -rf ~/Library/Application\ Support/com.ezviber.plus/
|
||
rm -rf /Applications/EzVibeR+.app # 图形界面拖废纸篓也行
|
||
|
||
# Windows (PowerShell)
|
||
Remove-Item -Recurse -Force "$env:USERPROFILE\.live2D"
|
||
Remove-Item -Recurse -Force "$env:APPDATA\com.ezviber.plus"
|
||
```
|
||
|
||
---
|
||
|
||
下一步：[09-常见问题FAQ.md](09-常见问题FAQ.md)。
|