项目与排障
管理本地项目与备份
理解 Lumi 项目目录、移动与重新定位方式,并建立安全的完整项目备份习惯。
Lumi 是本地优先工具。全局应用数据只保存模型服务配置、界面偏好和最近项目位置;每本绘本的长期内容保存在自己的项目文件夹中。
你可以在不同标签页打开多个项目。每个标签页的当前项目由 URL 决定:进入 B 不会关闭 A,也不会中断 A 正在进行的生成任务;重新访问 A 的旧链接会自动恢复它。项目在没有打开页面、没有请求且没有排队或运行中的任务满 5 分钟后才会独立释放。
认识项目目录
一个正常项目大致包含:
Moonlight-Mail/
├── README.md
├── STORY.md
├── project.sqlite
├── assets/
└── .lumi/
├── cache/
├── thumbnails/
├── tmp/
├── quarantine/
└── backups/
STORY.md是当前剧情简介的人类可读投影。project.sqlite是结构化项目数据的事实源,不能只备份 STORY.md。assets/保存项目正式图片等资产。.lumi/包含缓存、缩略图、临时文件、隔离文件和升级备份等内部内容。
完整备份项目
- 等待当前保存和生成任务结束。
- 退出 Lumi,避免复制时仍有后台任务写入。仅从项目切换器进入另一个项目不会关闭原项目。
- 复制整个项目根目录到备份磁盘、受控云盘或版本化备份工具。
- 保留文件夹结构和隐藏的
.lumi/目录,不要只挑选看得懂的文件。 - 定期抽查备份:复制到临时位置,再用“打开已有”确认项目可以读取。
移动或重命名项目
先退出正在使用该项目的 Lumi 实例,再整体移动或重命名根文件夹。重新打开 Lumi 后,最近项目卡片可能提示路径失效;使用“重新定位”选择新位置。不要在移动过程中单独改名或拆散内部文件。
同一项目不能同时被多个 Lumi 进程写入。遇到“项目已锁定”时,先检查另一实例是否还在运行,不要删除内部文件来强行绕过锁。
缓存与正式资产
.lumi/cache/ 和缩略图通常可以重新生成,但不要把“可以重新生成的缓存”和“可以随意删除整个 .lumi/”混为一谈。除非文档或界面明确说明,否则不要手动清理项目内部目录。
数据发送边界
Lumi 不会把完整项目上传到自己的云端。使用 AI 功能时,完成本次生成所需的文本、提示词和参考图片会发送给你选择的模型服务商。发送范围取决于具体任务和你选择的参考内容。