익숙한 편집기, 새로운 협업 파트너.

시작하기 전에

현재 릴리스는 Godot 4.7.2의 Orca 1.7.0입니다. Godot 프로젝트를 준비하고 호스팅 모델 공급자나 로컬 모델 서버를 선택하세요.

Orca 설치

1. ZIP을 다운로드하세요.GitHub Releases에서 orca-v1.7.0.zip을 다운로드하여 최신 버전을 받으세요. Godot Asset Store에는 현재 1.6.0이 나열되어 있습니다. 인터페이스 언어와 집중 검사에는 GitHub를 사용하세요.
2. 프로젝트에 압축을 풉니다.ZIP를 Godot 프로젝트의 루트 폴더로 이동하고 거기에서 압축을 풉니다. 추가 기능은 addons/orca/에 있어야 합니다. 그렇지 않은 경우 추출된 orca 폴더를 프로젝트의 addons/ 폴더로 이동하세요.
3. 플러그인을 활성화하세요.Godot 4.7.2에서 프로젝트를 엽니다. 이동 프로젝트 → 프로젝트 설정 → 플러그인 Orca을 활성화하고

   

   

4. Orca 도크를 엽니다.편집기 도구 모음에서 아래에 표시된 Orca 아이콘을 클릭하여 Orca 도크(채팅 패널)를 엽니다. 공급자를 선택하고, 모델을 구성하고, 에이전트와 세션을 시작하세요.

   

이미 1.4.0~1.6.0을 사용하고 계십니까? Orca의 일반 설정을 열고, 업데이트를 확인하고, 출시 노트를 검토하고, 업데이트 및 다시 시작을 선택하여 1.7.0을 설치하세요. 업데이트하려면 확인이 필요하며 로컬에서 수정된 추가 기능 파일을 보호합니다.

1.3.0 이하에서 업그레이드하시나요? 이 업데이터가 포함된 릴리스를 수동으로 한 번 설치하십시오. 그 후에는 후속 업데이트를 위해 편집기 내 컨트롤을 사용하세요.

인터페이스 언어를 선택하세요

설정 → 시스템 → 언어를 열고 영어, 중국어 간체, 스페인어, 일본어 또는 한국어를 선택하세요. Orca는 초안, 대화, 첨부 파일 및 공개 리뷰를 유지하면서 인터페이스를 실시간으로 새로 고칩니다.

번역은 플러그인과 함께 번들로 제공되며 오프라인으로 작업됩니다. 선택 사항은 편집기 재시작 및 프로젝트 전반에 걸쳐 Godot EditorSettings에 저장됩니다. Godot의 자체 편집기나 프로젝트 언어는 변경되지 않습니다.

원본 메시지, 코드, 경로, 모델 이름 및 원시 도구 증거는 원본 텍스트를 유지합니다. 응답 언어 지침은 인터페이스 언어를 대체로 사용하여 명시적인 요청과 현재 메시지의 언어를 따릅니다. 다른 응답 언어를 요청하려면 프롬프트에 그렇게 말하세요.

모델 연결

호스팅 제공업체

Orca의 설정을 열고 지원되는 제공업체를 선택한 후 자격 증명과 모델을 입력하세요. 자격 증명, 엔드포인트, 모델 및 추론 노력 설정은 각 공급자마다 별도로 유지됩니다. 공급자 사용 수수료는 Orca과 별개입니다.

로컬 모델

Ollama, LM Studio 또는 다른 호환 서버를 시작하고 채팅 가능 모델을 로드합니다. Orca에서 해당 프로필을 선택하고 엔드포인트를 확인한 후 모델 목록을 새로 고치거나 모델 ID를 입력하세요. 서버에 키가 필요하지 않은 경우 API 키는 선택 사항입니다.

로컬 및 편집 가능한 프로필은 채팅 모드에서 시작됩니다. 에이전트 도구를 명시적으로 활성화하려면 먼저 격리된 함수 호출 프로브가 정확한 구성을 통과해야 합니다.

지원되는 제공업체 및 지역 모델 세부정보 보기 →

질문으로 시작하세요

계획 모드에서 "이 프로젝트에서 플레이어 움직임이 어떻게 작동하는지 설명해주세요"와 같은 집중적인 요청을 시도해 보세요. Orca은 프로젝트나 외부 상태를 변경하지 않고도 관련 컨텍스트를 검사하고 프로젝트를 이해하는 데 도움을 줄 수 있습니다.

구현을 원하시면 작업 모드로 전환하세요. 기본 수정 검토 작업 흐름은 검토를 위해 지원되는 변경 사항을 제시합니다. 차이점을 읽고 편집기에서 적용 또는 거부를 선택하세요. 적격 프로젝트 스크립트에 대해 자동 적용을 명시적으로 활성화할 수도 있습니다.

스크립트 편집을 진행하세요

Orca 1.7.0은 작업 모드에서 제한된 프로젝트 .gd 패치에 대한 선택적 자동 적용을 제공합니다. 승인하면 각 제안서에 대해 적용을 클릭하지 않고도 적격 스크립트 수정을 계속할 수 있습니다. 인라인 빨간색/녹색 차이 및 확장된 검토는 계속 사용할 수 있습니다.

1. 유휴 작업 모드에서는 빈 채팅에서 수정 사항 검토를 클릭하거나 기존 대화에서 ORCA 옆에 있는 작은 수정 아이콘을 클릭하세요. 적합한 스크립트 제안을 검토하는 동안 이를 활성화할 수도 있습니다.
2. 세션 전용 권한의 경우 이 프로젝트 기억을 선택하지 않은 상태로 두거나, 향후 작업 세션에서 자동 적용을 사용하고 정확한 이 프로젝트에 대해 편집기를 다시 시작하도록 선택하세요.
3. 수정 허용을 확인하세요. 헤더 아이콘이 녹색으로 변합니다. 자동 적용을 선택하거나 대화가 시작되면 플로팅 칩이 사라집니다.
4. 권한을 취소하려면 ORCA 옆에 있는 녹색 수정 아이콘을 클릭하세요. 이는 회전 중에도 작동하며 기억된 프로젝트 기본값을 지웁니다.

설정 → 시스템 → 스크립트 편집에서 프로젝트 기본 설정을 관리할 수도 있습니다. 프로젝트 파일 및 대화 기록 외부의 Godot EditorSettings에 로컬로 저장됩니다. 새 세션, 기록 복원, 계획 선택 및 플러그인 다시 로드는 이전 런타임 부여를 지웁니다. 적격 작업 세션은 명시적으로 저장된 프로젝트 기본 설정에서 새로운 권한을 받을 수 있습니다.

자동 적용은 addons/ 외부의 제한된 독립 실행형 프로젝트 스크립트에 적용됩니다. 대규모 패치, 장면/구성 변경 및 스크립트 실행 신뢰에는 여전히 명시적인 검토가 필요합니다. 유효성 검사, 현재 파일 해시, 저장되지 않은 상태 확인 및 경로 보호는 계속 적용됩니다. Orca이 복구 체크포인트를 유지할 수 없으면 자동 편집이 일시 중지됩니다.

중지는 추가 작업을 방지하고 완료된 편집을 유지합니다. 완료된 편집을 취소하려면 별도의 되돌리기 작업이 필요합니다.

다시 시작한 후 검토 및 복구

자동 스크립트 편집은 쓰기 전에 지속 가능한 로컬 체크포인트를 저장합니다. 기록에서 대화를 열어 이전/제안된 차이점을 검사하고 파일이 독립적으로 변경되지 않은 경우 다시 시작한 후 적용된 정확한 상태를 명시적으로 되돌리세요.

중단된 기록은 복구 확인을 제공합니다. 복구에서는 현재 파일 상태를 확인합니다. 편집 내용을 재생하거나 편집 권한을 복원하지 않습니다. 계획 및 보기 전용 내역은 읽기 전용으로 유지됩니다.

자동 스크립트 복구는 최대 체크포인트 64개/대화당 4MiB를 유지하며 각 소스 버전은 256KiB/8000라인으로 제한됩니다. 정확한 이전/제안 소스는 일반 텍스트 로컬 대화 데이터이며 대화와 함께 삭제됩니다. 공급자 지속 및 지원 보고서에서 제외됩니다. 로컬 저장소 세부정보 읽기 →

보류 중인 승인 및 수동/구조적 되돌리기 체크포인트는 메모리 전용으로 유지되며 다시 시작해도 지속되지 않습니다. 모든 되돌리기는 현재 대상에 대해 충돌을 검사합니다.

프로젝트를 자세히 살펴보세요

에이전트 도구를 사용할 수 있으면 계획 모드를 사용하여 저장된 특정 노드, 하위 트리, 속성, 신호 연결 또는 애니메이션에 대해 문의하세요. 집중 읽기는 필요한 프로젝트 부분으로 증거를 좁힙니다.

• "저장된 장면의 플레이어 하위 트리만 검사하고 신호 연결을 표시합니다."
• "저장된 장면에 HUD 노드의 레이아웃 속성을 표시합니다."
• "저장된 AnimationPlayer 애니메이션을 나열한 다음 걷기 애니메이션의 첫 번째 순간을 검사합니다."

저장된 장면 읽기는 정확한 노드 또는 하위 트리 선택, 속성 이름 필터, 범위 연결 및 초기 노드 결과 창을 넘어서는 제한된 조회를 지원합니다. Orca는 또한 제한된 내장 또는 저장되지 않은 리소스 ID를 포함하여 장면 선택과 다른 경우에도 현재 Inspector 대상을 식별할 수 있습니다.

읽기 전용 애니메이션 검사는 지원되는 저장된 텍스트 장면과 기본 애니메이션 리소스(AnimationPlayer 라이브러리, 트랙, 키프레임 및 제한된 시간 창)를 다룹니다. 장면 스크립트를 로드하거나 애니메이션을 재생하지 않고 저장된 데이터를 디코딩합니다. 결과는 재생이나 게임플레이의 정확성이 아닌 리소스 데이터를 설명하며, 저장되지 않은 외부 리소스 Inspector 편집 내용은 포함하지 않습니다.

일반 텍스트 검색 결과에는 원본 발췌문, 개수 및 불완전한 범위 피드백과 개별적으로 클릭 가능한 일치 항목이 있습니다. 디렉토리 목록은 정렬되고 제한됩니다. 쌍을 이루는 .uid/.import 사이드카는 명시적인 개수로 접히지만 고아 사이드카는 계속 표시됩니다. 필요할 때 사이드카를 포함하도록 요청하세요.

Orca Cloud에는 확장된 검사 도구를 위해 일치하는 백엔드 배포와 새로 고쳐진 인증 모델 카탈로그가 필요합니다. 이전 카탈로그는 새로운 기능이 광고될 때까지 원래 도구를 유지합니다. 결과는 스캔 및 출력 제한을 공개합니다.

코드를 통해 길을 찾으세요

Orca 1.5.0에 도입된 두 개의 읽기 전용 탐색 도구는 저장된 프로젝트 .gd 스크립트와 함께 작동합니다. find_project_symbols은 선언을 조회합니다. find_symbol_references는 주석과 문자열을 제외하고 전체 식별자 참조 후보를 찾습니다.

에이전트 도구를 사용하여 계획 모드에서 집중 질문을 시도해 보세요.

• "이 프로젝트에서 Player 클래스의 선언을 찾으세요."
• “저장된 스크립트에서 take_damage에 대한 가능한 참조를 찾아보세요.”

결과에는 소스 발췌, 중첩 클래스 범위, 정확한 파일 및 줄 위치가 포함됩니다. 결과의 활동 행을 클릭하면 Godot에서 관련 소스가 열립니다.

검색에 포함할 스크립트를 저장하세요. 저장되지 않은 스크립트는 건너뛰고 결과에는 누락된 내용과 스캔 제한이 표시됩니다. 참조 후보는 이름과 일치합니다. 사용이 하나의 특정 선언에 속한다고 설정하거나 동적 호출 및 장면 신호 연결을 해결하지 않습니다.

Orca Cloud의 경우 이러한 도구에는 일치하는 백엔드 롤아웃과 새로 고쳐진 인증 모델 카탈로그가 필요합니다. 이전 카탈로그는 새로운 기능이 발표될 때까지 기존 도구를 계속 사용합니다.

시각적 참조 첨부

메시지와 함께 UI 스크린샷, 오류 스크린샷 또는 참조 이미지를 Orca 제공하세요. 이미지 입력에는 비전 지원 모델이 필요하며 에이전트 도구 호환성과는 별개입니다.

1. 이미지 입력을 지원하는 모델과 엔드포인트를 선택하세요. 사용할 수 없는 첨부 파일 컨트롤은 흐리게 표시됩니다.
2. 작곡가의 이미지 아이콘을 클릭한 다음 데스크톱 이미지를 탐색하거나 별도의 이미지 첨부 창에 끌어다 놓습니다.
3. 또는 Ctrl/Cmd+V 또는 컨텍스트 메뉴를 사용하여 복사한 이미지 픽셀을 붙여넣거나 Godot의 FileSystem 도크에서 기존 프로젝트 이미지를 입력으로 드래그하세요.
4. 떠다니는 미리보기 이미지를 검토하고 더 큰 미리보기를 보려면 하나를 클릭하고 원하지 않는 이미지를 제거한 다음 보내기를 누르세요.

메시지당 최대 4개의 PNG, JPEG 또는 WebP 정지 이미지를 첨부할 수 있습니다. 소스 파일은 10MiB 및 16메가픽셀로 제한되며, 측면당 최대 2048픽셀 및 각 1MiB에서 PNG으로 정규화됩니다. PDF, 문서, 애니메이션 이미지 및 자동 스크린샷 캡처는 포함되지 않습니다.

알 수 없는 이미지 지원이 포함된 사용자 지정 또는 로컬 프로필의 경우 공급자 설정을 통해 정확한 엔드포인트 및 모델에 대해 확인되지 않은 입력을 명시적으로 활성화할 수 있습니다. 이 설정은 시력 품질 테스트가 아닌 호환성 주장입니다. 모델별 이미지 지원에 대해 읽어보기 →

제출된 이미지는 도구 후속 조치 중에도 계속 사용할 수 있으며 대화 기록과 함께 복원됩니다. 보류 중인 초안은 메모리 전용입니다. 자세한 내용은 이미지 저장 및 개인정보 보호 요청을 참조하세요.

더 깊이 들어가세요

저장소에는 아키텍처, 운영 경계 및 기여에 대한 전체 참조 자료가 포함되어 있습니다.