Ультралёгкие заметки на AutoHotkey

Зачем делать своё мини‑приложение для заметок

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

Краткая цель проекта:

Открывать окно заметки одной комбинацией клавиш.
Вводить заголовок и тело заметки.
Сохранять заметку как текстовый/Markdown файл с безопасным именем файла.

Без форматирования, без шаблонов и лишних окон — «микро‑приложение», которое не мешает.

Важно: это руководство рассчитано на Windows и AutoHotkey. Оно не требует глубоких знаний AHK — все шаги подробно описаны.

Основной план и архитектура (умственная модель)

Ментальная модель приложения очень простая:

Скрипт создаёт GUI (окно) с двумя полями и кнопкой.
Нажатие клавиши на рабочем столе запускает скрипт (или ярлык с хоткеем).
Нажатие OK или закрытие окна запускает сохранение: заголовок превращается в имя файла (очищается от недопустимых символов), тело записывается в %NotesPath% с добавленным суффиксом.
Скрипт завершает работу.

Если вы планируете другие сценарии (несколько заметок в одном файле, синхронизация, теги), рассмотрите расширения внизу.

Когда это не подойдёт

Если вам нужен шифрованный журнал — хранить открытые Markdown‑файлы небезопасно.
Если вы работаете на нескольких ОС и хотите единую базу — лучше использовать кроссплатформенные приложения.
Если необходимы сложные шаблоны, версии и поиск по базе — это уже не «lite». Используйте заметочники вроде Obsidian/Notion.

Как установить AutoHotkey

AutoHotkey — сторонняя утилита. Скачайте установщик с официального сайта AutoHotkey. Выберите текущую стабильную версию (Current Version). После установки вы не увидите изменений в системе: AutoHotkey — это среда выполнения для AHK‑скриптов.

Подсказка: пропускайте V1 (устаревшую) и V2 (если в бета‑стадии у вас нет причины её использовать). Для этого руководства используем актуальную стабильную ветку.

Как создать новый скрипт AutoHotkey

Откройте Проводник и выберите папку, где будет скрипт (рабочий стол, Documents и т.п.).
Нажмите правой кнопкой → New → AutoHotkey Script.

Создать новый скрипт AutoHotkey через меню Проводника

Переименуйте файл, откройте его в удобном редакторе (Notepad, Notepad++, VS Code).
Сохраните резервную копию перед редактированием, если будете вносить изменения.

Основные переменные и где хранить заметки

В начале скрипта удобно объявить две переменные:

NotesPath — полный путь к папке, куда будут сохраняться заметки.
FileNameExtra — суффикс, который добавляется к названию файла, например «_MUOnote.md».

Пример (не забывайте заменить путь на свой):

NotesPath = A:\00_Cloud_Storage\Dropbox\Notes\Obsidian\Duckland!Inbox
FileNameExtra = _MUOnote.md

Настройка путей и переменных в скрипте AHK

Совет: используйте папку, которая синхронизируется (Dropbox, OneDrive), если хотите получить доступ к заметкам с других устройств.

Создаём GUI в AutoHotkey — код и объяснение

Ниже — минимальная GUI‑часть. Добавляйте её в ваш .ahk файл.

Gui, QN:Font, s14 c666666
Gui, QN:Add, Edit, x5 y5 w550 h60 vTitle, Title - Filename
Gui, QN:Font, s12 c444444
Gui, QN:Add, Edit, x5 y70 w550 h600 vNote, %Clipboard%
Gui, QN:Add, Button, x5 y680 w550 h50, OK
Gui, QN:Show, x0 y0 w560 h735, MUONotes

Пояснения к строкам:

Gui, QN:Font, s14 c666666 — задаёт шрифт для следующих элементов: размер 14, серый цвет.
Gui, QN:Add, Edit, x5 y5 w550 h60 vTitle, Title - Filename — добавляет поле для заголовка (с начальным текстом).
Следующий блок меняет шрифт и добавляет большое поле для заметки, предварительно заполняя его содержимым буфера обмена (%Clipboard%).
Кнопка OK привязана к обработчику по умолчанию.
Gui, QN:Show — показывает окно в верхнем левом углу с размерами 560×735 и заголовком MUONotes.

Изображение результата:

Интерфейс MUONotes: поле заголовка, большое поле заметки и кнопка OK

Логика сохранения: что должен делать OK

Добавьте обработчик для кнопки OK, чтобы сохранить заметку:

QNButtonOK:
FileEncoding, UTF-8-RAW
Gui, QN:Submit
TempClipboard = %ClipBoard%
ClipBoard = %Title%
gosub CleanText
FileName = %ClipBoard%
ClipBoard = %TempClipboard%
FinalFilename = %NotesPath%\%FileName%%FileNameExtra%
FileDelete, %FinalFileName%
FileAppend, %Note%, %FinalFileName%
return

Пошагово:

Метка QNButtonOK: — запускается при нажатии кнопки OK.
FileEncoding, UTF-8-RAW — устанавливает кодировку создаваемого файла (UTF‑8 без BOM).
Gui, QN:Submit — получает значения элементов GUI и присваивает их переменным (Title и Note).
Мы временно сохраняем текущий буфер обмена, затем копируем в ClipBoard содержимое Title и отправляем его в функцию CleanText (для получения безопасного имени файла).
Собираем FinalFilename из NotesPath + FileName + FileNameExtra.
FileDelete — удаляем существующий файл с таким именем (чтобы записать новый), затем FileAppend записывает текст.

Важно: этот код удаляет файл с тем же именем перед записью. Если вам нужно сохранять каждую заметку отдельно (без перезаписи), замените логику формирования FinalFilename на добавление временной метки.

Функция очистки заголовка (sanitize)

Эта функция удаляет неподходящие символы и убирает лишние пробелы. Вставьте её в скрипт:

CleanText:
CleanMePlease = %ClipBoard%
CleanMePlease := Regexreplace(CleanMePlease, "a-zA-Z0-9", " ")
loop
{
    StringReplace, CleanMePlease, CleanMePlease, %A_SPACE%%A_SPACE%, %A_SPACE%, all
    if ErrorLevel <> 0
        break
}
ClipBoard = %CleanMePlease%
Return

Пояснение:

Regexreplace оставляет только буквенно‑числовые символы.
Цикл удаляет двойные пробелы, пока их не останется.
Результат возвращается в буфер обмена и затем используется как FileName.

Примечание: для локализации файловых имён вы можете расширить регулярку, чтобы разрешить символы Unicode (например, кириллицу). Если вам нужны имена файлов с русскими буквами, измените RegEx соответственно.

Завершение функций и выход приложения

Не забудьте закрывать функции командой return после каждого блока. Иначе окно может закрываться сразу или скрипт останется работать в трее. Вставьте в конце:

QNGuiEscape:
QNGuiClose:
ExitApp
return

Это гарантирует, что при закрытии окна скрипт корректно завершится.

Определение момента выхода приложения в AHK

Запуск и привязка хоткея к ярлыку

Создайте ярлык на .ahk файл на рабочем столе.
Правый клик → Свойства → Shortcut key → нажмите желаемую комбинацию (например Ctrl+Alt+N).
Сохраните. Дважды кликните по файлу, чтобы запустить. Теперь комбинация откроет окно.

Совет: если хотите, чтобы скрипт всегда работал в фоне, положите ярлык в папку автозагрузки Windows.

Варианты улучшений (когда полезно и как реализовать)

Уникальные имена файлов по времени — добавьте временную метку:

FormatTime, timeNow, , yyyy-MM-dd_HH-mm-ss
FinalFilename = %NotesPath%\%FileName%_%timeNow%%FileNameExtra%

Добавить тег/метку — добавьте ещё одно поле Edit для тегов и вставляйте его в имя файла или в YAML‑шапку заметки.
Append вместо перезаписи — используйте FileAppend без FileDelete и добавляйте разделитель между заметками.
Диалог выбора папки — используйте FileSelectFolder для интерактивного выбора NotesPath.
Поддержка нескольких профилей (работа/личные) — храните несколько NotesPath и добавляйте быстрый выбор.

Безопасность и конфиденциальность

Файлы сохраняются в открытом виде. Для конфиденциальных данных используйте шифрование (например VeraCrypt или встроенное шифрование хранилища).
Помните о синхронизации: облачные сервисы могут хранить данные на серверах третьих лиц.

Отказоустойчивость и тестирование (SOP)

Короткий SOP для проверки работоспособности скрипта:

Запустите скрипт вручную. Окно должно появиться.
Вставьте текст в поле заметки (Ctrl+V), добавьте заголовок.
Нажмите OK.
Проверьте, что файл появился в NotesPath с ожидаемым именем и содержимым.
Закройте приложение и убедитесь, что процесс AHK не висит в трее.

Критерии приёмки:

Окно открывается по хоткею/вручную.
Текст сохраняется в UTF‑8 и открывается в редакторе корректно.
Имя файла не содержит недопустимых символов.
Файлы не теряются при повторном сохранении (или ведётся ожидаемое поведение перезаписи).

Тестовые кейсы:

Заголовок с символами: «Привет/мир: тест?» → результат: безопасное имя файла.
Большой объём текста (10k+ символов) → файл сохраняется без потери данных.
Буфер обмена содержит картинку → приложение не ломается.

Отладка и частые проблемы

Проблема: окно появляется и тут же закрывается.
Решение: проверьте, что в конце каждого блока есть return; убедитесь, что нет лишнего ExitApp.

Проблема: файл не создаётся или возникает ошибка доступа.
Решение: проверьте права на папку NotesPath и правильность пути. Если папки нет, создайте её заранее.

Проблема: имя файла пустое при сохранении.
Решение: добавьте fallback — если FileName пуст, используйте временную метку.

Примеры расширений кода (шаблоны)

Добавление временной метки, если заголовок пуст:

if FileName =
{
    FormatTime, fileTime, , yyyy-MM-dd_HH-mm-ss
    FileName = note_%fileTime%
}

Добавление YAML‑шапки в Markdown:

yaml = ---
Title: %Title%
Date: %A_Now%
---

FileAppend, %yaml%%Note%, %FinalFileName%

Роль‑ориентированные чеклисты

Для разработчика:

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

Для продвинутого пользователя:

Хоткей назначен.
Путь синхронизируется.
Испытано на UTF‑8.

Для обычного пользователя:

Простое окно открывается.
Можно быстро сохранить заметку.

Ментальные эвристики и рекомендации по использованию

Думайте об этом приложении как о «черновике входящих» (inbox), который позже можно перенести в более сложную систему заметок.
Не используйте для секретов без шифрования.
Для повышения скорости вставьте горячую клавишу запуска в автозагрузку.

Краткое сравнение с альтернативами

Существующие приложения (Notepad, Notepad++, Obsidian): больше возможностей, но не всегда мгновенны.
Скрипт AHK: максимально быстрое открытие, лёгкая кастомизация, хранение локально.

FAQ

Q: Нужно ли устанавливать AutoHotkey v2?

A: Для приведённого кода рекомендуется стабильная версия v1. Если вы предпочитаете v2, адаптируйте синтаксис (в v2 много изменений).

Q: Как разрешить в именах файлов русские буквы?

A: Измените регулярное выражение в CleanText на поддержку Unicode. Тестируйте на создании и открытии файла в редакторе.

Q: Как сохранить несколько заметок в одном файле?

A: Используйте FileAppend без удаления файла и добавляйте разделитель (например “\n—\n”).

Итоги и советы по следующему шагу

Вы создали простое, быстрое и настраиваемое приложение для заметок. Теперь вы можете:

Добавить теги и шаблоны.
Внедрить уникальные имена с метками времени.
Интегрировать синхронизацию через выбранный облачный сервис.

Важно: протестируйте сохранение, кодировку и поведение при пустом заголовке.

Короткая сводка:

Скрипт даёт мгновенный доступ к полю заметок.
Сохраняет в UTF‑8.
Можно расширять: метки, шаблоны, шифрование.

Спасибо — теперь у вас есть своё ультралёгкое приложение MUONotes, сделанное на AutoHotkey.

Как создать ультралёгкое приложение для заметок на AutoHotkey