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

Защита на агент: безопасност, разрешения и доверени папки

Урок 3 от 14 Обновен 2 ноември 2026 г. Напреднало
На тази страница
  1. Какво прави (и какво не прави) safety
  2. Първи лост: налични инструменти
  3. Втори лост: разрешения за всеки инструмент
  4. Трети лост: обхват на работната директория
  5. Четвърти лост: доверени папки
  6. Отговор на подкана за одобрение
  7. Избор на правилния баланс
  8. Ключови изводи

Урокът е пренаписан на 2 ноември 2026 г. Предишната версия описваше полето safety като ниво на разрешение. Документацията на Vibe е категорична: то е визуален индикатор, който оцветява рамката на входа; то не налага никакви ограничения. Реалната защита идва от списъците с инструменти, разрешенията за всеки инструмент и доверените папки. Източници: Safety, approvals, and permissions · Configuration reference.

Какво прави (и какво не прави) safety

Полето safety във файла на агента приема пет стойности: safe, neutral (по подразбиране), destructive, smart и yolo. То променя цвета на рамката на входната област, за да Ви даде бърза визуална подсказка кой агент използвате. То не премахва инструменти и не задейства подкани за одобрение. Агент, маркиран като safe, но оборудван с неограничен bash, все още може да изпълнява деструктивни команди.

Има едно изключение: когато администратор деактира автоматичното одобрение (enable_auto_approve = false), Vibe скрива всички агенти, маркирани като yolo. В противен случай safety е етикет, а не ключалка. Винаги го комбинирайте с реалните контроли, описани по-долу.

Първи лост: налични инструменти

enabled_tools (списък с позволени) и disabled_tools (списък със забранени, прилаган след това) определят какво агентът може да извика. Те приемат точни имена, шаблони с глоб и регулярни изрази с префикс re:.

# Агент за одит само за четене
display_name = "Security Audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]

Ако даден инструмент не е в списъка, той не съществува за този агент. Това е Вашата най-силна гаранция.

Втори лост: разрешения за всеки инструмент

За наличните инструменти блокът [tools.<tool>] задава правилото: "always" (без подкана), "ask" (подкана всеки път) или "never" (блокиране).

display_name = "Refactoring"
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, allowlist и denylist определят префикси на команди, които винаги са позволени или винаги са забранени. Vibe позволява няколко команди само за четене по подразбиране (ls, pwd, cat, git status и др.), но всеки списък, който напишете, замества списъка по подразбиране: включете всички команди по подразбиране, които искате да запазите. За read_file, write_file и edit тези списъци приемат шаблони за абсолютни пътища. Едно разумно правило: скрипт, стартиран чрез bash, може да конструира пътища, които Vibe не вижда в самата команда; поддържайте bash настроен на "ask", когато залогът го оправдава.

Трети лост: обхват на работната директория

По подразбиране Vibe пита преди файл или шел инструмент да достъпи път извън работната директория, дори чрез символична връзка, и преди четене или модифициране на файлове .env и .envrc. Можете да затвърдите това поведение:

outside_workdir = "deny"   # отказ вместо подкана; агентът получава грешка и продължава

Четвърти лост: доверени папки

Хранилището може да включи своя собствена конфигурация на Vibe (агенти, умения, MCP сървъри, разрешения) в папка .vibe/ или инструкции във файл AGENTS.md. Тъй като тази конфигурация променя поведението на Vibe, тя се зарежда само от папка, която изрично сте одобрили. При първо стартиране Vibe изброява откритите файлове и предлага Trust folder, Trust full repo или Don’t trust; Вашият избор се запазва в ~/.vibe/trusted_folders.toml. Диалогът не анализира тези файлове: прегледайте ги като всеки друг код в хранилището, особено дефинициите на MCP сървъри и разрешенията. В програмния режим Vibe никога не пита: vibe --trust предоставя временно доверие за едно изпълнение.

Отговор на подкана за одобрение

Когато Vibe отправи подкана, са възможни четири клавиатурни отговора: 1 или y позволява веднъж, 2 за остатъка от сесията, 3 винаги, а 4, n или Escape отказва. Цветът на рамката Ви напомня кой агент е активен.

Избор на правилния баланс

НуждаНастройка
Анализ без докосване на нищоenabled_tools = ["read_file", "grep"]
Рефакторинг с увереностedit зададен на "always", bash зададен на "ask" със allowlist от тестови команди
Почистване на проектbash зададен на "ask" и denylist от необратими команди
Задача без наблюдение в CIЕфемерен контейнер, vibe --prompt … --auto-approve, лимити --max-turns и --time-limit

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

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

  • safety (safe, neutral, destructive, smart, yolo) оцветява рамката; не налага никакви разрешения
  • Реални ключалки: enabled_tools/disabled_tools, след това [tools.<tool>] (always, ask, never)
  • За bash, allowlist и denylist заместват списъците по подразбиране
  • Vibe пита преди излизане от работната директория или докосване на .env файлове
  • Конфигурацията на проекта се зарежда само в доверена папка; прегледайте я преди одобрение