Skip to content

Releases

PDF2zh Easy 0.1.1 · 高吞吐默认

Choose a tag to compare

@fxz729 fxz729 released this 03 Nov 07:12

PDF2zh Easy 0.1.1 · 高吞吐默认

本版改进

  • 新安装的 Next 默认 128 并发 / 48 QPS,与维护者高吞吐配置一致;仍可显式切换到 8 并发 / 4 QPS 稳妥预设。
  • 已保存的用户设置优先,打开设置或保存“保持当前设置”不改写并发、QPS 或高级质量参数。
  • 设置页明确提示配额、余额、费用与 429 限流风险。遇到限流请先降低并发和 QPS。
  • README 新增用户提供的三张实际左右双语效果图:正文、概念框架、研究汇总表,以及并发参数和性能边界说明。

128/48 是引擎内部工作池与请求速率上限配置,不等于 128 篇 PDF 同时翻译、48 页/秒或实测速率。没有同条件前后对照测速,不承诺加速倍数。 翻译、布局与底层并行能力来自原作者及 pdf2zh-next/BabelDOC;Easy 主要改进配置入口、默认调优、受管服务复用和后台进度体验。

安装或升级

下载下方 pdf-2-zh-easy.xpi,在 Zotero 插件管理器中通过“从文件安装插件”安装;已安装 Easy 的用户也可使用 Zotero 的插件更新检查。使用原版时请先手动禁用原版,不要在翻译任务运行时切换。

新用户在设置页填写自己的 API,确认后下载安装本地引擎。首次安装可能需要数 GB 空间;远程 API 可能产生费用。已有的受管运行环境版本仍为 0.1.0,本版未改翻译引擎和其 25 个公开运行时源文件。保留 v0.1.0 发行物。

验证范围

  • 本地 Node 128 项、Python 106 项回归全部通过,TypeScript、生产构建和实际 XPI 审计通过。
  • 已检查打包后的新默认值、两更新 feed 的版本/下载地址/SHA512;25 个运行时源文件与已发布 0.1.0 逐字节一致。
  • 本版未重新运行 Zotero 原生安装/启动/真实 API 翻译链条,未修改维护者本机 API 或 profile。 历史 Windows x86_64 / Zotero 10.0.6 验收仍绑定旧记录,不自动算作本版重测。
  • macOS/Linux 未实机验证。 前次远程 CI 被账号账单锁定拦截,不能宣称远程 CI 通过,详见仓库 Actions 实时状态。
  • 三张论文效果图是用户提供的展示截图,不是速度或准确率测试;论文版权归原作者及出版方,不附原 PDF。

XPI SHA256:

d93608b93efef32f12df7621f90038c788af5b9fe071913407f5b24ffe110a98

使用说明、平台限制、界面预览和脱敏验证记录见仓库 README。独立项目基于 guaguastandup/zotero-pdf2zh,保留原作者署名及 AGPL-3.0-or-later 许可证。

PDF2zh Easy 0.1.0

Choose a tag to compare

@fxz729 fxz729 released this 03 Nov 06:41

PDF2zh Easy 0.1.0

独立于原版的 Zotero PDF 翻译易用发行版,基于 guaguastandup/zotero-pdf2zh 4.1.8,保留原作者署名及 AGPL-3.0-or-later 许可证。

安装

  1. 在 Zotero 插件管理器中手动禁用原版 PDF2zh,勿在翻译任务运行时切换。
  2. 下载下方 pdf-2-zh-easy.xpi,通过“从文件安装插件”安装。
  3. 打开“PDF2zh Easy”设置,填写自己的 API 地址、模型和 Key,保存后明确同意下载安装引擎。

无需自行配置系统 Python。首次引擎安装及可能的模型、字体下载需要网络和数 GB 磁盘空间;调用远程 API 可能产生费用。更新 feed 和校验和文件不是安装包。

主要变化

  • 引导安装独立 Python/固定版本翻译引擎,验证候选环境后才切换,不覆盖系统 Python。
  • Windows 后台隐藏启动;主窗口内进度卡片替代独立黑边进度窗口。
  • 四区设置、明确确认后的本机原版配置迁移、API 连接测试费用确认及凭据脱敏。
  • 新用户默认 8 并发 / 4 QPS;已有高级配置保持不变,可显式选择 128/48 预设。
  • 服务仅监听回环地址,使用每环境身份验证;关闭 Zotero 后服务可继续运行。

验证范围

本地 Node 126 项、Python 106 项回归通过,TypeScript 与实际 XPI 审计通过,包内 25 个运行时源码文件校验通过。

完整首次安装、正常启动及真实 API 合成单页原生验收覆盖 Windows x86_64 / Zotero 10.0.6,观察到可见控制台窗口为 0,原设置及 API 保留。完整原生验收基线 SHA256 为 ca62849294d28142245a9a2d81bee72f2ac96a66db5ed220ab7f5140880eb3e7。最终包仅追加两项前端高级设置修复,随后完成自动回归,并在 Zotero 已关闭时替换核验;25 个运行时源文件与基线一致,未再次执行整条原生验收或付费翻译。

macOS、Linux 及其他 Zotero 版本未实机验证。CI 单元测试/构建不等同原生验证。合成单页原文保留性指标不代表通用翻译准确率。

远程 CI 首次运行的三个平台任务均因 GitHub 账号账单锁定而未启动,未执行测试或构建。此发行基于上述本地验证,不宣称远程 CI 通过;初次运行记录。

最终 XPI SHA256:

0e926b276a1044321f984875c2728a419c12fe59c2457cf81a73f34107c9d3a4

使用说明、界面预览、验证记录和已知限制见仓库 README。当前无设置页停止服务按钮;不要删除活动运行环境或批量终止未知 Python 进程。