LeafLoom帮助中心

常见问题与求助

使用目标

快速查找离线使用、模型、数据位置与安装问题。

开始前

先关联一个本机目录;建议用演示知识库练习。

操作步骤

搜不到资料? 检查选中目录、扩展名和排除设置,再查看索引进度。语义模型或索引未准备时,会明确显示关键词/Wiki 降级;这不代表语义索引已经完成。

开始使用前必须下载模型吗? 不需要。桌面安装包内置私有运行环境,阅读、编辑、图谱和关键词检索无需 BGE-M3;需要语义检索时再从设置下载模型。源码安装另需准备开发依赖。

设置 → 搜索与索引和首次引导会持续显示模型准备的连接、下载、校验阶段,以及文件数、接收量、速度和已用时间。30 秒无新进度时会显示等待提示;失败后保留诊断详情并可重试。关闭设置后仍会在后台准备,可继续阅读;退出应用会中断。重试会尽量复用已有下载。模型文件就绪后,后续建索引有独立进度。

模型区域还显示实际保存路径,点击「打开目录」可在系统文件管理器中查看;目录不存在时会先创建空目录,不会触发模型下载。

数据在哪里? 笔记在关联目录,索引、历史和回收区位于其中的 .vault-rag/。配置、模型、令牌和 AI 历史位于 Windows 的 %LOCALAPPDATA%\VaultRag 或 macOS 的 ~/Library/Application Support/VaultRag。可用 VAULT_RAG_HOME 指定私有目录。

可以离线使用吗? 桌面应用安装后,本地阅读、编辑、图谱和关键词检索可以离线使用;语义检索还需先准备本地模型。外部 AI 的联网需求由服务商决定。

白屏或更新没生效? 完成网页构建与安装,重启服务,再刷新浏览器。检查日志和端口冲突。仅重新打开浏览器不会加载新服务器代码。

支持网络目录吗? 桌面端使用本机目录;拒绝 UNC 共享和符号链接/junction 访问,以保证操作留在关联目录内。

如何卸载? 先退出 LeafLoom,再通过 Windows 系统设置卸载,或在 Mac 的「应用程序」中移除应用。笔记、配置、索引和模型会保留。旧版源码服务可在对应环境运行 vault-rag service uninstall;不再需要的数据请自行确认后删除。

完成后的表现

按症状找到具体文章,必要时整理脱敏信息求助。

没有成功时

提交问题时附版本、系统、复现步骤和脱敏错误;不要公开笔记、令牌或完整配置。

下一步

查看仓库原文 ↗