업그레이드

이 페이지에서는 NeoTavern 업데이트가 전달되는 방식, 업그레이드 중 데이터에 일어나는 일, 변경 사항을 확인하는 방법을 설명합니다.

업데이트 동작 방식

NeoTavern은 핵심 앱, 플러그인, 테마를 별도의 단위로 취급하며, 각각 독립적으로 업데이트됩니다.

• 핵심 업데이트는 애플리케이션 자체를 교체하며 데이터 디렉터리는 건드리지 않습니다.
• 플러그인 및 테마 업데이트는 앱의 각 관리자를 통해 이루어지며, 검토 없이 자동으로 활성화되지 않습니다.
• 모든 설치는 원자적입니다. 새 버전이 한 단계로 이전 버전을 교체하며, 실패한 업데이트를 롤백할 수 있도록 이전 버전이 보관됩니다.
• 패키지 무결성은 체크섬으로 검증되며, 공식 카탈로그는 그 위에 서명을 추가할 수 있습니다.

업데이트에 Git, npm, 터미널이 필요하지 않습니다. 앱을 일반적인 방식으로 설치했다면 설치했던 것과 같은 방식으로 업데이트합니다.

업그레이드 중 데이터 안전

• 업데이트는 사용자 파일을 직접 수정하지 않습니다. 캐릭터, 채팅, 로어북, 페르소나, 설정은 설치 프로그램이 건드리지 않습니다.
• 업데이트에 데이터베이스 스키마 마이그레이션이 포함되면 마이그레이션 실행 전에 백업이 생성되며, 마이그레이션은 트랜잭션 방식으로 멱등(idempotent)합니다.
• SQLite 데이터베이스는 WAL 모드로 실행되므로 마이그레이션이나 업그레이드가 진행되는 동안에도 앱을 계속 사용할 수 있고 쓰기가 유지됩니다.
• 플러그인 또는 테마 업데이트가 실패하면 앱은 반쯤 설치된 패키지를 남기는 대신 이전 버전을 계속 사용합니다.

변경 사항 확인

변경 로그에는 모든 변경 사항이 영향과 함께 정리되어 있습니다. 업그레이드 전에 최신 항목을 훑어보세요. 호환성이 깨지는 변경에는 마이그레이션 가이드가 딸려 오고, 아직 실험적이거나 계획된 기능은 명시적으로 표시됩니다.

플러그인 및 테마 업데이트

플러그인 및 테마 섹션을 엽니다. 설치된 각 항목에는 버전, 상태, 업데이트 가능 여부가 표시됩니다. 업데이트가 새 권한을 요청하면 앱은 적용 전에 다시 명시적 동의를 요구합니다. 권한이 업데이트로 조용히 확장되는 일은 없습니다.

롤백

핵심 업데이트 중 이전 버전이 보관되므로, 새 릴리스가 문제를 일으키면 이전 버전을 다시 설치할 수 있습니다. 데이터 디렉터리는 이전 버전에서도 읽을 수 있고, 위험한 마이그레이션 전에 생성된 백업으로 UI에서 알려진 정상 상태를 복원할 수 있습니다. 데이터 및 백업을 참조하세요.