Захват сессии
Как работает сессия SmartNotes — голосовые триггеры, скриншоты, дебаунс, issue-карточки и суммаризация.
Сессия — это единица захвата в SmartNotes. Вы её запускаете, говорите естественно во время работы и останавливаете, когда закончите. Каждая произнесённая мысль становится нотой со скриншотом, транскриптом, временной меткой и тегом issue.
Начало сессии
- Перейдите на вкладку Захват.
- Проверьте источник скриншотов, микрофон и папку вывода.
- Нажмите Начать сессию.
SmartNotes теперь слушает. Он не записывает постоянно — он ждёт речи.
Как работает захват
VAD onset (энергия речи выше порога в течение 300 мс)
→ делается один скриншот
→ начинается буферизация аудио
Речь продолжается (с паузами)
→ аудио дописывается к той же ноте
VAD offset (тишина 700 мс)
→ аудио-блоб финализируется
→ ffmpeg конвертирует WebM/Opus в WAV 16 кГц mono
→ whisper-cli транскрибирует аудио
→ IssueClassifier помечает ноту
→ нота сохраняется и пушится в UI
Кулдаун 7 секунд:
если новая речь началась в этом окне — продолжаем ту же ноту,
не создавая новый скриншот.Дебаунс в 7 секунд — это то, что позволяет одной мысли остаться одной нотой, даже если вы делаете паузы между предложениями.
Теги нот
Каждая нота получает быструю локальную эвристическую метку:
| Тег | Значение | Примеры |
|---|---|---|
decision | Что-то, что нужно сделать | «нужно исправить», «добавить валидацию», «поменять цвет» |
observation | Нейтральная заметка | «эта страница медленно грузится» |
question | Открытый вопрос | «почему это здесь?», «как это масштабируется?» |
Эти теги — локальные помощники. Когда ноты отправляются в Cradle, triage-агент там делает финальную классификацию.
Ревью нот
Откройте вкладку Заметки, чтобы увидеть сессии и отдельные ноты. Вы можете:
- Фильтровать ноты по тегу.
- Редактировать транскрипт или переклассифицировать ноту.
- Просматривать скриншот, захваченный с каждой нотой.
- Выбрать ноты и запустить Суммаризировать, чтобы получить Markdown-сводку и issue-карточки.
Суммаризация
Суммаризация может работать локально через Cradle, если он подключён, или опционально через OpenAI (gpt-4o). Она берёт захваченные ноты, чистит их, группирует связанные пункты и выдаёт:
- Краткую Markdown-сводку сессии.
- Issue-карточки, которые можно отправить в Cradle для triage.
Сводки ничего не отправляют автоматически — сначала вы ревьюите issue-карточки.