DeepRead v1.4.0

DeepRead v1.4.0

• 统一阅读器、卡片、查证浮层和侧栏的明暗主题：中性色背景、蓝色操作、绿色个人笔记、琥珀色待回看；保留七种段落角色的明显色条和实色标签。
• 页边卡片重新安排角色、摘要、操作、出处、讲解与笔记层级。正文默认字号从 12px 调整为 13px，保留用户已设置的字号；改善行距、留白和窄栏大字号显示。
• 常用操作改为「笔记 / 提问 / 更多」，复制、编辑摘要、重生成、合并、拆开和隐藏集中到更多菜单。菜单支持方向键、Home／End、Esc 和焦点恢复，独立于卡片滚动区域。
• 功能菜单按显示、版面与标记、论文操作分组；短窗口可完整滚动，作用范围保持可见，点击 PDF 或主窗口、再次点击按钮或 Esc 都能收起。
• 摘要、大纲、聊天、阅读目标和问题侧栏统一控件尺寸与层级；明暗主题检查正文、按钮和角色标签的对比，减少动态效果的系统设置也会生效。
• 本轮仅调整界面与交互，不增加模型请求；样式与验证说明见 docs/VISUAL_DESIGN.md。
• 单元测试通过；Zotero 10.0.6 的八组原生回归共 201 项通过，另检查四种侧栏在 355px／280px 下的明暗视觉效果。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-1.4.0.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: 6f32729b59ef6fe179a6c73a7577e04b1aab9d1c13944e80d20fbf02e6f1838b

Full Changelog: v1.3.0...v1.4.0

DeepRead v1.3.0

DeepRead v1.3.0

• 段落卡片新增「待弄懂」标记，在现有阅读问题侧栏集中回访原文、查看自己的笔记、取消标记；关闭 AI 阅读问题时本地清单仍可使用，不新增模型请求。
• 标记绑定物理段落并保存原文，合并／拆分不改变归属；重新解析仅按旧、新原文都唯一的匹配迁移。未定位的疑点仍可查看、导出或取消，同时避免重复原文导致个人笔记互相覆盖。
• 结构条按可用宽度换行并为 PDF 留出实际高度；窄窗口使用完整章节选择器，密集问题出处通过索引逐个跳转，键盘焦点和中文输入法不会被快捷键打断。
• 章节文字使用统一背景，浏览进度移到底部细线；整体进度称为「浏览至」，仅表示最远到达位置。
• 引用／图表查证丢弃过期查询，关闭后不再被迟到结果重新弹出；支持 Esc、键盘焦点保留和可视区域限制，查证时暂停段落悬停译文。
• 修复相似 DOI／标题误报“已在文库”的问题，使用完整匹配并拒绝有歧义的标题候选；导入文献后可重新查证。
• 单元测试及 Zotero 10.0.6 的 150 项原生检查通过；覆盖本地标记、结构条、查证和既有阅读交互，使用构造数据，未做学习效果实验。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-1.3.0.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: 9212282c127cb77b5e6ca9ac92e3291c65e8062faf813d64bcc2d0cb72d7a145

Full Changelog: v1.2.0...v1.3.0

DeepRead v1.2.0

DeepRead v1.2.0

• 新增按论文保存的「专注」模式：只展开当前段落，其余段落保留摘要。紧凑段落／图表卡片改为显式开合，鼠标经过时不再突然增高。
• 卡片增加「核对原文」入口，合并卡片可分别定位每个原段落；长讲解在卡片内滚动，标题保持可见。
• 卡片标题支持 Enter／空格开合，点「改」或 F2 编辑摘要；刷新保留键盘焦点和正在输入的笔记，中文输入法确认不会误保存。
• 悬停译文限制在当前可视窗口内，长内容完整保留并滚动；焦点在译文内时不因鼠标移出消失，Esc 可关闭，滚动原文清除旧弹层。
• 阅读问题区分「我的解释」「AI 参考答案」「核对原文」；隐藏答案仍能定位出处，后台刷新保留问题草稿与光标，失败时恢复未提交问题。
• 改善窄侧栏与暗色显示；阅读进度改称「已浏览到出处」，不把浏览位置等同于理解程度。
• 本次改动复用已有结果，不新增模型请求；依据与验证范围见 docs/READING_METHODS.md。
• 单元测试通过；Zotero 10.0.6 的 149 项原生检查覆盖卡片、表单、排版和续段。测试使用构造 PDF 与固定响应，尚未进行用户阅读效率实验。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-1.2.0.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: 99ad06481d7f617b478d45a96af506e1bc54405cd34371ec3e2517afa1333b23

Full Changelog: v1.1.1...v1.2.0

DeepRead v1.1.1

DeepRead v1.1.1

• 保留原文段落与列表结构：在归一化换行前提取源单元，按固定 ID 分别翻译，恢复项目符号、粗斜体、首行及悬挂缩进；参考 RetainPDF 的结构和缩进规则，并附 MIT 许可。
• 旧缓存自动从 PDF 文字层恢复结构；仅对不能可靠复用的混合译文补译，无需重新跑 MinerU。超长译文仍完整保留，可滚动查看。
• 修复正常布局下再次点击原文不能真正收起卡片的问题，包含合并卡片；导航跳转仍能重新打开。
• 七种段落角色使用不同的高对比色带与实色标签，贡献为紫色、方法为蓝色，深色模式也保持区别。
• 单元测试、33 项结构／交互／配色检查以及 22 项跨页／跨图检查通过；测试使用构造 PDF 和模拟模型响应。详见 docs/TRANSLATION_LAYOUT.md。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-1.1.1.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: 3ef97567c03a8f2ee831b43b84e833c84d799fab78a126bac6967b3871418aa8

Full Changelog: v1.1.0...v1.1.1

DeepRead v1.1.0

DeepRead v1.1.0

阅读流程与功能精简，作者显示名更新为 solsongli。

• 跨页／跨图续段：结合位置筛选候选，模型确认后联合翻译；两端共用完整译文和卡片，图注、章节和不相关段落独立。旧缓存打开后自动补处理，保留粗体与原文坐标，支持手动拆开回退。
• 修复保存精读结果时遗漏原文字号、重要度来源等元数据的问题，合并译文和检查状态也一并持久化。
• 译文框等宽、尽量等高；紧凑翻译、先调行距再有限缩小字号，超长内容在框内滚动，完整保留译文。
• 修复原文块第二次点击无法收起；合并卡片任一成员都能切换，导航跳转仍始终打开。
• 自动合并明确的连续文本片段（包括跨页续句），卡片新增「合／拆」手动纠正；保留原文、讲解与各段笔记。
• 修复要点重要度没有传入高亮的流程；新结果请求稀疏重要度，旧结果本地推荐兜底，手动取消优先。
• 移除术语与符号、闪卡、代码侧栏及相关入口、自动请求与运行模块；已有数据库内容保留。
• 阅读目标可按论文保存，提供相关章节／图表入口；图表新增比较对象、观察结果、结论与限制三项证据笔记，AI 读图步骤默认折叠。
• 自动高亮增加仅手动／少量／标准／更多四档，自动建议参考阅读目标，手动标记优先。
• 个人阅读记录可复制或保存为 Zotero 笔记；重新精读保留目标、证据笔记和自测回答，按原文唯一匹配恢复段落笔记，无法匹配的单独保留。
• 阅读问题增加可选自测：先写自己的解释，再查看 AI 答案和原文。网络调研与证据边界见 docs/READING_METHODS.md。

续段确认与联合翻译沿用已配置的精读 API，仅对候选边界追加请求；不能确认时保留分段。单元测试、隔离 Zotero 阅读流程 35 项及续段 22 项检查通过；模型响应使用本地模拟，实际语义判断取决于所配置的模型。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-1.1.0.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: 13a7896a9836d619539fdab6febdd6b9b71ca18ede08fe08f7063004aa6e9265

Full Changelog: v1.0.1...v1.1.0

DeepRead v1.0.1

DeepRead v1.0.1

• 将 GitHub 仓库、更新与发布链接统一为 solsongli/deepread；保持插件 ID 不变。
• 默认测试加入 guide.test.mjs 和排版回归测试；带读默认关闭，已有结果保留。
• 翻译提示词传入 PDF 字符的粗体／斜体范围，译文保留对应强调；修复中文标点旁强调标记无法显示的问题。
• 译文字号不再放大填框；图注按真实文字定位和字号显示，旧缓存没有文字尺寸时使用保守回退。
• MinerU 框过大时，以完整原文匹配收紧字符；可靠匹配后排除夹入的图中文字。无法可靠匹配时保留原有结果，避免误删正文。
• 速读工具条加入「读图…」选择器，直接查看图表证据；窄窗口隐藏时间估计以保留操作空间。
• 新增不依赖外部 API 的 PDF 排版夹具与 Zotero 渲染回归。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-1.0.1.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: 8a638300e51378f9e1ac05a43cbce1ecda3e92866aeb8133211b7aaa9ca2e39e

Full Changelog: v1.0.0...v1.0.1

DeepRead v1.0.0

DeepRead v1.0.0

带读：让 Agent 先通读整篇论文，再带你按 ① 定位 → ② 骨架 → ③ 方法 → ④ 证据 → ⑤ 带走 五步读。

• 工具栏新增「带读」按钮，点开后在阅读器右侧显示带读面板（右侧卡片栏暂时让位，关闭面板后恢复）：
  • ① 定位：这篇真正主张什么、作者的研究路径（原文 / 推断 / 待读）、建议阅读顺序和用时、带着 3 个问题读。
  • ② 骨架：背景 → 空白 → 已有方案 → 贡献 → 主张 → 证据 → 局限，每个主张标出 已证 / 部分 / 未证 / 待读；术语账本统一译名。
  • ③ 方法：部件承重判断（承重 / 贡献 / 装饰 / 未确立，按证据而不是按作者的强调来定）、核心思想三层、关键公式带数字手算一遍。
  • ④ 证据：证据链（能支持什么、不能支持什么）、边界检查清单、措辞强度（不把「可能」读成「确实」）。
  • ⑤ 带走：一句话总结、学到的知识、研究想法（AI 生成的候选），以及完整的 16 节精读卡；可以保存为 Zotero 笔记，或复制 Markdown。
• 每一条都标出依据的段落，点一下跳到原文并打开卡片。带读的判断（承重部件、措辞强度、主张状态）也会显示在对应段落的页边卡片上，点一下打开带读。
• 带读走设置里的 ③ Agent 通道，四种方式：
  • 本地 Codex / Claude Code：在本机运行，按你的 nature-paper-xray 和 nature-paper-card 技能写出精读长文和精读卡。PDF 和论文文本只交给本机的 Agent，Agent 用它自己的账号和模型。命令可以在设置里改。
  • 远程 API：用设置里填的 Agent API 和模型直接写。
  • 导入：导入在别处生成的精读卡或长文（Markdown），或者 DeepRead 导出的带读 JSON。
  • 前三种生成的 Markdown 最后都由「精读 API」整理成五步，并对上原文段落。
• 运行时面板显示用时和 Agent 的实时输出，可以随时取消；超时时间在设置里改（默认 10 分钟）。失败或取消时，上一次的带读结果会保留。
• 可以在「功能」菜单里关掉带读（按论文或设为默认）。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-1.0.0.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: 6819c139069f3006c33dae8155429ec0a5c73c460bc64dfd1ab50536e2717a2b

Full Changelog: v0.9.0...v1.0.0

DeepRead v0.9.0

DeepRead v0.9.0

三个新的阅读模块，都可以在工具栏「功能」菜单里按论文开关，也可以在设置的「功能模块」里设默认值。

速读分层

• 工具栏下方的横条里多了「阅读深度」：全文 / 重点 / 只看边注。
  • 重点：次要段落（背景、已有工作、参考文献、致谢等）淡化，重点段落（贡献、结果，以及 AI 标为重要的要点）的关键句加琥珀色下划线；次要段落的卡片收成一行。
  • 只看边注：正文整体淡化，所有卡片收成一行摘要，只读页边。
• 横条显示当前深度下「本页约 X 秒 · 全文约 Y 分钟」的阅读时间。
• 「下一个重点 ↓」跳到下一个重点段落；在 PDF 里按 N 跳到下一个，Shift+N 跳回上一个。
• 每篇论文记住自己的阅读深度。

悬停查证（和页边卡片互相独立）

• 鼠标停在引用编号（如 [18]、(Ho et al., 2020)）上，会弹出这条参考文献：标题、作者、年份、本文一共引用了几处。
  • 如果这篇文献已经在你的 Zotero 文库里，会显示「✓ 已在你的文库中」和「打开」按钮。
  • 否则可以复制条目，或按 DOI / arXiv / 学术搜索打开。
• 鼠标停在「Fig. 3」「Table 1」这样的图表引用上，会弹出这张图的缩略图和读图步骤，可以直接跳过去。
• 鼠标停在术语或符号上，会弹出 AI 整理的定义、首次出现的位置和全文出现的次数。侧栏新增「术语与符号」一节，列出全部术语和符号，点一下跳到首次出现处。

问题导向

• 精读后，AI 针对这篇论文回答 5 个阅读问题：要解决什么问题、方法的核心、关键设计、证据是否充分、局限是什么。每个答案都标出依据的段落。
• 侧栏新增「阅读问题」一节：点段落标签跳到原文并打开卡片；也可以输入自己的问题，AI 在全文中找答案。
• 回答问题的段落，卡片标题旁会出现 Q1、Q2 等标记；全文结构条上也标出每个问题的答案在哪一节。
• 工具栏显示「问题 2/5」：已经读到答案所在段落的问题数。勾选「先自己想，读到时再揭晓」后，答案会等你读到那里才显示。

费用：问题导向在精读后多 1 次请求，自己提的问题每个 1 次；悬停查证的术语与符号表在精读后多 1 次请求，引用和图表查证不需要请求。之前精读过的论文，第一次打开时会补生成一次。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-0.9.0.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: 17bd3f6042d6222b78c5f92d9b14c6eb4cd0f420255e238f0e7cda994c489c70

Full Changelog: v0.8.1...v0.9.0

DeepRead v0.8.1

DeepRead v0.8.1

悬停翻译：放在另一栏，和原段一样大

• 双栏论文：鼠标停在左栏段落上，译文显示在右栏同一高度；停在右栏段落上，译文显示在左栏。原文不被遮挡。
• 单栏论文：译文仍显示在段落下方（下方放不下时显示在上方）。
• 译文框和原段落宽高一致，字号会自动调整，让译文正好填满这个框。

页边卡片

• 相关段落合并成一张卡片。 生成 AI 讲解时，AI 会把连续几段讲同一件事的段落合并成一张卡片，讲解覆盖这几段。合并卡片的标题是 AI 起的小标题，旁边标着「2 段」等字样。单击其中任何一段都会打开这张卡片，鼠标停在卡片上会框出它包含的所有段落。可在设置里关闭合并。已经生成过讲解的论文，在「功能」菜单里点「重新生成全部 AI 讲解（合并相关段落）」即可。
• 卡片保持展开（默认开启）。打开的卡片不会因为点了别处就自动收起，单击卡片标题才收起。「功能」菜单里可以关掉这个选项，也可以「收起所有展开的卡片」。
• 荧光笔颜色和点击次数可以自定义。 单击卡片上的要点，会依次换成第 1、2、3……种颜色，最后再点一次清除。颜色的数量（1–6 种）和每种颜色都可以在「功能」菜单或设置里修改，PDF 里的高亮也会跟着变。
• 左右卡片栏可以收起。 卡片栏顶部有一个小按钮，点一下就收成一条窄边，再点窄边恢复。打开右侧 AI 对话时，可以把右侧卡片栏收起来，不再挤占阅读区域。「功能」菜单里也有「收起卡片栏：左 / 右」。

图表卡片

• 修复：用新版 MinerU 解析的论文，大部分图没有卡片。新版 MinerU 会把图表标成 chart 类型、把一张图拆成多个子图，标题也不一定在第一项。现在这些情况都能识别，子图会合并成一张卡片。在一篇 16 页的双栏论文上，有卡片的图从 13 张里的 6 张增加到全部 13 张（6 个表原本就能识别）。
• 图的卡片用琥珀色，表的卡片用青绿色，和段落卡片一眼就能分开。
• 只找到标题、找不到图片区域的图表，卡片上不显示缩略图。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-0.8.1.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: e322a0783425cbdafe2c1ff138f7ad725db408150fabd3d6f5c69426d876b31c

Full Changelog: v0.8.0...v0.8.1

DeepRead v0.8.0

DeepRead v0.8.0

工具栏「功能」菜单

• 阅读器工具栏的「▾」菜单换成「功能 5/5 ▾」，可以逐项勾选：页边卡片、悬停翻译、要点高亮、全文结构条、图表卡片。勾选立即生效，菜单不会关闭。
• 菜单顶部可选「仅本文」或「设为默认」：「仅本文」只改当前这篇论文，「设为默认」改所有论文的默认设置。
• 卡片字号、卡片宽度、「双栏论文两侧放卡片」、重新精读、生成 AI 讲解、DeepRead 设置、删除本文精读结果也都在这个菜单里。卡片位置在设置的「阅读」一节里也可以改。

页边卡片：段落角色

• AI 讲解会同时判断每段在论文里的作用：背景、空白、已有工作、贡献、方法、结果或局限。卡片左上角显示对应的彩色标签，卡片头部按角色着色。
• 折叠的卡片会显示「闪卡 N」「理解」小标记，不用展开就能看到这一段有没有你的记录。
• 已经展开的卡片会加一圈蓝色描边。
• v0.8.0 之前生成的讲解没有角色标签；在「功能」菜单里点「重新精读」可以补上。

全文结构条

• 工具栏下方新增一条章节横条：每节按篇幅占位、按类型着色（引言、方法、实验、讨论、参考文献等）。
• 已读部分用深色填充，右侧显示「已读 x%」，当前所在章节加描边。
• 点击某一节会跳到该节标题处。

图表卡片

• 论文里的每张图和每个表格会生成一张卡片，放在图表旁边的页边。卡片上有：
  • 图号和标题，以及正文提到它的次数；
  • 图表缩略图；
  • 单击卡片会跳到原图，鼠标停在卡片上会在原文中框出这张图；
  • AI 写的 2–4 步读图步骤：先看什么，再对比什么，最后得出什么结论。
• 单击正文中提到「图 3(b)」的段落，对应的图表卡片会高亮，并标出与 (b) 相关的那一步。

设置：三个通道

• ① 精读 API：可以保存多组服务商配置（类似 CC Switch），点卡片即可切换。支持新增、复制、删除和重命名。
• ② 文档解析：MinerU 官方 API、自建 MinerU、内置文字层和 GROBID 改成四张卡片，选一个即可。
  • 如果选中的解析服务连不上或出错，会自动改用内置文字层，精读继续进行。
• ③ Agent：为 v1.0 的「带读」做准备，现在可以先填好：
  • 选择 Codex、Claude Code、远程 API 或导入结果；
  • 填写命令、选择要用的技能（nature-paper-xray、nature-paper-card）；
  • 「检测」只检查命令和技能文件是否存在，不会运行任何程序。
• 「功能模块」一节可以设置各模块对所有论文的默认开关。

安装 / Install: Zotero → 工具 / Tools → 插件 / Plugins → ⚙ → 从文件安装附加组件 / Install Add-on From File → 选择 / choose deepread-0.8.0.xpi.
已安装的 DeepRead 会自动更新到此版本 / Installed copies update automatically.

SHA-256: c3753ff37c6cbc12202530f650e0ee675e808b7a49f19ee852a4e714b99b8174

Full Changelog: v0.7.0...v0.8.0