本次更新

0.6.1 是 0.6.0 的设置界面修正版：删除「设置 → 功能配置」底部的 查看待恢复 AI 请求 按钮及其专用结果面板，清理对应分隔区域和样式。

聊天、解析与翻译任务内部的恢复机制保持不变；PDF 部分成果、补译未完成部分、对照阅读和字号滑块继续可用。

操作与配置

• 安装/升级：下载本页 jadense-in-zotero-v0.6.1.xpi，在 Zotero「工具 → 插件 → 齿轮 → 从文件安装插件」中选择文件，按提示重启 Zotero。
• 无需新增配置：现有 AI 服务、模型、界面字号、本地历史和版面解析引擎继续使用。不要卸载插件或删除 profile 来升级。
• 版面解析引擎：已安装用户无需重装。首次使用可在「设置 → 外置依赖配置 → 版面解析引擎」自动准备；自动安装沿用随插件附带的安装脚本与锁定依赖。
• Windows 离线安装：继续下载 0.6.0 中的引擎完整包，选择「导入离线包」。该包与 0.6.1 兼容；本版不重复上传相同引擎。
• 自动、手动安装及库内备用源指南 · 完整使用与 AI 服务配置 · 0.6.0 功能介绍

v0.6.0 相比 v0.5.1，重点新增 PDF 对照与原位翻译：保留论文版面阅读译文，边生成边查看，失败后保留已有成果并继续补译。同时改进翻译请求调度、长文处理和设置体验。

PDF 对照阅读与导出

• 从 PDF 阅读操作进入「对照翻译」，并排查看原文和译文；可切换为整页译文，也可打开独立窗口用于多屏阅读。
• 支持连续滚动、同步/解除同步滚动，方便按自己的节奏对照核读。
• 「保存译文」导出仅译文 PDF，「保存对照」导出原文与译文对照 PDF；不会覆盖原附件。
• 新功能与原有侧栏段落翻译并存，可根据阅读习惯选择。

精简、完整与部分成果

• 默认「精简」：翻译正文、图表说明和学术脚注，出版信息与参考文献保留原文；「完整」翻译所有可译文字。
• 整理文段并聚合请求，减少碎片化翻译；完成内容逐步显示，不必等待全文结束。
• 部分段落失败时，已完成成果仍可阅读和导出；点击「补译未完成部分」复用已完成片段。
• 改进临时网络错误、限流、模型输出不完整和版面处理异常的恢复提示。重试和补译可能继续产生服务费用，不代表原请求一定未计费。

翻译与设置体验

• 全文翻译新增「请求与速度（高级）」：按服务地址设置并发、每分钟 HTTP 请求数和 PDF 每批原文 token，并查看在途及排队状态。多个翻译入口共享相应服务额度。
• OCR 与 PDF 排版引擎集中到「外置依赖配置」，功能设置提供跳转入口。
• 「界面字号」改为滑块：80%–200%、1% 微调，显示当前百分比，拖动即时生效，可恢复 100%；工作台与原生设置共用偏好。
• 改进长文提取、翻译成果读取与文件处理，减少重复工作；保留已有设置及历史。

v0.5.1 新增可选云 OCR，并将选文翻译与全文翻译分开配置，便于为不同阅读任务选择服务。

• 云 OCR：可选择 MinerU、智谱 GLM-OCR、硅基流动、阿里百炼或 OpenAI 兼容服务；无需安装本机 Python。普通文字层提取仍默认不使用 OCR。
• 按用途配置：工作台和 Zotero 原生设置统一按任务分组。选文与全文翻译各自保存配置；旧设置自动迁移，保留已保存的独立设置。OCR 用途开关可直接跳转到引擎配置。
• 阅读显示：改善 OCR 公式含空格时的 Markdown 渲染，并修复阅读器内更新弹窗的居中布局。

v0.5.0 相对 v0.4.10，新增文献分类和对话文件附件，让长 PDF 问答能按模型容量准备正文，并把全文任务的 OCR 改为按需使用。参考文献的原文、检索候选和选择状态也更清楚，便于导入前核对。

1. 独立文献分类窗口：先预览，再应用

• 在 Zotero 文献列表选择条目，右键「文献分类…」打开独立窗口，不必先打开对话工作台。
• 从当前文库选择候选分类目录，生成推荐后逐项核对，再应用到资料库；生成推荐本身不会修改条目，支持撤销本次归类。
• 分类独立使用 TypeSafe 的 Jev 服务，只发送所选文献的标题、摘要、标签和候选目录信息，不发送 PDF。需单独配置 TypeSafe API Key，不跟随对话模型或攻玉连接。
• 请求失败会停止后续请求，已完成的预览仍可查看；应用前会重新检查条目与目录状态，避免把过期预览写入资料库。

2. 对话可附文件：从论文扩展到研究材料

• 可在对话中添加 PDF、Word DOCX、HTML、Markdown 和常用文本文件，包括 CSV、TSV、JSON、BibTeX、TeX、XML、YAML、RIS；PNG/JPEG 图片入口继续可用。
• 文字在本机提取，附件信息与提取文字随本地对话保存，后续问题可继续使用相应上下文。
• 单个上传文件最大 20 MB，最多保留前 60,000 字符，超出或无可提取文字会提示。DOCX 只提取正文，不含嵌入图片、批注、页眉页脚；旧 .doc 请先另存为 .docx。
• 上传文件与关联 Zotero PDF 是两个入口。需要完整长文阅读时，请关联 Zotero PDF；上传附件仍受上述提取上限约束。

3. 关联长 PDF：分层阅读与页码来源

• 关联 Zotero PDF 后，在本机缓存可提取正文；短文直接准备上下文，长文按模型容量分块概括，并根据问题召回相关原文。
• 显示阅读进度、缺页提示与页码来源；追问可复用已保存的正文和概括，避免每次从头准备。
• 模型窗口、历史消息与图片共同影响本次可用上下文。分块概括和回答可能产生多次模型请求及费用，不等于一次请求读取全部原文。
• 扫描页无文字层时仍需 OCR；缺页、提取或缓存问题会提示。模型回答和页码引用仍应回到原文核对。

4. 全文任务默认文字层，OCR 按需开启

• 全文 Markdown、全文翻译和参考文献提取默认读取 PDF 文字层，不再要求先安装 Python、OCR 依赖和模型。
• 原文提取工具栏可为本次提取选择「不使用 OCR / 使用 OCR」；OCR 需先配置就绪。扫描文献可在「设置 → OCR配置」启用全文 OCR 增强。
• OCR 失败时尝试文字层，并保留不可读页提示；完善准备等待、取消与重试处理，避免准备状态妨碍普通阅读。
• 首次全文翻译增加积分消耗与稳定性提示，取消发生在提取和翻译请求之前；确认记录保存在当前 profile。建议先选中需要精读的段落翻译。

5. 参考文献更容易核对

• 修复独立年份行、跨行年份被误拆成新引用或序号的问题。
• 将「原文引用」和「检索结果」分开展示，选择框放在行首；缩短长作者列表的显示，导入使用的完整元数据仍保留。
• 优先采用精确匹配；无精确匹配时选用首条有效检索候选并显示「已选首条」。这不是准确匹配的保证，请核对题名、作者和年份后再导入。
• 编辑原始引用会清除旧候选，重新核验后再导入；导入仍需用户主动操作。

6. 阅读侧栏与本机诊断

• 改进侧栏首次加载、失效后的恢复、成果读取重试，以及阅读器重开时的初始化。
• 扩充本机生命周期与 OCR 诊断信息，便于区分界面挂载、资料读取和依赖准备问题；可从工具菜单或「帮助 → 错误诊断」查看、导出。
• 诊断保存在本机，导出后请检查内容再主动分享；没有自动上传诊断。

操作与配置

1. 分类：在工作台「设置 → 功能配置」保存 TypeSafe API Key，再从 Zotero 文献右键菜单进入「文献分类…」，选择候选目录、生成预览、核对并应用。测试密钥会发送示例请求，可能消耗服务额度。
2. 文件问答：在对话输入区添加文件；长论文优先使用「关联文件」选择 Zotero PDF。检查提取范围与缺页提示后提问。
3. OCR：普通文字层任务可直接开始。只有需要识别扫描页时才准备 OCR 依赖和模型，首次安装需要联网和数 GB 磁盘空间。
4. AI 服务：对话、解析和翻译继续使用各自配置的攻玉或 BYOK 服务；分类密钥独立配置。本地保存历史不代表离线 AI，准备好的上下文会发送到所选服务。

详细步骤见使用指南及本机 OCR 指南。

本次更新

本次更新让本机 OCR 的安装过程更清楚，也更容易在下载失败或组件损坏后恢复。

• 看得见准备进度：显示当前阶段、下载文件或批次、已下载量、平均速度和等待时间；检查与安装设置超时边界，避免一直等待。
• 复用已准备的环境：优先读取已有就绪状态与模型缓存，减少重复检查；下载失败后保留完整文件，可继续准备。
• 修复与重新安装：在设置中修复识别组件，或确认删除插件专用依赖后重装。默认保留已下载模型，也可选择同时删除模型；PDF、已保存的原文/译文/解析成果、日志和自行安装的 Python/uv 保留。
• 更完整的安装指南：补充 Windows、Linux、macOS 分环境手动安装、模型验证及故障处理，中英文 README 均有独立入口。

v0.4.9 改进全文翻译的流式结束、已完成进度保留、手动继续和错误提示；统一本机 OCR 的状态读取、依赖/模型准备与修复入口，复用已有缓存并支持 Hugging Face、HF-Mirror 和 ModelScope；新增本机错误诊断的筛选、复制、导出与清空，并改进解析任务状态和文献成果提示。

本次更新

0.4.8 让选文引用和翻译更顺手：可选择用本机 OCR 提取选区文字与公式，默认文字层提取也改善了段落换行、跨行断词、连字和上下标。

• 选文 OCR 按需开启：识别后再引用或翻译；识别未完成时提示并使用原选文，继续当前操作。
• 选文浮窗更顺手：记住位置和大小，也可跟随选文；支持自动翻译或引用到新侧栏对话。自动引用只创建草稿，不自动发送。
• 模型下载与更新提示：可选择第三方 HF-Mirror 下载公开 OCR 模型；打开工作台或阅读器时可收到新正式版提示。

0.4.7 修复解析历史详情与设置界面混杂的问题，让工作台页面切换恢复正常。

• 从解析详情进入设置、对话、攻玉学术或上手指南时，旧页面会正确隐藏，不再与当前内容叠加。
• 返回解析历史时保留原有详情；已有设置与历史无需迁移。

0.4.6 让参考文献整理更方便：可以直接修正引用内容、删除多余记录，并减少文献序号和 PDF 版式换行对检索的干扰。

功能与体验

• 编辑参考文献：在参考文献列表中点击每条记录的编辑按钮，修改完整引用文本并保存，再点击「重新核验」更新匹配结果。手动修改的内容会保留，后续 AI 批量识别不会覆盖它。
• 删除多余引用：点击删除按钮并确认，即可移除当前解析结果中的引用记录。已保存的 Zotero 条目、PDF 和已导入文献均保留。
• 清理文献序号：引用开头的序号与引用正文分开显示，减少搜索时混入编号的问题，同时保留原 PDF 定位。
• 改善已有记录：打开已有参考文献结果时也会清理版式换行和开头序号。延续 0.4.5 的底部全选框修复，可批量选择当前可导入条目。

0.4.5 改善本机 OCR 的安装与配置体验，并优化文献工作区和阅读界面。

功能与改进

• 独立 OCR 配置：在「设置 → OCR 配置」中管理本机 OCR 环境与缓存位置，查看安装和启动状态。
• 更顺畅的首次安装：改善 OCR 依赖安装、模型准备和启动等待流程，提供更清晰的进度与错误提示。
• 文献阅读体验：调整文献详情、参考文献列表及底部操作栏的布局，改善阅读与操作体验。
• 工作台界面：优化导航和攻玉学术页面的信息展示。

0.4.4 将原文、译文与解析成果集中到文献工作区，支持传统翻译和本机 OCR，让扫描论文也能进入全文阅读流程。

功能与体验

• 文献成果集中查看：按论文与 PDF 附件管理全文 Markdown、全文翻译、选中翻译、解析总结、笔记、参考文献和历史。Reader 侧栏跟随当前 PDF；原文可以独立提取和阅读，打开历史不会自动重新翻译。
• AI 与传统翻译可选：在「设置 → 功能配置 → 翻译」选择 AI 或 Bing/Google。改善长文本请求、暂停与继续体验；限流后提示可继续时间，不会自动切换服务。
• 本机 OCR：全文翻译先在本机识别完整 PDF，按阅读顺序保留正文、表格及本机公式图片，再将正文发送至你选择的翻译服务。可通过「安装并启动本机 OCR」提前准备环境。首次需要联网下载 Python、依赖及模型，并预留数 GB 空间。
• 更清晰的入口与指南：优化工作台导航、模型配置和阅读布局，补充快速开始、图文指南、FAQ 与 OCR 安装说明。

本次更新涉及 UI 交互、全文翻译（早期功能，不稳定）以及文献解析功能的优化。

• 全文译文在阅读器侧栏连续展示，支持目录、阅读/定位模式、独立字号与行距、阅读位置恢复及独立 PDF 窗口。
• 改善跨页完整段落提取与翻译，减少换行和页边编号干扰；旧译文继续保留，回看不会自动重新请求。
• 论文详情集中展示解析总结、笔记与参考文献，保留搜索、筛选和导入选择。
• 参考文献批量 AI 默认关闭，可主动开启并暂停/继续；攻玉请求支持已有结果恢复，BYOK 不自动重发未确认请求。
• 修复大字号选文工具条溢出。

本次更新将翻译从选文扩展到整篇 PDF，并把参考文献核验、导入与文献解析放在一起。阅读浮窗和字号也可以按习惯调整。

功能与体验

• 可恢复的全文翻译：从阅读操作选择「全文翻译」，按段阅读、复制译文并跳回原文核对。隐藏浮窗后继续处理；中断或重启后可手动继续，已完成内容保留。全文翻译与实时翻译共用模型配置。
• 参考文献核验与导入：「解析」同时提取同一 PDF 的参考文献，在「文献解析 → 参考文献」查看原文、核验 DOI 并导入已确认条目。保留引用顺序、编号、重复项及未确认内容；同库 DOI 去重，不覆盖已有文献，不自动下载 PDF。
• 更合适的阅读外观：「设置 → 常规」新增 12–24px 字号、普通/毛玻璃浮窗及背景透明度。选文与全文浮窗均支持标题拖动和边角缩放，也可从左下角「外观」直接调整。
• 阅读器入口更清楚：空间不足时，提问、解析、引用与全文翻译收在「•••」菜单内，为 Zotero 页码和批注工具留出空间；点击 Jadense 图标打开工作台。选文翻译使用选区弹出栏的「智能翻译」或 Ctrl+Alt+T（macOS：⌘+Alt+T），顶部不再放置选文翻译按钮。

Jadense in Zotero 0.4.1：中英文界面、主题切换与账号体验升级

本次更新让插件更贴合你的阅读习惯：自由选择界面语言与主题，集中查看攻玉账号和积分，并获得更清晰的模型选择提示。

• 新增中英文界面设置：在「设置 → 常规」中选择跟随 Zotero、简体中文或 English，覆盖工作台、阅读器工具、上手指南和设置等界面。修改后重启 Zotero 生效，不影响已有内容和翻译方向。
• 完善浅色与深色主题：支持跟随 Zotero、浅色、深色三种模式，切换后立即应用于已打开的插件界面，保留当前草稿和进行中的生成。
• 集中查看账号与积分：「连接攻玉」中的「你的攻玉」汇总账号、订阅、可用积分及签到状态，并提供官网、签到页和订阅与用量入口。签到在网页完成后，可刷新插件查看最新状态。以上变化见 0.4.1 官方说明。
• 优化模型选择与订阅提示：更清楚地展示模型所需的订阅档位，遇到使用限制时提供更换模型或升级订阅的指引。连接攻玉的新配置默认使用 DeepSeek V4 Flash Vision，已有明确模型与自定义服务配置继续保留。
• 提供开源客户端与安装包：客户端以 MIT 协议开源，支持自带 API Key 或连接攻玉账号；安装包附带校验信息，方便下载与核验。这两项改进延续自 0.4.0 官方发布。

升级提示：使用 GitHub 0.4.0 的用户可直接从文件安装更新，保留设置与本地历史。使用官网 0.3.2 或更早版本的用户，请先禁用旧 Jadense 插件，再安装新版，避免同时启用两个版本；请勿删除 Zotero 用户数据目录。自动识图需要 Zotero 10.0.1 或更高版本的兼容 PDF 阅读器。下载 0.4.1 安装包

开源版本！

• 新增 PDF 手动截图解读：支持在 PDF 页面内拖动框选，即使图片未被自动识别，也可手动选取区域进行解读；完善截图退出与选区交互。
• 增强图片解读对话：支持开启新对话或追加到当前对话；开启新对话时，自动关联当前文献信息与可提取的 PDF 正文，辅助理解图片背景。
• 新增多语言翻译设置：提供 32 种语言选项及源语言自动识别，支持按文献保存翻译方向，也可为当前选文临时切换语言并重新翻译。
• 新增阅读器快捷键设置：支持快捷截图与选文翻译，默认快捷键分别为 Ctrl+Alt+S 和 Ctrl+Alt+T，可在设置中自定义、停用或恢复默认。
• 完善文献解析结果保留：解析历史支持展开查看和复制详细笔记；生成中断、返回格式异常或部分批注写入失败时，尽可能保留已生成内容，并提示处理结果。
• 新增插件内置上手指南：涵盖文献解析、图片解读、实时翻译和 AI 对话，可直接在工作台查看操作步骤与使用说明。
• 新增 AI 对话图片上传与消息显示：支持上传、粘贴或拖入 PNG/JPEG 图片，发送前可预览、替换或移除，也可直接发送图片。上传图片与 PDF 图片解读均在对应消息中显示图片，支持点击放大；图片随对话保存在本机，重新打开后仍可查看并继续带图追问。

新增独立的文献解析历史与解析配置，解析结果不再写入对话；支持点击解析历史标题直接打开对应的本地 PDF。

新增 PDF 图片解读内测功能，可识别论文图片、结合图注进行分析，并在独立对话中继续追问。

完善翻译历史原文页跳转、BYOK Provider 与模型管理、攻玉模型选择，以及插件内账号、积分和签到体验。

内测版本发布，更新了BYOK功能