Инструкции

Как надиктовать комментарий к коду в любом приложении

Марк Весёлый · основатель «Потока» · ~5 мин
Как надиктовать комментарий к коду в любом приложении

Комментарий к коду можно надиктовать в любом текстовом редакторе так же, как обычный текст: поставьте курсор в нужное место в коде и произнесите мысль обычной фразой. Поток (potok.now) вставляет надиктованное в активное поле любого приложения и выдаёт голосом около 900 знаков в минуту — заметно быстрее печати.

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

Как в реальной задаче надиктовать комментарий к коду

Разработчица дописывает функцию, которая при сбое запроса к серверу выжидает паузу и пробует ещё раз, и хочет сразу оставить коллегам объяснение этой логики, пока не забыла сама, почему сделала именно так. Печатать длинное пояснение по буквам — время, которого жалко; проще сказать его вслух, не отрывая рук от клавиатуры для остального кода. Курсор стоит в начале строки комментария, зажимается горячая клавиша «Потока», и мысль произносится обычной фразой — наш пример: «этот блок обрабатывает повторные запросы с задержкой». Точки, запятые и заглавные буквы программа ставит сама, отдельно их называть не требуется. Клавишу отпустили — сказанное появилось ровно на месте курсора, а не в конце файла и не строкой ниже. Если в объяснении попадается редкое имя переменной или специальный термин, готовиться заранее не нужно: модель обучена под русскую речь, включая термины, а совсем нечастые слова добавляют в личный словарь — это функция тарифа Pro.

Три шага диктовки в «Потоке»: зажал Ctrl + Space, сказал фразу вслух, текст появился в активном поле
Диктовка в «Потоке»: горячая клавиша, речь, готовый текст в том окне, где стоит курсор.

Как повторить у себя

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

  1. Поставьте курсор в строку, где должен появиться комментарий.
  2. Нажмите и держите горячую клавишу — в настройках по умолчанию это Ctrl+Space.
  3. Проговорите пояснение обычными словами, не выделяя знаки препинания отдельно.
  4. Отпустите клавишу — надиктованный текст встанет туда, где стоял курсор.
  5. Пробегите глазами получившийся комментарий и подправьте то, что требует уточнения.

Если Ctrl+Space пересекается с сочетанием клавиш редактора или IDE, в настройках приложения его меняют на своё: другую клавишу, комбинацию или боковую кнопку мыши. Голосовой ввод на компьютере ещё не настроен — сначала загляните в инструкцию по его включению на ноутбуке.

Платформы
Windows, macOS, Linux
Бесплатно
Free: 2500 слов в неделю; первые 14 дней — полный доступ без карты
Pro
Pro 690 ₽/мес, 499 ₽/мес при оплате за год
Оплата
российские карты, рубли
Где распознаётся речь
облако, серверы в России; нужен интернет

«Поток» — облачный сервис: распознавание идёт на серверах в России, без интернета он не работает. Скачать: potok.now/download

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

Кому способ не подойдёт

«Поток» — облачный сервис, распознавание идёт на серверах в России, и без интернета оно не работает; сама запись при этом сохраняется в истории, и её можно отправить на распознавание повторно кнопкой «Перераспознать», когда сеть вернётся. Отдельных голосовых команд у программы нет, так что подвинуть курсор в другое место файла или переписать уже сказанное придётся руками — голосом это не сделать. На телефоне такой способ тоже недоступен: приложение существует только для компьютеров с Windows, macOS и Linux. И тем, кто комментирует код весь рабочий день, бесплатных 2500 слов в неделю может оказаться мало.

Сравнение «Потока» и Win+H по строкам: платформы, бесплатно, оплата из рф, распознавание
«Поток» и Win+H: условия по официальным сайтам сервисов.

Частые вопросы

Нужен ли редактору кода особый режим для диктовки комментариев?

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

Можно ли надиктовать комментарий к коду с телефона?

Через «Поток» нет — версий для Android и iPhone у него нет, есть версии только для компьютеров с Windows, macOS и Linux.

В каких случаях диктовать выгоднее, чем печатать?

Диктовка особенно выгодна для длинных текстов «с ходу» — черновиков писем, заметок, ответов в мессенджерах, конспектов, а также когда руки заняты или устали (например, при RSI). Для коротких точных правок (однословные команды, код) печать часто быстрее.

Работает ли голосовой ввод с любым микрофоном?

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

Какие есть способы ввода текста голосом, кроме специализированных программ?

Встроенные системные инструменты (Win+H в Windows, Диктовка в macOS, Voice Typing в Google Docs, Gboard на Android), голосовые расширения браузера, а также специализированные десктопные/веб-сервисы (Поток и аналоги), которые работают поверх любого приложения через хоткей.

Насколько голосовой ввод быстрее клавиатуры?

У Потока заявлено около 900 знаков в минуту голосом против около 200 при печати — примерно в 4 раза быстрее. Это оценка продукта, а не независимый замер.

Как начать

«Поток» есть для Windows, macOS и Linux. Две недели всё открыто бесплатно, дальше — 2500 слов в неделю без оплаты. «Поток» — облачный сервис: распознавание идёт на серверах в России, без интернета он не работает.

Скачать «Поток»

Одна подписка — два инструмента: диктовка в любой программе на компьютере и @potok_now_bot в Telegram, который расшифровывает голосовые, аудио и видео.

Встроенная диктовка и «Поток»

По справке Microsoft и Apple.
СредствоГде работаетРусский языкГде распознаётся речь
Голосовой ввод Windows (Win+H)Windows 10 и 11только в Windows 11облако Microsoft, без интернета не работает
Диктовка macOSmacOSестьна устройстве или на серверах Apple
ПотокWindows, macOS, Linuxосновной языкоблако, серверы в России, без интернета не работает
Расчёт по средней скорости печати и речи, не замер.
ЗадачаЗнаковПечать (200 зн/мин)Голос (900 зн/мин)
ответ в чате3002 мин0.5 мин
письмо15008 мин1.7 мин
пост или протокол400020 мин4.4 мин
статья1000050 мин11.1 мин

Первоисточники: support.microsoft.com · support.apple.com

Марк Весёлый — основатель «Потока». Пишет о голосовом вводе на русском: как диктовать в рабочих программах, что мешает и чем это чинится.
© Поток · Липатников Владимир Олегович · ИНН 502915859701 · Оферта Сравнения · Вопросы и ответы · О проекте Бесплатный голосовой ввод · Голосовой ввод для нейросетей · Данные и 152-ФЗ · Голосовой ввод на Mac · Тарифы бота · 14 дней Pro за отзыв