Failas config.toml
Šiame puslapyje
Pamoka atnaujinta 2026 m. lapkričio 2 d. pagal Vibe Code dokumentaciją: integruotas modelis „Mistral Medium 3.5“ (plius „Devstral 2“),
enable_update_checks(raktasenable_auto_updatenebeturi poveikio), įrankisedit(anksčiausearch_replace) ir pašalintas skiltis[safety], pakeista įdefault_agent. Šaltiniai: Konfigūravimas · Konfigūravimo nuoroda.
Kur yra config.toml?
„Vibe“ ieško savo konfigūracijos failo dviejose vietose, tokia tvarka:
- Projekto konfigūracija:
./.vibe/config.toml(esamame aplanke) - Globali konfigūracija:
~/.vibe/config.toml(tavo namų aplanke)
Projekto konfigūracija turi pirmenybę prieš globalią konfigūraciją. Šis mechanizmas daro įrankį praktišką kasdieniam kūrėjo darbui: tavo globali konfigūracija atspindi tavo įpročius, o kliento saugykla savo aplanke taiko savo taisykles, nereikalaujant rankiniu būdu keisti nustatymų.
Failo struktūra
Failas config.toml naudoja TOML formatą – tai skaitomą ir vienareikšmį konfigūracijos formatą. Štai pilnas pakomentuotas pavyzdys, kuriame yra viskas, ko tau prireiks:
# ~/.vibe/config.toml
# Aktyvus modelis: įmontuotas modelis arba aliasas [[models]] išankstiniam nustatymui
active_model = "mistral-medium-3.5"
# Numatytasis agentas (jei rakto nėra, naudojamas „accept-edits“)
default_agent = "ask"
# Tinkintas sistemos promptas (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Tema: automatiškai seka terminalą; naudok /theme pasirinkimui
theme = "auto"
# Kasdienis naujų versijų tikrinimas
enable_update_checks = true
Modelio pasirinkimas
Parametras active_model nulemia, kurį modelį „Vibe“ naudoja generavimui. Jis tikisi aliaso: arba įmontuoto modelio „Mistral Medium 3.5“, arba aliaso [[models]] išankstiniam nustatymui, kurį deklaravai (apie tai kalbėsime kitoje pamokoje).
active_model = "mistral-medium-3.5"
Tau nereikia redaguoti failo norint pakeisti modelius: komanda /model perjungia modelius sesijos metu ir rodo galimų variantų sąrašą. Naudok failą nustatyti numatytąjį pasirinkimą, o komandą – vienkartiems testams.
Sistemos prompto tinkinimas
Sistemos promptas apibrėžia „Vibe“ elgesį. Pagal nutylėjimą jis sukonfigūruotas būti efektyviu kodavimo asistentu, tačiau gali jį specializuoti. Tai dažnai yra nustatymas, duodantis didžiausią matomą naudą: agentas, iš anksto žinantis tavo konvencijas, nesiūlo kodo, kurį reikia performatuoti.
Promptai yra Markdown failai, saugomi aplanke ~/.vibe/prompts/. Susikurk savo; štai pavyzdys komandai, dirbančiai su Python ir FastAPI:
mkdir -p ~/.vibe/prompts
cat > ~/.vibe/prompts/mon_prompt.md << 'EOF'
Tu es un assistant de développement spécialisé en Python et FastAPI.
Tu écris du code propre, typé, avec des docstrings.
Tu privilégies les approches fonctionnelles quand c'est possible.
Tu réponds toujours en français.
EOF
Tada nurodyk jį faile config.toml naudodamas failo pavadinimą be plėtinio:
system_prompt_id = "mon_prompt"
Agentų konfigūravimas
Agentai eina toliau nei vien promptai: tai pilni konfigūracijos profiliai, kuriuose kiekvienas agentas turi savo modelį, sistemos promptą ir įrankių leidimus. Juos kuri aplanke ~/.vibe/agents/. Aiškiausias pavyzdys – kodo peržiūros agentas:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Paleisk jį pagal poreikį:
vibe --agent code_review
Šis agentas gali tik skaityti: jis negali rašyti failų ar vykdyti komandų. Todėl gali leisti jam nuskaityti kolegos šaką nebijodamas atsitiktinių pakeitimų, todėl tai idealus režimas saugioms kodo peržiūroms.
Įrankių valdymas
Šis įrankių filtravimas taikomas ir pagrindinei konfigūracijai. Yra du sąrašai: vienas leidžia tik specifinius įrankius, kitas juos draudžia:
# Įgalinti tik specifinius įrankius
enabled_tools = ["read_file", "grep", "edit"] # edit: anksčiau search_replace
# Išjungti specifinius įrankius
disabled_tools = ["bash", "write_file"]
Rašyti kiekvieną pavadinimą rankiniu būdu tampa varginanča, kai MCP serveris eksponuoja dvidešimt įrankių. MCP įrankiai vadinami {server}_{tool}, o filtrai priima pakaitos simbolius ir reguliariuosius reiškinius (priešdėlis re:). Tai leidžia mąstyti šeimomis, o ne atskirais įrankiais:
# Įgalinti visus įrankius iš MCP serverio, vadinamo serena (glob šablonas)
enabled_tools = ["serena_*"]
# ... arba tas pats naudojant reguliarųjį reiškinį:
# enabled_tools = ["re:^serena_.*$"]
# Išjungti visus įrankius iš fetch_server MCP serverio
disabled_tools = ["fetch_server_*"]
Tema ir konfigūracijos vieta
Temą nustatyk tame pačiame faile arba realiuoju laiku naudodamas komandą /theme:
theme = "auto"
Galimos temos skiriasi priklausomai nuo versijos; interaktyviu režimu naudok /theme, kad pamatytum pilną sąrašą ir peržiūrėtum kiekvieną variantą prieš įtvirtindamas savo pasirinkimą.
Galiausiai, „Vibe“ pagal nutylėjimą saugo savo konfigūraciją aplanke ~/.vibe/, tačiau gali pakeisti šią vietą naudodamas aplinkos kintamąjį:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Tai naudinga, jei tavo namų aplankas yra lėtame tinklo diske, kur kiekvienas konfigūracijos skaitymas sukeltų delsą, arba jei daliniesi konfigūracija tarp kelių kompiuterių naudodamas sinchronizavimo tarnybą.
Projekto specifinė konfigūracija
Grįžtant prie pradinio scenarijaus: projekto specifiniams nustatymams sukursk .vibe/config.toml projekto šaknyje:
mkdir -p .vibe
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pytest"]
EOF
„Vibe“ įkelia šį failą tik tada, kai pirmojo paleidimo metu paskelbei aplanką patikimu. Kaip atsargumo priemonė prieš commit’inant: pridėk .vibe/ į savo .gitignore, jei faile yra jautrios informacijos, pavyzdžiui, kintamųjų pavadinimų arba vidinių URL adresų, kurių nenori įtraukti į saugyklą.
Svarbiausi punktai
- config.toml egzistuoja globalioje (
~/.vibe/) ir projekto (./.vibe/) versijose - Projekto konfigūracija turi pirmenybę prieš globalią konfigūraciją
- Agentai yra pilni profiliai su modeliu, promptu ir leidimais; nustatyk numatytąjį agentą su
default_agent - Įrankius galima filtruoti naudojant pakaitos simbolius arba regex
- Kintamasis
VIBE_HOMEleidžia pakeisti konfigūracijos aplanką