Об этом проекте

Archive Suite — это монорепозиторий из трёх нативных приложений macOS, предназначенных для историков и архивистов, работающих с десятками тысяч отсканированных страниц. Каждое приложение может работать самостоятельно, но они используют общий документированный контракт тегов и PDF (SPEC/tag-format.md) и рассчитаны на совместное применение. Archive Processor отвечает за захват, OCR и тегирование. Он фотографирует или импортирует изображения документов, выполняет OCR и записывает PDF из двух страниц с тегами, содержащий исходное изображение и выбираемый текст OCR, с тегами Finder для темы, даты, приоритета, цвета и состояния прочтения. Он включает компаньоны для захвата на iPhone и Android (Live Capture) и управляемое использование собственных ключей OCR Gemini или Mistral. Archive Reader охватывает поиск, чтение и триаж. Он обнаруживает файлы прямым обходом папки архива, а не через Spotlight, поэтому устаревший индекс не может скрыть файлы; в README указано примерно 100 тыс. PDF примерно за 10 секунд с мгновенным тёплым стартом из локального кэша, поддерживаемого в актуальном состоянии через FSEvents. Он предлагает хронологическую навигацию, фильтрацию по теме, приоритету и состоянию прочтения, полнотекстовый поиск, просмотрщик с двумя панелями изображения и OCR, безопасное редактирование тегов и триаж Read/Unread одним нажатием клавиши. Archive Notes обеспечивает заметки с приоритетом происхождения: заметки и выдержки сохраняют устойчивую ссылку обратно на точную исходную страницу, которая переживает перенос компьютера, а также ссылки Zotero, папки, умные папки, репликацию и полнотекстовый поиск, рассчитанные на 100 тыс. заметок и 2 млн слов. В README заявлена гарантия неприкосновенности файлов: Archive Reader никогда не удаляет, не перемещает, не переименовывает и не изменяет байты или расположение файла; единственное изменение, которое он вносит, — это теги macOS Finder, проходящие через единственный проверяемый модуль записи как намеренное, подтверждённое и обратимое действие. Установка в настоящее время возможна только сборкой из исходного кода; более ранние DMG были приватными и отозваны, публичного релиза пока нет. Сборки используют XcodeGen (project.yml является авторитетным, .xcodeproj генерируется и игнорируется git), с диспетчером launch.sh для reader, processor или notes, требующим macOS 14+, Xcode 16 и xcodegen через Homebrew. Диспетчер test-smoke.sh запускает модульные тесты ArchiveCore без графического интерфейса и бесплатно, с опциональными ветками приложений; ветка Processor выполняет два небольших запроса OCR. LAN- и USB-транспорты Live Capture не требуют настройки, тогда как опциональный ретранслятор Google Drive для ограниченного Wi-Fi требует созданного пользователем клиента OAuth, привязанного к имени пакета и ключу подписи приложения. Проект описывается как рабочий инструмент, созданный для собственного архива одного историка и опубликованный для возможного повторного использования, а не как поддерживаемый продукт; его сопровождает ИИ-агент без CI. Известные ограничения записаны в KNOWN_ISSUES.md каждого приложения, включая принятую, неисправленную слабость в LAN-транспорте Live Capture. Лицензия — MIT.