Mini 程序——常驻系统托盘，保持资源库同步
为什么需要 Mini 程序
Pixcall 同步资源库的云端同步需要有一个进程在后台运行来保持连接。但桌面客户端主窗口占屏幕、占内存、容易被不小心关掉。Mini 程序的作用：
- 保持同步连接：主窗口关掉了，Mini 程序继续运行，文件变化仍然实时同步
- 不占屏幕：常驻系统托盘（Windows 右下角）或菜单栏（macOS 顶部）
- 极低资源占用：只做同步相关的后台工作，不加载主界面
- 一键唤起主窗口：点击托盘/菜单栏图标可以快速打开主界面
Mini 程序在哪里
Windows
- 常驻在系统托盘（右下角任务栏的小图标区）
- 可能需要点击"↑"箭头展开才能看到 Pixcall 图标
- 右键托盘图标可以操作
macOS
- 常驻在屏幕顶部菜单栏（右上角区域）
- 直接显示图标
- 点击图标可以打开 Mini 程序的操作菜单
Mini 程序的常用操作
打开主窗口
点击托盘/菜单栏的 Pixcall 图标 → 打开 Pixcall 主界面（如果还没打开的话）。
立即同步
右键（Windows）或点击（macOS）Mini 程序图标 → 找到"立即同步"选项 → 手动触发一次同步扫描。
检查更新
Mini 程序会自动检查 Pixcall 更新。有新版本时会弹出提示。
退出 Mini 程序
右键（Windows）或点击（macOS）Mini 程序图标 → 选择"退出 Pixcall"或"退出 Mini 程序"。
⚠️ 完全退出 Mini 程序会中断同步！关掉 Mini 程序后：
- 本地文件变化不会再自动同步到云端
- 云端新文件也不会自动下载到本地
- 直到下次打开 Pixcall 主窗口或 Mini 程序才恢复同步
Mini 程序 vs 主窗口
| 对比项 | Mini 程序 | 主窗口 |
|---|---|---|
| 是否保持同步 | ✅ | ✅ |
| 是否可见 | 系统托盘/菜单栏小图标 | 全屏应用窗口 |
| 内存占用 | 极低（通常 < 30MB） | 较高（主界面 + 缩略图缓存） |
| 能否操作文件 | ❌ | ✅ 完整功能 |
| 能否暂时"隐身" | ✅（不占屏幕） | ❌（占一个任务栏位置） |
正确用法：平时让 Mini 程序常驻保持同步；需要整理素材时打开主窗口操作；用完关闭主窗口但别退出 Mini 程序。
Mini 程序的同步机制
Mini 程序保持着和 Pixcall 客户端相同的三条同步链路：
- 磁盘 ↔ 客户端：监控资源库文件夹变化（本地 SSD/HDD 实时监控；外置设备/ NAS 重启时扫码）
- 客户端 ↔ 云端：保持 WebSocket 长连接，云端有新文件实时推送
- 自动检测网络状态，断网时排队待同步的操作，联网后立即补传
Mini 程序和主窗口的关系
主窗口和 Mini 程序是同一个进程的不同界面——打开主窗口后 Mini 程序仍然在后台运行（因为同步逻辑在 Mini 程序里）。关闭主窗口后 Mini 程序继续运行，保持同步。
如何设置开机自启动
Pixcall 桌面客户端通常可以在设置里开关"开机自启动"。开启后：
- Windows：开机自动启动 Mini 程序（主窗口不自动弹出）
- macOS：开机自动启动 Mini 程序（菜单栏出现图标）
这样每次开机就自动保持同步连接，不需要手动启动 Pixcall。
退出 Pixcall 的正确方式
暂时不用 → 关闭主窗口，保留 Mini 程序
点击 Pixcall 主窗口右上角的关闭按钮（×）。主窗口关闭，但 Mini 程序继续在后台保持同步。
完全离开 → 退出 Mini 程序（⚠️ 中断同步）
右键托盘图标 → 选择"退出 Pixcall"。Mini 程序关闭，同步中断。下次需要同步时再打开 Pixcall。
Pixcall 帮助中心特别提醒
在 重建索引 的文档里，Pixcall 提到：
完全退出 Pixcall 时需要退出状态栏的 Pixcall mini 程序
这是因为：重建索引时需要 Pixcall 完全停止运行（主窗口 + Mini 程序都退出），否则后台的同步进程可能和重建索引产生冲突。
常见问题
Mini 程序图标不见了（Windows）
- 点击任务栏右下角的"↑"箭头展开隐藏图标区
- 如果还找不到 → Pixcall 可能已完全退出，重新打开主窗口会自动启动 Mini 程序
Mini 程序显示异常状态
如果 Mini 程序图标显示异常（比如一直转圈、红色感叹号等）：
- 检查网络是否连通
- 检查云端空间是否已满
- 右键 Mini 程序 → "立即同步"或"退出后重新启动"
Mini 程序占用 CPU 高
可能原因：
- Pixcall 正在后台处理大量新导入的文件（缩略图生成队列）
- 正在执行云端同步（大量文件上传/下载）
- 正在重建索引
正常现象，等处理完就会恢复正常。如果长时间高占用（超过 10 分钟），可能是某个后台任务卡住了 → 退出 Mini 程序后重新启动 Pixcall。