garden-md

Что такое garden-md?

garden-md — это инструмент командной строки, который превращает расшифровки встреч (и связанные заметки) в структурированную связанную базу знаний компании. Он генерирует вики в стиле Wikipedia в формате HTML из локальных markdown-файлов, чтобы вы могли просматривать людей, компании, продукты/инструменты вашей организации и упоминания о них в документах.

Основная цель — помочь командам организовать разрозненный материал расшифровок в удобный для просмотра формат, сохраняя оригинальные расшифровки дословно (без переписывания или суммирования). Вы можете синхронизировать данные из поддерживаемых сервисов, извлекать сущности, связывать упоминания и открывать получившуюся вики в браузере.

Ключевые возможности

• Синхронизация расшифровок из нескольких источников (локальная сцена + локальная вики): Запуск garden sync загружает новые расшифровки из Grain, Granola, Fireflies.ai или коннектора “Other” на основе API в локальную зону сцена.
• Извлечение сущностей по документам: Во время garden tend инструмент извлекает сущности, такие как люди, компании и продукты/инструменты, и использует их для организации страниц вики.
• Связанные, просматриваемые страницы вики в markdown: Выходные данные — это связанные .md-файлы, которые растут со временем по мере упоминания существующих или новых сущностей в документах.
• HTML-рендеринг в стиле Wikipedia: garden open генерирует и запускает HTML-вики с навигацией, поиском и обратными ссылками.
• Локальная работа в первую очередь: Вики хранится как папки с markdown-файлами на вашем устройстве, а не в облачной базе данных.
• Необязательная интеграция с git / автоматические коммиты: garden init может включить git, а вики обновляется коммитами автоматически (опционально для настройки).
• Подход с коннекторами и проверкой для кастомных сервисов: Встроенные коннекторы протестированы; для “Other” ИИ генерирует скрипт коннектора для проверки перед запуском.
• Четкие нецели (сохраняет расшифровки): Он не переписывает и не суммирует контент; расшифровки остаются дословными в исходных документах.

Как использовать garden-md

1. Установка и требования: Установите с помощью npm install -g garden-md. Используйте Node.js 18+ и предоставьте API-ключ для поддерживаемого провайдера ИИ.
2. Инициализация вики: Запустите garden init, чтобы выбрать провайдера ИИ, настроить расположение вики и опционально включить git.
3. Подключение источника данных: Запустите garden connect и выберите сервис — Grain, Granola, Fireflies.ai или Other — для настройки синхронизации. Для “Other” укажите название сервиса и URL документации API.
4. Синхронизация новых расшифровок: Запустите garden sync, чтобы загрузить новые расшифровки в зону сцена (отображается как “wildland” в демо-выводе).
5. Обработка в вики: Запустите garden tend для извлечения сущностей, создания заглушек страниц и генерации связанной структуры markdown/вики; затем garden open для просмотра HTML-вики.

Частые команды: garden connect --repair (для ремонта сломанных коннекторов), garden sync --schedule (автоматическая синхронизация по cron) и garden tend / garden open для обработки и просмотра.

Сценарии использования

• Превращение расшифровок встреч в searchable внутреннюю вики: После синхронизации расшифровок из источника заметок/расшифровок запустите garden tend для генерации страниц сущностей и обратных ссылок, чтобы члены команды могли просматривать знания компании по людям, компаниям или продуктам/инструментам.
• Поддержка “мозга компании” на основе дословного исходного материала: Поскольку garden-md избегает переписывания/суммирования, команды могут полагаться на оригинальный контент расшифровок, пользуясь при этом структурированным слоем вики.
• Непрерывное обновление страниц вики по мере поступления новых встреч: Используйте garden sync (опционально с --schedule) для загрузки новых расшифровок, затем перезапустите garden tend, чтобы вики росла и связи расширялись при упоминаниях сущностей в новых документах.
• Ввод в курс дела команд или стейкхолдеров с общей навигацией: Используйте garden open для просмотра HTML-вики с боковой навигацией и поиском, чтобы проще находить релевантные упоминания по множеству расшифровок.
• Интеграция кастомного источника расшифровок через API: Выберите “Other” в garden connect и предоставьте документацию API; инструмент сгенерирует скрипт коннектора для проверки перед запуском.

FAQ

• Переписывает или суммирует garden-md мои расшифровки? Нет. garden-md сохраняет расшифровки дословно (не переписывает и не суммирует контент).

• Где хранится вики? В локальных markdown-файлах (папки с .md-файлами) на вашем устройстве; не требуется база данных или облачное хранилище.

• Какие сервисы поддерживаются из коробки? Репозиторий перечисляет встроенные протестированные коннекторы для Grain, Granola и Fireflies.ai. Для других используйте “Other” с документацией API.

• Что делают garden tend и garden open? garden tend читает из зоны сцена, отправляет контент провайдеру ИИ для извлечения сущностей и обновляет связанную markdown-вики. garden open рендерит и запускает HTML-вики для просмотра.

• Какие требования необходимы? В README указано, что требуется Node.js 18+, и нужен API-ключ от любого поддерживаемого провайдера ИИ.

Альтернативы

• Создать вики вручную с markdown + скриптами: Если нужна только базовая организация, вы можете сами создавать и связывать markdown-страницы без AI-выделения сущностей и рабочих процессов рендеринга HTML.
• Использовать платформу для документации/вики с конвейерами импорта: Универсальные базы знаний хранят и ищут документы, но рабочий процесс отличается, поскольку garden-md специально генерирует википедийские перекрестно-связанные страницы сущностей из расшифровок.
• Инструменты суммаризации расшифровок с базами знаний: Некоторые инструменты фокусируются на суммаризации расшифровок и индексации этих саммари; подход garden-md иной, поскольку он сохраняет оригинальный текст и строит структурированные связи сущностей вместо замены контента саммари.
• Собственные ETL-конвейеры (синхронизация → парсинг → индексация): Для команд с инженерной поддержкой можно воспроизвести паттерн «синхронизация + выделение сущностей + связывание» с помощью своих инструментов и хранилища вместо набора команд и рендерера вики garden-md.