archive-suite

Archive Suite 是一个 monorepo，包含三款原生 macOS 应用，面向需要处理数万页扫描件的历史学家和档案管理者。每款应用都可以独立运行，但它们共享一套有文档记录的标签/PDF 契约（SPEC/tag-format.md），并且设计为配合使用。 Archive Processor 负责捕获、OCR 和打标签。它可以拍摄或导入文档图像，运行 OCR，并写出一个带标签的两页 PDF，其中包含原始图像以及可选择的 OCR 文本，同时为 Finder 标签写入主题、日期、优先级、颜色和已读状态。它包含 iPhone 和 Android 捕获伴侣应用（Live Capture），并提供引导式自带 Gemini 或 Mistral OCR 密钥的配置。 Archive Reader 负责查找、阅读和分拣。它通过直接遍历归档文件夹来发现文件，而不是依赖 Spotlight，因此过期的索引无法隐藏文件；README 提到，大约 10 万份 PDF 可在约 10 秒内完成处理，并且借助由 FSEvents 保持实时更新的本地缓存实现即时热启动。它提供按时间顺序导航、按主题、优先级和已读状态过滤、全文搜索、图像加 OCR 的双栏查看器、安全的标签编辑，以及一键完成已读/未读分拣。 Archive Notes 提供来源优先的笔记功能：笔记和摘录会保留指向确切源页面的持久链接，即使移动电脑后仍然有效，此外还支持 Zotero 引用、文件夹、智能文件夹、复制和全文搜索，设计目标为 10 万条笔记和 200 万词。 README 声明了一项不可替代文件保证：Archive Reader 从不删除、移动、重命名或更改文件的字节或位置；它唯一做出的更改是 macOS Finder 标签，并且通过单一受审计的写入器执行，作为一项有意、经过验证且可逆的操作。 目前安装仅支持从源码构建；此前的 DMG 为私有并已撤回，尚未发布公开版本。构建使用 XcodeGen（project.yml 是权威来源，.xcodeproj 为生成文件并已加入 gitignore），并提供 launch.sh 调度器用于 reader、processor 或 notes，要求 macOS 14+、Xcode 16 以及通过 Homebrew 安装的 xcodegen。test-smoke.sh 调度器可以无头且免费地运行 ArchiveCore 单元测试，并带有可选的应用通道；Processor 通道会发起两次小型 OCR 请求。Live Capture 的局域网和 USB 传输无需设置，而针对受限 Wi-Fi 的可选 Google Drive 中继则需要用户创建 OAuth 客户端，并绑定到应用的包名和签名密钥。 该项目被描述为一个为某位历史学家自己的档案而构建的实用工具，发布出来是为了可能的复用，而不是作为受支持的产品；它由 AI 代理维护，没有 CI。已知限制记录在每个应用的 KNOWN_ISSUES.md 中，包括 Live Capture 局域网传输中一个已接受但未修复的弱点。采用 MIT 许可证。