MEFinder v0.6.0

MEFinder v0.6.0 已发布（2026-10-23）。本次提供 Windows x64 安装版、便携版，以及 macOS Apple Silicon / Intel 两架构安装包与 SHA-256 校验文件。

本版更新

• 修复部分 PDF 原句定位页码错误：修复 MinerU 将跨页文字合并到上一页，导致原句命中页码错位的问题。新版导入时根据原始版面记录，将文字拆回实际所在页，引用页码以该页书上印的页码为准；跨页检索和 Markdown / EPUB 导出同步使用修正后的文字。
• 美化「关于与更新」设置页：重新整理版本号、项目链接、更新状态和说明的排版，统一 Windows、macOS 与浏览器入口；Mac 增加可复制的 Homebrew 更新命令，官网、更新日志和 GitHub Star 入口更集中。
• 下载与安装进度更清楚：译本对齐模型下载显示速度和预计剩余时间，计算组件安装显示当前步骤与已用时间。
• 修复从缓存刷新后阅读位置丢失：局部刷新页内文字时保留“上次读到”的位置；旧解析清单中的路径可自动改接到当前数据目录。
• 改进 MCP 页码说明：明确引用页码直接对应书上印的页码，显示页内文字核对状态和缺页跳转，移除容易误解的 offset 字段。

升级注意

• 已有文献需要从缓存刷新后，才能应用这次页码修复；升级不会自动改写旧书。需要时关闭 MEFinder，并按版本说明使用 refresh-page-text --root <数据根> --apply 从缓存刷新；工具会先备份，刷新会移除受影响文献的旧译本对齐，之后需重新对齐。
• 缺少原始版面记录的文献保持未核对状态，不推算缺失证据。
• macOS 提供 Apple Silicon（arm64，最低 macOS 14）和 Intel（x86_64，最低 macOS 12）两套 DMG / ZIP。Intel 包在 Apple Silicon 上通过 Rosetta 构建，尚未在 Intel 真机验证。
• 本次构建验证覆盖自动测试与制品；目标机器上的安装 / 升级 / 卸载体验仍建议实机确认。

Windows 构建验证

• 构建源码：2371f60dc3b058ef9b945b618545a3562477fac4；版本 0.6.0，Windows x64。
• 安装版官方脚本：全量 2,825 项 unittest 通过（52 项环境跳过，220.038 秒）。
• 便携版官方脚本：全量 2,825 项 unittest 通过（52 项环境跳过，217.495 秒）。
• Chrome 浏览器回归 16 项、Ruff(F)、JavaScript 语法、前端守卫、MCP STDIO、空库 / FTS5、隐私与许可证检查通过。
• ZIP CRC、81 个界面资源、230 份 Python 源文件、两程序冻结应用模块、版本 / x64 与 SHA-256 校验通过。

文件	字节数	SHA-256
MEFinder-v0.6.0-windows-setup.exe	82,513,410	052fd6d57ce7259fd9552d2b627d36941218e11024f03cc2dab0feaf917a27db
MEFinder-v0.6.0-windows-portable.zip	98,284,307	557ffc04205c3f92c12a28adb25d7020c9ba55b3b9c9a55deabfe5b783fca334

每个二进制文件均附同名 .sha256.txt。

macOS 构建验证

• 构建源码：2371f60dc3b058ef9b945b618545a3562477fac4，版本 0.6.0。
• Apple Silicon：全量 2,825 项 unittest 通过（39 项条件跳过，229.038 秒）；关于与更新页 Chrome 回归 3 项通过。
• Intel：通过 Rosetta 使用 x86_64 Python 环境运行官方构建，全量 2,825 项 unittest 通过（44 项条件跳过，214.035 秒）。
• 两架构均通过 Ruff(F)、JavaScript 语法、五阶段 MCP STDIO、签名、ZIP 解包、DMG 挂载 / 拖出副本及 SHA-256 校验。
• 两架构主程序与 MCP 侧车分别核对为纯 arm64 / 纯 x86_64；包内各自 312 个产品文件与构建源码逐一一致。

文件	架构 / 最低系统	字节数	SHA-256
MEFinder-v0.6.0-macos-arm64.dmg	arm64 / macOS 14	104,330,119	9a505a443c23304720f6da96587b4f8836a11cabafb8808147568b47ca6d073d
MEFinder-v0.6.0-macos-arm64.zip	arm64 / macOS 14	96,291,408	0c26ecba3d375acb3d7acc9c5bdb5fb143b089afa026fbec97a157fe976fcf01
MEFinder-v0.6.0-macos-x86_64.dmg	x86_64 / macOS 12	108,662,028	b168c654ce28a1d1bbdb2796261bf59a9aec14f7f86ef99a38a9af34cffe43bc
MEFinder-v0.6.0-macos-x86_64.zip	x86_64 / macOS 12	102,826,401	723ea5b41281070c2e05344414e996c97d554ca9f94ecd16852b346a216634df

每个二进制文件均附同名 .sha256.txt。

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 离线验证。
• 以上均为自动化验证，不替代安装与升级的实机验收。

MEFinder v0.5.8

2026-10-03：v0.5.8 正式发布。Windows x64 与 macOS arm64 / x86_64 安装文件已上传 GitHub Release，构建与测试门禁通过；Windows 安装 / 升级 / 卸载自动冒烟及安装后的人工验收仍待进行。

文献原句定位器 v0.5.8

搜索更快，记错字也能找回原句

• 搜两个字的短词（如「社会」「麒麟」）明显变快：以前开着繁简联合要等几秒，现在基本即时出结果。升级后软件会在后台给已有文献补建索引，补完之前搜索照常可用，只是暂时按原来的速度。
• 模糊搜索整体提速，常见短词快了几倍，搜索结果不变。
• 记错一两个字也更容易找回原句：4～8 个字的短句即使处处被错字打断，现在也能搜到；长句里有漏字、多字或 OCR 识别错字时，高亮能更准确地框住原句。这部分改动会让一些搜索结果与以前不同。
• 引文页码更准：PDF 里一段文字跨了两页、而你要的那句话只在其中一页时，显示和复制的引文只写那一页（如「463」，不再是「463–464」）；句子本身跨页时仍写两页。
• 修复 MCP 按主题检索两个字的词时，什么也搜不到的问题。

MCP 更新

• AI 可以直接查到一本书哪些页码能用于正式引用，以及 PDF 页与书上印刷页码怎么对应，不必一页页去试。
• AI 可以按章节读书；核对引文时会告诉你命中的句子在哪一章，方便发现「字对上了、出处却不对」的情况。
• AI 列出文献时，能看到同一作品的其他版本，以及是否已有译本对照。
• 书目补全：AI 可以从版权页等处读出出版年、出版社、译者等，提议补进书目信息。每一项都附原书依据，必须经你明确同意才会写入，并且只填空着的项，已有内容不会被改掉。写入由桌面端完成，桌面端没开时，会在下次启动后写入。
• MCP 工具从 13 个增加到 17 个。升级后请在 AI 客户端里重新连接 MEFinder。

导入与 Zotero

• 修复 Zotero 同步完成后，文献库仍显示旧列表的问题；现在不打开设置页、或在启动时自动同步，文献库也会自动更新。
• 修复软件中途关闭后，没导完的 Zotero 文献一直卡着、不再处理的问题；这些文献现在会标为失败，手动同步一次即可重新导入。
• 导入页现在能看到 Zotero 同步交给后台的文献，也可以在这里停止和移除。
• MinerU 云端排队较久时，进度会如实显示「MinerU 云端排队中：已等待 N 分钟」，不再一直写「解析中」。

本地 MinerU

• 本地 MinerU 的设置改为每台电脑各存一份。数据目录放在网盘里、Mac 和 Windows 共用时，两台电脑不会再互相覆盖设置，也不会出现显示「已配置」却连不上的情况。MinerU 账号仍随数据目录同步。
• 托管 MinerU 组件按系统分开存放，另一台电脑装的组件不会再被当成「未安装」而被覆盖重装。
• 修复本地 MinerU 推荐配置漏装一个依赖、导致解析整批失败的问题。
• 设置页：本机没装托管组件时显示黄色「本机未安装」；「检查新版本 / 安装推荐配置」按钮恢复横排；Apple Silicon 电脑的设备名不再显示成「arm」。

技术与架构

• 数据库升级到 v11，新增书目补全记录和短词搜索索引。新数据库无法由 0.5.7 及更早版本打开。若需要保留退回旧版的可能，请先退出软件，再完整备份数据目录；设置中的「导出备份」不包含原文文件和索引库。
• 短词索引会让文献库文件略微变大（约 6.4 万段的库增加约 90 MB）。
• 模糊搜索改用 RapidFuzz 计算相似度，在本机运行，不联网。
• 搜索与阅读器的数据库查询继续集中到持久化层，方便后续维护；使用方式不变。

下载

Windows（64 位 Windows 10 / 11）

使用方式	下载文件	SHA-256
安装版（推荐）	MEFinder-v0.5.8-windows-setup.exe	385b880420228e44e9ee8b5bd387d7206ef9901969418dd70db7f628544744b6
便携版	MEFinder-v0.5.8-windows-portable.zip	1303be2cd920059404c6ed3fde876378428c22891a7cfe9f9ff6dd2132999b3a

macOS

使用方式	下载文件	SHA-256
Apple Silicon DMG（推荐）	MEFinder-v0.5.8-macos-arm64.dmg	18b30799babc85a74b5aef5b94263d34786003152a0011f9f92ab6535ee7a4d4
Apple Silicon ZIP（备用）	MEFinder-v0.5.8-macos-arm64.zip	58927d6b67b5bd57a33598946069f40fc36cf9b8722546a21bac11ec320380af
Intel（x86_64）DMG（推荐）	MEFinder-v0.5.8-macos-x86_64.dmg	29d43c3cc7abf3e1eabf0441996a4ac634ece4b1aa2bdce686412132e5c55309
Intel（x86_64）ZIP（备用）	MEFinder-v0.5.8-macos-x86_64.zip	993f0eaff7112516a457eefb83778cd365c4c7803ea5147ad36dc216b34b06c6

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

构建验证

• Windows 安装版与便携版的构建脚本各自通过全量 unittest（2738 项，42 项按条件跳过）；MCP 组件冒烟、便携包解包校验通过。
• macOS 双架构包经官方构建流程：arm64 直接构建，全量 unittest 2738 项通过（34 项按条件跳过）；x86_64 经 Rosetta 构建，全量 2738 项通过（39 项按条件跳过），反查主应用与 MCP 组件均为纯 x86_64、最低系统 macOS 12.0。严格签名校验、MCP 组件冒烟、ZIP 解包、DMG 挂载与复制校验通过。
• 三个包的代码均与源码 84a0fc1 一致。Windows 安装 / 升级 / 卸载的自动冒烟因测试环境编码设置失败、尚未跑通，留待后续补做。
• 以上为自动化验证，不替代安装与升级的实机验收。

MEFinder v0.5.7

文献原句定位器 v0.5.7

Zotero 文献库同步

• 在「设置 → 来源 → Zotero」选择分类后，可手动同步、启动时同步，或在软件运行期间每 30 分钟同步。页面会显示连接状态、进度和每篇文献的处理结果。
• MEFinder 会导入所选分类中的 PDF、EPUB 附件及题录。Zotero 中新增文献会继续导入；只改题录时，不会重新解析文件。茉莉花插件写入 Zotero 的知网、万方期刊题录也能同步。
• 从 Zotero 删除条目、移出所选分类，或取消勾选分类后，MEFinder 会在下次同步时移除相应的 Zotero 来源文献；原本就存在于 MEFinder 的文献只解除关联。取消勾选前会提示可能移除的数量。Zotero 未运行或列表读取不完整时，同步会暂停，避免误删。

同步使用 Zotero 自带的本机只读接口，无须安装额外插件，也不会修改 Zotero 数据库。目前支持「我的文库」，暂不支持群组文库。

其他更新

• 文献库首屏无须等整份译本对照总览加载；同一构建中的正文范围核对结果可复用缓存。
• Zotero 设置页重新整理了连接状态、分类、同步选项和结果明细；设置目录换用了更容易辨认的图标。
• 设置目录与内容区的滚动条改为鼠标停留时才显示；最大化后，设置目录末尾的选项也能完整显示。
• 主窗口改为首个页面加载完成后再显示，减少启动时一两秒的整窗底色（Windows 与 macOS）。

技术与架构

• 数据库升级到 v8，用于保存 Zotero 条目、附件和同步状态。新数据库无法由旧版软件打开。若需要保留退回旧版的可能，请先退出软件，再完整备份数据目录；设置中的「导出备份」不包含原文文件和索引库。
• 阅读器和前端页面按职责拆分，数据库查询集中到持久化层，后台任务的关闭流程也作了统一。这些调整方便后续维护；检索、阅读和页码定位的使用方式不变。
• 设置页的「译本对齐模型」和「托管 MinerU」两张卡片改由随包附带的 Vue 3 渲染（试点，运行时不联网），显示与操作不变；主页面体积约增加 13%。

Bug 修复

• 修复 Zotero 大批量同步时，导入队列满后留下未完成条目，并将排队误报为解析失败的问题。
• 修复切换资料库位置后，MCP 组件仍可能读取旧文献库的问题。
• 修复书目信息中切换文献类型后，已编辑的书名、作者等字段被改回原值的问题。
• 修复不支持 VLM 的电脑上仍显示托管 MinerU 的 VLM 选项的问题。
• 修复 Windows 重新对齐及托管 MinerU 硬件检测时弹出终端窗口、本地 OCR 更新或对齐组件卸载时偶发的文件占用错误，以及设置页旧请求覆盖新任务状态的问题。
• 修复 Windows 主窗口边缘拉不动、没有缩放光标的问题；现在四条边和四个角都可拖动缩放。
• 修复 Windows 主窗口启动后，最小化按钮带着蓝色焦点框的问题。

下载

Windows（64 位 Windows 10 / 11）

使用方式	下载文件	SHA-256
安装版（推荐）	MEFinder-v0.5.7-windows-setup.exe	5bf3080113dfd6b7707b2b177a87c258fc57de4f1539a72b5c7b18ec25da1434
便携版	MEFinder-v0.5.7-windows-portable.zip	4c126ead57685251d97bb0cb168bd725f8180f86297464280731788737b44432

macOS

使用方式	下载文件	SHA-256
Apple Silicon DMG（推荐）	MEFinder-v0.5.7-macos-arm64.dmg	1655ccef1b641ab8b33436bd63975e2537757a0e410c4d7621cafaa334c440c9
Apple Silicon ZIP（备用）	MEFinder-v0.5.7-macos-arm64.zip	7ca80c22ddfae786c8d085f9ce936d7aa903c346bc4a618e88faab93613ec915
Intel（x86_64）DMG（推荐）	MEFinder-v0.5.7-macos-x86_64.dmg	1e1605b03be794263a29eb23707674395c8961cb151a9c399075581aca5b021c
Intel（x86_64）ZIP（备用）	MEFinder-v0.5.7-macos-x86_64.zip	c3a86ea2aa3519cb9792342c0fb0cfad4bc8fe4b229770fa36a85e925dc41e26

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

构建验证

• Windows 安装版与便携版的构建脚本各自通过全量 unittest（2611 项，36 项按条件跳过）。
• macOS 双架构包经官方构建流程：arm64 直接构建，全量 2613 项通过（28 项按条件跳过）；x86_64 经 Rosetta 同源构建，全量 2613 项通过（33 项按条件跳过），反查主应用与 MCP 组件均为纯 x86_64、最低系统 macOS 12.0。严格签名校验、MCP 组件冒烟、ZIP 解包、DMG 挂载与复制校验通过。
• macOS 包于 2026-09-28 发布当天覆盖重传，补入启动整窗底色修复；Windows 包未变。
• 以上为自动化验证，不替代安装与升级的实机验收。

MEFinder v0.5.5

文献原句定位器 v0.5.5

2026-09-24：Windows（安装版 / 绿色版）与 macOS 双架构（Apple Silicon / Intel）均已可用；首次生成对齐前需联网安装一次独立计算运行时。

0.5.5 重点完成了两项改动：一是译本对照全面改版，新增独立的「作品—版本」管理页、统一阅读器与正文范围人工纠偏机制；二是将对齐计算数值栈剥离为按需安装的独立组件，使桌面端主包体积减半。

注意升级边界：数据库升级至 v7，无法退回旧版打开；「生成对齐」需在设置中联网安装一次独立计算运行时。未安装时已有对照仍可离线只读浏览，检索、题录与原句定位均不受影响。

升级须知

• 数据库升级至 v7：本次仅新增表结构，不改写既有数据；但 v7 数据库无法被 0.5.5 之前的旧版本打开。若需保留降级能力，请在升级前彻底退出应用，完整备份数据目录（macOS 为 ~/Library/Application Support/MEFinder）。设置中的「导出备份」仅包含书目、页码和偏好，不含索引库，无法替代整目录备份。
• 首次生成对齐需联网安装独立运行时：对齐所需的数值计算栈（约 94 MiB）不再随主程序分发。首次生成或重新对齐前，请前往「设置 → 译本对齐」安装独立计算运行时并下载对齐模型；安装完成后计算全程离线，任务中途不联网。若未安装，已生成的对照仍可正常阅读（入口标为「只读」，生成类按钮禁用并就地说明原因）；若库中暂无对照结果，入口保持隐藏。
• 镜像与校验：运行时安装默认优先使用清华 TUNA 国内镜像，失败自动回退官方源；每段下载支持重试与断点续传，并对产物逐一执行 SHA-256 校验。若不希望使用镜像，可设置环境变量 MEFINDER_ALIGNMENT_MIRROR=off。
• 旧对照状态重验：若更换对齐模型或受本版正文范围识别修复影响，已有结果仍可正常阅读，但页面会标记「需重新对齐」。
• 精简主包缺少数值栈而触发模型下载时，现在给出明确的「运行时未安装」提示，不再抛出底层 ImportError。

更新内容

译本对照独立成页

• 作品—版本管理：侧边栏新增「译本对照」页（位于「文献库」后）。左栏汇集作品列表、检索与同名归组建议；右栏呈现该作品下的各版本清单（版本名、书名与格式、语言、出版信息、页码来源；无出版方页码如实标「未校准」）与两两对齐状态。
• 同名归组核对：对照表列出书名、作者、格式、篇幅与页码并标出不一致项，提供「归为一部作品 / 不是同一作品 / 稍后」选项；选择「不是同一作品」后会记住，不再重复询问。
• 管理版本抽屉：支持修改作品名称、设定基准版本、重命名版本以及增删版本。删除作品的确认条带「撤销」，提示消失后才真正删除；对齐关系与人工校正随之删除，文献本身保留。
• 文献库入口收敛：移除工具栏「全部文献 / 按作品组」下拉、「管理作品组」弹窗与「加入作品组」下拉，改为多选文献后通过「加入作品…」弹窗新建或加入已有作品（新建时第一本为基准）；完成后不跳转，就地提示并提供「前往译本对照」。已归组的文献行显示作品名链接，详情抽屉新增「阅读」。

逐对对齐状态常显与批量重算

• 状态常显：版本列表内直接展示每对版本的对齐状态（直接对齐、间接关联、需重新对齐、尚未对齐、生成中），并附匹配段落比例与待检查数量，行内提供「对照阅读」与生成 / 重新对齐按钮。包含基准版本的组合排在前面，无需先勾选两个版本。
• 失效批量重算：存在失效对齐时，作品列表顶部提示「N 组对齐需重新生成 · 全部重新对齐」；确认后按原对齐方向逐组重算，显示进度（i/N 与当前作品、版本对），可随时「停止」（当前批次结束后停），结束时汇总一次。只重算直接对齐，间接关联随之更新。
• 匹配统计口径：「已匹配段落 N%」仅统计基准版本一侧被算法接受的段落比例，用于衡量覆盖面，不代表对应准确。

统一阅读器

• 主窗口内阅读：检索、文献库与译本对照进入同一个阅读器，在主窗口内占满内容区，不再使用大弹窗；应用侧栏收拢为图标栏，返回按钮写明来源页面。
• 排版与段落高亮：正文改为连续段落排版（18px、行距 1.85），只在页码变化处标注页码；直接对齐的两栏之间为细实线，间接关联为虚线并在顶部说明换算关系。点击任一段落即高亮对侧对应段。
• 低置信度核对：算法给出对应但置信度低于门槛的段落旁标「!」，支持多选候选译文段保存一对多校正、标记「译本无对应」或「暂不处理」；标为无对应的段落在定位时明确返回无对应，不退回算法结果。「!」与作品页「N 处待检查」读同一条规则，状态不再脱节。
• 阅读位置：按作品保存版本对与阅读位置；刷新或重开独立阅读窗口不再丢失右栏，关闭阅读器后「继续阅读」立即准确。位置用 PDF 页序或段落序号如实表述，不冒充印刷页码。

正文范围查看与改正

• 可视化范围核验：针对自动识别可能出现的首尾偏移，作品页每一对版本新增「正文范围」入口。两书并排显示各自的开头与结尾，可按目录章节、PDF 页码或文本段序号定位；显示的是真实入库文本，不重解析源文件。两书页码彼此独立，无出版方页码的文献如实显示「页码尚未解析」。
• 独立调整与保存：两侧范围独立修改、互不干扰；结尾早于开头时就地报错并禁止提交。「保存范围并重新对齐」一次写入两端范围并强制重算当前这一对版本；「取消」不写入书库。缺少对齐计算组件时仍可查看与修改，只有提交一步禁用。
• 与分段数据绑定：人工范围按文本段序号记录，绑定两书当前的分段数据；重新解析产生新分段后，旧的人工范围不再适用，需要重新确认。

章节目录

• 阅读器工具栏新增「目录」，按原有层级展示已入库的一、二级标题，支持方向键、Enter 与 Escape。
• 点击章节高亮左栏标题，右栏按现有对齐关系定位；暂停跟随时也同步一次，之后保持暂停。没有对应位置时保留右栏原位置并说明原因。
• 目录只用已入库的标题数据，不重解析原文件、不生成虚构页码；缺少标题数据的旧文献显示空目录说明。

主程序与 MCP 组件体积缩减

• 主包体积减半：桌面主程序不再打包对齐计算数值栈，macOS ARM 实测 MEFinder.app 由 206.4 MiB 降至 100.8 MiB（约 −51%，不含 sidecar）。
• MCP sidecar 轻量化：sidecar 只读取已有对齐、不做对齐计算，同样不再携带数值栈，单个可执行文件由 77.9 MiB 降至 45.9 MiB（约 −41%），13 个 MCP 工具的行为不变。
• 对齐后内存即时释放：对齐计算改在按任务启动的独立进程中运行，任务结束进程即退出。09-19 整应用实测，一次冷对齐瞬时峰值约 1.1–1.4 GiB（全部在计算进程内），任务后整应用回落至 30–86 MiB，连续 6 个任务无累积；改动前主进程在任务后常驻 571–704 MiB。

设置页：独立计算运行时管理

• 「译本对齐」设置页新增「独立计算运行时」卡片：未安装可安装、失败可重试、有新版可升级、已装可卸载，进行中可取消；有对齐任务在跑时，升级 / 卸载会等待任务结束。
• 卸载会删除运行时及其所属的对齐模型文件，文献、已有对齐成果与人工校正都会保留。
• 自带数值栈的老用户不受打扰，卡片保持隐藏。

本地 MinerU 接口自适应

• 自适应接口代数：连接本地部署的 MinerU 时先探测 GET /v1/health，通则走 4.x 作业接口，否则回落 3.x 的 /tasks 接口；「检测连接」直接显示握手到的接口代数与版本。设置中可显式锁定协议，锁定后不静默回落。
• 坐标统一与纯净入库：4.x 的 0..1 归一化坐标换算为与既有文献一致的 1000 画布坐标入库，同时保留精确的归一化坐标供页码识别与引用定位优先使用；4.x 正文中的粗体、行内公式、链接与转义标记在入库前还原为纯正文，保证原句精确匹配不失配。
• 托管安装策略：安装与更新改为「兼容区间内取最新」，设置页新增「检查新版本」并标明当前目标来源；查不到时回落清单固定版本（当前 3.4.5），不阻塞安装；区间外的大版本明确提示缺少安装配方。已安装组件按自身回执识别与启动，避免版本误判。
• 服务端启用 API key 时，可在本地部署设置中配置，按 Authorization: Bearer 发送。

启动流程与响应优化

• 消除开窗闪烁：后端改为先于窗口启动（限时 2 秒等待），就绪后主窗口直接以正式页面开窗，不再先蓝后白；极慢冷启动超时才退回加载页，就绪后自动换页。macOS 另把网页视图底色设为主题底色，兜底路径首绘前也不露白。
• 首屏不再被全库统计阻塞：文献库与正文分别取轻量状态与逐对统计。在真实书库副本的 HTTP 诊断中，文献库排队由约 3.25 秒降到 58 毫秒、正文由约 2.17 秒降到 24 毫秒；这是接口诊断数字，不是完整的桌面启动基准。
• 云盘占位防护：索引数据库被 OneDrive 等云盘降级为「仅云端」占位文件时，启动不再假死，而是直接给出带操作步骤的错误页。

Bug 修复

对齐与正文范围

• 修复编者导论自带参考文献表被误当作全书书末、导致正文范围塌缩的问题（英文版《消费社会》此前只识别出前 13%）。现在书末副文本只在第一章之后识别；基线快照上该书的控制样本由 50/61 恢复到 57/61，其他 19 本书的正文范围不变。受影响的旧对齐显示「需重新对齐 · 正文范围识别已修正」。
• 修复正文范围提交的版本校验：同时校验两本书的分段集，重新解析后的旧段号会被拒绝；编辑一侧时保留另一侧的目录、输入和滚动位置。
• 统一人工校正的读取逻辑，消除阅读器、「!」标记与作品页统计之间「一处已改、一处未改」的不一致；重新分段后失效的校正不再计入「已处理」。
• 对齐任务只保留一份监听，消除同一次生成弹两次提示、刷两次视图的问题；阅读器里生成的对齐会立即更新作品页状态。

阅读与交互

• 修复多源段落定位时人工校正被绕过、过期请求重新打开已关闭的对照、新对齐结果未刷新链接缓存等问题；跟随模式下只移动右栏，不再把左栏拉回搜索命中。
• 修复阅读会话竞态：任务刷新期间切换文献或关闭阅读器，旧请求不再使新文献的请求失效，关闭时交回的阅读位置也不会被在途旧响应覆盖。
• 修复设置页读取对齐运行时状态时，把响应中表示「上次操作失败」的业务字段误判为请求失败的问题，恢复真实的「安装失败 / 重试」状态。
• 修复运行时安装 / 卸载后状态不刷新、取消被改写为失败、下载中途卸载留下半成品、退出后下载进程残留、维护中断后无法再计算，以及清单损坏时中断的旧运行时无法恢复等问题。

导入与解析

• 修复分段数多于 MinerU 账号数时，导入进度全程误报「等待可用的 MinerU 账号」的问题；解析调度与账号健康判定未改动，只修文案。
• 修复 MinerU 托管安装把回执与目标版本混写的问题：安装期间的配方在开始时冻结，进行中不会被「检查新版本」中途替换。

已知问题与本轮未验

• MinerU 4.x 通道只有契约证据与模拟服务端测试，尚未用真实 MinerU 4.x 做端到端解析验收；3.x 通道已在本地 MinerU 3.4.4 上全链路跑通。
• 国内镜像的真机可达性未联网验证；镜像失效时自动回退官方源，最坏情况与改动前相同。
• Windows 完整组件链与 macOS Intel 真机的安装尚未验收；x86_64 包已在 Rosetta 下通过全量回归与冒烟测试，但不替代 Intel 真机验收。
• 独立计算运行时相关的界面行为尚未在真实书库环境中完成人工验收。
• 「生成中 N%」未做：对齐计算进程只上报开始与结果，没有批次进度来源。
• EPUB 暂不支持按页跳转（只有 PDF 支持）。
• 繁简一起查时，较冷门的繁体变体仍需全库扫描，完整请求可能仍在秒级。
• E5 对齐模型仍为实验档，不作为默认；默认维持 MiniLM。
• 应用未经 Developer ID 签名与 Apple 公证，首次打开需手动允许。

下载

Windows（64 位 Windows 10 / 11）

使用方式	下载文件	SHA-256
安装版（推荐）	MEFinder-v0.5.5-windows-setup.exe	cdbbfeeffe5907cbd74dff04c66a4439565182445f7d04d0233883f91d91a371
绿色免安装版	MEFinder-v0.5.5-windows-portable.zip	85b1705353e81ea7b767bb5a890206a81512b3a0f822fa33f9291de0762cc6fd

macOS

使用方式	下载文件	SHA-256
Apple Silicon DMG（推荐）	MEFinder-v0.5.5-macos-arm64.dmg	b8f160b301fbb6e926f091ebbf0d0a036677160769d8f9ee7ab177b58c54e8a4
Apple Silicon ZIP（备用）	MEFinder-v0.5.5-macos-arm64.zip	fa85cd6fb0452e0c91fabd00e2662d6e216f44a83bace7f9c742f4b071e422ad
Intel（x86_64）DMG（推荐）	MEFinder-v0.5.5-macos-x86_64.dmg	d28bd3b7d3ad83e805becaa851c803b91c2ee3cfcf49e02230d4766238285d9c
Intel（x86_64）ZIP（备用）	MEFinder-v0.5.5-macos-x86_64.zip	af5a5f50f155cf0ba2ef6dd41cd651eafe4c0d3820291e31cc98083b83de26b3

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

构建验证

• 全量 2494 项 unittest 通过（arm64 23 项 / x86_64 28 项按条件跳过），Ruff（F 规则）零告警，前端装配指纹、主题 / 偏好快照守卫与 JavaScript 语法检查通过。
• GitHub Actions CI 的 lint、ubuntu tests、windows-tests 在 5d4f557 全绿；windows-tests 此前的红灯源于两条测试用例未关闭 SQLite 句柄，已修复，与产品代码无关。
• macOS 双架构包经官方构建流程（arm64 直接构建；x86_64 经 Rosetta 同源构建，反查主应用与 MCP 组件均为纯 x86_64、最低系统 macOS 12.0）：严格签名校验、STDIO 冒烟、ZIP 解包、DMG 挂载与拖出复制校验通过；Apple Silicon DMG 实际 95.6 MiB。
• 以上为自动化验证，不替代安装与升级的实机验收。

接口与契约

• HTTP 契约：docs/contracts/v0.5.5-http-api.json；另有 v0.5.5-translation-overview.md、v0.5.5-alignment-corrections.md、v0.5.5-body-ranges.md、v0.5.5-alignment-runtime.md。
• MCP 仍是 13 个工具，行为不变。

完整变更：v0.5.4 → v0.5.5

MEFinder v0.5.4

文献原句定位器 v0.5.4

0.5.4 是一个以「整理与修复」为主的版本：新增可选的独立阅读窗口，检索和阅读互不干扰；设置页整体重做；检索更快、导出更稳。修复方面，最重要的是生成对照期间检索直接失败的问题（真实库实测约 28% 重叠请求受影响），另有切换同步书库后组件误报未安装、关闭阅读窗口卡死等一批修复。对齐默认模型仍是 MiniLM，E5 仍为实验档。

更新内容

独立阅读窗口

• 设置 → PDF 阅读新增「独立阅读窗口」开关，默认关闭。开启后，结构化阅读和译本对照在独立的原生窗口中打开，每个窗口保留自己的文献、阅读位置和对照状态；主窗口继续检索，互不影响。
• 阅读窗口可以移动、缩放和关闭；主窗口退出时统一关闭阅读窗口并正常释放后台。
• 开关从下一次打开阅读时生效；「打开 PDF 原文」的打开方式保持不变。

设置页重做

• 整体布局重做：内容铺满窗口，不再居中留白；开关、下拉、账号、引文格式、数据备份统一为行式布局，说明文字完整显示，不再被省略号截断。
• 「阅读」与「文献检索」合并为一个分类；PDF 阅读分成「阅读窗口 / PDF 原文 / 正文排版」三小节，独立窗口开关放在最上方。
• 下拉菜单重做：支持键盘选择、带浮层动效（跟随系统「减少动态效果」设置）；滑杆重做，显示已选区间。
• 已下载的对齐模型可以删除，显示实际释放的空间；删除当前使用中的模型会提示需要重新下载才能继续生成对照，已生成的对照不受影响。
• 解析统计新增「占比」列与条形图；数据备份显示上次导出的时间。

检索

• 检索详情去掉外层卡片和四周留白，宽窄窗口都直接铺满内容区，正文可以框选复制，操作按钮固定在底部。
• 高频短词检索明显加快：全库检索「社会」这类常见短词，单次查询从约 0.4 秒缩短到约 0.02 秒（冷启动从约 2.3 秒到约 0.02 秒），命中结果与之前完全一致。

数据与资料库

• 设置 → 数据位置新增「打开已有资料库」：直接指向一份已有索引，验证后保存为下次启动的读取位置，不复制、不覆盖原库；原来的搬迁操作独立保留为「迁移当前资料库」。

架构与可靠性

以下改动不改变使用方式：

• 搜索、桌面壳层、导出三条主线完成内部拆分，各自职责与边界用测试钉死，为后续迭代铺路。
• 导出（文档包 / Markdown / EPUB）改为读取数据库的一致快照：导出过程中修改题录或删除文献，产物不再出现前后混杂的版本或空文件。
• 未安装对齐模型组件时，检索、查看已有对照和定位完全可用；生成对照前会先检查组件，缺什么在设置里明确提示，不在任务中途联网下载。
• 新增基于真实文献库的可重复性能基准（检索、两种导出、对齐期间检索四场景），后续优化以此为对照。

分发与安装

• macOS 新增 Homebrew 安装渠道：先 brew trust sabercomo/mefinder 信任第三方 tap，再 brew tap sabercomo/mefinder 后 brew install --cask mefinder，自动选择 Apple Silicon / Intel 包，新版本可被 brew upgrade 跟踪；卸载保留文献数据。应用未经公证，首次启动需在系统设置中批准一次；Homebrew 渠道要求 macOS 14 及以上（Intel 的 macOS 12–13 请手动下载 DMG）。

Bug 修复

检索与对照

• 修复生成对照期间检索直接失败的问题：此前生成译本对照时，与其重叠的检索请求会快速报失败，真实文献库实测约 28% 的重叠请求受影响；现在生成不再中断检索，期间搜索最多等待不到 0.2 秒，结果与平时完全一致，生成失败或中途取消也不会留下半成品数据。
• 修复关闭阅读窗口时整个应用可能无提示卡死的问题。
• 修复重新打开对照时总是跳回成员列表第一个版本（通常是英文版）的问题：现在按文献记住你上次选择的版本，简繁中文视为同语言；阅读中手动切换的版本保持不变。

设置与界面

• 修复 macOS 上外观模式预览卡整块消失的问题。
• 修复 MinerU 账号从未检测时显示「可用」的问题：未检测过如实显示「密钥已保存 · 尚未检测」，检测结果就地回显，修改密钥或服务地址后旧结果作废。
• 修复本地 OCR 读取失败被当作「未安装」处理的问题：状态分六种如实呈现，安装失败显示失败阶段和重试入口，未安装时不再摆放看似可用的启用开关。
• 修复「其他解析 API」模型列表按名称猜测能力、把不认识的新模型错标成「不支持图片」的问题：列表不再标注能力，模型是否支持图片输入由保存后的「测试」按钮发送真实测试图验证。
• 界面提示文案句末不再加句号。

数据与迁移

• 修复迁移资料库时复制正在使用的 WebView 缓存导致失败的问题（Windows 文件占用场景，Mac 与 Windows 共用此修复）。
• 修复 macOS 上切换 OneDrive / 同步盘书库后，本地 OCR 与对齐模型误报「未安装」的问题：组件统一保存在本机稳定目录，切换书库后自动复用已下载组件，不再重复下载。

后台与分发

• 修复内置 MCP 组件被强制结束后在系统临时目录留下累积残留的问题：现在会安全回收自己产生的临时目录，正在运行的实例受锁保护，不会被误删。
• 修复对齐模型运行库退出时的一个崩溃，并关闭该库内置的遥测上传（与本地优先原则不符）。

已知问题

• 繁简一起查时，较冷门的繁体变体仍需全库扫描，完整请求可能仍在秒级，这是下一个性能优化目标。
• 阅读器与作品版本页尚未按新设计规范改造，计划下一版本处理。
• E5 对齐模型仍为实验档，不作为默认；默认维持 MiniLM。
• 应用未做 Developer ID 公证，首次打开需手动批准。

下载

Windows（64 位 Windows 10 / 11）

使用方式	下载文件	SHA-256
安装版（推荐）	MEFinder-v0.5.4-windows-setup.exe	dc0d5c0d10d8b47b11e88db22412347cc3d80519693f30242a65ed436c959452
绿色免安装版	MEFinder-v0.5.4-windows-portable.zip	6240c91b6a503bfa707005b801a018c48c8d6a6d1b19b7461766432dace20dd7

• 从 v0.5.3 升级：推荐，修复资料库迁移并包含本版全部改动（0.5.4 迭代期间的早期 Windows 包不含后述功能，发布时会以本轮构建为准）。
• 从 v0.5.2 及更早升级：推荐，同时获得译本对照、繁简统一检索等新功能。

macOS

使用方式	下载文件	SHA-256
Apple Silicon DMG（推荐）	MEFinder-v0.5.4-macos-arm64.dmg	2a8574b451e516237f5e527797baa450fc39c0de5a6d183287768700778bbd3e
Apple Silicon ZIP（备用）	MEFinder-v0.5.4-macos-arm64.zip	9d20bf801d4db54ee62f6c7b127592af5e7edab8a6e74d1f235473889a0278b4
Intel（x86_64）DMG（推荐）	MEFinder-v0.5.4-macos-x86_64.dmg	c9518c3bae25fdf70458b25d5547f1bd74edf1b16b9fb502f3e319b9d4983b13
Intel（x86_64）ZIP（备用）	MEFinder-v0.5.4-macos-x86_64.zip	4e66b74ea0d1309e3579af8a19476b7a3f76b19902d417719d57a6764af6f6b9

• Apple Silicon 包要求 macOS 14 及以上；Intel 包要求 macOS 12 及以上。
• 每个发布文件都附带同名 .sha256.txt 校验文件；SHA-256 只能证明文件下载完整，不等同于代码签名。应用未经公证，首次打开可能需要在访达右键应用选「打开」。

构建验证

• 与 CI 一致的全量 unittest 2275 项通过（arm64 22 项 / x86_64 27 项按条件跳过），Ruff F 零告警，前端守卫与 JavaScript 语法检查通过。
• macOS 双架构包经官方构建流程（arm64 直接构建；x86_64 经 Rosetta 同源构建并反查主应用与 MCP 组件均为纯 x86_64、最低系统 macOS 12.0）：严格签名、STDIO 冒烟、ZIP 解包、DMG 挂载与拖出复制校验通过。
• 以上为自动化验证，不替代安装与升级的实机验收。

完整变更：v0.5.3 → v0.5.4

MEFinder v0.5.3

MEFinder v0.5.3

这个版本新增繁简统一检索和按页导出 Markdown，并修复了译本对照的一系列问题。

繁简统一检索

• OpenCC 查询变体现在默认开启：搜简体能命中繁体原文，反之亦然。查港台译本时，不必先在脑子里把检索词转成繁体再搜。
• 不需要的话，可在「设置 → 文献检索」里随时关闭。它只扩展查询词，不改动源文献，也不影响导出内容。

按页导出 Markdown

以前导出 Markdown 只能整本带走，但写论文时往往只引用十几页。现在在文献库里选「更多操作 → 按页 Markdown」，要哪几页就导哪几页：

• 单页写 5，连续范围写 12-18，也可以组合使用：5, 12-18, 25。
• PDF 页码可选「原书页码」或「PDF 物理页」：原书页码认 iv、v 这类印刷页标签，物理页则从文件第 1 页起算。切换选项时，界面会随即说明当前输入的数字按哪种规则计数，不用自己猜。
• 导出前会先恢复整本书的脚注关系，再只把所选正文引用到的脚注定义一并带出。
• EPUB 仍只采用出版方自己标注的页码，不会按屏幕排版去猜「一页」在哪里。

译本对照

这个版本集中修复了对照功能的几个常见问题：

• 修复 Apple Silicon 上生成对照时 CPU 拉满、整机卡顿的问题。推理时会为系统和界面留出资源，不再抢占整机性能。
• 对齐运行时按钮会变成「取消对齐」，可随时停止；停止后不会留下半成品结果。
• 长时间对齐改为后台任务。以前约一分钟后界面会误报 Load failed，其实后台仍在计算。
• 作者自己撰写的「导论／绪论／引言／Introduction」现在归入正文，不再被误判为副文本。
• 阅读器会记住每本书上次选择的对照版本。若当前结果是经第三个版本「中转」算出的，会明确提示可能有段落漏配，并可一键生成这两个版本之间的直接对照。
• 对重复页眉、中文章节标题、注释区域和信息量较低的锚点，识别更准确，跨章错配和漏配都会减少。

界面细节

• 文献库列表的徽标只标文件格式：PDF、EPUB、Word、JSON。具体使用了哪个解析器，移至详情面板的「解析方式」查看，列表因此更简洁。
• 作品组列表首次打开不再自动展开第一个作品组，所有组默认折叠，需要时再点开。

Windows 下载（64 位 Windows 10 / 11）

使用方式	下载文件	SHA-256
安装版（推荐）	MEFinder-v0.5.3-windows-setup.exe	32810fc82534c2f7a6ce439beec0726113b483bc310bb7d8426f17ac62f094f7
绿色免安装版	MEFinder-v0.5.3-windows-portable.zip	04f414fb1339d092b3133b666457c34ae4cd4e6ed8082e2034f514b2f192dd55

两个发布文件都附带同名 .sha256.txt 校验文件。SHA-256 只能校验下载是否完整，不能替代代码签名。安装版可从旧版覆盖升级，保留已导入的文献、索引和设置；绿色版需完整解压后再运行，解压不全会打不开。两个文件都内置独立 MEFinderMCP.exe，不需要另装 Python。

安装包尚未做商业代码签名，首次运行 Windows 可能弹出 SmartScreen 提示，点「更多信息 → 仍要运行」即可。

macOS Apple Silicon 下载

使用方式	下载文件	SHA-256
DMG（推荐）	MEFinder-v0.5.3-macos-arm64.dmg	b9773adcd3683176b6ac9205e3c1a24629809665a6156238d2638ed748782fdc
ZIP（备用）	MEFinder-v0.5.3-macos-arm64.zip	b293b191f5c512976c13a0be9e272c1abafb137461e62fa1e9acdeaa8218c68e

两个发布文件都附带同名 .sha256.txt 校验文件。SHA-256 只能校验下载是否完整，不能替代代码签名。

macOS Intel（x86_64）下载

使用方式	下载文件	SHA-256
DMG（推荐）	MEFinder-v0.5.3-macos-x86_64.dmg	de058f8ffb4c8bb5dd79653b4b1e7d690fcb941c553746a3dae986cd89ba9a3b
ZIP（备用）	MEFinder-v0.5.3-macos-x86_64.zip	806a12517d8cc5a2c0d0e4f8027d89845e1b1441cf24ef0fc32ea6571700426f

适用于 macOS 12 或更高版本。签名情况与 arm64 包相同（ad-hoc 签名、尚未公证），首次打开如被系统拦截，在访达中右键应用选择「打开」即可。

验证

• macOS 构建流程通过 2085 项 unittest（21 项按条件跳过）、Ruff F 检查和前端构建检查。
• Windows 安装版与绿色版基于同一提交重建，同样通过 2085 项 unittest（装 OpenCC 后仅 1 项条件跳过）、前端 node --check 语法门禁，以及打包后 MCP sidecar STDIO 冒烟与空索引 FTS5 trigram 校验。
• 主应用与内置 MCP sidecar 均确认与各自架构相符；严格签名、ZIP 解包、DMG 挂载与 checksum 检查全部通过。
• 已在实际安装的应用中验收 0.5.3 版本号、按页导出的单页示例及动态页码说明。

说明

• E5 Large 对齐模型仍属实验性功能，本版本未将其设为默认。
• 已生成的对照结果仍可正常查看；只有重新生成时才会使用当前的对齐算法。

MEFinder v0.5.2

MEFinder v0.5.2

本版本集中改进译本对照：给自动对齐加了三道检查，拦截"字面相同、含义不同"造成的错配。此前出过一批错配对照，这个版本是对 0.5.2 的重新发布，重点就是修这个问题。另外新增了实验性的 E5 Large 对齐模型（默认模型仍是 MiniLM，E5 对齐更准，愿意尝鲜的可以切换），并小幅调整了作品组管理和阅读器界面。

译本对齐

新增实验性 E5 Large 模型

• 设置里新增"译本对齐"区块，可在 MiniLM 和 E5 Large 之间选择。默认模型仍是 MiniLM，E5 Large 还在实验阶段、不作为默认；不过 E5 Large 对齐更准，追求精度的话推荐切换。MiniLM 体积小，之前已下载的可以继续用，不受影响。
• 对齐模型默认不下载，第一次生成对照时再按需下载。下载时显示已下载大小、总大小和百分比；中断后再下载，会从上次的进度继续。

三道新的错配检查

对齐算法本身没有改动，只是在生成结果的前后加了检查，结构锚点不受影响：

1. 同形异义词：原文和译文里字面相同、含义不同的词，以前可能被当成锚点，把不相干的段落连在一起；现在相似度不够的这类锚点会被直接丢弃。
2. 每章重新编号的脚注：有些书每章注释都从 1 重新数，纯数字编号以前会被误认成对应点；现在小于 100 的裸数字不再用作锚点，跨度明显不合理的锚点也会被拒收。
3. 低信息量段落：整段对照如果只靠圈号脚注块（①②③）这类内容撑起来，会降级处理，不再当作可靠对应；正文里正常的 $^{②}$ 上标引用不受影响。

升级后需重新生成对照

升级到本版后，以前生成的对照会全部失效，需要重新生成一次。模型不用重新下载，已算好的向量缓存也会复用，重新生成只是花一些计算时间。

对齐效果实测

从全部文献中随机抽取 100 条对照结果人工核对（抽样固定、可复现）：60 条完全正确，29 条基本对应，错配约 11%（统计误差范围约 6%–19%）。此前出过问题的两个案例——《消费社会》的同词异义错配、《战斗美少女》的跨章注号错配——重新生成后均确认消失。

仍有两个已知问题，尚未解决：

• 长段落密集的文献中，约一成的链接会偏到相邻段落（跟进：#18）。
• 《战斗美少女》(R9) 可用锚点太少，对照覆盖率偏低（跟进：#17）。

界面调整

• "管理作品组"弹窗重做：成员的格式标识更清楚，打开时自动刷新到最新状态。
• 双栏对照阅读器：头部改为两行布局，版本选择改为下拉框；默认按流式排版阅读，需要保留原书断行的可切回"复刻断行"。

Windows 下载（64 位 Windows 10 / 11）

使用方式	下载文件	SHA-256
安装版（推荐）	MEFinder-v0.5.2-windows-setup.exe	82984616b2bfd4a3e522fe5cdf5a892416e4a00036377345362808b1ce695167
绿色免安装版	MEFinder-v0.5.2-windows-portable.zip	b9bced7faa2a64f8edc8ec714cd7b098bf525c160711699505cb1326e4c1c401

两个发布文件都附带同名 .sha256.txt 校验文件。SHA-256 只能证明文件下载完整，不等同于代码签名。

macOS Apple Silicon 下载

使用方式	下载文件	SHA-256
DMG（推荐）	MEFinder-v0.5.2-macos-arm64.dmg	64d15638401983beac512f8c5896c3046c240c24c178ec7193c0993fc23337c3
ZIP（备用）	MEFinder-v0.5.2-macos-arm64.zip	6b09cecb6a1f3ffa4a3b00ed7d2405d07e7ab9e027c853b6522163d76c194b86

macOS 包目前为 ad-hoc 签名、尚未公证；首次打开可能需要在访达里右键应用并选择"打开"。构建时 1990 项测试全部通过，应用和内置 MCP 组件均确认为 arm64 原生。

macOS Intel（x86_64）下载

使用方式	下载文件	SHA-256
DMG（推荐）	MEFinder-v0.5.2-macos-x86_64.dmg	6742bc8041d04a143ae0fba53d16bd7dbf7b0572ad954e43748c87f0bbaf241f
ZIP（备用）	MEFinder-v0.5.2-macos-x86_64.zip	137d7d671118423bd0afb222e643d03201fd5e6c88adefd5c97241bc9f40724d

适用于 macOS 12 或更高版本，签名情况与 arm64 包相同（ad-hoc 签名、尚未公证）。构建时 1990 项测试全部通过，应用和内置 MCP 组件均确认为 x86_64 原生。

MEFinder v0.5.1

MEFinder v0.5.1

这个版本重做了作品组管理：建组、加版本、设基准版本，不用再开管理弹窗来回折腾了。跨版本对照也从「生成完就结束」往前走了一步——结果可以核对，对齐错了可以人工修正。另外，书目语言识别不准时可以手动指定，EPUB 能导出成 Markdown，还修了语言识别、解析统计刷新和弹出菜单定位的几个问题。

作品组管理

• 在文献库勾选两个以上版本，点「加入作品组 → 新建并加入作品组」，建组、加入成员、设基准版本一步完成。作品组标题优先用中文版本的书名，基准版本优先用非中文、非英文的原文版本，两处都可以再改。
• 「加入作品组」下拉直接列出现有作品组，单篇或多篇文献都能一键加入，不用先打开管理弹窗。
• 管理弹窗里的「添加版本」改成搜索后点击即加入，面板保持打开，方便连续加好几个版本。
• 还没归组的同名文献会给出一键合并建议。建议只依据规范化后的同名标题，不会猜不同语言的标题是不是同一部作品。
• 多个作品组改成各自独立的折叠面板：展开一个不会收起其他组，想全展开、全收起都行。「生成对照」区域默认折叠，成员行只留版本名和语言标签，格式和解析器信息改成鼠标悬停时才显示，列表看着干净一些。
• 生成双栏对照的版本选择换成应用内统一的下拉框，长标题会截断显示；下拉菜单改成浮层显示，不会再被滚动区域裁掉，页面滚动、窗口缩放时都会跟着按钮走。
• 文献标题显示时会清掉 Z-Library、LibGen、Anna's Archive 这类下载站附加的噪声；只改界面显示，不动题录和原文件名。

跨版本核对与 MCP

• 新增 find_parallel_passages：以已有对齐为中心，返回其他语言或版本里的多个附近候选，带前后文和定位信息，可以按目标语言或具体版本缩小范围。它不联网翻译，也不会自动写回对齐结果。
• 新增对齐修正流程：AI 助手提出修正，你用一个一次性的确认码确认之后，双栏阅读和 MCP 查询会优先采用人工修正。修正可以撤销，没确认的提案不影响现有结果。
• MCP 契约扩到 13 个工具：10 个只读、3 个写操作，写操作全部走上面的确认流程：

分类	工具	干什么用
找文献	list_documents	列出本地文献，没指定具体文献时先查它
定位与阅读	locate_quote、read_document_window	定位原句和页码；从命中位置继续读上下文
核对引文	verify_quotes、diff_quote	批量核对多条引文；逐字比对，指出漏字和改写
大意检索	search_passages	记不得原句时，按主题和问题召回相关段落
书目补全	read_bibliographic_metadata、read_bibliographic_pages	看题录缺哪些字段；读版权页原文把字段补齐
跨版本对照（本次新增）	find_parallel_passages、list_alignment_corrections	在其他语言或版本里找对应段落；查看人工修正记录
修正写操作（本次新增）	propose_alignment_correction、confirm_alignment_correction、revoke_alignment_correction	提出修正、确认生效、撤销修正

• 补齐了 Codex、Claude Code 和其他 MCP 客户端的配置、工具验证和排错说明。

书目、语言与导出

• 书目信息新增语言手动覆盖：自动识别不准时，可以手动指定简体中文、繁体中文、英语、德语、法语等语言；清掉手动值就恢复自动识别。
• 语言选择换成和界面主题一致的下拉框，和 ISBN 并排显示；EPUB 现在也有书目信息面板，可以直接查看、补全和手动编辑从 EPUB 自带元数据（OPF）里读到的内容。
• 已入库的 EPUB 可以导出成 Markdown，保留标题层级、引用、列表、代码块和出版方提供的正式页码标记；导出不会重新解析，也不会 OCR 原文件。
• 统一了界面圆角、下拉框样式和细节动效，简化了文献详情关闭按钮和解析模型的分组标题。

修复

• 修复英文正文里夹带单个俄文姓名或引文时，被误送进俄语判断、最终显示「语言未识别」的问题。现在只有西里尔字母占主导时才进入俄语识别。
• 修复刷新本地解析统计时调用了不存在的全局函数，报 renderVisionProviders is not defined、统计区域刷不出来的问题。
• 修复语言和版本的下拉菜单在页面滚动后和按钮脱节的问题；菜单滚出视野时会自动关闭。
• 修复作品组生成对照的版本菜单可能被管理弹窗裁掉的问题。

Windows 下载

Windows（64 位）	下载文件
安装版（推荐）	MEFinder-v0.5.1-windows-setup.exe
绿色免安装版	MEFinder-v0.5.1-windows-portable.zip

支持 64 位 Windows 10 / 11。安装版可从旧版覆盖升级，保留已导入的文献、索引和设置；绿色版需完整解压后再运行，解压不全会打不开。两个文件都内置独立 MEFinderMCP.exe，不需要另装 Python，也都附带同名 .sha256.txt 校验文件。

安装包尚未做商业代码签名，首次运行 Windows 可能弹出 SmartScreen 提示，点「更多信息 → 仍要运行」即可。

macOS 下载

Mac	推荐安装包	备用 ZIP
Apple Silicon，macOS 14+	MEFinder-v0.5.1-macos-arm64.dmg	MEFinder-v0.5.1-macos-arm64.zip
Intel，macOS 12+	MEFinder-v0.5.1-macos-x86_64.dmg	MEFinder-v0.5.1-macos-x86_64.zip

打开 DMG 后，把 MEFinder.app 拖进「应用程序」。覆盖升级不会删除 ~/Library/Application Support/MEFinder 里的文献、索引、设置和 API 配置。每个安装包都附带同名 .sha256.txt 校验文件。

当前 macOS 包使用 ad-hoc 签名，还没做 Apple Developer ID 签名和公证。首次启动可能需要在访达里右键应用，选「打开」。

Windows

• 安装版和绿色版两个构建入口各自跑了完整测试：均 1929 项通过，1 项按环境条件跳过。
• 两个包都要求 64 位 Python 构建，产物只含 文献原句定位器.exe 和内置 MEFinderMCP.exe 两个可执行文件；并通过打包后 MCP sidecar 的 STDIO 实际会话冒烟、空白索引的 FTS5 trigram 校验，以及绿色版 ZIP 的授权文件检查。

macOS

• arm64 原生环境和 x86_64 Rosetta 环境分别跑了完整测试：各 1929 项通过，17 项按环境条件跳过。
• 两种架构的桌面程序和内置 MEFinderMCP 都确认是对应架构的 Mach-O 可执行文件。
• 两套应用都过了严格签名检查、MCP STDIO 实际会话冒烟、ZIP 解包验证、DMG 校验与挂载，以及从 DMG 复制后的再次验证。
• x86_64 包已在 Apple Silicon + Rosetta 上完成构建和运行门禁，还没在 Intel 真机上复验。

完整变更：v0.5.0...v0.5.1

MEFinder v0.5.0

本版本让 AI 助手可以核对引文、查阅书目信息和按主题检索段落，不再限于精确定位。解析新增通用自托管模型选项，阅读器可以切换页眉页脚显示，导入文献时可以直接加入已有作品组。

MCP 文献核对：让 AI 助手帮你查证引文

• 把一段引文交给 AI 助手，它可以调用 verify_quotes 在已导入的文献中逐条核对，返回每条引文是否找到原文、在哪一页、原文与引文的差异。diff_quote 进一步逐字比较引文与原文，方便发现漏字、改写或版本差异。
• read_bibliographic_pages 让 AI 助手按页读取正文，read_bibliographic_metadata 提取题名、作者、出版信息等书目元数据，适合批量整理参考文献。
• search_passages 提供按主题和问题的段落检索。之前的工具只能精确定位已知引文，现在可以问“这本书里关于某某概念说了什么”，AI 助手会召回相关段落。
• MCP 工具契约更新到 0.5.0。Windows 安装版和绿色版继续内置独立 MEFinderMCP.exe，不需要另装 Python。

MCP 工具供 Claude、ChatGPT 等支持 MCP 的 AI 助手调用，不是应用界面里的按钮。这些工具只负责在已导入的文献中定位和返回原文，不提供问答、总结或翻译等生成功能。配置方法见项目 README 的 MCP 部分。

解析、阅读与文献库

• 新增通用自托管模型解析选项：如果你在本地或内网部署了兼容 OpenAI 接口的模型服务，现在可以直接填入地址和模型名称来解析文献。本地无鉴权的服务可以留空 API Key。
• 结构化阅读器新增页眉页脚显示切换——有些文献的页眉页脚包含有用信息，现在可以选择显示或隐藏，同时修复了阅读器的样式和状态恢复。
• 文献导入后弹出的确认界面可以直接选择加入已有作品组，不用再回到文献库重新勾选。

架构改进

• Windows 和 macOS 四个构建入口统一运行完整测试套件，以后新增的测试会自动进入发布门禁，不会因为忘记加到打包脚本而漏掉。
• 整理了内部模块边界，拆分了数据库备份、索引检查等职责；前端六个主要脚本收敛了全局作用域，减少意外的变量冲突。
• 新增 push/PR 持续集成，提交和合并请求会自动跑测试。

下载

Windows（64 位）

使用方式	下载文件
安装版（推荐）	MEFinder-v0.5.0-windows-setup.exe
绿色免安装版	MEFinder-v0.5.0-windows-portable.zip

• 支持 64 位 Windows 10 / Windows 11。安装版支持从 v0.4.9 覆盖升级并保留用户文献、索引和设置。
• 绿色版需要完整解压后运行。两个 Windows 文件均附带同名 .sha256.txt 校验文件。
• Windows 安装版与绿色版构建入口各自通过 1897 项测试，1 项按条件跳过。安装包尚未做商业代码签名，Windows 可能显示 SmartScreen 提示。

macOS（Apple Silicon）

使用方式	下载文件
DMG 安装（推荐）	MEFinder-v0.5.0-macos-arm64.dmg
ZIP 免安装	MEFinder-v0.5.0-macos-arm64.zip

macOS（Intel）

使用方式	下载文件
DMG 安装（推荐）	MEFinder-v0.5.0-macos-x86_64.dmg
ZIP 免安装	MEFinder-v0.5.0-macos-x86_64.zip

• DMG 打开后拖入应用程序文件夹即可使用。ZIP 解压后直接运行。
• 首次打开时 macOS 会提示”未知开发者”，需要在系统设置 → 隐私与安全性中点击”仍要打开”。
• 所有文件均附带 .sha256.txt 校验文件。