项目与排障

管理本地项目与备份

理解 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/ 包含缓存、缩略图、临时文件、隔离文件和升级备份等内部内容。

完整备份项目

  1. 等待当前保存和生成任务结束。
  2. 退出 Lumi,避免复制时仍有后台任务写入。仅从项目切换器进入另一个项目不会关闭原项目。
  3. 复制整个项目根目录到备份磁盘、受控云盘或版本化备份工具。
  4. 保留文件夹结构和隐藏的 .lumi/ 目录,不要只挑选看得懂的文件。
  5. 定期抽查备份:复制到临时位置,再用“打开已有”确认项目可以读取。

移动或重命名项目

先退出正在使用该项目的 Lumi 实例,再整体移动或重命名根文件夹。重新打开 Lumi 后,最近项目卡片可能提示路径失效;使用“重新定位”选择新位置。不要在移动过程中单独改名或拆散内部文件。

同一项目不能同时被多个 Lumi 进程写入。遇到“项目已锁定”时,先检查另一实例是否还在运行,不要删除内部文件来强行绕过锁。

缓存与正式资产

.lumi/cache/ 和缩略图通常可以重新生成,但不要把“可以重新生成的缓存”和“可以随意删除整个 .lumi/”混为一谈。除非文档或界面明确说明,否则不要手动清理项目内部目录。

数据发送边界

Lumi 不会把完整项目上传到自己的云端。使用 AI 功能时,完成本次生成所需的文本、提示词和参考图片会发送给你选择的模型服务商。发送范围取决于具体任务和你选择的参考内容。

Lumi Docs

搜索教程

输入关键词,搜索 Lumi 使用教程。