OneReader v0.3.1 Developer Preview

OneReader v0.3.1

首个公开可下载的 macOS Developer Preview，版本 0.3.1（build 4）。

本版内容

• 全新原生资料库与专注阅读界面，统一 macOS 和 iPhone 的阅读导航、排版与阅读辅助面板。
• 支持 PDF、EPUB、Markdown、文本、代码、HTML、网页，以及文件夹和公开 GitHub 仓库；无需配置模型即可开始阅读。
• 跨类型保存阅读位置、书签、笔记和阅读历史；支持搜索和重启后恢复阅读。
• 减少 macOS 滚动过程中的重复排版与进度写入，修复 iPhone 文本、Markdown 和代码页面无法滑动的问题。
• 可选的单 Reading Agent 提供带原文证据的阅读辅助；项目采用 Apache-2.0，安装包包含第三方许可证与声明。

下载与运行

• 平台：Apple Silicon Mac，macOS 26.1 或更新版本。 下载下方 DMG 或 ZIP，解压或打开磁盘映像后将 OneReader.app 放入“应用程序”。
• 本版为 ad-hoc 签名、启用 Sandbox、尚未 notarize 的 Developer Preview，不是 Developer ID 正式发行包。首次打开可能被 Gatekeeper 拦截；如选择运行，请先核验下载来源与校验和，并参考 Apple 的安全打开说明。无需关闭系统安全保护。
• iPhone 源码和 Xcode 工程包含在仓库中，但此 Release 不包含 iOS 安装包、TestFlight 或 App Store 版本。iPad 真机验收暂缓。
• .sha256 文件用于核验下载完整性；release-manifest.json 记录源代码提交、依赖锁摘要、构建工具链、签名状态与产物摘要。

验证记录

• 合并提交：d45d73a836d200d053f8b0fbf17e118cd5896c8e，不可变 annotated tag：v0.3.1。
• main 分支完整验证：228 项测试，以及 Release 构建、依赖锁、文档、Sandbox、codesign 和 Apple 平台编译检查。
• 独立 tag 发布构建：从标签提交重新验证并生成下方产物。
• 同一实现已在 iPhone 13 Pro Max / iOS 27 beta 上通过 9 项原生布局测试和 5 项真实触控测试，覆盖滑动与终止、重启后的阅读位置恢复；这不代表所有系统版本或 iPad 均已完成真机验收。

完整合并记录