클라우드 버전과 로컬 캐시
원본 데이터의 기준, 저장 및 업로드 순서, 이미지의 클라우드 전송, 로그아웃 상태에서 지원되는 기능을 다룹니다.
원본(마스터) 데이터와 캐시의 기준
일반 무료 계정의 프로젝트는 기기에 저장되며 로그인만으로 업로드되지 않습니다. 세 유료 플랜 모두 유효 기간 중 클라우드 프로젝트 수가 무제한입니다. 유효한 구독 또는 기록된 Global 레거시 이용 권한이 있으면 생성·가져오기·열기를 한 현재 프로젝트의 동기화를 자동 시작하고 본문·이미지·부속 기록을 완전히 업로드합니다. 로컬 사본은 유지하며 열지 않은 다른 프로젝트는 검색하거나 업로드하지 않습니다. 웹은 현재 브라우저의 IndexedDB를, 데스크톱은 로컬 폴더와 SQLite를 사용합니다. 프로젝트 수 무제한은 저장 용량 무제한을 뜻하지 않으며 파일 및 업로드 크기 제한은 적용됩니다.
클라우드에 연결된 프로젝트를 열 때 시스템은 다음 순서로 검증을 실행합니다.
- 먼저 프로젝트 목록의 요약 정보와 버전을 대조합니다. 클라우드에 변경이 없고 로컬에도 대기 중인 편집이 없다면 전체 다운로드를 건너뛰고 즉시 집필을 시작합니다.
- 클라우드에 최신 업데이트가 있고 로컬 상태가 깨끗하다면(대기 중인 수정 없음), 최신 원고를 다운로드하여 로컬 캐시를 갱신합니다. 데스크톱 앱은 이어 설계 파일과 파생 데이터를 디스크에 다시 씁니다.
- 로컬에 아직 업로드되지 않은 편집 내용이 남아 있고(디바운스 350ms 동안 아직 디스크에 기록되지 않은 편집 포함) 클라우드에도 새로운 버전이 생성되어 있다면 충돌 상태로 진입하며 양측 복사본을 모두 안전하게 보존합니다.
자동 동기화와 프로젝트 AI 전 버전 확인은 현재 웹 버전 기준입니다. 데스크톱은 해당 기능을 지원하는 클라이언트가 필요하며 구버전의 동작은 다를 수 있습니다.
로컬 저장과 클라우드 업로드의 순서
모든 편집은 네트워크를 기다리지 않고 먼저 로컬에 저장됩니다. 클라우드 권한이 유효하면 저장된 변경을 모아 백그라운드에서 업로드하며, 키 입력마다 즉시 전송하지는 않습니다. 네트워크 오류가 로컬 저장을 되돌리지 않으며 권한이 유효하면 재연결 시 최신 원고로 재시도합니다. 권한 만료 또는 권한 확인 실패 시 업로드만 일시정지하고 로컬 집필은 계속됩니다.
- 저장 알림은 로컬 저장 완료와 클라우드 동기화 완료를 구분합니다. 로컬 저장 성공이 업로드 완료를 뜻하지는 않습니다. 일상적인 저장과 백그라운드 동기화에서는 알림을 반복하지 않으며 오류와 복구 시 따로 안내합니다.
- 열려 있는 연결 프로젝트는 창이 다시 포커스를 받을 때와 매 60초 요약 하트비트를 통해 동기화 상태를 조정합니다. 백그라운드 탭에서는 타이머가 작동하지 않으며 다른 프로젝트로 전환하거나 닫으면 즉시 정지합니다. 하트비트가 타이핑 중인 원고를 몰래 바꿔치기하지 않습니다.
- 프로젝트 대화의 매 턴, 일회성 스킬, 윤문, 이미지 작업, 가져오기 분석 및 자동 유지보수는 먼저 클라우드 권한과 최신 로컬 내용의 동기화 완료를 확인합니다. 오프라인·충돌·동기화 실패 시 해당 AI 작업을 중단합니다. 크레딧 팩만으로는 클라우드 권한이 부여되지 않습니다. 프로젝트 생성 전 시작 흐름과 비용 견적만 조회하는 작업은 별도로 처리합니다.
이미지 파일의 클라우드 업로드 방식
클라우드로 업로드할 때 본문과 자료에 포함된 긴 data-URL 이미지는 내용 기반 주소 지정(Content-addressed) Blob 데이터로 자동 분할됩니다. 동일한 이미지는 전체 클라우드에 단 한 번만 저장되고 한 번만 전송되며, 프로젝트 JSON에는 가벼운 참조 링크만 유지됩니다. 프로젝트를 열고 정합성을 맞출 때 이 참조 링크로부터 이미지를 복원하여 로컬 캐시에 전달합니다. 처음으로 프로젝트를 클라우드에 올릴 때도 동일한 경로를 거칩니다. 이미지 업로드가 완료되지 못하면 방금 생성된 클라우드 프로젝트는 휴지통으로 이동하고 로컬 링크를 맺지 않으므로 불완전한 미완성 프로젝트가 남지 않습니다.
- 다운로드할 수 없는 이미지 참조는 임의로 삭제되지 않고 동기화 오류 상태를 붙인 채 원고 안에 그대로 유지됩니다.
- 단일 이미지의 원시 크기가 20MB를 초과하거나 이미지를 분리한 후에도 본문 크기가 32MB를 초과하는 경우 오류로 표시되며 동일한 콘텐츠를 무한 반복 재전송하지 않습니다. 이런 이미지는 크기를 줄이거나 분할하시기 바랍니다.
로그아웃 및 오프라인 상태에서의 동작
오프라인에서 집필한 내용은 로컬에 저장되며, 클라우드 이용 권한이 유효한 동안에는 다시 연결될 때 업로드됩니다. 권한이 만료되어도 기존 작품은 삭제되지 않습니다. 로컬 편집, 저장, 내보내기는 계속할 수 있으며, 기존 클라우드 프로젝트도 열람, 내보내기, 삭제할 수 있습니다. 구독을 갱신하면 동기화를 재개하기 전에 양쪽 버전을 확인합니다. 클라우드 프로젝트가 삭제되면 로컬 링크만 제거되고 작품 자체는 기기에 그대로 남습니다.
제한 사항 및 문제 해결
- 동기화는 필드 단위의 3방향 자동 병합이 아닌 전체 콘텐츠 버전 대조 방식으로 처리됩니다. 그렇기 때문에 충돌 발생 시 시스템이 임의로 자동 병합하지 않고 양측 버전을 모두 보존하는 방식을 취합니다.
- 동기화 오류가 발생하면 페이지와 로컬 프로젝트를 유지하고 사이트 데이터를 지우지 마세요. 오류 사유를 확인하고 네트워크나 이용 권한이 복구된 뒤 다시 시도하세요.
- 기기를 바꾸기 전에 현재 프로젝트의 동기화 완료를 확인하고 같은 계정으로 클라우드 버전을 여세요. 로컬 전용 프로젝트나 미전송 변경은 먼저 .quill.json 팩으로 내보내며, 브라우저 저장소 복사로 이전하지 마세요.
충돌 발생 시 내용 복구 방법은 충돌 복사본 문서를, 백업 및 마이그레이션은 프로젝트 팩 내보내기 및 가져오기 문서를 참고하시기 바랍니다.