От установки до своих сценариев.

Установка

Kslov работает на Windows 10/11 и Linux. Основной сценарий — установщик для Windows; на Linux приложение запускается из исходников. Доступ к приложению — по ключу активации: 299 ₽ за месяц или 1 199 ₽ навсегда. Ключ и сборку выдают в Telegram‑магазине. Для голосовых команд нужен микрофон, для распознавания — модель Vosk, которая идёт вместе с приложением.

Windows

1. Получите ключ и сборку в Telegram‑магазине. Тарифы — 299 ₽ за месяц или 1 199 ₽ навсегда.
2. Запустите установщик и дождитесь завершения. Ярлык появится в меню «Пуск».
3. Запустите Kslov, откройте Настройки → Модель, активируйте ключ и разрешите доступ к микрофону.

Linux

После получения доступа приложение можно запустить из исходников. Понадобятся Python 3.12, GTK/WebKit, PortAudio и eSpeak, установленные в системе. Ключ активации потребуется и здесь. Затем:

python3 -m venv --system-site-packages .venv
.venv/bin/pip install -r requirements.txt
chmod +x run.sh
./run.sh

Часть возможностей зависит от окружения: раздельная громкость приложений и глобальный хоткей используют pactl/wpctl и оконный менеджер.

Активация

Kslov распространяется по ключу активации, и ключ нужен для работы приложения. Доступны два тарифа: 299 ₽ за месяц и 1 199 ₽ навсегда. Для Kslov AI можно использовать Kslov Server или собственный API-ключ в настройках модели.

Тарифы

1. Откройте Настройки → Модель.
2. Вставьте ключ в поле «Лицензионный ключ». Формат выглядит как JRV-XXXX-XXXX-XXXX-XXXX.
3. Нажмите «Активировать» и дождитесь ответа сервера.

Статус лицензии, срок действия и HWID устройства отображаются там же. Ключ привязывается к компьютеру при активации; для переноса на другое устройство нужна отвязка на стороне продавца.

Первый запуск

После установки и активации пройдите четыре коротких шага — этого достаточно для первых команд.

1. Микрофон

Откройте Настройки → Голос и микрофон, выберите устройство ввода и проверьте уровень. Если фраза не распознаётся, поднимите чувствительность или уменьшите «Тишину до остановки».

2. Кодовое слово

В разделе Пробуждение включите «Слушать кодовое слово». По умолчанию это «Джарвис». Распознавание Vosk работает локально и не отправляет аудио в облако.

3. Быстрый вызов

Ctrl + Alt + Пробел открывает чат поверх любых окон. Комбинацию можно отключить в настройках системы.

4. Голос

В разделе Озвучка выберите Дмитрия, Светлану или системный голос. Здесь же настраиваются скорость и громкость речи.

Виджеты

Раздел Виджеты открывается с нижней панели приложения и собирает главное на одном экране. Доступны семь карточек: часы, погода, курсы ЦБ, задачи, музыка, состояние системы и быстрые действия.

Раскладка

Перетаскивайте карточку за заголовок, чтобы поменять место, и тяните за правый нижний угол, чтобы изменить размер. Расположение сохраняется и восстанавливается при следующем запуске. Кнопка «Сбросить» возвращает стандартную сетку, а «Обновить» принудительно запрашивает погоду, курсы и данные системы.

Задачи

Нажмите «+» в заголовке карточки, введите текст и нажмите Enter. Форма остаётся открытой, чтобы можно было добавить несколько задач подряд. Клик по задаче отмечает её выполненной, а кнопка × удаляет запись. Изменения сразу сохраняются на компьютере.

Быстрые действия

Нажмите шестерёнку в карточке, чтобы открыть редактор. В нём можно добавлять, удалять и искать действия, а также собрать до восьми кнопок. В каталог попадают безопасные действия без обязательных параметров; Блокнот доступен отдельной кнопкой. Конфигурация сохраняется вместе с настройками интерфейса.

Музыка

Виджет показывает текущий трек, исполнителя, обложку, позицию и длительность. Поддерживаются приложения, которые публикуют медиасессию Windows SMTC: браузеры, Spotify, Яндекс Музыка и другие. Доступны пауза, переключение треков и перемотка, если плеер разрешает изменение позиции. При повторе одного трека прогресс продолжает движение и не застревает в конце.

Погода, курсы и система

Погода и курсы ЦБ обновляются автоматически с разумным кэшированием. В карточке видно время последнего ответа, а при отсутствии сети сохраняются последние данные с пометкой «нет связи». Загрузка CPU в виджете усредняется за несколько секунд, поэтому кратковременные всплески не выглядят как постоянная нагрузка.

Команды

Команда — это одна или несколько фраз и действия, которые запускаются по ним. Команды хранятся в commands.json и редактируются прямо в приложении: дерево команд, карточка, шаги, фразы, триггеры, импорт и экспорт.

Фразы и слоты

У команды может быть несколько вариантов запуска. Слоты в фигурных скобках позволяют вытащить значение из фразы и подставить его в шаг:

"phrases": ["громкость {percent}", "погода в {city}"],
"steps": [
  {"action": "set_volume", "params": {"level": "{percent}"}},
  {"action": "weather", "params": {"city": "{city}"}}
]

Шаблон со слотом проверяется раньше нечёткого совпадения, поэтому срабатывает точно. Имя слота — латинские буквы, цифры и подчёркивание, начинается с буквы.

Запуск и хранение

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

Сценарии

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

{
  "action": "hotkey", "params": {"keys": "win+d"}, "pause_ms": 800
},
{
  "action": "set_volume", "params": {"level": 0}
},
{
  "action": "open_url", "params": {"url": "https://www.kinopoisk.ru"}
},
{
  "action": "speak", "params": {"text": "Протокол выполнен"}
}

У каждого шага есть действие из реестра, параметры и необязательная пауза pause_ms. Флаг continue_on_error позволяет продолжить сценарий, если шаг завершился ошибкой.

Запись действий

Нажмите «Записать действия», выполните нужное вручную и остановите запись. Kslov сохранит выполненные действия как шаги. Повторное срабатывание того же действия с теми же параметрами подряд не дублируется.

Остановка и подтверждения

Сценарий можно остановить — проверка происходит перед каждым шагом. Действия с уровнем delete или power не выполняются без явного разрешения пользователя.

Триггеры

Кроме голосовой фразы команду можно запускать по горячей клавише, расписанию или событию.

Дни недели: 0 — понедельник, 6 — воскресенье. Пустой список означает каждый день. Менеджер триггеров перечитывает команды при изменении и не запускает одну и ту же команду параллельно.

Голос и распознавание

Голосовой пайплайн Kslov состоит из пробуждения, распознавания, выполнения и озвучки.

Микрофон → Wake Word → Vosk STT → команда или Kslov AI → действие → TTS

Распознавание

• Модель Vosk RU работает локально, интернет не нужен.
• Проверяются склонения, разбиение на слоги и типичные ошибки распознавания.
• Сквозная команда выполняется сразу: «Джарвис, открой Steam».
• Чувствительность и пауза окончания фразы настраиваются.

Озвучка

Основной голос — Edge Neural (Дмитрий или Светлана). При сбое Edge Kslov переключается на gTTS, а при полном отсутствии интернета — на системный SAPI5. Аудио кэшируется, поэтому повторные фразы звучат быстрее.

Kslov AI

Kslov AI отвечает на вопросы и выполняет задачи, которых нет среди локальных команд: ищет в сети, объясняет экран, собирает документы. Нужны интернет, активированное приложение и доступ к модели: Kslov Server или собственный API-ключ.

Провайдер

В разделе Модель можно использовать Kslov Server или свой OpenAI-совместимый API. Базовый адрес, ключ и модель задаются в настройках. Добавленная модель появляется в списке моделей чата.

Что умеет

• Веб-поиск через DuckDuckGo с опорой на найденные страницы.
• Генерация Word, PowerPoint и PDF с открытием файла в системе.
• Анализ экрана: объяснить ошибку или то, что происходит на экране.
• Обычный чат, история и продолжение диалога.

Системные команды имеют приоритет над AI-режимом: «открой браузер» выполнится локально, а не уйдёт в нейросеть.

Плагины

В Kslov 14 встроенных плагинов. Каждый включается отдельным переключателем в разделе Расширения → Плагины.

Для Telegram и Discord нужны собственные токены или webhook. Ключи хранятся в настройках приложения; не публикуйте их. Для документов и анализа экрана требуется доступ к Kslov AI.

MCP

MCP — способ подключить внешние инструменты к ассистенту. Kslov поддерживает stdio- и HTTP-серверы, умеет сохранять, изменять, удалять и реально проверять подключение. В каталоге уже есть 20 готовых серверов, включая Filesystem, Memory, Playwright, Context7, DeepWiki, Sequential Thinking, GitHub, Notion, Sentry, Brave Search, Tavily, Firecrawl, Slack, Puppeteer, Everything, PostgreSQL, Google Maps, GitLab, AWS, Obsidian и Home Assistant.

1. Откройте Расширения → MCP и выберите сервер в каталоге.
2. Для серверов с ключом заполните токен или переменные окружения (например, NOTION_TOKEN или BRAVE_API_KEY).
3. Нажмите «Проверить» — Kslov выполнит initialize и tools/list.
4. Оставьте переключатель сервера включённым — его инструменты появятся у ИИ в чате.

Данные и приватность

Kslov хранит данные локально и не синхронизирует их с облаком. На Windows используется каталог %LOCALAPPDATA%\Jarvis, на Linux — ~/.config/kslov.

Локальное распознавание Vosk и системные команды не отправляют данные в сеть. Запросы к Kslov AI уходят выбранному провайдеру; истории чата и содержимое экрана обрабатываются согласно правилам этого провайдера.

Резервная копия

Скопируйте commands.json и tasks.json, чтобы сохранить команды и напоминания. Для переноса на другой компьютер удобнее экспорт отдельных команд в JSON.

Обновления

Kslov проверяет наличие новой версии на сервере. Если обновление доступно, в шапке приложения появляется кнопка «Обновление».

1. Нажмите кнопку в шапке или откройте Настройки → О программе.
2. Загрузите новую сборку по ссылке.
3. Установите поверх текущей версии — настройки и команды сохранятся.

Что нового в 1.2.0

• Экран виджетов: часы, погода, курсы, задачи, музыка, система и быстрые действия.
• Задачи можно добавлять, отмечать выполненными и удалять прямо в карточке.
• Быстрые действия настраиваются в отдельном редакторе с поиском — до 8 кнопок.
• Музыкальный виджет показывает обложку, трек, позицию и перемотку; повтор больше не замораживает прогресс.
• Погода и курсы получили ручное обновление и время ответа, а CPU в системе считается стабильнее.
• Добавлен плагин Home Assistant; каталог MCP расширен до 20 серверов.

Актуальная версия — 1.2.0 от 25 октября 2026. Ключи и сборки выдаются в Telegram‑магазине @ImzxcSanu. Тарифы — 299 ₽ за месяц или 1 199 ₽ навсегда.

Частые проблемы

Kslov не слышит команду

• Проверьте устройство ввода и уровень микрофона в настройках.
• Поднимите чувствительность распознавания.
• Убедитесь, что микрофон не занят другой программой.

Не работает Ctrl + Alt + Пробел

Комбинацию может перехватывать другая программа. Отключите её в настройках или назначьте другой хоткей на команду.

Команда не находится

• Проверьте, включена ли команда и не отключена ли её папка.
• Посмотрите фразы: они должны произноситься так, как записаны, с учётом слотов.
• Пользовательские команды перекрывают встроенные — проверьте дубли.

Нет озвучки

Нейроголосам нужен интернет. При сбое Kslov переходит на gTTS, затем на системный SAPI5. Проверьте громкость речи и выбранный голос в настройках.

Kslov AI не отвечает

• Проверьте ключ и статус лицензии в разделе «Модель».
• Убедитесь, что есть интернет.
• Проверьте базовый адрес API и модель, если используете свой ключ.

MCP-сервер не проверяется

Для stdio-серверов нужны Node.js и npx. Проверьте команду запуска и доступность URL для HTTP-сервера.

Виджеты не обновляются

• Нажмите «Обновить» в правом верхнем углу экрана виджетов.
• Для погоды и курсов проверьте интернет: без сети остаются последние данные с пометкой «нет связи».
• Если карточки наложились, нажмите «Сбросить» — вернётся стандартная раскладка.

Виджет музыки пуст

• Сначала запустите воспроизведение в приложении, которое поддерживает медиасессию Windows.
• Проверьте, что трек виден в системном оверлее громкости Windows.
• Если плеер не разрешает управление позицией, перемотка будет недоступна, но название и обложка продолжат отображаться.

Linux: не работают громкость приложений или хоткей

Убедитесь, что установлены pactl/wpctl и поддерживаемый оконный менеджер. Часть действий зависит от окружения.