Valdymas darbinio katalogo
Šiame puslapyje
Pamoka atnaujinta 2026 m. lapkričio 2 d.: Pavyzdžiuose nebenustatomas
active_model = "devstral-2"(„Devstral“ pašalintas iš API). Be šio rakto, projekte naudojamas modelis, apibrėžtas tavo naudotojo konfigūracijoje. Priminimas: projekto.vibe/config.tomlfailas įkeliamas tik patikimame aplanke. Šaltinis: Configuration.
2026 m. lapkričio 2 d. naujiena — „Devstral“. „Devstral 2“ (
devstral-2512) gyvavimo ciklas baigėsi 2026 m. liepos 31 d., o „Devstral Small 2“ – 2026 m. kovo 31 d.: kvietimai šiems modeliams nebėra garantuoti. Oficialioje modelių lentelėje jie nukreipiami į „Mistral Medium 3.5“, kuris savo ruožtu yra pasenęs ir keičiamas į „Mistral Large 4“. „Codestral“ (codestral-2508) vis dar bendrai prieinamas kodui užbaigti. Prieš naudodamas šiuos pavyzdžius iš naujo, patikrink modelių lentelę, kur nukreipti-latestaliasai.
Paleidimo aplankas apibrėžia projektą
Kai paleidi vibe, agentas priima esamą katalogą kaip savo darbinį katalogą. Šis pasirinkimas svarbus: jis lemia visą projekto kontekstą, nes „Vibe“ nuskenuoja katalogų medį, skaito konfigūracijos failus ir iš šios vietos nustato projekto tipą.
cd /home/user/projects/my-api
vibe
# → Vibe analizuoja my-api projektą
Jei „Vibe“ paleisi iš savo namų katalogo, o ne iš saugyklos, gausi agentą, kuris nesupranta tavo kodo – ne todėl, kad negalėtų, o todėl, kad ieško neteisingoje vietoje. Praktiškai cd yra komandos dalis.
Darbas kitur neperkeliant
Kartais cd yra neįmanomas arba nepatogus. Parinktis --workdir aiškiai nurodo tikslinį katalogą:
vibe --workdir /home/user/projects/my-api
Elgsena yra visiškai identiška paleidimui iš to aplanko: projekto skenavimas, failų kelių išsprendimas ir apvalkalo (shell) komandos naudoja šį katalogą kaip bazę. Ši parinktis pravartu automatizavimo scenarijuose, kai nekontroliuoji esamo katalogo, kai dirbi su keliais projektais nepersijungdamas tarp terminalų, ir CI/CD vamzdynuose, norėdamas nukreipti į ką tik klonuotą saugyklą. Scenarijaus naudojimo atvejis yra labiausiai iliustruojantis, leidžiantis apdoroti projektų seriją cikle:
# Scenarijuje
for project in api frontend worker; do
vibe --workdir "/projects/$project" \
--prompt "Check for npm vulnerabilities" \
--output json > "audit-$project.json"
done
Kelių projektų darbo organizavimas
Interaktyviu režimu švariausias būdas – skirti vieną terminalą (arba „tmux“ sritį, arba „screen“ sesiją) kiekvienam projektui:
# 1 terminalas: Backend API
cd /projects/api-backend
vibe
# 2 terminalas: Frontend
cd /projects/frontend-react
vibe
# 3 terminalas: Infrastruktūra
cd /projects/infra-terraform
vibe
Kiekvienas egzempliorius tada turi savo kontekstą, sesiją ir istoriją, taip išvengdamas „Terraform“ logikos maišymo su „React“ logika.
Šis atskyrimas taikomas ir konfigūracijai. Įdėjus .vibe/config.toml failą į kiekvieną projektą, agento elgsena pritaikoma konkrečiai kodų bazei. Python API atveju:
# Python API projektas
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
EOF
O „React“ frontendui, pridėjus MCP serverį:
# React Frontend projektas
# /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
Pirmenybės taisyklę lengva prisiminti: projekto konfigūracija (./.vibe/config.toml) nustelbia globalią konfigūraciją (~/.vibe/config.toml). Taigi kiekviena saugykla gali taikyti savo modelį, sistemos raginimą ir MCP serverius, nereikalaujant nieko keisti pereinant nuo vieno prie kito.
Patikimi aplankai
Darbinis katalogas taip pat lemia, ką „Vibe“ gali daryti neklausdamas tavęs. Patikimų aplankų sistema remiasi ~/.vibe/trusted_folders.toml, kuriame išvardytos vietos, kur leidžiami tam tikri automatiniai veiksmai – ypač automatinis patvirtinimas (auto-approve).
# ~/.vibe/trusted_folders.toml
trusted = [
"/home/user/projects/my-api",
"/home/user/projects/frontend",
]
Jei įgalinsi automatinį patvirtinimą kataloge, kurio nėra šiame sąraše, „Vibe“ įspės tave, kad jis nelaikomas patikimu. Tai yra būtent ta apsauga, kurios reikia klonuojant nežinomą saugyklą norint padėti kolegai.
Failų nurodymas ir katalogų keitimas sesijos metu
Pokalbiuose @ priima tiek kelius, santykinius su darbinio katalogo atžvilgiu, tiek absoliučius kelius, ir automatinis užbaigimas veikia abiem atvejais.
# Santykinis kelias (rekomenduojama)
Explain the code in @src/api/routes.ts
# Absoliutus kelias
Explain the code in @/home/user/projects/my-api/src/api/routes.ts
Teik pirmenybę santykiniams keliams: jie lengviau skaitomi ir lieka galiojantys nepriklausomai nuo naudotojo ar kompiuterio, o tai svarbu dalinantis raginimu su kolega.
Galiausiai, niekas netrukdo tau sesijos metu naršyti kitur naudojant apvalkalo komandą:
!cd /other/project && ls
Tačiau žinok, ką gauni: projekto kontekstas iš pradinio skenavimo lieka susietas su paleidimo katalogu, ir „Vibe“ automatiškai iš naujo neskenuoja naujo aplanko. Agentas matys išvardytus failus, bet vis tiek samprotaus remdamasis originalia projekto architektūra. Norint tikro konteksto perjungimo, atidaryk naują sesiją.
Svarbiausi punktai
- „Vibe“ paleidimo metu naudoja esamą katalogą kaip projekto kontekstą
--workdirleidžia nurodyti katalogą į jį nenaršant- Vienas terminalas vienam projektui yra švariausias būdas dirbti su keliais projektais
- Projekto lygmens
.vibe/config.tomlpritaiko elgseną kiekvienai kodų bazei - Patikimų aplankų sistema užtikrina automatinio patvirtinimo saugumą kiekvienam katalogui atskirai
- Santykiniai keliai su @ rekomenduojami dėl skaitomumo