Getting Started

安装与入门

关键词：安装、下载、首次打开、AI 配置、API Key、PDF、EPUB、DOCX、翻译、背单词、更新。

下载与安装

1. 打开 leafreader.space。
2. 下载当前版本安装包。
3. 打开 .pkg 安装包并按提示安装。
4. 从“应用程序”启动 Leaf Reader。

当前版本安装包：

LeafReader-1.7.4.pkg

首次打开

• 使用书架导入最近阅读的书。
• 也可以直接打开 PDF、EPUB 或 DOCX 文件。
• Leaf Reader 会记录阅读位置，重新打开时恢复进度。

打开文档

支持格式：

• PDF
• EPUB
• DOCX

PDF 使用 PDFKit 阅读；EPUB 和 DOCX 会转换为本地 HTML 后在 WebKit 中阅读。

配置 AI

AI 功能不是必须项。未配置 AI 时，普通阅读、书架、翻页和基础文档打开仍可使用。

配置步骤：

1. 打开设置。
2. 选择聊天模型供应商和模型。
3. 填入 API Key。
4. 如需整本书问答或文档检索，配置 embedding 模型。
5. 运行连接测试。

API Key 保存在 macOS Keychain 中。普通启动、打开文档和选择文字不会读取 Keychain；应用只在你实际执行 AI 操作、打开相关设置或运行诊断时读取所需密钥。只有使用 AI 功能时，选中的文本、问题或用于分析的片段才会发送到你配置的模型服务。

使用翻译和解释

1. 在书中选中文本。
2. 打开 AI 面板。
3. 选择解释、翻译、总结或继续追问。
4. 长文本翻译会自动分段处理。

使用阅读笔记

1. 在书中选中一段文字。
2. 点击浮动工具栏里的“笔记”。
3. 在阅读笔记窗口中补充翻译、难句解析或自己的备注。
4. 选中笔记中的词句后，可以使用“解析”“翻译”“总结”“整理”或“问 AI”继续加工。

阅读笔记支持 / 命令菜单、Markdown 显示、AI 补全和导出。完整说明见 阅读笔记。

使用背单词

1. 选中单词或短语。
2. 让 AI 解释含义。
3. 保存到本书背单词。
4. 在词汇面板中复习、查看上下文或导出。

检查更新

Leaf Reader 使用 Sparkle 更新通道。发布版本后，可以在应用内检查更新。

如果更新失败，先看 故障排查。

备份和恢复用户数据

• 使用“文件 > 备份用户数据...”备份词汇、学习状态、阅读笔记、笔记图片、会话和偏好设置。
• API Key、模型文件和可重建缓存不会写入备份。
• 使用“文件 > 恢复用户数据...”选择并验证备份。为避免替换已打开的数据库，恢复会安排在下次启动、Reader 窗口创建之前执行。
• 恢复不会覆盖当前 Mac 的 Keychain API Key。

相关页面

• 功能地图
• 快捷键
• 阅读笔记
• AI Chat
• AI Analysis Cache
• Word Highlights
• Troubleshooting