深读

深读是一款中文优先的本地论文阅读器。它在浏览器或 macOS App 中解析 PDF，将英文段落转换为中文对齐阅读流，并通过用户已登录的本地 Codex 提供翻译、解释和追问能力。

主要能力

• 在本地解析 PDF 文本、页码与段落结构
• 自动识别位图、矢量图表和表格页，保留原 PDF 页面并支持放大
• 中文优先阅读，按需打开 60/40 中英文对照
• 基于当前段落向 Codex 提问、解释或简化
• 本地保存阅读进度、笔记、书签、主题和显示模式
• 默认白色阅读界面，内置天蓝色、克莱因蓝和陶土红主题，并支持暗黑模式
• 中文使用思源宋体 VF，英文使用 Times New Roman
• 可封装为 Apple Silicon macOS App

隐私边界

• PDF 文件和页面渲染在本机完成。
• 只有待翻译的段落批次或当前选中的段落会交给本地 Codex CLI。
• 服务只监听本机回环地址，不接受局域网或公网连接。
• 阅读记录、笔记和书签保存在本机，不包含在代码仓库中。

本地运行

要求 Node.js 20 或更高版本，并提前登录本机 Codex。

npm install
npm run dev

生产构建：

npm run build
npm run preview

封装 Apple Silicon macOS App：

npm run package:mac

验证

npm test

完整论文包验证需要准备英文原文 PDF 和中文 PDF：

DEEPREAD_E2E_SAMPLE_ROOT="/path/to/paper-workspace" npm run e2e:paper-bundle

也可以分别设置 DEEPREAD_E2E_SOURCE_PDF 与 DEEPREAD_E2E_CHINESE_PDF。

项目结构

• src/：阅读器界面、PDF 解析与原页图像渲染
• electron/：macOS 桌面容器
• server.mjs：本地回环服务与 Codex 调用
• paper-bundles.mjs、paper-prepare.mjs：论文包准备与完整性校验
• schemas/：Codex 结构化输出约束
• test/：单元测试
• scripts/：端到端验证脚本