버전 히스토리

Baram은 Git과 무관하게 동작하는 자동 파일 버전 관리를 내장하고 있습니다. Git을 쓰지 않아도 작업에 안전망이 생깁니다.

동작 방식

Baram은 워크스페이스에서 바뀐 .md 파일의 스냅샷을 주기적으로 저장합니다. 마지막 스냅샷 이후 실제로 바뀐 파일만 담으므로 저장 공간을 아낍니다.

버전 히스토리 사이드바

활동 표시줄(왼쪽 사이드바)의 시계 아이콘을 클릭하면 버전 히스토리 패널이 열립니다.

패널은 모든 스냅샷의 타임라인을 보여 줍니다.

• ● 자동 스냅샷(타이머가 자동으로 만든 것)
• ★ 수동 스냅샷(사용자가 만든 것, 라벨을 붙일 수 있음)
• 항목마다 시간, 종류, 파일 개수, 총 크기가 보입니다

Diff 보기

1. 타임라인의 스냅샷을 클릭해 파일 목록을 봅니다
2. 파일 이름을 클릭하면 그 스냅샷 버전과 현재 파일을 한 줄씩 비교합니다
3. 추가는 초록, 삭제는 빨강으로 표시됩니다

파일 복원

1. 타임라인에서 스냅샷을 고릅니다
2. 체크박스로 복원할 파일을 고릅니다(또는 “모두 복원”을 씁니다)
3. 복원을 누릅니다 — Baram이 현재 상태를 자동 스냅샷으로 먼저 저장하므로 언제든 되돌릴 수 있습니다

수동 스냅샷 만들기

버전 히스토리 패널 헤더의 + 버튼을 누릅니다. 라벨(예: “리팩터링 전”)을 붙여 두면 나중에 찾기 쉽습니다. 라벨이 있는 수동 스냅샷은 자동으로 지워지지 않습니다.

설정

설정 > 일반에서 스냅샷을 조정합니다.

설정	기본값	설명
스냅샷 간격	30분	자동 스냅샷을 만드는 주기(0 = 비활성화)
최대 스냅샷 수	50	유지할 스냅샷의 최대 개수

보관 정책

공간을 아끼려고 오래된 스냅샷은 자동으로 솎아 냅니다.

• 최근 24시간 — 모든 스냅샷 유지
• 1~7일 — 시간당 최대 1개
• 7~30일 — 하루당 최대 1개
• 30일 이상 — 주당 최대 1개

라벨이 있는 수동 스냅샷은 자동으로 지워지지 않습니다. 최대 개수와 최대 저장 용량(500MB) 제한은 새 스냅샷을 만들 때 적용됩니다.

Git을 쓰는 분께

버전 히스토리는 Git과 나란히 동작하지만 서로 무관합니다. 버전 관리를 Git으로 하고 싶다면 설정에서 간격을 0으로 두어 스냅샷을 끌 수 있습니다.

---