Lertaro

정보 및 업데이트 ​

정보 페이지에서는 Lertaro의 전체 컴포넌트 버전 정보, 사용자 및 시스템 데이터 디렉토리 바로가기, 온라인 업데이트 확인 및 원클릭 무음 업데이트 기능을 제공합니다. 설정 경로는 설정 → 정보입니다.

1. 컴포넌트 버전 및 프로젝트 정보 ​

상단 영역에는 Lertaro 아키텍처를 구성하는 4대 핵심 컴포넌트의 버전이 표시됩니다.

  • App 버전: 전면 WPF 사용자 인터페이스 버전.
  • Core 버전: 검색 및 인덱싱 코어 로직 라이브러리 버전.
  • Service 버전: 백그라운드 Windows 인덱싱 서비스 버전(글자 색상으로 서비스 연결 상태 실시간 반영).
  • CLI 버전: 명령줄 터미널 유틸리티 lff 버전.

하단에는 공식 웹사이트, GitHub 오픈소스 리포지토리 및 온라인 문서 센터 링크가 제공됩니다.

2. 데이터 디렉토리 및 5단계 백업 롤링 보관 ​

클릭 시 탐색기로 해당 경로를 바로 열 수 있는 두 개의 링크가 제공됩니다(폴더가 없으면 자동 생성):

사용자 데이터 디렉토리 (User Data Directory) ​

  • 저장 내용: 사용자 설정 파일(user-settings.json, plugin-settings.json), 검색 및 키워드 기록, 사용자 전용 캐시 및 보안 인증서.
  • 5단계 백업 롤링 보관: 설정을 저장할 때마다 기존 설정 파일이 user-settings.json.bak.1로 순환 백업되며 최대 .bak.5까지 유지됩니다. 오류나 시스템 충돌 시에도 최근 5회의 백업에서 안전하게 복원할 수 있습니다.

머신 데이터 디렉토리 (Machine Data Directory) ​

  • 저장 내용: 관리자 권한 서비스용 설정(machine-settings.json), 디스크 물리 인덱스 영구 캐시 및 백그라운드 서비스 로그.

저장 경로 아키텍처 ​

  • 설치형 버전: 사용자 데이터는 %LocalAppData%\Lertaro, 머신 데이터는 %ProgramData%\Lertaro에 보관.
  • 포터블 버전: 프로그램 실행 파일 옆의 Data\Users\<SID hash> 및 Data\Machine에 보관되어 완전한 격리형 무설치 환경 지원(포터블 데이터 격리 안내 참고).

데이터 디렉토리 이동(심볼릭 링크 및 정션) ​

  • 지원됨: 사용자 데이터 디렉토리(설치형 버전은 %LocalAppData%\Lertaro, 포터블 버전은 <설치 경로>\Data\Users)는 심볼릭 링크나 정션으로 다른 로컬 파티션이나 다른 로컬 디스크로 옮길 수 있습니다. 시작할 때 Lertaro가 그 링크 체인을 실제 디렉토리로 해석하고, 이후에는 그 실제 디렉토리를 읽고 씁니다.
  • 로컬 고정 디스크만 지원: 링크 대상은 로컬 고정 볼륨이어야 합니다. 네트워크 위치나 이동식 볼륨을 가리키는 링크는 시작 시 이유와 함께 명확히 거부하며, 다른 곳에 조용히 기록하지 않습니다.
  • 데이터 루트 아래의 링크는 계속 거부: 데이터 디렉토리 내부의 하위 디렉토리는 링크일 수 없습니다. 실행 중 교체된 링크가 쓰기를 다른 곳으로 돌릴 수 있기 때문입니다. 이는 보안 경계이며 설정 항목이 아닙니다.

3. 업데이트 확인 및 원클릭 업데이트 ​

  • 업데이트 확인 버튼: 온라인 리포지토리에 새 버전을 질의하고 상태를 버튼에 표시("업데이트 확인 중..." → "최신 버전입니다" 또는 새 버전 안내).
  • 새 버전 발견 시 업그레이드 방식:
    • 무음 자동 업데이트 —— 백그라운드에서 다운로드 후 덮어쓰기 업데이트를 수행하고 완료 후 자동 재시작.
    • 다운로드 페이지로 이동 —— 기본 브라우저로 GitHub Releases 페이지를 열어 수동 다운로드.
  • 권한 안내: 표준 사용자 계정에서 백그라운드 서비스를 재시작할 수 없는 경우 수동 다운로드 페이지로 안내하는 배너가 표시됩니다.

4. 플러그인 설정 및 설정 백업 ​

네이티브 매개변수는 user-settings.json 옆의 plugin-settings.json에 저장되며 각 파일은 최대 다섯 단계의 순환 백업을 유지합니다. 이전 내장 매개변수는 한 번만 이전합니다. 전체 설정 ZIP에는 두 파일, 캘린더 데이터, Flow 설정이 포함됩니다. 실행 가능한 Flow 플러그인 파일은 명시적으로 포함해야 합니다. 현재 플러그인 설정을 옮길 때 주 설정 파일만 복사하지 마세요.

동기화 프로그램이 백업 대상을 일시적으로 점유하면 복구 가능한 전송 오류는 현재 설정을 보존하고 앱을 정상적으로 엽니다. 실행 잠금은 포터블 설치에서도 동기화 데이터 외부인 %LocalAppData%\Lertaro\RuntimeLocks에 둡니다. 롤백을 완료하지 못하면 일부만 복원된 설정에서 플러그인을 시작하지 않습니다.