Премини към основното съдържание
Български— Изберете език
Меню

Контрол на работната директория

Урок 15 от 16 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Стартовата директория дефинира проекта
  2. Работа на друго място без преместване
  3. Организиране на работа с множество проекти
  4. Доверени папки
  5. Справочни файлове и промяна на директории по време на сесия
  6. Ключови изводи

Актуализация на урока от 2 ноември 2026 г.: Примерите вече не задават active_model = "devstral-2" (Devstral бе премахнат от API). Без този ключ проектът използва модела, дефиниран във Вашата потребителска конфигурация. Напомняне: проектният файл .vibe/config.toml се зарежда само в доверена папка. Източник: Configuration.

Актуализация от 2 ноември 2026 г. — Devstral. Devstral 2 (devstral-2512) достигна края на жизнения си цикъл на 31 юли 2026 г., а Devstral Small 2 – на 31 март 2026 г.: обажданията към тези модели вече не са гарантирани. Официалната таблица с модели ги пренасочва към Mistral Medium 3.5, който самият той е остарял в полза на Mistral Large 4. Codestral (codestral-2508) остава общодостъпен за довършване на код. Проверете таблицата с модели, за да видите къде сочат псевдонимите -latest, преди да използвате повторно тези примери.

Стартовата директория дефинира проекта

Когато изпълните vibe, агентът приема текущата директория като своя работна директория. Този избор е от значение: той определя целия контекст на проекта, тъй като Vibe сканира дървовидната структура на директорията, чете конфигурационните файлове и извежда типа на проекта от това местоположение.

cd /home/user/projects/my-api
vibe
# → Vibe анализира проекта my-api

Ако стартирате Vibe от Вашата домашна директория вместо от хранилището, ще получите агент, който не разбира Вашия код – не защото не може, а защото търси на грешното място. На практика командата cd е част от изпълнението.

Работа на друго място без преместване

Понякога cd не е възможно или удобно. Опцията --workdir изрично определя целевата директория:

vibe --workdir /home/user/projects/my-api

Поведението е строго идентично със стартирането от тази папка: сканирането на проекта, разрешаването на пътищата до файловете и shell командите използват тази директория като своя база. Тази опция е полезна за скриптове за автоматизация, когато не контролирате текущата директория, при работа с множество проекти без превключване на терминали и в CI/CD pipelines за насочване към прясно клонирано хранилище. Случаят със скриптове е най-показателен, тъй като Ви позволява да обработвате поредица от проекти в цикъл:

# В скрипт
for project in api frontend worker; do
  vibe --workdir "/projects/$project" \
       --prompt "Check for npm vulnerabilities" \
       --output json > "audit-$project.json"
done

Организиране на работа с множество проекти

В интерактивен режим най-чистият подход е един терминал – или tmux панел, или screen сесия – за всеки проект:

# Терминал 1: Backend API
cd /projects/api-backend
vibe

# Терминал 2: Frontend
cd /projects/frontend-react
vibe

# Терминал 3: Инфраструктура
cd /projects/infra-terraform
vibe

Всеки екземпляр тогава има свой собствен контекст, сесия и история, което Ви предпазва от смесване на логиката на Terraform с тази на React.

Това разделение се простира и до конфигурацията. Разполагането на файл .vibe/config.toml във всеки проект адаптира поведението на агента към конкретната кодова база. За Python API:

# Проект за Python API
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"

[tools.bash]
permission = "ask"
EOF

А за React frontend, добавяне на MCP сървър:

# Проект за React Frontend
# /projects/frontend-react/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "react_expert"

[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
EOF

Правилото за приоритет е лесно за запомняне: проектната конфигурация (./.vibe/config.toml) замества глобалната конфигурация (~/.vibe/config.toml). Така всяко хранилище може да наложи собствен модел, системен промпт и MCP сървъри, без да се налага да променяте каквото и да е при превключване между тях.

Доверени папки

Работната директория също така определя какво Vibe има право да прави, без да Ви пита. Системата за доверени папки разчита на ~/.vibe/trusted_folders.toml, който изброява местоположенията, където са разрешени определени автоматични действия – по-специално автоматичното одобряване.

# ~/.vibe/trusted_folders.toml
trusted = [
  "/home/user/projects/my-api",
  "/home/user/projects/frontend",
]

Ако активирате автоматично одобряване в директория, липсваща в този списък, Vibe Ви предупреждава, че тя не се счита за доверена. Това е точно защитата, от която се нуждаете, когато клонирате непознато хранилище, за да помогнете на колега.

Справочни файлове и промяна на директории по време на сесия

В разговорите си @ приема както пътища, относителни към работната директория, така и абсолютни пътища, като автоматичното довършване работи и в двата случая.

# Относителен път (препоръчително)
Explain the code in @src/api/routes.ts

# Абсолютен път
Explain the code in @/home/user/projects/my-api/src/api/routes.ts

Предпочитайте относителните пътища: те се четат по-добре и остават валидни независимо от потребителя или машината, което е важно при споделяне на промпт с колега.

Накрая, нищо не Ви пречи да навигирате на друго място по време на сесия, използвайки shell команда:

!cd /other/project && ls

Въпреки това, знайте какво получавате: контекстът на проекта от първоначалното сканиране остава свързан с директорията на стартиране и Vibe не сканира автоматично новата папка. Агентът ще види изброените файлове, но все още ще разсъждава въз основа на оригиналната архитектура на проекта. За истинска промяна на контекста отворете нова сесия.

Ключови изводи

  • Vibe използва текущата директория като контекст на проекта при стартиране
  • --workdir Ви позволява да посочите директория, без да навигирате до нея
  • Един терминал на проект е най-чистият подход за работа с множество проекти
  • Проектният .vibe/config.toml персонализира поведението за всяка кодова база
  • Системата за доверени папки осигурява автоматично одобряване на база директория
  • Относителните пътища с @ се препоръчват за по-добра четимост