Nux Mp3 Preset Generator!!

https://nxrig.com

This is a tool to generate Nux Mp3 presets from a JSON file.

🎸 AI Chain Generator

Новая функция для генерации чейнов эффектов с помощью AI! Доступна по адресу /generator.

Как использовать:

1. Откройте страницу /generator
2. Введите описание желаемого звука (например: "Тяжелый металлический звук с дисторшном")
3. Нажмите "Сгенерировать Chain" или Enter
4. Получите QR код для импорта в NUX приложение

Настройка OpenAI (опционально):

Для включения AI генерации добавьте ваш OpenAI API ключ:

1. Создайте файл .env.local в корне проекта
2. Добавьте ваш API ключ:

OPENAI_API_KEY=your_openai_api_key_here

3. Перезапустите сервер разработки

Без API ключа: Приложение будет возвращать default chain для всех запросов. С API ключом: Chain будет генерироваться на основе вашего описания с помощью GPT-4o-mini (по умолчанию).

Доступные модели:

• gpt-4o-mini (по умолчанию) - быстрая и экономичная
• gpt-4o - самая новая и умная модель
• gpt-4-turbo - баланс между качеством и скоростью
• gpt-3.5-turbo - базовая модель

Настройка прокси (если нужно):

Если OpenAI API недоступен в вашем регионе, можно использовать прокси:

PROXY_URL=http://your-proxy-server:port

По умолчанию используется встроенный прокси Skyeng.

Usage

Для локальной разработки (с поддержкой API Routes):

npm run dev

Для статической сборки (GitHub Pages):

npm run build:static

Важно: API Routes (включая генератор Chain) работают только в режиме разработки. Для production на GitHub Pages используется статическая генерация без API.

Best practices

Тестирование

1. Фреймворк: Проект использует Vitest для тестирования. Импортируйте утилиты из 'vitest', а не из '@jest/globals'.

2. Unit тесты для конфигов: Каждый конфиг-файл должен иметь соответствующий тест-файл рядом с ним (например, config.ts → config.test.ts). Минимальные проверки:

   • Наличие обязательных ключей
   • Корректность структуры данных
   • Валидность значений

3. Соглашение о именовании: Тесты называются по схеме {filename}.test.ts и располагаются в той же директории, что и тестируемый файл.

4. Покрытие: Начинайте с простых smoke-тестов (проверка наличия ключей), затем добавляйте более детальные проверки по мере развития проекта.

5. Запуск тестов:

   • Все тесты: npm test
   • Конкретный файл: npm test path/to/file.test.ts