Swallow v0.1.0 — macOS Apple Silicon 미리보기

Swallow v0.1.0 — macOS Apple Silicon 미리보기

macOS Apple Silicon 미리보기 릴리스: 로컬 ad-hoc 서명으로 리소스 무결성 오류를 수정했습니다. 2026-10-18에 Chrome으로 새로 받은 DMG의 해시·자동 격리 속성을 확인하고 Applications 설치·macOS 앱별 허용·첫 학습·종료 후 재실행 검증을 마쳤습니다. 실제 설치 앱의 PDF 표시·한영 OCR·3회 실행 보존도 통과했습니다. Developer ID 서명·Apple 공증이 없는 미리보기이므로 아래 설치·보안 안내를 확인하세요.

원문을 작은 부분부터 읽고, 내 답변과 요점노트를 남기는 무료 오픈소스 학습 앱의 첫 macOS 미리보기 설치본입니다. 모든 기능을 무료로 제공하며 로그인이나 후원 없이 시작할 수 있습니다. 후원 접수는 아직 활성화하지 않았습니다.

다운로드할 파일

• Swallow-0.1.0-macOS-arm64-unsigned.dmg — Apple Silicon(M1 이후 M 시리즈)용 설치본. 약 149 MB(142 MiB).
• INSTALL-macOS-ko.md — 한국어 설치·보안 경고·첫 학습·백업 안내.
• SHA256SUMS.txt — DMG의 SHA-256 확인 값.
• BUILD-INFO.json — 검증된 최종 소스 커밋·실제 빌드 경위·버전·최소 대상·DMG 확인 값.

GitHub가 표시하는 Source code (zip)·Source code (tar.gz)는 설치본이 아닙니다. 이 릴리스의 Assets에서 설치본과 확인 파일을 받을 수 있습니다.

지원 환경

• 최소 대상: macOS 15.0 이상 / Apple Silicon arm64.
• 실제 검증: macOS 15.6.1 / M1 Pro. macOS 15.0 기기·다른 기기와 OS 버전·Intel Mac·Windows는 검증하지 않았습니다.
• 설치본 실행에는 소스 폴더·Node·npm·Xcode가 필요 없습니다. Ollama는 선택 기능입니다.

설치와 첫 실행

1. DMG를 열고 Swallow.app을 Applications로 드래그합니다.
2. DMG를 추출하고 응용 프로그램 → Swallow를 엽니다.
3. 개발자 확인 또는 공증 관련 경고는 아래 안내를 읽은 뒤 판단하세요.
4. 짧은 예제 문서로 시작하기 → 공부 시작 → 이번 부분 원문 보기 → 한 가지 질문에 답해보기 → 답변 저장하고 요점노트 보기 → 요점노트 저장으로 첫 학습을 확인합니다.
5. ⌘Q로 종료하고 다시 열어 기록을 확인합니다.

서명·공증 관련 주의

이 미리보기에는 Swallow 개발자의 Developer ID 서명과 Apple 공증이 없습니다. 인증서 없는 로컬 ad-hoc 서명은 내부 파일 무결성을 확인하는 기술적 서명이며 개발자 신원이나 Apple의 악성코드 검사를 대신하지 않습니다. 파일명의 unsigned도 Developer ID 미서명·미공증을 뜻합니다. 출처를 확신할 수 없거나 경고가 불편하면 설치하지 마세요.

공식 저장소의 파일임을 확인한 경우에 한해, 앱을 한 번 열려고 시도하고 “악성 코드가 없음을 확인할 수 없음” 경고를 완료로 닫은 뒤 시스템 설정 → 개인정보 보호 및 보안 → 보안 → 그래도 열기를 선택할 수 있습니다. 앱 이름이 Swallow인지 확인하고, 다시 뜨는 창에서 그래도 열기 또는 열기를 선택합니다. 암호/Touch ID를 요구할 수 있고 관리되는 Mac에서는 제한될 수 있습니다. 위 시험에서는 이 절차로 실행했으며 격리 속성을 삭제하지 않았습니다. Apple 공식 안내

손상됨·컴퓨터 손상·악성코드 발견 경고 또는 계속되는 차단은 우회하지 말고 중단하세요. 공식 파일을 다시 받아 체크섬을 확인한 뒤, 재현되면 개인정보를 지운 오류를 알려 주세요. Gatekeeper 전체 해제·quarantine 삭제·설치 후 사용자의 임의 재서명을 요구하지 않습니다.

DMG와 SHA256SUMS.txt를 같은 폴더에 받은 뒤 그 폴더에서 shasum -a 256 -c SHA256SUMS.txt를 실행하면 DMG 파일명 뒤에 OK가 나와야 합니다. 체크섬은 공증이나 앱의 안전성 보증을 대신하지 않습니다.

할 수 있는 것과 현재 제한

• 텍스트·Markdown·공개 문서 링크·PDF 가져오기, 작은 부분 학습, 답변·요점노트 저장, 자유 읽기·회상·복습·검색·폴더.
• PDF 텍스트 추출·로컬 OCR·페이지 그림·메모, macOS에 설치된 음성으로 읽기, 한국어·영어 UI.
• 사용자가 준비한 Ollama 텍스트 모델 연결. 호환 API 범위는 0.12.0 / 0.24.0 / 0.40.4이며 다른 버전은 별도 확인이 필요합니다. 모델을 자동 설치하지 않습니다.
• AI 설명은 오답일 수 있으며 피드백은 자동 정오 판정이 아닙니다. 번역은 검토 전 초안이고 숫자가 포함된 일반 문장은 제한합니다. PDF 그림 자체의 AI 설명이나 원래 지면 배치 복원은 지원하지 않습니다.
• 자동 업데이트·Intel/Windows 설치본·스토어 배포는 제공하지 않습니다.

데이터와 업데이트

기본 데이터는 ~/Library/Application Support/Swallow에 저장하며 앱 자체에서 암호화하지 않습니다. 앱을 종료한 뒤 폴더 전체를 비공개 위치에 백업하세요. 개발 실행과 설치본은 같은 기본 위치를 쓰므로 동시에 열지 마세요. 수동 교체 전에 백업하고, 앱 삭제와 데이터 삭제를 구분하세요. 개인정보·백업 안내

릴리스 대상 및 검증된 소스: 0b4255250976ae5ad6c9d564535e05712d6f0c3f. 실제 DMG는 기반 커밋 677f687d758189192d93b3fa0d24bd7ac80ee64a에 당시 미커밋 패키징 변경을 적용해 만든 기존 후보입니다. 최종 커밋에서 새로 빌드한 파일은 아닙니다. 원래 빌드 소스와 최종 커밋의 150개 파일을 SHA-256으로 비교해 설치 안내인 README.md·CONTRIBUTING.md 2개만 다르고 앱·패키징 입력은 일치함을 확인했습니다. 패키징 변경은 위 최종 소스에 포함됐으며 BUILD-INFO에 빌드 경위와 해시를 보존했습니다. 자체 코드는 MIT이며 Electron/Chromium과 운영 의존성의 원문 고지도 앱에 포함했습니다.

이번 후보의 검증 결과

• 새 체크아웃에서 Node 24.22.0으로 설치, 전체 테스트 51개 파일 / 461개 테스트, PDF helper·타입 검사·프로덕션 빌드 통과.
• 기존 UI 7종(학습·폴더·업데이트·Ollama·한영·번역·PDF) 통과. AI·업데이트 응답은 합성이며 실제 Ollama 모델 품질을 다시 검증한 결과는 아닙니다.
• DMG 무결성 검사, 읽기 전용 마운트, 앱 복사, 디스크 이미지 해제 통과.
• 빌드 소스 경로가 없는 상태에서 실제 DMG의 앱을 빈 PATH·임시 저장소로 3회 실행해 첫 학습·답변/노트·PDF 추출/페이지/메모·한영 OCR·재실행 보존 확인. renderer 오류 0.
• 앱과 내부 코드의 codesign --verify --deep --strict 통과. 봉인되지 않은 앱 및 봉인 후 리소스 변조를 거절하는 회귀 검사 추가. Developer ID가 없으므로 spctl 정책 거절은 남아 있으며 이를 공증 통과로 표현하지 않습니다.
• GitHub CLI로 받은 DMG를 격리 표시를 추가해 마운트·복사·해제하고, macOS 기본 실행 경로에서 실제 앱별 허용 → 첫 학습·노트 저장 → 완전 종료 → 재실행 후 같은 답변·노트 보존 확인. 소스 폴더 없는 App Translocation 경로에서도 실행했습니다.
• 같은 검증 사본을 /Applications/Swallow.app에 새로 설치해 격리 속성·무결성 유지와 임시 저장소의 노트 보존을 확인했습니다. 기존 앱 덮어쓰기 설치는 별도 확인이 필요합니다.
• Chrome 실제 다운로드 검증 완료(2026-10-18): 사용자가 Chrome에서 새로 받은 DMG를 Finder로 검사 위치에 복사했고, 파일 크기·SHA-256·Chrome 자동 격리 속성·GitHub 출처를 확인했습니다. 이 실제 다운로드 사본을 Applications에 새로 설치해 strict 검사·앱별 허용·첫 학습·노트 저장·완전 종료·재실행 보존을 확인했습니다. 격리 속성을 추가하거나 삭제하지 않았고 Gatekeeper는 활성 상태를 유지했습니다.
• 같은 Chrome 설치 앱의 패키지 UI 검증도 3회 실행·빈 PATH·원래 빌드 소스 경로 부재·PDF 표시/메모·한영 OCR·보존까지 통과했습니다. renderer 오류는 0개입니다.
• 자체 원본 소스·사용자 데이터 제외와 라이선스 포함을 확인했습니다. 앞선 GitHub CLI·시험용 격리 검사와 이번 실제 Chrome 수신·자동 격리 검사는 별도로 수행했습니다.
• 앱 코드 기준 커밋 c7b39e0에서 전체 51개 파일 / 461개 테스트와 빌드를 통과했습니다. 최신 커밋은 README 검증 결과만 갱신하며 앱 코드는 같습니다. 공개 소스 허용 목록 147개 파일·문서 내부 링크 12개·기존 DMG와 다운로드 앱 무결성도 재확인했습니다.
• 미리보기 범위에서 검증한 결과이며 다른 Mac·macOS 버전·기존 앱 덮어쓰기 설치는 별도 확인이 필요합니다. Developer ID 서명·Apple 공증은 수행하지 않았습니다.

문제 제보: GitHub Issues. 앱 버전·macOS 버전·CPU·재현 순서·개인정보를 지운 오류를 남겨 주세요. 실제 학습 DB·PDF·토큰은 올리지 마세요. 보안 문제는 비공개 신고 안내를 이용하세요.