01快速开始
自托管的拾光集只有三步：拿到实例地址 → 用邀请码注册 → 把首页装到桌面。默认部署是一个进程加一个 SQLite 文件，没有什么需要额外准备的服务。
# 示例：用 Docker Compose 起一个实例
services:
lumina:
image: lumina/lumina:latest
ports: ["8080:8080"]
environment:
LUMINA_INVITE: "GL-2026"
volumes:
- ./data:/app/data起来之后访问 http://你的服务器:8080，第一枚邀请码就是环境变量里那一枚。
02邀请码与家庭
注册必须带邀请码，是为了让实例只服务一个家庭或一个小圈子：没有公开注册入口，数据库里就不会冒出陌生人。
- 站长在
设置 → 成员里生成邀请码，可以设有效期与使用次数。 - 注册后自动加入该实例的「家庭空间」，共享模块默认对成员可见。
- 私密模块（如日记、财务明细）彼此隔离，可在成员设置里单独授权。
| 场景 | 建议 |
|---|---|
| 只给自己用 | 关闭家庭空间，仅保留一个管理员账号 |
| 夫妻 / 家人共享 | 开启共享账、共享影单，私密记录保持隔离 |
| 小团队 | 按人发放短期邀请码，到期自动失效 |
03微信推送（规划中）
到期提醒、发薪日、周报推微信是设计里的功能，当前版本还没有内置推送通道——它需要一个服务号或第三方通道（Server 酱、PushPlus）的 Token，属于可选配置。
04AI 随手记
一句话入账：「星巴克 38」「昨晚看完《沙丘 2》，票 98」。没配 Key 时用本地规则；配了之后由模型理解更自然的说法，自动归类到影视、书籍、游戏、财务、足迹、备忘或笔记。
- 打开
设置 → AI 随手记。 - 填接口地址（
https://api.openai.com/v1，或 DeepSeek / Moonshot / Ollama 的兼容地址）、模型名、API Key。 - 点「测试连接」，通过后勾选「启用 AI 解析」并保存。
# 也可以不用界面，用环境变量给整个实例兜底
LUMINA_AI_BASE_URL=https://api.deepseek.com/v1
LUMINA_AI_MODEL=deepseek-chat
LUMINA_AI_KEY=sk-****Key 用 AES-256-GCM 加密后落库，前端只显示掩码；模型调用失败或超时会自动回退到本地规则，不会丢记录。
LUMINA_AI_ALLOW_PRIVATE=1 启动；接口地址只允许 http/https。05导入与导出
「设置 → 数据」可以导出全量 JSON，也可以把之前导出的文件导回来；导入是追加，不会覆盖已有记录。
{
"version": 1,
"records": [
{ "module": "movies", "title": "星际穿越", "rating": 9, "occurredAt": "2026-10-21" }
]
}Steam 游戏库、豆瓣书影音的自动同步还在规划中；目前可以用脚本把外部数据整理成上面的格式再导入。
06备份与迁移
数据只有两处：data/lumina.db（SQLite）和 data/secret.key（AI Key 的加密主密钥）。两个一起备份才算完整。
sqlite3 data/lumina.db ".backup 'backup-2026-10-21.db'"
tar -czf secret-2026-10-21.tar.gz data/secret.key仓库里的 deploy/backup.sh 会同时做这两件事并保留 14 天，配一条 cron 即可。
07常见问题
数据会被上传到别处吗？
不会。除你自己配置的 AI 接口外，应用不发起外部请求；统计与年报都在本地生成。
可以多人共用一个实例吗？
可以，每个成员一个账号，数据默认彼此隔离。家庭成员之间的共享模块还在规划中。
手机浏览器能用吗？
能。全平台 PWA：iOS 用 Safari「添加到主屏幕」，Android 与桌面浏览器点「安装应用」。前提是 HTTPS。