mirror of
https://github.com/sotam0316/brain_dogfood.git
synced 2026-04-24 19:48:35 +09:00
leeyj
114 lines
5.7 KiB
Markdown
114 lines
5.7 KiB
Markdown
# 📔 뇌사료 (Brain Dogfood) 사용자 매뉴얼 (v5.0+)
|
|
|
|
'뇌사료' 프로젝트에 오신 것을 환영합니다! 본 매뉴얼은 파편화된 영감을 체계적인 지식 성단(Nebula)으로 구축하는 데 필요한 모든 가이드를 제공합니다.
|
|
|
|
---
|
|
|
|
## 🌌 1. 지식 네뷸라 (시각화 탐색)
|
|
|
|
메인 전면에 펼쳐진 **지식 네뷸라**는 단순한 목록이 아닌 지식의 유기적인 지도를 보여줍니다.
|
|
|
|
- **노드(Node)**: 각각의 메모를 상징합니다.
|
|
- **크기**: 내용이 많거나 연결이 많을수록 노드가 거대해집니다.
|
|
- **색상**: 각 메모에 설정된 고유한 그룹 색상을 따릅니다.
|
|
- **🔒 아이콘**: 암호화된 메모임을 나타내며, 제목만 미리보기로 제공됩니다.
|
|
- **링크(Link)**:
|
|
- **실선**: `[[#ID]]` 문법으로 명시적으로 연결된 관계입니다.
|
|
- **인력(Gravity)**: 같은 그룹이나 공통 태그를 가진 메모들은 서로를 끌어당겨 가까이 배치됩니다.
|
|
|
|
---
|
|
|
|
## 🌡️ 3. 지식 성장 히트맵 (Heatmap) 사용법
|
|
|
|
사이드바에 위치한 히트맵은 사용자의 기록 강도를 시각적으로 보여줍니다.
|
|
|
|
- **기간 전환**: 히트맵 상단 제목 옆의 드롭다운을 통해 **1개월 / 3개월 / 6개월 / 1년** 단위를 선택할 수 있습니다.
|
|
- **상태 유지**: 한 번 선택한 기간은 브라우저에 저장되어 다음 접속 시에도 그대로 유지됩니다.
|
|
- **활동량 확인**: 각 칸에 마우스를 올리면 해당 날짜에 작성된 메모의 개수를 확인할 수 있습니다. 색상이 진해질수록(Cyan -> Purple) 더 많은 지식을 축적했음을 의미합니다.
|
|
|
|
---
|
|
|
|
## ✍️ 4. 메모 작성 및 스타일링
|
|
|
|
### 4.1 지식 연결 문법 (`[[#ID]]`)
|
|
메모 간의 명시적인 지식을 연결하려면 본문에 샵(#) 기호와 메모 번호를 사용하세요.
|
|
> 예: "이 개념은 `[[#12]]`에서 다룬 내용과 상충됩니다."
|
|
- **효과**: 뷰어에서 클릭 시 해당 메모로 바로 이동하며, 지식 네뷸라 상에 강력한 연결선이 형성됩니다.
|
|
|
|
### 4.2 컬러 텍스트 (Color Syntax)
|
|
에디터 상단 툴바의 **색상 선택 아이콘**을 사용하여 텍스트에 색상을 입힐 수 있습니다. 중요 키워드를 강조하여 지식의 가독성을 높이세요.
|
|
|
|
### 4.3 개별 메모 암호화
|
|
중요한 개인 정보나 아이디어는 암호화하여 보호할 수 있습니다.
|
|
- **사용법**: 편집기 하단의 **[암호화 사용]** 체크 -> 비밀번호 설정.
|
|
- **특약**: 암호화된 메모는 서버 측에서도 해독이 불가능하며, 비밀번호 분실 시 복구가 절대 불가능하므로 주의하세요.
|
|
- **복호화**: 작성된 암호화 메모 옆의 **🔓 해독** 버튼을 눌러 비밀번호 입력 시 일시적으로 내용을 확인할 수 있습니다.
|
|
|
|
---
|
|
|
|
---
|
|
|
|
## 🧠 5. AI 인텔리전스 (AI Insights)
|
|
|
|
### 5.1 AI 활성화 및 API 키 설정 (초보자 가이드)
|
|
'뇌사료'의 지능형 기능을 사용하려면 Google의 Gemini API 키가 필요합니다. 다음 단계에 따라 **1분 만에 무료로** 설정을 마칠 수 있습니다.
|
|
|
|
1. **키 발급**: [Google AI Studio (https://aistudio.google.com/app/apikey)](https://aistudio.google.com/app/apikey)에 접속합니다.
|
|
2. **프로젝트 생성**: "Create API key in new project" 버튼을 누릅니다.
|
|
3. **키 복사**: 생성된 `AIza...`로 시작하는 긴 문자열을 복사합니다.
|
|
4. **서버 적용**: 본 프로젝트 폴더의 `.env` 파일을 열고 `GEMINI_API_KEY=` 뒤에 복사한 키를 붙여넣고 저장합니다.
|
|
5. **활성화**: 앱 우상단 **[⚙️ 설정]** -> **AI 기능 활성화** 체크박스를 켜고 저장합니다.
|
|
|
|
> [!TIP]
|
|
> - API 키 발급은 완전히 무료이며, 개인적인 용도로는 충분한 할당량이 제공됩니다.
|
|
> - 키가 없더라도 메모 작성 및 시각화 등 기본적인 기능은 "NO AI" 모드로 완벽하게 작동합니다.
|
|
|
|
### 5.2 주요 기능
|
|
- **자동 요약**: 방대한 내용을 AI가 1~2문장의 핵심 문장으로 압축해줍니다.
|
|
- **스마트 태그**: 본문을 분석하여 자동으로 추천 태그를 생성합니다.
|
|
- **추론형 배치**: AI가 생성한 태그를 기반으로 지식 네뷸라 상에서 비슷한 맥락의 메모들이 자동으로 성단을 형성합니다.
|
|
|
|
---
|
|
|
|
---
|
|
|
|
## ⌨️ 6. 단축키 및 작업 효율 (Shortcuts)
|
|
|
|
'뇌사료'는 마우스 없이도 거의 모든 작업을 수행할 수 있도록 강력한 **Ctrl 기반** 단축키를 지원합니다.
|
|
|
|
### 6.1 전역 내비게이션
|
|
- **`Alt + `** (Backtick): ⚡ **Quake 스타일 새 메모** (영감을 즉시 기록)
|
|
- **`Ctrl + Shift + N`**: 새 메모 작성기 열기 📝
|
|
- **`Ctrl + Shift + G`**: 지식 네뷸라(시각화) 열기 🕸️
|
|
- **`Ctrl + Shift + E`**: 지식 탐색기(사이드바) 열기 🔍
|
|
- **`Ctrl + Shift + C`**: 사이드바 캘린더 토글 📅
|
|
- **`Ctrl + Shift + Q`** 또는 **`ESC`**: 모든 모달 및 드로어 닫기
|
|
|
|
### 6.2 에디터 작업
|
|
- **`Ctrl + Enter`** 또는 **`Ctrl + S`**: **현재 메모 저장 및 게시** 💾
|
|
- **`/` (Slash)**: 슬래시 명령 오픈 (AI 요약, 서식 등) 🪄
|
|
- **`Shift + ESC`**: 작성 취소 및 닫기
|
|
|
|
### 6.3 마우스 팁
|
|
- **`Alt + 클릭`**: 메인 그리드에서 메모를 즉시 수정 ✏️
|
|
|
|
---
|
|
|
|
## 🚀 7. 운영 및 관리 (Ops & Backup)
|
|
|
|
### 7.1 정밀 배포 (`deploy.py`)
|
|
개발 환경에서 작업한 코드를 서버로 안전하게 배포합니다.
|
|
```bash
|
|
python deploy.py
|
|
```
|
|
|
|
### 7.2 재난 복구 백업 (`backup.py`)
|
|
서버의 모든 핵심 데이터를 압축하여 안전하게 보관합니다.
|
|
```bash
|
|
python backup.py
|
|
```
|
|
|
|
---
|
|
|
|
**지식의 우주를 마음껏 탐험하세요!** 🛸🌌
|