Repository navigation
Releases
PDF to Markdown v0.2.11
修复完整性修复后跳过原文复核的问题,并同步此前尚未发布的渲染服务和图注处理改进。
- 完整性修复与局部复核各自拥有一次独立 AI 请求额度。修复图片、公式占位符或重复段落后,有复核候选项时仍执行原文核对。
- 复核失败、返回缺项、无法定位或超出限制的项目保留待核对状态;正常流程和“修复并继续”均显示提示,日志分别记录完整性修复和复核是否执行。
- 渲染服务统一通过固定入口启动,自启绑定入口;提供 Windows 登录自启与 macOS LaunchAgent 注册工具。
- 包含组图与图注绑定、CRLF 段落清理、原文局部截图核对和缓存清理等改进。
安装与更新:
- 下载
pdf-to-markdown.xpi,在 Zotero 插件管理器中从文件安装。 - 下载
pdf2zh-render-service-v0.2.11.zip,解压到固定目录,更新完整service目录及包内配套文件并重启服务。仅更新 XPI 无法启用服务端改进。 - Windows 在该目录运行
npm.cmd run render-service:autostart注册登录自启;macOS 使用npm run render-service:autostart。保持安装目录不变,后续更新继续使用同一个入口。 - 渲染仍需 Node.js、Pandoc、XeLaTeX/ctex 和 Poppler。已有译文可使用“修复并继续(使用已保存译文)”进入修复和复核流程,无需重新翻译全文。
局部复核保留每篇最多 12 项问题(其中公式最多 8 项)、最多 3 页 / 6 个局部区域和 90 秒请求超时等限制。无疑点时不发起复核请求;失败不自动重试,重要结果仍应检查待核对提示。
验证:87 项本机自动测试通过,包含真实 PDF 渲染、Windows 自启注册、服务入口和后处理回归测试;格式与 lint 检查通过。未为此次发布重新调用真实翻译模型处理整篇论文。
发布工作流检查格式、lint、后处理回归测试与构建,并发布渲染服务包、SHA256SUMS.txt 及 Zotero 自动更新信息。
PDF to Markdown v0.2.4
修复翻译 PDF 中公式表格横向越界、右侧内容被裁切的问题。
- 为表格设置相对列宽,编号公式逐条分行并按单元格宽度局部适配。
- 方程长表可跨页,已识别的表头重复显示;至少八列的独立宽表使用横向页面。
- 渲染后检查可提取文字的页面边界;发现越界时保留诊断文件并返回错误,避免作为成功结果导入。
- 正确处理横向页面坐标与公式兼容回退后的最终 PDF;修复 Windows 保存译文恢复测试的路径兼容问题。
安装与更新:
- 下载 pdf-to-markdown.xpi,在 Zotero 插件管理器中从文件安装。
- 下载 pdf2zh-render-service-v0.2.4.zip,更新整个 service 目录并重启渲染服务。本次表格修正主要位于独立渲染服务,仅替换 XPI 不足以启用。
- 需要 Node.js、Pandoc、XeLaTeX/ctex,以及 Poppler 的 pdftotext、pdfinfo。健康检查应包含 tableLayout: true 与 layoutValidation: true。
- 已有译文可使用“重试渲染(使用已保存译文)”,无需重新翻译。
验证:构建、TypeScript、格式与 lint 检查通过;57 项本机逻辑和真实 PDF 渲染测试通过,覆盖表格内容完整性、宽表跨页、横向页面、越界拒绝和公式回退。边界检查不等于完整视觉审计,重要公式仍建议人工抽查。
隐私检查:源码归档 63 个文件、XPI 19 个条目和渲染服务 ZIP 10 个条目均已检查。发布包不包含个人配置、API 凭据、日志、缓存、Zotero profile、数据库或论文文件;凭据与导出目录默认留空,仅保留公开配置模板。SHA256SUMS.txt 提供附件校验值。
pdf2zh v0.2.3
修复 Zotero 沙箱缺少全局 AbortController 时无法发起 PDF 渲染的问题,并为完整响应读取提供超时限制;恢复重复公式引用,兼容公式后紧接数字的写法。包含当前源码中的翻译诊断、保存译文重试渲染及图组排版改进。
安装:下载下方 pdf-to-markdown.xpi,在 Zotero 插件管理器中从文件安装。已有本机配置会保留;XPI 中的 API Token / Key 默认均为空。
翻译至 PDF 仍需单独运行本仓库 service 目录中的渲染服务,并安装 Node.js、Pandoc、XeLaTeX 与中文排版依赖。请从本版本源码包同步更新整个 service 目录并重启服务。
验证:构建、TypeScript 检查、lint 及 26 项公式/渲染逻辑测试通过;Windows 本机中文与公式渲染返回正常 PDF,零回退、零缺字。当前 Windows 诊断测试套件有 1 项保存译文重试测试未通过,尚未完成全面兼容验证。实验性版本,重要公式仍需人工核对。
pdf2zh v0.2.1
渲染兼容性更新:兼容重复美元符号公式、常见数学环境、Unicode 数学符号与粗体数学字母,保留 HTML 表格公式;过宽公式自动适配版心。内容编译失败时优先局部展示原始 Markdown/TeX,必要时全文原文回退;新增警告与缺字计数、编译超时保护。已通过 25 项逻辑测试、2 项真实 PDF 渲染测试、格式检查及构建。本次渲染更新主要位于独立服务:除安装最新 XPI 外,请下载 pdf2zh-render-service-v0.2.1.zip 更新整个 service 目录并重启服务。压缩包包含快捷启动文件和中文说明。XPI 不包含 Node.js、Pandoc、XeLaTeX。重要公式仍需人工核对。
pdf2zh v0.2.0
首次发布:MinerU 解析、全文翻译与语义修订、公式候选复核、可选 PDF 视觉核对,最终 PDF 附回原 Zotero 条目。包含 macOS/Windows 渲染服务快捷启动文件和完整中文安装/设置说明。修复表格内公式恢复及数学分隔符保留。XPI 不包含 Node.js、Pandoc、XeLaTeX;请按 README 单独部署并启动渲染服务。已在 macOS + Zotero 9.0.6 验证;Windows 尚未实机测试。数学语义与布局仍需人工审查。所有 API 凭据默认留空,使用自己的本机配置。
Zotero Update Feed
Machine-readable Zotero update metadata. Install the XPI from the latest stable version release; this prerelease only hosts update.json.