교육 노트 어시스턴트

About

# 📚 교육 노트 어시스턴트 - Chrome Extension

**교육 중 노트 작성과 AI 요약을 도와주는 Chrome 확장 프로그램입니다.**

## 🌟 특징

- ⏱️ **고급 타이머**: 최초 시작 시간, 현재 세션 시간, 총 학습 시간 분리 관리
- 📝 **리치 텍스트 노트**: 색상, 하이라이트, 서식이 지원되는 고급 노트 작성
- 🤖 **AI 요약**: ChatGPT & Gemini 연동으로 학습 내용 자동 요약
- 💾 **세션 관리**: JSON 형태로 저장/불러오기 지원
- 🔄 **다양한 표시 모드**: 팝업, 새창, 사이드패널, 웹앱 모드 지원
- ⌨️ **키보드 단축키**: 한국어 지원 (Ctrl+S, Ctrl+O 등)

## 📦 확장 프로그램 구성

### 🎯 표시 모드
- **팝업 모드**: 확장자 아이콘 클릭 시 작은 팝업 창
- **새 창 모드**: 드래그 가능, 크기 조절 가능 (추천)
- **사이드패널 모드**: 브라우저 옆에 고정 패널
- **웹앱 모드**: 새 탭에서 전체 화면 사용


## 🚀 설치 방법

### Chrome에서 설치
1. Chrome에서 `chrome://extensions/` 이동
2. **개발자 모드** 활성화 (우상단 토글)
3. **"압축해제된 확장 프로그램을 로드합니다"** 클릭
4. 이 프로젝트 폴더 선택
5. 툴바의 확장자 아이콘 클릭하여 사용

## ⏰ 고급 시간 관리 기능

### 시간 추적 시스템
- **최초 시작 시간**: 프로젝트 최초 시작 시점 (변경되지 않음)
- **현재 세션 시간**: 현재 진행 중인 학습 세션 시간
- **총 학습 시간**: 모든 세션을 합친 누적 학습 시간
- **임시 세션 시간**: 재개 시 임시로 표시되는 연속 학습 시간

### 시간 관리 기능
- **시작/중지**: 학습 세션 시작 및 일시 중지
- **리셋**: 현재 세션만 초기화
- **학습시간 초기화**: 모든 시간 데이터 완전 초기화

## ⌨️ 키보드 단축키

- `Ctrl+S` (또는 `ㄴ`): 노트 저장
- `Ctrl+Shift+S` (또는 `ㄴ`): 프로젝트 저장  
- `Ctrl+O` (또는 `ㅐ`): 세션 불러오기
- `Ctrl+N` (또는 `ㅜ`): 새 세션
- `Tab`: 제목에서 내용으로 이동

## 📁 파일 관리

### 저장 형식
- **새 프로젝트**: `교육노트_[제목]_[날짜].json`
- **수정된 프로젝트**: `교육노트_[제목]_[원본날짜]_수정_[수정날짜].json`

### 데이터 구조
```json
{
  "title": "교육 제목",
  "location": "강의 장소", 
  "instructor": "강의자",
  "originalStartTime": "2024-01-15T09:00:00.000Z",
  "totalStudySeconds": 7200,
  "finalTotalStudyTime": "02:00:00",
  "notes": [
    {
      "id": 1234567890,
      "type": "note",
      "title": "노트 제목",
      "content": "리치 텍스트 노트 내용",
      "timestamp": "2024-01-15T09:30:00.000Z",
      "important": false
    }
  ],
  "endTime": "2024-01-15T12:00:00.000Z",
  "totalNotes": 5,
  "totalWords": 1250
}
```

## 🤖 AI 요약 기능

### ChatGPT & Gemini 연동 방법
1. **"ChatGPT로 복사"** 또는 **"Gemini로 복사"** 버튼 클릭
2. 노트 내용이 자동으로 클립보드에 복사되고 해당 AI 페이지가 열림
3. AI 페이지에서 `Ctrl+V`로 붙여넣기
4. AI 응답을 받은 후 **"응답 저장"** 버튼으로 저장

### 생성되는 요약 형식
- 📚 **주요 학습 내용**: 핵심 개념들을 간결하게 정리
- 🔑 **중요 포인트**: 기억해야 할 중요한 사항들을 리스트로 정리
- 💡 **추가 학습 제안**: 더 깊이 학습하면 좋을 주제들을 제안
- 📋 **체크리스트**: 오늘 학습한 내용 중 복습이 필요한 항목들

## 🛠️ 개발 환경

### 요구사항
- **Chrome**: Chrome 88+ (사이드패널은 Chrome 114+)
- **권한**: storage, activeTab, contextMenus

### 사용된 기술
- **Frontend**: Vanilla JavaScript, CSS3, HTML5
- **Backend**: Chrome Extension APIs, localStorage
- **UI/UX**: Inter 폰트, Font Awesome 아이콘
- **디자인**: Glassmorphism, 반응형 디자인

## 📝 버전 히스토리

### v2.0.0 (2024-XX-XX) - Chrome Extension 전용
- 🔄 **크롬 확장 프로그램 전용으로 전환**
- ⏰ **고급 시간 관리 시스템**: 최초/현재/총 학습시간 분리
- 🎨 **리치 텍스트 에디터**: 색상 팔레트 및 서식 지원
- 🔗 **Gemini AI 연동**: ChatGPT와 Gemini 양쪽 지원
- 📱 **4가지 표시 모드**: 팝업/새창/사이드패널/웹앱
- 🎯 **사용성 개선**: 임시 세션 표시, 학습시간 초기화 등

### v1.0.0 (2024-01-15)
- ✨ 초기 릴리스 (웹/크롬 확장자/Python 멀티 플랫폼)


## 📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.

## 📞 지원

문제가 발생하거나 제안사항이 있으시면 [Issues]
메일([email protected])으로 Feedback 주세요.

---

**📚 Chrome Extension으로 교육 효율성을 극대화하세요!** 🚀

## 🎯 이 프로젝트는 Chrome 확장 프로그램 전용입니다
**개발자 참고**: 이 저장소는 Chrome Extension 개발에만 집중합니다. 웹 버전이나 Python 버전은 더 이상 지원하지 않습니다.