Repository navigation
Paperico 1.1.0
Paperico v1.1.0
发布日期:2026-10-07。App build 11。需要 Apple Silicon Mac 和 macOS 26 或更高版本。
1.1.0 是一个收敛版本:把 1.0.x 留下的多处同一不变量实现收拢到各一处,并补齐唯一明显缺失的能力(论文元数据识别)。不新增阅读器形态,不改渲染管线,不动凭据体系。
新增
- 论文元数据自动识别:解析完成后从原文出版信息中识别 DOI / arXiv ID,命中 DOI 时查询 Crossref、命中 arXiv 时查询其 Atom 接口,自动补全作者、年份、期刊。此前这些字段建库时为空且全仓无写入点,论文卡片与 MetaCard 的对应渲染分支一直是空的。
- 识别失败静默降级,绝不阻塞解析与翻译;查询各有 8 秒硬超时。
- 没有 DOI / arXiv 的论文行为完全不变:不新增等待、不新增错误态。
- 你手改过任意元数据字段后(
meta_source记为manual),自动识别不再覆盖你的值。
- 按 DOI / arXiv 去重:解析完成后从原文识别 DOI / arXiv,在进入模型分析前完成同标识符去重——同一篇论文的预印本与正式版字节不同、SHA-256 不同,此前会被当作两篇论文入库,现在会被识别为重复并指向已有论文。
- MCP
brief资源:外部 Agent 可先读一份压缩上下文(逻辑链 6000 字符预算、方法索引Top-40,§章节标题恒留),需要原文时再读blocks。此前 MCP 端直接返回全量 Block,只有 6 MiB 上限兜底。它与 App 内对话共用同一套压缩实现(不是另写一份)。 - 未引用文件报告:库管理页新增「未引用文件」,列出磁盘上存在但索引里没有对应记录的文件(永久删除中途失败、旧版残留、手工拷入),显示路径、体积与类型。默认只报告不删除;删除需勾选并二次确认,逐项执行、失败可重试。
变更
- 本地 MinerU 解析改为串行(同一时刻只解析一篇)。本地服务就是这台机器上的同一个实例,并发提交两份只会互相拖慢;云端解析与模型调用保持 2 并发不变。批量导入本地论文时总耗时会变长,这是有意的取舍。
- 论文库索引 schema 升到 v2(新增
doi/arxiv_id/meta_source)。升级是单向的:1.1.0 写过的库 1.0.x 打不开,会收到明确的「请升级」提示。- 原因:1.0.x 虽能读懂新字段,但写回时会静默丢弃它们——降级会悄悄丢数据。显式拒绝比静默损坏好。
- 首次打开旧库时会在迁移前生成
library.json.bak-v1-<时间戳>备份并保留;迁移失败则保留原文件,不会进入半迁移状态。 - 迁移逻辑只有一个入口(
LibraryIndexMigrations),新增字段只允许在那里落。
开发者可见
- 新增真实论文 opt-in 解析回归(
PAPERICO_E2E_PDF_DIR)和已分析库副本检查(PAPERICO_E2E_LIBRARY_DIR),env 缺失时 skip,已配置服务的实际失败会让测试失败。macos/scripts/verify_real_pipeline.sh另行验证真实 App 上传与全管线、三篇排队及元数据落盘;需要显式配置 MinerU 和 LLM,使用隔离库,凭据只在内存中保留。真实 PDF 与解析产物不入仓库。 - 新增磁盘契约 fixture 与 MCP 契约快照(
UPDATE_SNAPSHOT=1刷新)。刷新快照必须在提交信息里说明契约为何变化,见CONTRIBUTING.md。
安装与升级
- 数据目录
Application Support/Paperico/结构不变:论文库、PDF、笔记、对话、方法分组全部保留。 - 无需任何手工操作。首次打开 1.0.x 的论文库时会自动迁移,并在同目录留下一份
library.json.bak-v1-<时间戳>。 - 从 1.1.0 降级回 1.0.x 会被明确拒绝。
- 新解析的论文会识别元数据;已完成旧论文的元数据不会在启动时自动回填。
- 若旧版保存的附录没有译文,可以在阅读器选择「重新翻译」生成完整结果。
发布前修复
- 保留首页含 DOI / arXiv 的页眉、页脚出版信息,避免解析器将标识符提前丢弃。
- arXiv 改用 HTTPS;元数据查询拒绝非成功 HTTP 状态,并以总时长限制持续流式响应。
- 保留合法 DOI 内的括号,正确编码 URL 保留字符。
- 同一次库操作内登记标识符与判断重复,防止并发论文互相判重;重复记录不会阻塞已有论文重试。
- 修复符号链接路径(包括 macOS 的
/var→/private/var)导致下载解包后清单路径失效。 - 修复真实回归的空库永久跳过、解析失败被误记为 skip,以及图表/公式译文检查使用错误字段。
- 中英文 README 下载版本与发布说明链接同步为 1.1.0。
- 论文卡片年份按年份显示,修复新元数据使
2026被显示为2,026的格式问题。
验证
swift test --package-path macos:212 个测试,0 失败,3 个 opt-in 默认跳过(202 个核心、10 个 MCP;含索引迁移、元数据五路径、并发判重与重试、总时长超时、编排顺序、brief预算、孤儿报告与误删防线、降级拒绝、时间戳定宽、契约快照)。已验证故意重命名一个
MCP 工具会让快照测试变红。- 完整 App target 编译通过(Debug / Release);8 个脚本测试通过(1 个 opt-in 跳过)。
真实环境验收
- 测试论文通过生产
PapersStore.upload → PaperPipeline导入,观察到本地解析峰值为 1、等待队列峰值为 2;均完成并持久化 DOI、作者、年份和期刊。一次模型段落 ID 错误被拒绝保存,手动继续后复用前五段,仅生成剩余内容,不重新上传或解析。 - 两篇真实 PDF 解析、三篇完成库的 sidecar 指纹与译文检查、外部客户端检查均通过,三项 opt-in 0 跳过。
- Release App 使用隔离真实库确认论文卡片作者/年份与 MetaCard 期刊;原用户库在验收后恢复。
- 外部 Python 进程通过生产 MCP HTTP 服务读取真实库的
brief→blocks,成功追溯 299 个原文块。 - Release DMG 可挂载并启动 App;内部版本为 1.1.0 / 11,ad-hoc 签名与四项 Sandbox/MCP 权限保留,同时提供 SHA-256 校验文件。本包沿用现有分发方式,未做 Developer ID 签名或 Apple 公证。