Перейти до вмісту
SnakeFlow SnakeFlow

FAQ і усунення проблем

Загальне

Розширення не бачить проєкт автоматично

Ctrl+Alt+M → Select Project → виберіть папку проєкту. Або вручну в .vscode/settings.json:

"devManager.project.name": "my-project",
"devManager.project.dir": "C:/Users/you/projects/my-project"

Як налаштувати сервери?

У .vscode/settings.json:

"devManager.project.servers": [
  { "id": "web", "label": "Dev Server", "command": "npm run dev", "path": "", "port": 3000 }
]

Або Ctrl+Alt+M → Manage Servers.

Налаштування не зберігаються

Переконайтеся, що редагуєте workspace (.vscode/settings.json), а не user settings. У Ctrl+, вкладка «Workspace».

Сервери

Статус «stopped», але сервер у терміналі працює

Так буває, якщо сервер запущено не через SnakeFlow. Потрібні: (1) відкритий TCP-порт і (2) термінал, який керує SnakeFlow. Запускайте через Ctrl+Alt+S.

Команда виконується не з тієї папки

Поле path — відносно кореня проєкту:

{ "id": "api", "command": "python manage.py runserver", "path": "backend", "port": 8000 }

Якщо в корені package.json — proxy ("dev": "npm run dev --prefix application"), використовуйте "path": "", а не "application".

Docker

Помилки Docker Compose

Перевірте CLI:

Terminal window
docker compose version

Якщо використовуєте застарілий docker-compose (з дефісом):

"devManager.docker.composeCommand": "docker-compose"

Docker Desktop встановлено, але compose не працює

Docker Desktop має бути запущений (іконка у треї). Без демона CLI падає.

Quality Hub / Bearer повільний, тайм-аут або зупинка після «Analyzing codebase»

Windows: сканування антивіруса в реальному часі (зокрема Microsoft Defender) часто заважає монтуванням Docker і інструментам, що читають увесь репозиторій. Додайте виключення папок для даних Docker і коренів проєктів, потім перезапустіть Docker Desktop. Детально: Встановлення → Антивірус і сканування в реальному часі (Windows). Шляхи для окремих CLI, якщо бінарники блокують: Виключення антивіруса та Device Guard.

GitHub

Панель Issues порожня

Потрібен gh і авторизація:

Terminal window
gh auth status
gh auth login

У панелі Pull Requests порожньо

Показуються лише відкриті PR. Якщо їх немає — панель порожня.

Quality Hub

Статус skip замість запуску

CLI не встановлено або не в PATH. Див. Встановлення CLI.

Semgrep повільний або timeout

Збільшіть timeout:

"devManager.quality.timeout": 60

Або додайте великі згенеровані папки:

"devManager.quality.skipDirs": ["generated", "proto-gen"]

Хмарний провайдер: «No data available»

Потрібен хоча б один git push і дані з CI. Без цього сервіс нічого не покаже.

ESLint Security падає, хоча ESLint є

Потрібен eslint-plugin-security у node_modules:

Terminal window
npm i -D eslint-plugin-security

Bearer на Windows — skip

Немає нативного Windows-бінарника. Варіанти:

  1. WSL2 і "devManager.quality.builtin.bearer.path": "wsl bearer"
  2. Пропустити — Semgrep, Trivy, ESLint Security покривають схожі ризики

Hadolint / ShellCheck / Trivy — skip

Інструмент не встановлено або не в PATH. Див. CLI install. Після winget перезапустіть VS Code/Cursor.

Windows

Помилки кодування (кирилиця в виводі)

Для Semgrep додайте змінну середовища:

Terminal window
PYTHONUTF8=1

(у системних змінних середовища.)

PowerShell execution policy

Terminal window
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Далі не виходить?

Напишіть:

Додайте до листа:

  1. ОС і версія VS Code / Cursor
  2. Текст помилки (Output → SnakeFlow)
  3. Релевантний .vscode/settings.json (без токенів)