Bilingual Paper Reader

学术论文双语对照阅读器

专为学术论文研读设计的 VS Code / 反重力 IDE (Antigravity IDE) 扩展插件：左栏文献原文、右栏译文对照、鼠标划词实时双向高光联动、划线高亮与便签批注、一键导出全文双语精读稿。

在扩展市场安装：paper-reader.academic-pdf-reader

🖼️ 界面预览

阅读与高亮	批注库	AI 问答

截图取自 VS Code 内的实际界面。更多截图欢迎通过 Issues 提供。

✨ 核心特性

1. 📖 双栏文献对照阅读

• 左栏：基于 PDF.js 完整渲染原版 PDF 文献，支持缩放（放大、缩小、适合宽度）、跳转翻页、高保真文字层（Text Layer）。
• 右栏：支持【逐句精读】与【连贯段落】双模式自由切换，智能段落重组器（自动修复跨行断词与连字符，如 differ- \n ent 拼合），告别机械机翻的碎片感。
• AI 版面判断 + 代码动刀的分段：让支持图片的多模态模型看整页图像，判断哪块是正文 / 图注 / 图内文字 / 独立公式、阅读顺序如何，以及哪两段本是一段（跨栏被切开）、哪一段里混着"正文 + 公式 + 正文"；代码据此真的合并与拆分——切点用模型给出的原文文字在本地文本层里定位，定位不到就跳过那一处，绝不猜位置。图内文字自动剔出正文与翻译队列，公式用 KaTeX 排版（含正文里的行内公式）。卡片顶部会写明这次改了什么，每一页默认都跑这一套。
• 坐标永远来自本地文本层：视觉只负责"结构与类型"，所以划线高亮、"点中文跳英文"、导出 PDF 把高亮画回原位，精度都不受影响。
• 自由分栏：中间配备可拖拽的 Splitter 分割条，随心调整左右视窗比例。

2. ⚡ 鼠标划词双向高光联动

• 左选右亮：在左侧 PDF 中使用鼠标选中任意单词或句子，右侧对应的段落翻译卡片立即触发发光呼吸灯高亮（Glow Highlight），并自动平滑滚动至视野正中，快速定位理解。
• 右点左闪：点击右侧翻译卡片的“定位”按钮或段落本身，左侧 PDF 自动平滑滚动到该段落所在页面与位置，并以动态微光高亮闪烁，实现完美的双向视觉对齐。

3. ✍️ 划线高亮与便签批注

• 划词悬浮菜单 (Floating Action Bar)：选中文字瞬间浮出 Notion 风格的工具条：
  • 4 色荧光笔高亮：🟨 核心要点 / 🟩 论据数据 / 🟦 公式方法 / 🟥 疑难待查。
  • 添加批注便签：记录个人理解、推导公式、文献对比心得。
  • 即时查词/译句：无需切换页面，悬浮气泡即时展现当前短语的精准译文。
• 批注库管理：右上角切换【批注笔记】视图，所有批注按页码聚合，支持点击一键跳转原文、修改、删除。
• 自动持久化：所有批注与翻译缓存均自动保存在本地，下次打开同一篇文献无需重复翻译，所有标记与批注永久保留。

4. 📝 一键导出笔记（两种形态）

点顶部【导出笔记】会让你选一种：

① 全文双语精读稿（Markdown） —— 把整篇按页交织成可读文稿：原文段 → 译文（逐句对齐时逐句成行）→ 我的批注 → AI 答疑，标题与图表题注保留层级。带 YAML front-matter（标题/来源/时间/收录页范围/统计）与目录锚点，无缝导入 Obsidian、Notion 或个人知识库。

② 高光批注 PDF —— 直接产出一份 PDF，适合打印、归档、发给别人。点导出后先问你一句要不要高光译文（选择会记住，下次排在第一位）：

• 只要高光后的原文：全部原文页原样保留（矢量、可搜索、版式与图不变），高亮按原坐标画回原位，颜色与透明度/混合模式跟阅读器里看到的一致（multiply + 0.6，黑字不会被盖住）。体积更小，且不需要中文字体。
• 原文 + 高光译文：在此基础上给每条高光在左页边距标一个带色序号，并在该原文页紧跟一页「第 N 页 · 高光译文」，按同一序号逐条给出 原文摘录 → 译文 → 我的批注 → AI 答疑（译文优先取与这条高光对应的那一句）；末尾还有一页导出说明，列出"有高光的页 / 已带译文的页 / 这些页的高光还没有译文"。

中文用系统字体嵌入并子集化（Windows 黑体/宋体、macOS Arial Unicode、Linux Noto 自动探测；也可用设置 academicReader.pdfExportFontPath 指定）。若机器上确实没有中文字体，会如实降级为"只出原文页 + 提示"，而不是画一堆豆腐块。

两者都会弹「另存为」让你选位置（默认文件名 <论文名>-双语精读稿.md / <论文名>-高光批注.pdf），不会悄悄写进你的文献目录。AI 答疑自动落盘：AI 导师的讲解不再关掉阅读器就丢，重新打开同一篇论文仍会出现在导出里。

5. 🌐 灵活强大的翻译引擎

• Google Gemini 官方 API：专为学术论文研读调优的学术 Prompt，术语地道严谨，公式与引用规范完整保留，Google AI Studio 提供免费额度。
• 自定义大模型 (DeepSeek / Kimi / 通义 / 智谱 / OpenAI / 本地模型)：兼容 OpenAI 标准接口，国内直连、性价比高。设置里直接选常用模型，端点自动带出，只需填 API Key。
• 开箱即用 (内置免费翻译)：无需申请任何 API Key，安装即可直接使用基础翻译。

翻译与 AI 问答共用所选引擎；问答会在提问界面标明"论文内容"与"通用背景知识"的来源区别。

📦 安装

方式一：扩展市场安装（推荐）

在扩展面板（Ctrl+Shift+X）搜索 Bilingual Paper Reader（中文可搜「论文 翻译」「文献 对照」等关键词），点击安装即可；后续版本会自动更新。

或直接打开商店页面：paper-reader.academic-pdf-reader

方式二：从 VSIX 安装（离线 / 内网环境）

先取得 academic-pdf-reader-x.y.z.vsix，然后：

在反重力 IDE (Antigravity IDE) 中安装

1. 打开反重力 IDE。
2. 点击左侧活动栏的 扩展市场 图标（或按快捷键 Ctrl+Shift+X）。
3. 点击扩展视图右上角的 ... (更多操作) 菜单。
4. 选择 “从 VSIX 安装... (Install from VSIX...)”。
5. 选中 .vsix 文件即可安装完成。

命令行等价写法：

antigravity-ide.cmd --install-extension academic-pdf-reader-x.y.z.vsix --force

在 VS Code 中安装

1. 按 Ctrl+Shift+X 打开扩展面板。
2. 点击右上角 ... 菜单 → 选择 “从 VSIX 安装... (Install from VSIX...)”。
3. 选中 .vsix 文件完成安装。

命令行等价写法：

code --install-extension academic-pdf-reader-x.y.z.vsix --force

安装后需要重启 IDE 才会生效（或执行 Developer: Reload Window）。

🔑 如何配置 API Key

安装后打开任意 PDF，有三种方式配置：

方式一：阅读器右上角【设置】（最直观）

点击右侧顶栏的 设置 按钮，弹出快捷菜单：

选模型 → 填 Key 就完事，不需要自己查 base URL 和模型名。常用列表包含 DeepSeek（deepseek-chat / deepseek-reasoner）、Kimi、通义千问、智谱 GLM、OpenAI、本地模型（Ollama/vLLM）等。

方式二：命令面板（Ctrl+Shift+P）

方式三：IDE 设置面板（Ctrl+, 搜 academicReader）

💡 API Key 从哪里获取

DeepSeek（国内直连，性价比高）

1. 到 DeepSeek 开放平台 注册并创建 API Key；
2. 阅读器【设置】→【配置模型 API】→ 选 deepseek-chat → 粘贴 Key。端点会自动填好。

Google Gemini（有免费额度）

1. 到 Google AI Studio 创建 API Key；
2. 阅读器【设置】→【配置 Google Gemini API Key】粘贴即可。

两种引擎的翻译与 AI 问答是同一套流程：一次请求拿到「整段译文 + 严格逐句译文」， 并对译文做语言与术语保真校验。选哪个取决于你的网络条件与预算。

📄 许可证

MIT © academic-pdf-reader contributors

本扩展内嵌 pdf.js（Apache-2.0），第三方声明见 THIRD-PARTY-NOTICES.md。

🔗 相关链接

• 更新日志 — 各版本改了什么
• 设计说明与问题复盘 — 历次问题的根因与修法
• 贡献与发布指南 — 本地构建、测试、发布流程
• 提交问题