Об этом проекте
Cognote — это локальная веб-система интеллектуальных заметок для личных Markdown-знаний, ориентированная на приватное развертывание и хранение файлов локально. Она автоматически рекурсивно сканирует Markdown-файлы в указанном каталоге, организует их по дереву каталогов и тегам, а также предоставляет полнотекстовый поиск, ИИ-помощь в организации и возможность редактирования в браузере.
Основные функции
- Просмотр и поиск заметок: дерево каталогов слева отображает категории, клик по папке фильтрует, клик по заметке открывает её; верхняя панель поддерживает полнотекстовый поиск со смешением китайского и английского, результаты сортируются по релевантности и подсвечиваются; контекстное меню позволяет создавать, редактировать, классифицировать, удалять или открывать локальное расположение.
- Полнотекстовый поиск на китайском: собственная инвертированная индексная система на основе китайских биграмм и английской токенизации, с ранжированием по TF-IDF, решает проблемы китайской сегментации и инвертированного поиска.
- Редактирование Markdown: интегрирован Vditor 3.10.8, поддерживаются три режима — мгновенный рендеринг, WYSIWYG и разделенный предпросмотр, поддерживаются математические формулы KaTeX, диаграммы Mermaid и подсветка кода; заголовок, теги (frontmatter) и основной текст разделены, сохранение происходит в реальном времени на диск.
- ИИ-классификация: анализирует текущую заметку и возвращает предлагаемую категорию, теги, аннотацию и ключевые слова, которые можно применить одним кликом.
- ИИ-расширение знаний: может добавлять расширенный контент в конец текущей заметки или создавать отдельный новый документ-заметку.
- Повторение и самопроверка: генерирует одностраничную сводку для повторения (ключевые моменты, команды, частые ошибки, вопросы для самопроверки), создает вопросы и ответы для самопроверки на основе текущей заметки и заметок той же категории, а также позволяет задавать вопросы ИИ по содержанию заметки с указанием источника.
Технические особенности
- Бэкенд без зависимостей, требуется только Node.js 22 и выше, используются встроенные модули http, fetch, fs, exec в сочетании с инвертированным индексом в памяти.
- Фронтенд — одностраничное приложение на нативном HTML/CSS/JS с собственным легковесным рендерером Markdown.
- Поддержка ИИ: DeepSeek, OpenAI, Anthropic Claude, Moonshot, Zhipu GLM, Tongyi Qianwen, а также пользовательские сервисы, совместимые с протоколом OpenAI; настройка возможна в файле конфигурации или через веб-интерфейс.
- Предоставляется HTTP API, охватывающий дерево каталогов, поиск, чтение/запись, перемещение и удаление заметок, ИИ-классификацию/расширение/аннотацию/самопроверку/вопросы-ответы, перестроение индекса, чтение и запись конфигурации, а также граф ссылочных связей заметок.
Способ использования
После клонирования репозитория скопируйте config.example.json в config.json, заполните каталог заметок, порт и ключ AI API, затем запустите npm start и откройте локальный порт. Если ключ API не настроен, просмотр, поиск и редактирование заметок по-прежнему работают нормально, только ИИ-функции попросят настройку. Проект предоставляет стартовые скрипты для macOS и Windows.
Проект распространяется под лицензией MIT. Дорожная карта показывает, что уже реализованы базовый индексированный поиск, инкрементальное обновление с сохранением индекса, пакетная классификация, представление связей двусторонних ссылок, а также план повторения на основе кривой забывания.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.