Safety.ko

안전장치

English

• 로컬 전용. 서버는 127.0.0.1에서만 연결을 받습니다. 브라우저의 Origin이 localhost, 127.0.0.1, [::1]이 아니면 요청을 거부합니다. AuthToken을 설정하면 bearer 토큰도 요구합니다.
• 되돌릴 수 있고 전부 아니면 전무인 쓰기. Write 도구는 무언가를 바꾸기 전에 모든 값을 검사하고, 에디터 트랜잭션 안에서 실행됩니다. 일부를 바꾼 뒤 실패하면 트랜잭션을 되돌립니다.
• 플레이 중 쓰기 금지. Play In Editor가 시작 중이거나 실행 중이면 Write 도구와 에셋을 만들거나 가져오는 도구를 거부합니다.
• 프로젝트 콘텐츠만. 에셋 생성, 가져오기, 변경, 저장은 /Game과 프로젝트 plugin 안에서만 합니다. 엔진 콘텐츠는 읽기 전용입니다.
• 명시적 저장. 부수 효과로 저장하는 도구는 없습니다. 예외는 level_new 하나로, 레벨은 디스크에만 존재하므로 만든 레벨을 바로 씁니다. asset_save는 로드된 프로젝트 에셋만 저장하고 레벨은 여전히 거부합니다. 레벨은 level_save가 저장하며, 대상은 에디터에 열린 레벨입니다.
• 레벨을 말없이 교체하지 않음. 레벨을 여는 순간 저장 안 된 변경이 사라지므로, level_new와 level_open은 저장 안 된 레벨 변경이 있으면 거부합니다.
• dry run. Destructive 도구는 bConfirm: true가 있어야 실제로 실행하고, asset_import_textures는 무엇이든 가져오기 전에 모든 항목을 검사합니다.
• 허용·차단 목록. AllowedTools와 BlockedTools로 도구를 숨기고, BlockedProperties로 object_set_properties와 umg 도구가 바꾸지 못할 프로퍼티를 지정합니다.
• 파일. skills_get은 스킬 폴더 안의 파일만 읽고, 그 밖의 경로와 숨김 파일은 거부합니다. asset_import_textures는 받은 이미지 파일을 읽으며, 프로젝트 폴더 밖의 파일도 읽습니다.
• 소스 파일. 소스 도구는 SourceFolders 안의 텍스트 파일만 읽고 쓰며, 그 밖의 경로, 밖으로 나가는 .., 빌드 폴더, 텍스트가 아닌 파일은 거부합니다. 소스 편집은 에디터에서 되돌릴 수 없습니다.
• 태그가 붙은 클라이언트의 승인. X-AgentMcp-Client 헤더를 보낸 세션은 끝날 때까지 그 태그를 유지합니다. 태그가 붙은 세션의 도구 호출은 Read 도구를 빼고 모두 그 태그에 등록된 승인 게이트를 거칩니다. 등록된 게이트가 없으면 APPROVAL_UNAVAILABLE, 거부되면 DENIED로 실패합니다. AI 채팅은 agent-mcp-chat 게이트를 등록하고 변경마다 승인 카드를 보여 줍니다. 헤더 없이 연결한 세션은 영향을 받지 않으므로, 직접 연결한 Claude Code와 Codex는 예전처럼 동작합니다.
• 성능 파일. perf 도구는 프로젝트 폴더 안의 파일만 읽습니다. perf_trace_hotspots는 트레이스 옆에 내보내려고 엔진의 UnrealInsights.exe를 실행합니다.
• 콘솔 명령이나 스크립트를 실행하는 도구는 없습니다.