Uprawnienia agenta kodowania: tryby, reguły allow i deny

OHarness sprawdza każde wywołanie narzędzia względem reguł allow, ask i deny, a potem trybu uprawnień. deny wygrywa ze wszystkim — także z trybem bypass — więc wyraźny zakaz to jedyna granica, na której możesz polegać.

Zaktualizowano

Pięć trybów

TrybDziałanie
default (Ręczny)Pyta przed wszystkim, co zmienia stan
acceptEditsEdycje plików przechodzą, o resztę pyta
planTylko odczyt; każda zmiana jest odrzucana
autoEdycje i rutynowe polecenia przechodzą, o ryzykowne pyta
bypassPermissionsZatwierdza wszystko — poza tym, czego zakazuje reguła deny

Wybierz go przez /mode w sesji albo --permission-mode w wierszu poleceń. auto to ocena kosztów, a nie kontrola bezpieczeństwa: mierzy zasięg szkód (rm, sudo, git push, kubectl, npm publish, zapisy poza projektem) i pyta o wszystko, czego nie rozpoznaje jako rutynowe.

Reguły

Reguły dopasowują nazwę narzędzia albo formę Tool(argument) z symbolami wieloznacznymi:

{
  "allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
  "ask":   ["Bash(git push*)"],
  "deny":  ["Bash(rm -rf *)", "write(.env*)"]
}

Gdzie są zapisane reguły

ZakresPlikDo czego
user~/.oharness/settings.jsonOsobiste przyzwyczajenia
project.oharness/settings.jsonNależy do repozytorium, podlega przeglądowi
local.oharness/settings.local.jsonTylko ta kopia robocza, w gitignore

Zakazy kumulują się między zakresami i nigdy nie są nadpisywane, więc projekt może zabronić tego, na co użytkownik zezwolił globalnie. „Zawsze zezwalaj” w pytaniu o zgodę zapisuje najbardziej szczegółowy wzorzec — zatwierdzenie Bash(npm test) nie daje zgody na każde Bash(...). /permissions pokazuje obowiązujące reguły.

Czym system uprawnień nie jest

Kontrola katalogów z prawem zapisu (workspaceMode) odrzuca ścieżki spoza projektu jeszcze przed pytaniem, ale sprawdza argumenty; nie izoluje procesu. Polecenie powłoki może sięgnąć wszystkiego, do czego ty masz dostęp. Do prawdziwej izolacji uruchamiaj agenta w kontenerze lub maszynie wirtualnej i traktuj reguły jako zabezpieczenie przed pomyłkami.

Częste pytania

Jak powstrzymać agenta kodowania przed uruchamianiem niebezpiecznych poleceń?

Dodaj reguły deny. W OHarness reguła taka jak "deny": ["Bash(rm -rf *)", "Bash(git push*)"] odrzuca te polecenia w każdym trybie, także w bypassPermissions. Reguły deny są granicą; tryby to wygoda.

Czy tryb bypass ignoruje reguły deny?

Nie. W OHarness zakaz wygrywa ze wszystkim, także z bypassPermissions. Wyraźny zakaz to jedyna reguła, na której użytkownik może polegać bezwarunkowo.

Czy repozytorium może ustawić uprawnienia dla wszystkich, którzy z niego korzystają?

Tak. Reguły w .oharness/settings.json są commitowane razem z projektem. Zakazy z dowolnego zakresu się kumulują, więc projekt może czegoś zabronić, nawet jeśli użytkownik zezwolił na to globalnie.

Powiązane