MEFinder v0.5.9

2026-10-20：v0.5.9 正式发布。 Windows x64 安装版 / 便携版与 macOS arm64 / Intel 的 DMG、ZIP 均已上传，全部附同名 SHA-256 校验文件。产品源码为 9fe9b03，tag v0.5.9 指向 19fa89e，两者 src/ 逐文件相同，差异只有测试入口修复与文档。

文献原句定位器 v0.5.9

这一版没有新的功能方向，全部是 0.5.8 之后实际用起来才暴露出来的问题修复。数据库结构、MCP 工具和文档包内部格式都没变，0.5.8 建的库可以直接用 0.5.9 打开。

导入不再卡死，也不会误报失败

• 修复取消掉的导入一直占着 MinerU 账号、后续导入永远停在「等待可用的 MinerU 账号」的问题。现在取消或移除导入时，会同步取消它的解析任务并把账号并发还回去；软件启动时还会清扫那些已经没有对应导入任务的残留解析任务。
• 修复本机进度查询临时断开时，导入被显示成失败、进度不再刷新，而后台其实还在继续跑的问题。现在断开期间保留原任务状态继续查询，连上后接着显示真实进度和最终结果。你主动取消、以及后台真正解析失败，仍各自如实显示。
• 重复上传同一个 PDF 不再当成新任务误报：现在跟踪已有的那次导入，沿用原来的解析方式，队列里多出来的重复行合并掉。
• 点「取消」后任务行不再提前消失。后台清理期间会持续显示「正在停止」，清理完成才移除，之后可以重新导入。

文献库与译本对照刷新

• 导入完成、Zotero 同步完成后，文献库不再停留在旧列表；迟到的旧摘要响应也不会把新目录盖回去。两处现在共用同一个刷新入口。
• 修复导入完成后译本对照页的版本信息没跟上：新版本的语言显示「未识别」、书名退化成内部 ID、出版与页码信息为空。现在随导入完成一起刷新，不需要重新导入，也不需要重新生成对齐。
• 打开软件时文献列表出得更快。以前默认首页的对齐总览会抢在文献摘要前面占用，文献列表只能排队；现在先取摘要，再预取总览。

作品弹窗与对齐

• 新建作品搜文献时，中文输入法不再被打断，在句子中间编辑时光标也不会跳到末尾；「加入作品」的下拉菜单宽度恢复到跟按钮一样宽。
• 对齐计算组件在启动探测阶段就没有应答时，现在提示你在设置里重新安装计算组件，不再只留一个说不清的失败。
• 生成对齐时显示当前阶段的百分比、进度条和预计剩余时间。样本不足时显示正在估算，刷新页面后进度能接上。剩余时间只指当前阶段，不代表整本书还剩多少。这一条是本版唯一新增的界面信息。

文档包与 U 盘

• 导出的文档包统一改用 .mefinder 后缀，修复文档包拷到 U 盘再插 Windows 时反复弹窗的问题：Windows 会按 ZIP 自动浏览它，Mac 在同目录生成的 ._ 辅助文件也一样中招。包内部仍是原来的数据和页码信息，不重新解析、原 PDF 不变。
• 导入页的文件选择、拖入与包恢复支持 .mefinder，旧的 .mefinder.zip 继续可用，Mac 的 ._ 辅助文件自动忽略。
• 0.5.8 及更早版本选不了新后缀。需要把文档包传回旧版时，把真正的文档包改名为 .mefinder.zip；._ 开头的文件不是文档包。

本地 OCR 安装

• 修复 Windows 上安装本地 OCR 组件时，Python 已经下载好、却因版本目录链接受限报 error 448 而整次安装失败的问题。现在复用已下载的 Python 自动恢复一次，不重新下载，恢复后继续跑依赖与样图验证。其他错误码仍按原流程报错回滚，不会把失败藏起来。

技术与兼容

• 数据库结构沿用 v11，本版本没有迁移；MCP 仍是 17 个工具，接口契约不变。
• 导入任务的状态与轮询收进独立前端模块，顺带修掉重复监听、旧响应覆盖新任务的隐患；目录与搜索页记录的读取收进持久化层。这两项是使用方式不变的内部整理。

下载

Windows（64 位 Windows 10 / 11）

使用方式	下载文件	SHA-256
安装版（推荐）	MEFinder-v0.5.9-windows-setup.exe	dff98d985772a08ae55bef983c9e330e6b014f274a81f5434b1341d598dc47c6
便携版	MEFinder-v0.5.9-windows-portable.zip	3e11ba2ee61468a97482a0001963d86fb58ce9a38b82353d9a25fef6bbc98692

macOS

使用方式	下载文件	SHA-256
Apple Silicon DMG（推荐）	MEFinder-v0.5.9-macos-arm64.dmg	6273e47f96917177acc013aec6417c67958f7e5482f45d6b6ec74d6db2111d02
Apple Silicon ZIP（备用）	MEFinder-v0.5.9-macos-arm64.zip	31ca0c89e4c11055e7c62d32e3b2534813b94d816b2d95d45df2a55d9552f478
Intel（x86_64）DMG（推荐）	MEFinder-v0.5.9-macos-x86_64.dmg	ec35a731f97f84e1c6e0023f41e21e2458d6c8583e3b243f41ac093ebc836a53
Intel（x86_64）ZIP（备用）	MEFinder-v0.5.9-macos-x86_64.zip	4db29659539c3e1d219c12da9824024212bc4b94bdeb644d4ee375623d8c5e17

• Apple Silicon 包要求 macOS 14 及以上；Intel 包要求 macOS 12 及以上。
• 每个发布文件都附带同名 .sha256.txt 校验文件；SHA-256 只能证明文件下载完整，不等同于代码签名。Windows 安装包未做数字签名；macOS 应用为 ad-hoc 签名、未经公证，首次打开可能需要在访达中右键应用选「打开」。
• Homebrew cask 在正式发布后自动同步。

构建验证

• Windows：安装版与便携版各按官方脚本独立构建，全量 unittest 各 2,790 项通过（49 项环境跳过）；真实 Chrome 回归 13 项、Ruff(F)、逐文件 JS 语法、前端守卫、打包后 MCP STDIO 冒烟、空库 / FTS5、隐私与许可证检查通过。便携 ZIP 校验通过，解包后 81 个界面资源、225 份 Python 源文件与源码逐文件相同，两份程序均为 x64 / 0.5.9，包内 OCR 冻结模块与修复源码一致。
• macOS：arm64 官方构建全量 2,790 项通过（41 项跳过）；x86_64 经 Rosetta 构建全量 2,790 项通过（46 项跳过）。逐文件 Node 语法、五阶段 MCP STDIO 冒烟、严格签名、ZIP 解包、DMG 挂载与拖出副本检查通过；两包各 307 份源码、静态资源、模板与清单和构建前逐文件相同，主应用与 MCP 侧车均为纯目标架构。
• 本地 OCR 的目录链接恢复另经真实 uv 0.12.1 / Python 3.11.15 离线验证。
• 以上均为自动化验证，不替代安装与升级的实机验收。