FLS-PLUS (Files Plus) v1.1

FLS-PLUS — программа для создания текстовых снимков файловых структур проектов с автоматическим определением кодировок (UTF-8 / CP1251).

---

🆕 Что нового в версии 1.1

Новые возможности:

• ✅ Асинхронное сканирование — интерфейс больше не зависает при сканировании больших папок
• ✅ Предварительный расчёт размера — перед сохранением показывается предполагаемый размер снимка
• ✅ Проверка свободного места — программа предупредит, если на диске недостаточно места
• ✅ Отмена операций — длительные операции можно прервать кнопкой "Отмена"
• ✅ Всплывающие подсказки с задержкой — более профессиональное поведение
• ✅ Защита от глубокой рекурсии — безопасность при очень глубоких папках (макс. 100 уровней)
• ✅ Изменение заголовка окна — показывает текущую активную вкладку
• ✅ Защита от одновременных операций — предотвращение конфликтов

Исправления:

• 🐛 Устранены утечки памяти при сворачивании больших проектов
• 🐛 Исправлено мерцание всплывающих подсказок
• 🐛 Исправлена ошибка с длинными путями (MAX_PATH)
• 🐛 Корректное определение кодировки файлов
• 🐛 Удалены неиспользуемые переменные

---

📋 О программе

FLS-PLUS (Files Plus) — это инструмент для разработчиков и системных администраторов, позволяющий:

• Построить псевдографическое дерево файлов и папок
• Автоматически определить кодировку файлов (UTF-8 / CP1251)
• Свернуть проект в один текстовый файл-снимок
• Развернуть проект из снимка с сохранением структуры и кодировок

📸 Скриншоты

Основное окно программы

Все четыре вкладки основного окна на скриншоте assets/app_tabs.png

Окно справки (F1)

Вкладки справки на скриншоте assets/help_tabs.png

🚀 Возможности

Функция	Описание
📁 Дерево папок	Псевдографическое отображение структуры с кодировками
🔍 Автоопределение кодировок	UTF-8 / CP1251 (Windows-1251, кириллица)
📦 Свертывание	Сохранение проекта в один текстовый файл
📂 Развертывание	Восстановление проекта из снимка
📋 История	Выпадающие списки последних папок и файлов
⭐ Закладки	Быстрый доступ к избранным папкам
📊 Прогресс-бар	Визуальное отображение хода операций
💬 Подсказки	Всплывающие подсказки на кнопках (с задержкой 500ms)
🛑 Отмена	Прерывание длительных операций
💾 Автосохранение	Сохранение размера окна и активной вкладки
📌 Поверх всех	Режим "Always on Top"

📥 Установка

Требования

• AutoHotkey v2.0 или выше (скачать)
• Windows 7 / 8 / 10 / 11

Установка

1. Скачайте файл FLS-PLUS.ahk
2. Установите AutoHotkey v2.0
3. Запустите FLS-PLUS.ahk двойным щелчком

Примечание: Программа не требует установки — достаточно запустить .ahk файл.

🎮 Использование

Быстрый старт

1. Выберите папку — кнопка "📁 Обзор" или выпадающий список истории
2. Дождитесь сканирования — дерево построится автоматически (асинхронно, UI не зависает)
3. Перейдите на вкладку "Свернуть"
4. Нажмите "📦 Свернуть" — программа рассчитает размер и проверит свободное место
5. Подтвердите сохранение

Для разворачивания:

1. Перейдите на вкладку "Развернуть"
2. Выберите файл-снимок и целевую папку
3. Нажмите "📂 Развернуть"

Закладки

• ➕⭐ — добавить текущую папку в закладки
• ⭐ — открыть меню закладок

Горячие клавиши

Клавиша	Действие
F1	Открыть справку

📁 Формат снимка

Снимок сохраняется в текстовый файл с форматом:

=== путь/к/файлу | utf-8 ===
содержимое файла

=== путь/к/файлу | cp1251 ===
содержимое файла

Поддерживаемые кодировки: utf-8, cp1251

⚙️ Настройки

Все настройки сохраняются в файле FLS-PLUS.ini в папке со скриптом:

• Последняя выбранная папка
• История папок и файлов (до 20 записей)
• Закладки (до 15 записей)
• Размер и положение окна
• Активная вкладка
• Режим "Поверх всех"

🛠️ Технические детали

Защита от ошибок

• Глубокая рекурсия — ограничение глубины сканирования (макс. 100 уровней)
• Длинные пути — проверка на превышение MAX_PATH (260 символов)
• Одновременные операции — блокировка повторного запуска
• Нехватка места — предварительная проверка свободного пространства
• Безопасность путей — экранирование спецсимволов для командной строки

Оптимизация памяти

• Прямая запись в файл при сворачивании (без хранения в памяти)
• Асинхронное сканирование (не блокирует интерфейс)

📝 Известные ограничения

• Файлы размером >2 ГБ могут загружаться в память целиком при чтении
• Не поддерживаются пути длиннее 260 символов (ограничение Windows)
• Требуется AutoHotkey v2.0 (не совместимо с v1.x)

🤝 Вклад в проект

Буду рад вашим идеям и сообщениям об ошибках!

1. Форкните репозиторий
2. Создайте ветку для ваших изменений (git checkout -b feature/amazing-feature)
3. Зафиксируйте изменения (git commit -m 'Add some amazing feature')
4. Отправьте в ветку (git push origin feature/amazing-feature)
5. Откройте Pull Request

📄 Лицензия

Распространяется под лицензией MIT. См. файл LICENSE для получения дополнительной информации.

📞 Контакты

• Автор: IgerOK
• GitHub: https://github.com/IgerOK/FLS-PLUS

---

📊 История версий

v1.1 (2026)

• ✨ Асинхронное сканирование
• ✨ Предварительный расчёт размера снимка
• ✨ Проверка свободного места на диске
• ✨ Отмена длительных операций
• ✨ Всплывающие подсказки с задержкой
• ✨ Защита от глубокой рекурсии
• ✨ Изменение заголовка окна при смене вкладки
• 🐛 Исправлены утечки памяти
• 🐛 Исправлено мерцание подсказок

v1.0 (2026)

• Первоначальный выпуск
• Построение дерева файлов
• Автоопределение кодировок UTF-8/CP1251
• Свертывание и развертывание проектов
• История и закладки
• Прогресс-бары

---

Если вам понравилась программа, поставьте ⭐ на GitHub!