指南
安装与首次启动
第一次使用时，先确认系统环境和安装来源，避免把权限或文件路径问题带到后续阅读流程中。
- 从官网下载安装包，并将应用拖入系统应用目录。
- 首次打开时，根据系统提示完成安全验证与权限确认。
- 进入设置页检查默认阅读目录、界面语言和词典状态是否正常。
补充说明
- 建议优先使用最新稳定版本。
- 若系统拦截应用启动，请先确认安装包来源是否为官网。
指南
导入书籍与开始阅读
留白阅读器更适合连续阅读而不是碎片化练习，建议先从篇幅适中的 EPUB 或 Markdown 书籍开始。
- 在书库中点击导入，选择 EPUB 或 Markdown 文件。
- 导入后检查章节目录、段落换行和正文编码是否正常。
- 根据自己的英语水平调整注释密度，再开始第一轮阅读。
补充说明
- 如果书籍排版异常，优先检查源文件本身是否完整。
- 大体量书籍首次导入时可能需要额外解析时间。
指南
导入专业词典
如果你在读医学、法律、计算机或学术材料，建议补充更专业的词典文件，而不是只依赖默认释义。
- 进入设置中的词典管理。
- 导入 Mdx 或 Stardict 格式词典文件。
- 设置默认主词典，并根据需要调整词典优先级。
补充说明
- 导入前确认词典文件版权和来源合规。
- 词典文件较大时，首次索引可能持续数十秒。
指南
已知词与注释层级
留白阅读器的核心体验来自“已知词追踪 + 注释减法”，建议先建立自己的标记规则。
- 阅读时点掉你已经掌握的单词，让系统逐步建立已知词库。
- 根据当前阅读难度调整注释显示层级，不必追求一次性关闭所有提示。
- 定期回看阅读统计，确认自己的阅读流畅度是否持续提升。
补充说明
- 如果误标了单词，应尽早在词库中修正。
- 更适合在真实阅读语境中积累词汇，而不是当作背单词工具使用。
指南
备份与迁移数据
更换电脑、重装系统或尝试测试版前，先完成本地备份，这是个人开发者应用最重要的使用习惯之一。
- 导出或备份本地数据库文件。
- 同时备份词典文件、配置文件和自定义资源目录。
- 在新设备导入后，优先核对词库、阅读进度和词典加载状态。
补充说明
- 迁移完成后，先抽查最近阅读的几本书是否正常打开。
- 在同步功能正式上线前，数据迁移仍以手动备份为主。
指南
常见故障排查
遇到无法导书、词典未生效或阅读进度异常时，先做基础排查，通常能在几分钟内定位问题。
- 重启应用并确认使用的是最新稳定版。
- 检查书籍文件、词典文件和数据库路径是否仍然存在且可访问。
- 如果问题仍然存在，整理复现步骤、系统版本和错误截图后联系支持。
补充说明
- 涉及数据异常时，请先备份当前本地数据库。
- 提交反馈时附带问题文件样本，通常能明显缩短排查时间。
联系支持前
先准备这些信息，排查会更快
- 你的系统版本与应用版本号
- 问题出现前的具体操作步骤
- 相关截图、错误提示或日志片段
- 是否已经尝试重启应用、重新导入文件或恢复备份
当前支持范围
个人开发者维护下的支持边界
- 支持 EPUB 与 Markdown 等当前版本已说明的导入格式
- 支持本地词典导入、阅读数据备份与手动迁移相关说明
- 对于第三方词典、书籍源文件本身的版权与质量问题，仅能提供兼容性层面的建议