cognote

Cognote는 개인용 Markdown 지식 노트를 위한 로컬 Web 지능형 노트 시스템으로, 프라이빗 배포와 로컬 파일 저장을 강조합니다. 지정된 디렉터리의 Markdown 파일을 자동으로 재귀 스캔하여 디렉터리 트리와 태그로 구성하고, 전문 검색, AI 보조 정리, 브라우저 내 편집 기능을 제공합니다. 주요 기능 - 노트 탐색 및 검색: 왼쪽 디렉터리 트리에서 분류를 표시하고, 폴더를 클릭해 필터링하며 노트를 클릭해 엽니다. 상단 바는 중영문 혼합 전문 검색을 지원하고, 결과는 관련도순으로 정렬되어 하이라이트됩니다. 오른쪽 클릭 메뉴로 새로 만들기, 편집, 분류, 삭제 또는 로컬 위치 열기가 가능합니다. - 중국어 전문 검색: 자체 구축한 중국어 bigram 및 영어 분절 역색인을 사용하며, TF-IDF 가중 정렬을 적용해 중국어 분절과 역색인 검색 문제를 해결합니다. - Markdown 편집: Vditor 3.10.8을 통합해 즉시 렌더링, 위지윅, 분할 화면 미리보기의 세 가지 모드를 지원하며, KaTeX 수학 공식, Mermaid 차트, 코드 하이라이트를 지원합니다. 제목, 태그(frontmatter)와 본문을 분리하고 저장 시 실시간으로 디스크에 기록합니다. - AI 지능형 분류: 현재 노트를 분석해 제안 분류, 태그, 요약, 키워드를 반환하며 원클릭으로 적용할 수 있습니다. - AI 지식 확장: 확장 내용을 현재 노트 끝에 추가하거나 독립적인 새 노트 문서를 생성할 수 있습니다. - 복습 및 자가 테스트: 한 페이지 복습 요약(핵심, 명령, 오류 발생 지점, 자가 테스트 문제)을 생성하고, 현재 노트 및 동일 분류 노트를 기반으로 문답 자가 테스트 문제를 생성하며, 노트 내용에 대해 AI에 질문하고 출처를 표시할 수 있습니다. 기술 특징 - 백엔드는 의존성이 없으며 Node.js 22 이상만 필요하고, 내장 http, fetch, fs, exec 모듈과 메모리 역색인을 사용합니다. - 프런트엔드는 네이티브 HTML/CSS/JS 단일 페이지 애플리케이션이며, 자체 작성한 경량 Markdown 렌더러를 함께 사용합니다. - AI는 DeepSeek, OpenAI, Anthropic Claude, Moonshot, 즈푸 GLM, 통이치엔원 및 사용자 정의 OpenAI 호환 프로토콜 서비스 제공자를 지원하며, 설정 파일 또는 Web 인터페이스에서 설정할 수 있습니다. - HTTP API를 제공하며, 디렉터리 트리, 검색, 노트 읽기/쓰기 및 이동/삭제, AI 분류/확장/요약/자가 테스트/문답, 색인 재구축, 설정 읽기/쓰기 및 노트 참조 관계 그래프를 포함합니다. 사용 방법 저장소를 클론한 후 config.example.json을 config.json으로 복사하고, 노트 디렉터리, 포트 및 AI API Key를 입력한 뒤 npm start를 실행하고 로컬 포트에 접속하면 됩니다. API Key를 설정하지 않아도 노트 탐색, 검색 및 편집은 정상적으로 사용할 수 있으며, AI 기능만 설정 안내를 표시합니다. 프로젝트는 macOS 및 Windows용 시작 스크립트를 제공합니다. 프로젝트는 MIT 라이선스를 채택하며, 로드맵에 따르면 핵심 색인 검색, 색인 영속화 증분 업데이트, 일괄 분류, 양방향 링크 참조 관계 뷰 및 망각 곡선 기반 복습 계획 등의 기능이 이미 구현되었습니다.