OV 사용자 가이드

OV의 주요 기능을 한 번에 훑어볼 수 있는 사용자 매뉴얼입니다. 앱 안에서도 동일한 가이드를 우측 레일 ? 버튼 → "외부 문서" 또는 사이드바의 starter 노트(Welcome, 단축키, 마크다운, 캘린더, 보안)에서 볼 수 있어요.

1. Vault — 노트를 저장하는 폴더

OV의 모든 노트는 로컬 마크다운 파일입니다. Vault는 그 파일들이 모여 있는 폴더 한 개를 가리켜요.

기본 vault: 첫 실행 시 ~/Documents/OV 폴더가 자동 생성됩니다.
다른 vault 열기: 좌측 사이드바(📁) → "Vault 열기" → 임의의 폴더 선택.
여러 vault 사용: 한 번에 하나의 vault만 열 수 있지만, 자유롭게 전환할 수 있습니다.
호환성: 같은 폴더를 Obsidian, iA Writer, VS Code 등에서도 열어 작업할 수 있어요. 변경하면 OV 쪽에서 자동 새로고침됩니다.

저장 안전성:

모든 쓰기는 atomic (tmp + rename) — 저장 도중 크래시나 정전이 발생해도 파일이 손상되지 않습니다.
외부 편집기가 파일을 동시에 수정하면 mtime 충돌 감지 모달이 떠서 덮어쓸지 / 외부 변경을 불러올지 선택할 수 있어요.
종료 시 저장하지 않은 변경이 있으면 확인 다이얼로그가 뜹니다.

동기화 & 모바일

vault를 iCloud Drive 폴더에 두면 모든 기기가 같은 노트를 봅니다. 데스크탑 설정에서 "vault를 iCloud로 이동"을 한 번 실행하면 이후로는 자동으로 동기화돼요. 노트가 평범한 .md 파일이라 동기화는 당신의 iCloud를 통해서만 이뤄지고 OV 서버를 거치지 않습니다.

iPhone · Android 앱(곧 출시)에서 같은 vault를 열어 데스크탑 작업을 그대로 이어가세요. 모바일 앱 소식은 다운로드 페이지에서 확인할 수 있어요.

2. 마크다운 작성

빈 줄에서 자동 변환되는 입력 규칙:

입력	결과
`#`	큰 제목 (H1)
`##`	중간 제목 (H2)
`###`	작은 제목 (H3)
`-`	글머리 기호 목록
`1.`	번호 목록
`- [ ]`	할 일 체크박스
`>`	인용문
```	코드 블록
`---`	가로 구분선

인라인 마크다운: **굵게**, *기울임*, ~~취소선~~, `코드`, [링크](url), [[위키링크]].

슬래시 메뉴(/): 빈 줄에서 / 입력 → 모든 블록 타입을 메뉴에서 선택. 마크다운을 외우기 싫다면 슬래시가 답입니다.

Callout 색상 의미:

🔴 빨강 (Callout · 빨강) — 강조 / 위험
🟦 청록 (Callout · 청록) — 정보
🟡 노랑 (Callout · 노랑) — 경고
🟢 초록 (Callout · 초록) — 성공 / 확인
⚪ 회색 (Callout · 회색) — 보조 메모

3. 노트 속성 (Frontmatter)

노트 상단의 회색 영역에서 + Add a property를 클릭해 메타데이터를 추가할 수 있어요. 마크다운 파일 맨 위에 YAML frontmatter로 저장됩니다.

지원 타입: Text, Date, Tags(다중), Checkbox, Number.

이 속성은 데이터베이스 뷰(⌘2)에서 자동으로 컬럼이 되고, Kanban에서 그룹키로 쓸 수 있고, 캘린더에서 date 속성을 가진 노트들이 표시됩니다.

4. 데이터베이스 뷰 (`⌘2`)

Table: 노트 목록 + 정렬 + 필터. 필터 입력으로 빠르게 좁힐 수 있어요.
Kanban (보드): Group by로 선택한 속성으로 카드를 열 단위로 묶음. 카드를 드래그해서 다른 열로 이동하면 속성 값이 자동으로 바뀝니다.

5. 캘린더 & 일정

좌측 캘린더 아이콘(📅) 클릭:

Month view: 한 달치 그리드. 날짜 클릭 → 그 날의 일정 패널.
Day view: 시간 슬롯이 있는 하루 뷰. NOW 라인이 현재 시각을 보여줍니다.

일정 추가: 날짜 선택 → + Add to schedule → 제목 + 시간(14:00 또는 14:00-15:30) + 설명 → 저장. Schedule/ 폴더 안에 노트로 저장됩니다.

Schedule/의 노트는 일반 노트와 똑같이 편집 가능. frontmatter의 date와 time 필드를 직접 고쳐도 됩니다.

6. AI Copilot (`⌘J`)

우측 패널에서 AI 어시스턴트를 띄울 수 있어요.

설정:

설정(⌘,) → AI Copilot 탭
OpenAI API 키 입력 → "저장" → 키체인(macOS Keychain / Windows DPAPI / Linux libsecret)에 암호화 저장됩니다.

키는 OV 서버를 거치지 않고 OpenAI로 직접 호출됩니다. 로컬에 평문으로 남지 않아요.

기능:

요약·이어쓰기·정리 같은 자연어 명령
vault를 읽는 도구(list/read/search) + 변경을 제안하는 도구(create/edit) — 모든 변경은 diff로 표시되고 사용자가 직접 Approve해야 적용됩니다.
"오늘", "내일", "어제" 같은 단어는 intent router가 자동 인식해 캘린더에서 미리 데이터를 가져옵니다.

단축키:

⌘J — 열기/닫기
⌘↵ — 메시지 전송

설정에서 File password 등록
사이드바에서 노트 우클릭 → "잠금" → AES-GCM-256으로 암호화
잠금 해제: 노트 클릭 → 비밀번호 입력 (세션 동안 캐시)

암호화 알고리즘: PBKDF2-SHA256 (200k iterations) + AES-GCM-256. WebCrypto API 사용. 평문 비밀번호는 메모리에만 존재합니다.

8. 단축키 모음

전체 단축키는 앱 안에서 ⌘/ 로 띄울 수 있고, SHORTCUTS.md에 정적 버전이 있어요.

핵심 5개만:

⌘K — 명령 팔레트
⌘P — 파일 빠른 점프
⌘J — AI Copilot
⌘D — 오늘의 노트
⌘/ — 단축키 시트 (이 시트)

9. 첨부파일

이미지·동영상·일반 파일을 노트에 첨부할 수 있어요.

드래그 & 드롭: 에디터에 파일을 끌어다 놓으면 자동 첨부
붙여넣기: 클립보드의 이미지를 ⌘V로 붙여넣기
슬래시 메뉴: /이미지, /동영상, /파일
임베드: /임베드 → YouTube/Vimeo URL 입력 → iframe으로 임베드

첨부파일은 vault 안의 .attachments/ 폴더에 저장됩니다.

10. 도움이 필요할 때

? 버튼 (우측 레일) — 도움말 메뉴 + 가이드 노트로 이동
⌘/ — 단축키 시트
사이드바 starter 노트 — Welcome, 단축키, 마크다운, 캘린더, 보안
SHORTCUTS.md — 단축키 전체
COLORS.md — 색상 토큰 의미
CHANGELOG.md — 버전별 변경 내역