Один VITE_OPENAI_API_KEY в .env или один define: { 'process.env': env } после loadEnv(mode, process.cwd(), '') помещает ваши секретные ключи в JavaScript, который скачивает каждый посетитель. Этот навык находит эти и ещё семь ошибок Vite до сборки или развёртывания и объясняет, как исправить каждую из них.

Ваш агент запускает сканер для файлов vite.config, файлов .env (включая .env.example) и скриптов vite в package.json. Сканер читает envPrefix каждой конфигурации и применяет его к файлам .env соответствующего проекта, поэтому префиксы вроде APP_ или TAURI_ проверяются с учётом переменных, которые они действительно раскрывают. Он пропускает комментарии, отличает настройку от строки, в которой она лишь упоминается, и не отмечает публичные ключи (VITE_FIREBASE_API_KEY, VITE_SUPABASE_ANON_KEY, публикуемые ключи Stripe). Стандартный проект npm create vite проходит проверку без замечаний. Сканер никогда не запускает Vite или ваше приложение. Он возвращает BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного подхода. Секреты никогда не выводятся.

Что проверяется

BLOCK (исправить до публикации)

• V01: секреты в переменных, которые Vite раскрывает браузеру (имена секретов, ключи API ИИ, секретные ключи Stripe или ключи Supabase service_role, копии вроде VITE_DB="${DB_PASSWORD}")

• V02: пустой или слишком короткий envPrefix либо префикс, совпадающий с серверными секретами и секретами CI (APP_, TAURI_, GITHUB_, AWS_)

• V03: define, внедряющий process.env, результат loadEnv(mode, root, '') либо секретную переменную или значение

• V04: server.fs.strict: false или server.fs.allow с корнем файловой системы либо домашней папкой

REVIEW (проверить до выпуска)

• V11: сервер разработки или предпросмотра на всех интерфейсах (host: true, 0.0.0.0, адрес локальной сети, vite --host)

• V12: карты исходного кода для продакшена в сборках приложения (build.sourcemap или rollupOptions.output.sourcemap со значением true либо 'inline')

• V13: CORS, открытый для любого сайта (cors: true, origin '*' или /.*/, Access-Control-Allow-Origin: *)

• V14: allowedHosts: true или legacy.skipWebSocketTokenCheck: true

• V15: список server.fs.deny, заменяющий стандартный и не содержащий записей .env

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с объяснением причин и более безопасным подходом для каждого правила

• Небезопасный и безопасный примеры проекта Vite (vite.config.ts, .env.example, package.json), а также настоящий отчёт сканера по небезопасному примеру

Ограничения

Каждый файл анализируется в том виде, в котором написан: параметры, создаваемые функциями или импортируемые из других файлов, и флаги командной строки, кроме --host, не отслеживаются. Клиентский исходный код не читается, установленная версия Vite не проверяется. NOT FLAGGED не является гарантией безопасности.

Содержимое

Один ZIP-архив с 13 файлами: SKILL.md, сканер в scripts/ (4 файла Python), references/rules.md (каждое правило с объяснением причин и более безопасным подходом) и examples/ (6 файлов примеров и report.md, настоящий результат работы сканера на небезопасном примере).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить проект. Скрипты также можно запускать отдельно с Python 3.9 или новее, без установки дополнительных пакетов. Они только читают ваши файлы: не подключаются к сети и ничего никуда не отправляют.