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