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