常见问题

通用

Mosaic 是什么？

Mosaic 是一个结合笔记与心情追踪的数字第二大脑应用。它是开源、可自托管的应用，包含移动端（React Native / Expo）和 Rust 后端。

Mosaic 免费吗？

是的，Mosaic 基于 AGPL-3.0 协议开源，你可以免费自托管。唯一可能的费用是你自己的服务器（VPS、NAS 等）和可选的 AI API 使用费。

需要服务器吗？

是的，Mosaic 需要服务器来存储数据、同步和使用 AI 功能。你可以将其部署在任何支持 Docker 的机器上——一台便宜的 VPS 就足够了。

设置

如何开始使用？

1. 用 Docker Compose 部署服务端（参见快速开始）
2. 安装移动端 APK
3. 在移动应用中连接你的服务器地址

需要 AI API 密钥吗？

AI 功能（自动标签、自动摘要、机器人回复）是可选的。你需要在管理面板中配置 AI 提供者（兼容 OpenAI 或 Anthropic）。不配置 AI 时，所有核心功能正常工作。

服务器最低配置？

• 1 CPU 核心，512MB 内存，10GB 存储
• Docker 和 Docker Compose
• 支持 PostgreSQL 的环境（pgvector 扩展通过 Docker 自动安装）

数据与隐私

数据存储在哪里？

在你的自己的服务器上。所有数据（笔记、图片、视频）都保存在你控制的硬件上。存储可以是本地磁盘或 Cloudflare R2（兼容 S3）。

能导出数据吗？

API 支持通过标准 REST 端点获取所有笔记、日记和资源。管理面板也提供健康和统计信息。

数据加密吗？

• 传输中：是的，通过反向代理配置 HTTPS 后加密（参见部署指南）
• 静态存储：数据库级别加密取决于你的 PostgreSQL 配置。文件存储按原样保存在磁盘或 R2 上
• 密码：使用 bcrypt 哈希存储

功能

Mosaic 支持多用户吗？

目前 Mosaic 主要面向个人或小团队使用。多个用户共享同一个服务器实例。

可以离线使用吗？

移动端使用 SQLite 在本地缓存数据。你可以在离线时查看和编辑笔记——重新连接服务器后会自动同步。

支持哪些 AI 模型？

任何兼容 OpenAI API 或 Anthropic API 的模型。包括 OpenAI（GPT-4、GPT-4o）、Anthropic（Claude）、Ollama（本地）以及提供兼容端点的任何服务商。

同步

同步如何工作？

Mosaic 使用基于时间戳的游标协议。每种实体类型（笔记、日记、资源、机器人）跟踪其最后更新时间。移动端客户端从上次同步游标处拉取变更并在本地合并。

冲突怎么办？

Mosaic 采用"最后写入者胜出"策略，基于 updated_at 时间戳。保留最近的更改。

故障排除

服务器无法启动

• 检查 PostgreSQL 是否运行且可访问
• 验证 DATABASE_URL 是否正确
• 确保端口未被占用（默认：8080）
• 查看服务器日志：docker compose logs mosaic-server

移动端无法连接

• 确保服务器地址正确（含端口号）
• 检查服务器是否可从你的网络访问
• 验证防火墙规则允许连接
• 在同一网络时，使用服务器的局域网 IP 地址