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
| Tryb | Działanie |
|---|---|
default (Ręczny) | Pyta przed wszystkim, co zmienia stan |
acceptEdits | Edycje plików przechodzą, o resztę pyta |
plan | Tylko odczyt; każda zmiana jest odrzucana |
auto | Edycje i rutynowe polecenia przechodzą, o ryzykowne pyta |
bypassPermissions | Zatwierdza 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
| Zakres | Plik | Do czego |
|---|---|---|
| user | ~/.oharness/settings.json | Osobiste przyzwyczajenia |
| project | .oharness/settings.json | Należy do repozytorium, podlega przeglądowi |
| local | .oharness/settings.local.json | Tylko 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.