archive-suite

Archive Suite는 수만 페이지의 스캔 문서를 다루는 역사가와 기록 보관가를 위해 설계된 세 가지 네이티브 macOS 애플리케이션의 모노레포입니다. 각 앱은 독립적으로 실행될 수 있지만, 문서화된 태그/PDF 규약(SPEC/tag-format.md)을 공유하며 함께 사용하도록 설계되었습니다. Archive Processor는 캡처, OCR 및 태그 지정을 처리합니다. 문서 이미지를 촬영하거나 가져오고, OCR을 실행하며, 원본 이미지와 선택 가능한 OCR 텍스트가 포함된 태그가 지정된 양면 PDF를 작성하고, 주제, 날짜, 우선순위, 색상 및 읽기 상태에 대한 Finder 태그를 추가합니다. iPhone 및 Android 캡처 동반 앱(Live Capture)과 사용자 제공 Gemini 또는 Mistral OCR 키를 위한 안내식 설정을 포함합니다. Archive Reader는 찾기, 읽기 및 분류를 다룹니다. Spotlight에 의존하지 않고 아카이브 폴더를 직접 탐색하여 파일을 발견하므로, 오래된 인덱스가 파일을 숨길 수 없습니다. README는 약 10초 안에 약 10만 개의 PDF를 처리하며, FSEvents로 실시간 유지되는 로컬 캐시 덕분에 즉시 워밍 스타트가 가능하다고 언급합니다. 연대순 탐색, 주제·우선순위·읽기 상태별 필터링, 전체 텍스트 검색, 양면 이미지 및 OCR 뷰어, 안전한 태그 편집, 한 번의 키 입력으로 읽음/읽지 않음 분류를 제공합니다. Archive Notes는 출처 우선 메모 작성 기능을 제공합니다. 메모와 발췌문은 컴퓨터를 이동해도 유지되는 정확한 소스 페이지에 대한 영구 링크를 유지하며, Zotero 참조, 폴더, 스마트 폴더, 복제 및 전체 텍스트 검색을 포함하고, 10만 개의 메모와 200만 단어를 처리하도록 설계되었습니다. README는 대체 불가능한 파일 보장을 명시합니다. Archive Reader는 파일의 바이트나 위치를 삭제, 이동, 이름 변경 또는 변경하지 않으며, 유일한 변경은 macOS Finder 태그에 대한 것으로, 단일 감사된 작성자를 통해 의도적이고 검증 가능하며 되돌릴 수 있는 작업으로 처리됩니다. 설치는 현재 소스에서 빌드하는 방식만 지원됩니다. 이전 DMG는 비공개였으며 회수되었고, 공개 릴리스는 아직 게시되지 않았습니다. 빌드는 XcodeGen을 사용하며(project.yml이 권위 있고, .xcodeproj는 생성되어 gitignore됨), reader, processor 또는 notes용 launch.sh 디스패처를 포함하며, macOS 14+, Xcode 16 및 Homebrew를 통한 xcodegen이 필요합니다. test-smoke.sh 디스패처는 ArchiveCore 단위 테스트를 헤드리스로 무료로 실행하며, 선택적 앱 레인을 지원합니다. Processor 레인은 두 개의 작은 OCR 요청을 만듭니다. Live Capture의 LAN 및 USB 전송은 설정이 필요 없지만, 제한된 Wi-Fi용 선택적 Google Drive 릴레이는 앱의 패키지 이름과 서명 키에 바인딩된 사용자 생성 OAuth 클라이언트가 필요합니다. 이 프로젝트는 한 역사가의 개인 아카이브를 위해 구축된 작업 도구로 설명되며, 지원 제품이 아닌 재사용 가능성을 위해 게시되었고, CI 없이 AI 에이전트가 유지 관리합니다. 알려진 제한 사항은 각 앱의 KNOWN_ISSUES.md에 기록되어 있으며, Live Capture LAN 전송의 수용된 미해결 약점을 포함합니다. MIT 라이선스로 배포됩니다.