LumenPDF：为深度阅读者设计的 macOS 智能 PDF 阅读器 #
LumenPDF 是什么？ #
LumenPDF 是一款面向深度阅读场景的 macOS PDF 阅读器，它保留系统 Preview 式的轻量阅读体验，同时把翻译、AI 导读、划线笔记、单词本和本地知识沉淀放进同一个阅读工作流里。
它主要解决长文档阅读中的高频痛点：读英文论文或技术书时，需要在阅读器、翻译网站、聊天窗口和笔记软件之间反复切换，思路被打断、笔记也散落各处。LumenPDF 让你在 PDF 内划选文本即可查看上下文翻译、发起 AI 追问、完成跨页划线与笔记，再用 ⌘F 一键回到原文位置。阅读进度、单词和笔记保存在本机，不依赖云端账号，适合注重效率与隐私的深度阅读者。
LumenPDF 有哪些亮点特色？ #
- Preview 级轻量阅读体验：基于 SwiftUI + PDFKit 实现连续滚动、目录跳转，自动恢复上次阅读位置与视口，打开即续读，接近 macOS 系统预览的流畅手感。
- 上下文感知翻译：划选单词、短语或句子后即可快速查看上下文翻译，默认目标语言为简体中文；即使不配置 LLM，也能使用基础翻译能力。
- AI 导读与连续追问：围绕当前选区持续追问，支持 Markdown 格式回复和一键保存，把「查资料—提问—记录」压缩在一次划选之内。
- Reading Inspector 集中工作台：右侧面板统一显示上下文、AI 导读、单词和笔记，减少在多个窗口与页面之间来回切换的认知损耗。
- 工作区全文搜索（⌘F）：可在笔记、划线、单词和当前 AI 导读中搜索，选中结果后直接跳到原文并恢复完整选区，方便回看与复核。
- 跨页划线与可编辑笔记：支持跨页划线，笔记可直接编辑并自动保存；⌘Z / ⇧⌘Z 可撤回或重做最近 50 次标注操作，输入框内则优先处理文字编辑。
- 自定义 LLM 与安全存储：采用 OpenAI 兼容接口，支持内置服务商预设或「其他」自定义端点，任意兼容 Chat Completions 的模型均可使用；API Key 存入 macOS Keychain，不写入明文配置文件。
- 本地优先与开源免费：阅读进度、单词和笔记保存在本机，不依赖云端账号；项目以 MIT 协议开源，代码公开可审计。
免费下载 LumenPDF #
以下为官方提供的安装包，点击链接即可下载。
| 文件名 | 描述 | 大小 | 下载 |
|---|---|---|---|
| LumenPDF-1.0.33.dmg | macOS 安装包（DMG） | 21.0 MB | 夸克网盘 |
你也可以前往 GitHub Releases 获取最新版本的
LumenPDF-<version>.dmg，或参考下文「从源码打包」自行构建。
LumenPDF 如何使用？ #
- 首次设置 LLM（可选）：打开 App 后点击右上角设置按钮，填写一个 OpenAI 兼容接口。可选择内置服务商预设，或选择「其他」自定义端点，填入 API Base URL（例如
https://api.openai.com/v1或https://api.deepseek.com/v1）、API Key 和模型名称。Extra Config 为可选项，未修改时显示当前服务商关闭 thinking 的默认 JSON；目标语言默认简体中文。不配置 LLM 也能使用基础翻译，但上下文解释和追问需要 LLM 支持。 - 打开 PDF 并继续阅读：打开文档后，LumenPDF 会自动恢复上次的阅读位置，并在左侧显示目录。阅读时可用连续滚动浏览，也可通过目录快速跳转（⌘F 也可用于搜索工作区内容）。
- 划选文本并处理：选中一段文本后，可以翻译、解释、划线或写笔记。「解释」会把内容送入右侧 Reading Inspector，后续的追问、保存 AI 回复、查看单词和笔记都在这里完成。
- 管理与回看标注：需要回到某条笔记或划线时，按 ⌘F 搜索并跳转；标注操作可用 ⌘Z / ⇧⌘Z 撤回或重做（光标位于输入框内时，快捷键优先处理文字编辑）。切换到「单词本」或「笔记」页，可集中搜索和管理已保存内容。
- 沉淀本地知识：所有阅读进度、单词和笔记保存在本机，长期积累后即形成属于自己的阅读知识库。
LumenPDF 的常见问题？ #
不配置 LLM 还能用吗？ 可以。LumenPDF 内置基础翻译能力（未配置 LLM 时走 MyMemory fallback），划选文本即可查看翻译；但上下文解释、AI 导读和连续追问需要配置 LLM 后才能使用。
我的 API Key 安全吗？ 安全。API Key 存入 macOS Keychain，不会写入明文配置文件；阅读进度、单词和笔记也保存在本机，不依赖云端账号。
支持哪些 LLM 服务商和模型？ 采用 OpenAI 兼容接口，内置常见服务商预设，也可选择「其他」填写自定义端点，使用任意兼容 Chat Completions 的模型。
运行 LumenPDF 需要什么系统版本？ 应用面向 macOS，开发环境要求 macOS 15+、Xcode 16+、Rust stable 与 Homebrew。首次打开若提示「无法验证开发者」或「无法打开」，请先尝试打开一次 LumenPDF.app，然后进入「系统设置 → 隐私与安全性」，在「安全性」区域点击「仍要打开 / Open Anyway」，再在确认弹窗中选择「打开」。该入口通常只在尝试打开后的短时间内出现。
我的数据保存在哪里？
SQLite 数据库位于 ~/Library/Application Support/LumenPDF/data.db，API Key 位于 macOS Keychain，阅读状态保存在 UserDefaults。
可以自己从源码构建吗？
可以。项目以 MIT 协议开源，开发者可克隆仓库后使用 XcodeGen、Rust 工具链和 Makefile 构建 DMG；make dmg / make upgrade 默认要求长期稳定的代码签名身份，以避免二进制更新后反复触发 Keychain 授权。
LumenPDF 如何安装？ #
macOS（推荐方式：下载 DMG） #
- 从 GitHub Releases（或上方下载表格）下载最新
LumenPDF-<version>.dmg文件。 - 双击打开 DMG 磁盘映像。
- 将
LumenPDF.app拖拽到「应用程序 / Applications」文件夹。 - 首次运行时，如果 macOS 提示「无法验证开发者」或「无法打开」，请先尝试打开一次 LumenPDF.app，然后前往「系统设置 → 隐私与安全性」，在「安全性」区域点击「仍要打开 / Open Anyway」，在确认弹窗中选择「打开」。
macOS（从源码打包） #
适合开发者，或当前还没有预编译 DMG 时使用。
git clone https://github.com/hedon954/lumen-pdf.git
cd lumen-pdf
brew install xcodegen
rustup target add aarch64-apple-darwin x86_64-apple-darwin
make dmg
构建产物会生成在 build/LumenPDF-<version>.dmg。如果你只是想把当前构建安装到本机，可以执行：
make upgrade
它会先打包，再终止正在运行的 LumenPDF，并替换 /Applications/LumenPDF.app。
提示：
make dmg/make upgrade默认要求长期稳定的代码签名身份，以避免二进制更新后反复触发 Keychain 授权。身份准备、CI secrets 和临时 ad-hoc 调试方式可参考仓库中的代码签名与 Keychain 延续文档。也可以直接用 Xcode 打开工程运行：
open LumenPDF/LumenPDF.xcodeproj
LumenPDF 如何卸载？ #
macOS #
- 退出正在运行的 LumenPDF（⌘Q）。
- 打开「访达 → 应用程序」，将
LumenPDF.app拖入废纸篓，或右键选择「移到废纸篓」。 - 清空废纸篓完成卸载。
清理残留数据（可选） #
LumenPDF 采用本地优先策略，卸载应用后仍会保留阅读数据。如需彻底清理，请手动删除以下内容：
- SQLite 数据库：删除
~/Library/Application Support/LumenPDF/目录（其中包含data.db，即笔记、单词与阅读数据）。 - 阅读状态：相关偏好项保存在 UserDefaults 中，可在终端执行
defaults delete <bundle-id>清理（bundle id 请以应用实际信息为准）；如不确认，可在「访达」中搜索包含 LumenPDF 的 plist 文件后删除。 - API Key：进入「钥匙串访问 / Keychain Access」，搜索 LumenPDF 并删除对应的 API Key 条目。
建议在删除数据前先备份
data.db，以免丢失长期积累的单词本与笔记。