노트
노트는 채팅이나 Work 작업과 독립적으로 존재하는 영구 Markdown 문서입니다. 대화와 모델 선택이 바뀌어도 유지하려는 개요, 조사 기록, 체크리스트, 초안 또는 모든 자료에 사용할 수 있습니다.
노트 페이지는 기존 노트를 읽기 전용 미리보기로 엽니다. 변경하려면 편집을 선택하세요. 편집 내용은 잠시 후 자동 저장됩니다. 목록을 검색할 수 있고 고정한 노트는 눈에 잘 띄며, Cmd/Ctrl-K는 디스크에 평문 검색 인덱스를 유지하지 않고 자신과 공유된 노트 내용을 검색할 수 있습니다.
Markdown 미리보기 및 내보내기
미리보기는 표를 포함한 표준 Markdown을 렌더링합니다. 정제 후 기본 인라인 HTML과 SVG도 지원하며, 페이지에 도달하기 전에 스크립트, 이벤트 핸들러, 안전하지 않은 URL을 제거합니다.
내보내기는 현재 노트 내용을 .md 파일로 다운로드합니다. 이 내보내기는 평문이며 첨부 파일과 버전 기록을 포함하지 않습니다. 다른 노트 사본처럼 보호하세요.
버전 및 복원
제목이나 내용을 변경할 때마다 업데이트를 커밋하기 전에 이전 제목과 내용을 스냅샷으로 저장합니다. 버전 탭에는 보관된 버전과 현재 노트의 줄 단위 차이가 표시됩니다. 이전 버전을 복원할 때 먼저 현재 상태를 스냅샷으로 저장하므로 복원 자체도 되돌릴 수 있습니다.
Libre는 노트마다 최신 50개 버전을 보관합니다. 고정 상태만 바꾸면 콘텐츠 버전이 생성되지 않습니다.
첨부 파일
첨부 파일 탭에서 노트 관련 파일을 업로드, 나열, 다운로드, 삭제할 수 있습니다. 노트 하나에 최대 10개를 첨부할 수 있으며 각각 10 MiB 이하여야 합니다. 첨부 바이트는 노트 소유자의 신원으로 플랫폼 Blob 스토리지를 사용하므로 소유자 할당량, 암호화, 백업, 삭제 동작은 선택한 solo 또는 team 스토리지 프로필을 따릅니다.
다운로드할 때 노트 접근 권한을 다시 확인하고 private, no-store를 사용하며, nosniff를 적용한 첨부 파일로 제공해 임의의 업로드 콘텐츠를 인라인 렌더링하지 않습니다. 현재 Libre는 첨부 바이트에서 악성 코드를 검사하지 않습니다. 다른 사람에게서 받은 파일은 다운로드 후에도 신뢰하지 마세요.
공유
소유자는 인증된 다른 사용자에게 다음 권한을 부여할 수 있습니다.
- 읽기 — 노트를 열고 버전을 보며 첨부 파일을 다운로드합니다.
- 쓰기 — 추가로 내용을 편집하고 버전을 복원하며 첨부 파일을 관리하고 AI 지원 편집을 사용합니다.
요청할 때마다 권한을 확인하므로 권한 취소는 다음 읽기 또는 쓰기부터 적용됩니다. 소유자만 노트 고정, 공유, 공유 취소, 삭제를 할 수 있습니다. 전역 관리자 역할 자체는 비공개 노트 내용에 접근 권한을 주지 않습니다.
노트는 공개 링크가 아니며 편집기는 동시 공동 편집 화면이 아닙니다. 두 사람이 동시에 편집할 때 표시되는 접속 상태, 공유 커서, 병합 프로토콜이 없습니다.
AI 지원 편집
지원 탭은 지시, 노트 제목, 현재 Markdown을 애플리케이션에서 선택한 모델과 제공자에게 보냅니다. 모델은 전체 대체안을 반환합니다. Libre는 제안을 차이로 표시합니다. 버리기는 변경하지 않으며, 적용은 일반 업데이트 경로를 사용해 이전 상태를 버전으로 보관합니다.
제안 생성만으로는 저장되지 않고 적용할 때 저장됩니다. 원격 제공자는 해당 제공자의 보존, 개인정보 보호, 청구 조건에 따라 노트 내용과 지시를 받습니다. 노트가 설정한 Ollama 인프라 안에 머물러야 하면 로컬 모델을 선택하세요. 지원 지시는 4,000자로 제한되며 제안은 일반 노트 콘텐츠 제한 안에 들어야 합니다.
채팅 도구로서의 노트
채팅 도구가 활성화되면 지원 모델은 다음을 사용할 수 있습니다.
- 권한이 있는 자신의 노트 또는 공유 노트를 위한
list_notes와read_note. - 부작용 승인이 필요한
create_note. - 승인과 이전 콘텐츠의 버전 스냅샷이 필요한
update_note.
노트 도구는 호출 사용자의 신원으로 동작합니다. Markdown 콘텐츠를 읽으며 첨부 바이트는 읽지 않습니다. 시크릿 채팅에서는 도구를 제공하지 않습니다.
스토리지, 암호화, 이동성
제목, 콘텐츠, 보관된 버전은 애플리케이션 암호화 서비스로 저장 시 암호화됩니다. 첨부 파일은 암호화된 플랫폼 Blob 스토리지를 사용합니다. 이는 애플리케이션 수준 보호이며 전체 디스크 또는 종단 간 암호화가 아닙니다. 데이터베이스, Blob 스토리지, 백업, 암호화 키를 하나의 배포 경계로 보호하세요.
버전 관리되는 사용자별 아카이브에는 현재 노트와 고정 상태가 포함됩니다. 버전 기록과 첨부 파일은 의도적으로 제외됩니다. 따라서 서버 전체 복구에는 사용자 아카이브만이 아니라 데이터베이스, 암호화 자료, 관련 Blob 스토리지가 필요합니다. 데이터 이동성과 복구 준비를 참조하세요.
제한
| 항목 | 제한 |
|---|---|
| 사용자당 소유 노트 | 100 |
| 제목 | 200자 |
| Markdown 콘텐츠 | 200,000자 |
| 노트당 보관 버전 | 50 |
| 노트당 첨부 파일 | 10 |
| 첨부 파일 크기 | 각각 10 MiB |
| AI 편집 지시 | 4,000자 |
API
모든 경로에는 인증된 세션 또는 notes 범위의 API 토큰이 필요합니다. 공유 노트 접근은 인터페이스와 동일한 읽기/쓰기 규칙을 따릅니다.
| 메서드 | 경로 | 용도 |
|---|---|---|
GET | /api/notes | 자신 및 공유 노트 목록 |
POST | /api/notes | 노트 생성 |
GET | /api/notes/:noteId | 노트 하나 읽기 |
PUT | /api/notes/:noteId | 콘텐츠, 제목 또는 고정 상태 업데이트 |
DELETE | /api/notes/:noteId | 소유 노트 삭제 |
GET | /api/notes/:noteId/revisions | 보관 버전 목록 |
POST | /api/notes/:noteId/revisions/:revisionId/restore | 버전 복원 |
GET | /api/notes/:noteId/attachments | 첨부 파일 목록 |
POST | /api/notes/:noteId/attachments | 첨부 파일 업로드 |
GET | /api/notes/:noteId/attachments/:attachmentId | 첨부 파일 다운로드 |
DELETE | /api/notes/:noteId/attachments/:attachmentId | 첨부 파일 삭제 |
POST | /api/notes/:noteId/assist | 저장하지 않는 편집 제안 생성 |