🏠 Главная › user guide › health neuroskill bci

{/ Эта страница автоматически создается на основе файла SKILL.md навыка с помощью сайта site/scripts/generate-skill-docs.py. Редактируйте исходный код SKILL.md, а не эту страницу. /}

Нейроскилл Bci

Подключитесь к работающему экземпляру NeuroSkill и включите в ответы когнитивное и эмоциональное состояние пользователя в реальном времени (сосредоточенность, расслабление, настроение, когнитивная нагрузка, сонливость, частота сердечных сокращений, ВСР, стадию сна и более 40 полученных показателей ЭГГ). Требуется носимое устройство BCI (Muse 2/S или OpenBCI) и настольное приложение NeuroSkill, работающее локально.

Метаданные навыков
Источник Необязательно — установите с помощью hermesskills installofficial/health/neuroskill-bci
Путь optional-skills/health/neuroskill-bci
Версия 1.0.0
Автор Агент «Гермес» + Nous Research
Лицензия Массачусетский технологический институт
Платформы Linux, MacOS, Windows
Теги BCI, нейроуправление, здоровье, фокус, ЭЭГ, когнитивное состояние, биометрия, нейронавыки

Ссылка: полная версия SKILL.md:::информация

Ниже приведено полное определение навыка, которое Гермес загружает при активации этого навыка. Это то, что агент видит в качестве инструкций, когда навык активен.

Интеграция NeuroSkill BCI

Подключите Hermes к работающему экземпляру NeuroSkill, чтобы прочитать Показатели мозга и тела в реальном времени с носимого устройства BCI. Используйте это, чтобы дать когнитивно-ориентированные реакции, предлагать меры вмешательства и отслеживать умственную работоспособность со временем.

⚠️ Только для исследовательского использования — NeuroSkill — это исследовательский инструмент с открытым исходным кодом. Это НЕ является медицинским устройством и НЕ прошло одобрение FDA, CE или каких-либо регулирующих органов. тело. Никогда не используйте эти показатели для клинической диагностики или лечения.

Полный справочник по метрикам см. в references/metrics.md, references/protocols.md для протоколов вмешательства и references/api.md для API WebSocket/HTTP.

Предварительные условия

Проверка настройки

node --version                    # Must be 20+
npx neuroskill status             # Full system snapshot
npx neuroskill status --json      # Machine-parseable JSON

Если npx Neuroskill status возвращает ошибку, сообщите пользователю: - Убедитесь, что настольное приложение NeuroSkill открыто. - Убедитесь, что устройство BCI включено и подключено через Bluetooth. - Проверьте качество сигнала — зеленые индикаторы в NeuroSkill (≥0,7 на электрод) - Если команда не найдена, установите Node.js 20+.

Ссылка на CLI: npx нейроскилл <команда>

Все команды поддерживают --json (необработанный JSON, безопасный для канала) и --full (человеческое резюме + JSON).

Команда Описание
статус Полный снимок системы: устройство, баллы, полосы, коэффициенты, сон, история
сессия [N] Разбивка по одной сессии с тенденциями первого и второго полугодия (0 = самые последние)
сессии Список всех записанных сессий за все дни
поиск ИНС-поиск сходства для нейроподобных исторических моментов
сравнить Сравнение сеансов A/B с дельтами показателей и анализом тенденций
спать [N] Классификация стадий сна (Пробуждение/N1/N2/N3/REM) с анализом
метка "текст" Создать аннотацию с отметкой времени в текущий момент
поисковые метки "запрос" Семантический векторный поиск по прошлым меткам
интерактивный «запрос» Кросс-модальный поиск по 4-слойному графу (текст → EXG → метки)
слушать Потоковая передача событий в реальном времени (по умолчанию 5 с, установите --секунд N)
умап 3D-проекция UMAP вложений сеансов
калибровать Открыть окно калибровки и запустить профиль
таймер Запустить таймер фокусировки (предустановки Pomodoro/Deep Work/Short Focus)
уведомить "заголовок" "тело" Отправьте уведомление ОС через приложение NeuroSkill
сырой '{json}' Передача необработанного JSON на сервер

Глобальные флаги

Флаг Описание
--json Необработанный вывод JSON (без ANSI, конвейерная безопасность)
--полный Человеческое резюме + раскрашенный JSON
--порт <N> Переопределить порт сервера (по умолчанию: автоматическое обнаружение, обычно 8375)
--ws Принудительный транспорт WebSocket
--http Принудительно использовать HTTP-транспорт
--k <N> Подсчет ближайших соседей (поиск, поисковые метки)
--секунд <N> Продолжительность прослушивания (по умолчанию: 5)
--тренды Показать тенденции показателей за сеанс (сеансы)
--точка Вывод Graphviz DOT (интерактивный)

1. Проверка текущего состояния

Получайте текущие показатели

npx neuroskill status --json

Всегда используйте --json для надежного анализа. Вывод по умолчанию раскрашен человекочитаемый текст.

Ключевые поля в ответе

Объект «scores» содержит все текущие показатели (шкала 0–1, если не указано иное):

{
  "scores": {
    "focus": 0.70,           // β / (α + θ) — sustained attention
    "relaxation": 0.40,      // α / (β + θ) — calm wakefulness
    "engagement": 0.60,      // active mental investment
    "meditation": 0.52,      // alpha + stillness + HRV coherence
    "mood": 0.55,            // composite from FAA, TAR, BAR
    "cognitive_load": 0.33,  // frontal θ / temporal α · f(FAA, TBR)
    "drowsiness": 0.10,      // TAR + TBR + falling spectral centroid
    "hr": 68.2,              // heart rate in bpm (from PPG)
    "snr": 14.3,             // signal-to-noise ratio in dB
    "stillness": 0.88,       // 0–1; 1 = perfectly still
    "faa": 0.042,            // Frontal Alpha Asymmetry (+ = approach)
    "tar": 0.56,             // Theta/Alpha Ratio
    "bar": 0.53,             // Beta/Alpha Ratio
    "tbr": 1.06,             // Theta/Beta Ratio (ADHD proxy)
    "apf": 10.1,             // Alpha Peak Frequency in Hz
    "coherence": 0.614,      // inter-hemispheric coherence
    "bands": {
      "rel_delta": 0.28, "rel_theta": 0.18,
      "rel_alpha": 0.32, "rel_beta": 0.17, "rel_gamma": 0.05
    }
  }
}

Также включает в себя: «устройство» (состояние, батарея, прошивка), «signal_quality» (для каждого электрода 0–1), «сеанс» (длительность, эпохи), «вложения», «метки», сводка «сна» и «история».

Интерпретация вывода

Разберите JSON и переведите метрики на естественный язык. Никогда не сообщайте необработанные данные одни лишь цифры — всегда придавайте им значение:

ДЕЛАТЬ:

«Ваш фокус сейчас твердый на 0,70 — это территория состояния потока. Сердце Частота стабильна на уровне 68 ударов в минуту, а ваш ФАА положительный, что говорит о хорошем подход к мотивации. Прекрасное время, чтобы заняться чем-то сложным».

НЕЛЬЗЯ:

«Фокус: 0,70, Релаксация: 0,40, ЧСС: 68»

Ключевые пороговые значения интерпретации (полное руководство см. в references/metrics.md): - Фокус > 0,70 → обтекайте территорию государства, защищайте ее - Фокус < 0,40 → предложите перерыв или протокол - Сонливость > 0,60 → предупреждение об усталости, риск микросна - Расслабление < 0,30 → необходимо вмешательство при стрессе - Когнитивная нагрузка > 0,70 продолжительная → выбросить сознание или сломаться - TBR > 1,5 → тета-доминантность, снижение исполнительного контроля - ФАУ < 0 → отказ/негативный эффект — рассмотреть вопрос о ребалансировке FAA - SNR < 3 дБ → ненадежный сигнал, предложите переместить электрод.

2. Анализ сессии

Разбивка по одному сеансу

npx neuroskill session --json         # most recent session
npx neuroskill session 1 --json       # previous session
npx neuroskill session 0 --json | jq '{focus:.metrics.focus, trend:.trends.focus}'

Возвращает полные показатели с трендами первого и второго полугодия («вверх», «вниз», «флэт»). Используйте это, чтобы описать, как развивалась сессия:

«Ваш фокус начался с 0,64 и к концу поднялся до 0,76 — явный восходящий тренд. Когнитивная нагрузка снизилась с 0,38 до 0,28, что позволяет предположить, что задача стала более автоматической. как ты поселился."

Список всех сеансов

npx neuroskill sessions --json
npx neuroskill sessions --trends      # show per-session metric trends

3. Исторический поиск

Поиск сходства нейронов

npx neuroskill search --json                    # auto: last session, k=5
npx neuroskill search --k 10 --json             # 10 nearest neighbors
npx neuroskill search --start <UTC> --end <UTC> --json

Находит моменты в истории, которые нейронно похожи, используя приближение HNSW. поиск ближайшего соседа по 128-D вложениям ZUNA. Возвращает статистику расстояния, временное распределение (часы суток) и наиболее подходящие дни.

Используйте это, когда пользователь спрашивает: - «Когда я последний раз был в таком состоянии?» - «Найди мои лучшие фокус-сессии» - «Когда я обычно терплю крах днем?»

Поиск по семантической метке

npx neuroskill search-labels "deep focus" --k 10 --json
npx neuroskill search-labels "stress" --json | jq '[.results[].EXG_metrics.tbr]'

Ищет текст метки с использованием векторных вложений (Xenova/bge-small-en-v1.5). Возврат сопоставление меток со связанными с ними показателями EXG во время маркировки.

Межмодальный поиск по графу

npx neuroskill interactive "deep focus" --json
npx neuroskill interactive "deep focus" --dot | dot -Tsvg > graph.svg

Четырехслойный график: запрос → текстовые метки → точки EXG → близлежащие метки. Используйте --k-text, --k-EXG, --reach <минуты> для настройки.

4. Сравнение сессий

npx neuroskill compare --json                   # auto: last 2 sessions
npx neuroskill compare --a-start <UTC> --a-end <UTC> --b-start <UTC> --b-end <UTC> --json

Возвращает дельты показателей с абсолютным изменением, процентным изменением и направлением ~50 показателей. Также включает массивы insights.improved[] и insights.declined[], подготовка сна для обоих сеансов и идентификатор задания UMAP.

Интерпретируйте сравнения с учетом контекста — упоминайте тенденции, а не только дельты:

«Вчера у вас было два сильных блока фокусировки (10 утра и 14 часов). Сегодня у вас был один примерно с 11 утра это продолжается. Ваша общая вовлеченность сегодня выше но всплесков стресса было больше — ваш индекс стресса подскочил на 15% и ФАУ чаще оказывалось отрицательным».

# Sort metrics by improvement percentage
npx neuroskill compare --json | jq '.insights.deltas | to_entries | sort_by(.value.pct) | reverse'

5. Данные о сне

npx neuroskill sleep --json                     # last 24 hours
npx neuroskill sleep 0 --json                   # most recent sleep session
npx neuroskill sleep --start <UTC> --end <UTC> --json

Возвращает поэтапную стадию сна (5-секундные окна) с анализом: - Коды стадий: 0=Пробуждение, 1=N1, 2=N2, 3=N3 (глубокий), 4=REM - Анализ: эффективность_pct, onset_latency_min, rem_latency_min, количество боев. - Здоровые мишени: N3 15–25 %, REM 20–25 %, эффективность >85 %, начало <20 мин.

npx neuroskill sleep --json | jq '.summary | {n3:.n3_epochs, rem:.rem_epochs}'
npx neuroskill sleep --json | jq '.analysis.efficiency_pct'

Используйте это, когда пользователь упоминает сон, усталость или восстановление.

6. Маркировка моментов

npx neuroskill label "breakthrough"
npx neuroskill label "studying algorithms"
npx neuroskill label "post-meditation"
npx neuroskill label --json "focus block start"   # returns label_id

Автоматически отмечайте моменты, когда: - Пользователь сообщает о прорыве или понимании - Пользователь запускает новый тип задачи (например, «переход на проверку кода»). - Пользователь заполняет важный протокол - Пользователь просит отметить текущий момент - Происходит заметный переход состояний (вход/выход из потока)

Метки хранятся в базе данных и индексируются для последующего поиска с помощью «поисковых меток». и «интерактивные» команды.

7. Потоковая передача в реальном времени

npx neuroskill listen --seconds 30 --json
npx neuroskill listen --seconds 5 --json | jq '[.[] | select(.event == "scores")]'

Потоковая передача событий WebSocket в реальном времени (EXG, PPG, IMU, оценки, метки) для указанных продолжительность. Требуется соединение WebSocket (недоступно с --http).

Используйте это для сценариев непрерывного мониторинга или для наблюдения за изменениями показателей в режиме реального времени. во время протокола.

8. Визуализация UMAP

npx neuroskill umap --json                      # auto: last 2 sessions
npx neuroskill umap --a-start <UTC> --a-end <UTC> --b-start <UTC> --b-end <UTC> --json

3D-проекция UMAP с графическим ускорением встроенных элементов ZUNA. separation_score показывает, насколько нейронно различны два сеанса: - > 1,5 → Сеансы нейронно различны (разные состояния мозга) - < 0,5 → Похожие состояния мозга на обоих сеансах

9. Проактивное информирование государства

Проверка начала сеанса

В начале сеанса при необходимости запустите проверку статуса, если пользователь упоминает он носит свое устройство или спрашивает об его состоянии:

npx neuroskill status --json

Введите краткое описание состояния:

«Быстрая проверка: концентрация внимания повышается на 0,62, расслабление хорошее на 0,55, а ваш ФАУ позитивно — задействована мотивация подхода. Похоже, начало хорошее».

Когда следует активно упоминать состояние

Упоминайте когнитивное состояние только, когда: - Пользователь прямо спрашивает («Как у меня дела?», «Проверьте мою концентрацию») - Пользователь сообщает о трудностях с концентрацией внимания, стрессе или усталости. - Критический порог пересечен (сонливость > 0,70, концентрация внимания < 0,30 устойчива) - Пользователь собирается сделать что-то требующее когнитивных функций и запрашивает готовность.

НЕ прерывайте состояние потока для отчета о показателях. Если фокус > 0,75, защитите сессия — молчание — правильный ответ.

10. Предложение протоколов

Когда метрики указывают на необходимость, предложите протокол из «references/protocols.md». Всегда спрашивайте перед началом — никогда не прерывайте состояние потока:

«Последние 15 минут ваше внимание снижается, а TBR преодолевает 1,5 — признаки тета-доминирования и умственной усталости. Хочешь, чтобы я провел тебя через Тета-бета-якорь нейробиоуправления? Это 90-секундное упражнение, в котором используются ритмичные упражнения. счет и дыхание для подавления теты и подъема бета».

Ключевые триггеры: - Фокус < 0,40, TBR > 1,5 → Тета-бета-якорь нейробиоуправления или коробочное дыхание - Расслабление < 0,30, высокий индекс стресса → Сердечная когерентность или Дыхание 4-7-8. - Когнитивная нагрузка > 0,70 продолжительная → Разгрузка когнитивной нагрузки (свалка разума) - Сонливость > 0,60 → Сброс ультрадиана или сброс бодрствования. - ФАУ < 0 (отрицательный) → Ребалансировка ФАУ - Состояние потока (фокус > 0,75, вовлеченность > 0,70) → НЕ прерывайте - Высокая неподвижность + head_index → Последовательность расслабления шеи - Низкое RMSSD (<25 мс) → Тонирование вагуса

11. Дополнительные инструменты

Таймер фокусировки

npx neuroskill timer --json

Запускает окно Таймера фокусировки с помощью Pomodoro (25/5), Deep Work (50/10) или Предустановки короткого фокуса (15/5).

Калибровка

npx neuroskill calibrate
npx neuroskill calibrate --profile "Eyes Open"

Открывает окно калибровки. Полезно, когда качество сигнала плохое или пользователь хочет установить персонализированный базовый уровень.

Уведомления ОС

npx neuroskill notify "Break Time" "Your focus has been declining for 20 minutes"

Передача необработанного JSON

npx neuroskill raw '{"command":"status"}' --json

Для любой команды сервера, еще не сопоставленной с подкомандой CLI.

Обработка ошибок

Ошибка Вероятная причина Исправить
npx нейроскилл статус зависает Приложение NeuroSkill не работает Открыть настольное приложение NeuroSkill
device.state: "отключено" Устройство BCI не подключено Проверьте Bluetooth, батарею устройства
Все результаты возвращаются 0 Плохой контакт электродов Переставьте повязку, смочите электроды
Значения signal_quality < 0,7 Свободные электроды Отрегулируйте посадку, очистите контакты электродов
ОСШ < 3 дБ Шумный сигнал Минимизируйте движения головой, проверьте окружающую среду
команда не найдена: npx Node.js не установлен Установите Node.js 20+

Примеры взаимодействий

"Как у меня сейчас дела?"

npx neuroskill status --json

→ Интерпретируйте результаты естественно, упоминая концентрацию, расслабление, настроение и любые заметные коэффициенты (ФАУ, TBR). Предлагайте действие только в том случае, если метрики указывают на необходимость.

"Я не могу сконцентрироваться"

npx neuroskill status --json

→ Проверьте, подтверждают ли это показатели (высокая тета, низкая бета, повышение TBR, высокая сонливость). → В случае подтверждения предложите соответствующий протокол из references/protocols.md. → Если показатели в порядке, проблема может быть мотивационной, а не неврологической.

"Сравните мое внимание сегодня и вчера"

npx neuroskill compare --json

→ Интерпретируйте тенденции, а не только цифры. Укажите, что улучшилось, что ухудшилось и возможные причины.

"Когда я последний раз был в состоянии потока?"

npx neuroskill search-labels "flow" --json
npx neuroskill search --json

→ Сообщайте о временных метках, связанных показателях и о том, что делал пользователь (из ярлыков).

"Как я спал?"

npx neuroskill sleep --json

→ Сообщите об архитектуре сна (N3%, REM%, эффективность), сравните со здоровыми целями, и обратите внимание на любые проблемы (высокие периоды бодрствования, низкий уровень REM).

"Запомните этот момент — у меня только что случился прорыв"

npx neuroskill label "breakthrough"

→ Подтвердите сохранение метки. При желании запишите текущие показатели, чтобы запомнить состояние.

Ссылки