Agendi turvamine: ohutus, õigused ja usaldusväärsed kaustad
Sellel lehel
Õppetund kirjutati ümber 2. novembril 2026. Eelmine versioon käsitles välja
safetykui õiguste taset. Vibe’i dokumentatsioon on selge: see on visuaalne indikaator, mis värvib sisendi äärise; see ei jõusta midagi. Tegelik kaitse tuleneb tööriistade loenditest, iga tööriista õigustest ja usaldusväärsetest kaustadest. Allikad: Safety, approvals, and permissions · Configuration reference.
Mida safety teeb (ja mida mitte)
Agendi failis väli safety aktsepteerib viit väärtust: safe, neutral (vaikimisi), destructive, smart ja yolo. See muudab sisendiala äärise värvi, et anda sulle kiire ülevaade, millist agenti kasutad. See ei eemalda tööriistu ega käivita kinnitusküsimusi. Agent, millel on märgitud safe, kuid millel on piiramatu bash, saab siiski käivitada hävitavaid käske.
On üks erand: kui administraator keelab automaatse kinnituse (enable_auto_approve = false), peidab Vibe kõik agendid, millel on märgitud yolo. Muul juhul on safety silt, mitte lukk. Kombineeri see alati allpool toodud tegelike juhtelementidega.
Esimene hoob: saadaolevad tööriistad
enabled_tools (lubatud loend) ja disabled_tools (keelatud loend, rakendatakse hiljem) otsustavad, mida agent saab kutsuda. Need aktsepteerivad täpseid nimesid, glob-mustreid ja regulaaravaldisi, mille eesliide on re:.
# Ainult lugemise auditi agent
display_name = "Turvaaudit"
safety = "safe"
enabled_tools = ["read_file", "grep"]
Kui tööriista loendis pole, siis seda selle agendi jaoks ei eksisteeri. See on sinu tugevaim garantii.
Teine hoob: iga tööriista õigused
Saadaolevate tööriistade jaoks määrab plokk [tools.<tool>] reegli: "always" (ei küsi), "ask" (küsi iga kord) või "never" (blokeeri).
display_name = "Refaktoriseerimine"
safety = "neutral"
enabled_tools = ["read_file", "grep", "edit", "write_file", "bash"]
[tools.edit]
permission = "always"
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pnpm test"]
denylist = ["rm -rf", "git push"]
bash puhul määravad allowlist ja denylist käsueesliited, mis on alati lubatud või alati keelatud. Vibe lubab vaikimisi mõnda ainult lugemise käsku (ls, pwd, cat, git status jne), kuid iga sinu kirjutatud loend asendab vaikimisi loendi: lisa kõik vaikimisi käsud, mida soovid säilitada. read_file, write_file ja edit puhul aktsepteerivad need loendid absoluutseid teemustreid. Üks ettevaatlik reegel: skript, mida käivitatakse bash kaudu, saab konstrueerida teid, mida Vibe ise käsus ei näe; hoia bash väärtusel "ask" iga kord, kui panused seda õigustavad.
Kolmas hoob: töökataloogi ulatus
Vaikimisi küsib Vibe kinnitust enne, kui faili- või kestatööriist pääseb ligi teele väljaspool töökataloogi, isegi sümbollingi kaudu, ning enne .env ja .envrc failide lugemist või muutmist. Saad seda käitumist kindlustada:
outside_workdir = "deny" # keela küsimise asemel; agent saab vea ja jätkab tööd
Neljas hoob: usaldusväärsed kaustad
Hoidla saab siduda oma Vibe’i konfiguratsiooni (agendid, oskused, MCP serverid, õigused) kaustas .vibe/ või juhised failis AGENTS.md. Kuna see konfiguratsioon muudab Vibe’i käitumist, laaditakse see ainult kaustast, mille oled sõnaselgelt heaks kiitnud. Esimesel käivitamisel loetleb Vibe tuvastatud failid ja pakub valikuid Trust folder, Trust full repo või Don’t trust; sinu valikud salvestatakse faili ~/.vibe/trusted_folders.toml. Dialoog ei analüüsi neid faile: vaata need üle nagu iga muu kood hoidlas, eriti MCP serveri definitsioone ja õigusi. Programmeeritavas režiimis Vibe ei küsi kunagi: vibe --trust annab ajutise usalduse üheks käivituseks.
Kinnitusküsimusele vastamine
Kui Vibe küsib kinnitust, on võimalikud neli klaviatuurivastust: 1 või y lubab ühe korra, 2 ülejäänud sessiooni jaoks, 3 alati ning 4, n või Escape keelab. Äärise värv tuletab meelde, milline agent on aktiivne.
Õige tasakaalu leidmine
| Vajadus | Sätted |
|---|---|
| Analüüsi ilma midagi puutumata | enabled_tools = ["read_file", "grep"] |
| Refaktoriseeri kindlusega | edit väärtusega "always", bash väärtusega "ask" koos testikäskude allowlist-iga |
| Puhasta projekt | bash väärtusega "ask" ja pöördumatute käskude denylist |
| Järelevalveta ülesanne CI-s | Ephemeral container, vibe --prompt … --auto-approve, piirangud --max-turns ja --time-limit |
Kuldreegel on endiselt vähimprivileegid: anna igale agendile vajalik miinimum, alusta piiravalt ja ava juurdepääsu ainult vajadusel.
Peamised punktid
safety(safe,neutral,destructive,smart,yolo) värvib äärise; see ei jõusta mingeid õigusi- Tegeliku lukud:
enabled_tools/disabled_tools, seejärel[tools.<tool>](always,ask,never) bashpuhul asendavadallowlistjadenylistvaikimisi loendeid- Vibe küsib kinnitust enne töökataloogist lahkumist või
.envfailide puudutamist - Projekti konfiguratsioon laaditakse ainult usaldusväärses kaustas; vaata see enne heakskiitmist üle