Question 1

Orca 터미널을 사용할 때 Android 폴더블 폰에서 텍스트 오버플로와 화면이 반으로 잘리는 이유는 무엇인가요?

Accepted Answer

이는 Orca v0.0.11에서 Android 폴더블 기기(예: Samsung Fold, Motorola Razr)에서 발생하는 알려진 버그입니다. Android WebView의 기본 textZoom이 터미널 셀 그리드를 넘어 텍스트를 확장시키고, 펼친 후 viewport가 재측정되지 않기 때문에 발생합니다. Orca를 버전 0.0.12 이상으로 업데이트하십시오. 이 버전에서는 textZoom을 100으로 고정하고 창 크기 변경 시 viewport를 동적으로 재측정합니다.

Question 2

macOS에서 버전 1.4.43으로 업그레이드한 후 Orca 충돌 루프를 해결하는 방법?

Accepted Answer

Electron 렌더러 데이터를 삭제하여 크래시 루프를 중지하세요. 터미널에서 다음 명령어를 실행하십시오:

rm -rf ~/Library/Application\ Support/Orca/Session\ Storage
rm -rf ~/Library/Application\ Support/Orca/Local\ Storage
rm -rf ~/Library/Application\ Support/Orca/Partitions
rm -rf ~/Library/Application\ Support/Orca/Cache
rm -rf ~/Library/Application\ Support/Orca/Code\ Cache
rm -rf ~/Library/Application\ Support/Orca/GPUCache
rm -rf ~/Library/Application\ Support/Orca/DawnGraphiteCache
rm -rf ~/Library/Application\ Support/Orca/DawnWebGPUCache
rm -rf ~/Library/Application\ Support/Orca/Cookies*
rm -rf ~/Library/Application\ Support/Orca/DIPS*
rm -f  ~/Library/Application\ Support/Orca/Preferences
rm -f  ~/Library/Application\ Support/Orca/"Network Persistent State"
rm -f  ~/Library/Application\ Support/Orca/"Local State"

이 작업은 내장 브라우저 세션 상태(쿠키, 로그인 세션)를 삭제하지만 터미널 대화 기록과 오케스트레이션 데이터베이스는 유지합니다. 문제는 Electron version bump in 1.4.43이 이전 버전에서 작성된 스토리지 데이터를 deserialize할 수 없기 때문에 발생합니다.

Question 3

대용량 UTF-8 문자열을 파일에 쓸 때 Electron 앱이 충돌하는 이유와 해결 방법은 무엇인가요?

Accepted Answer

이 충돌은 Electron에 번들된 Node에서 발생한 상위 버그(electron/electron#51871)로 인해, 파일 시스템 쓰기 시 큰 비ASCII 문자열을 잘못 처리하여 잡을 수 없는 네이티브 중단(abort)이 발생합니다. 상위 수정 사항이 포함된 Electron 42.3.3 이상으로 업그레이드하세요. 즉시 업그레이드할 수 없는 경우, 임시 해결 방법으로 Buffer.from(string, 'utf8')을 사용하여 수동으로 문자열을 Buffer로 인코딩한 후 작은 청크로 나누어 쓰는 방법(청크 파일 라이터 등)이 있지만, 업그레이드가 권장되는 영구적인 해결 방법입니다.

Question 4

회사 또는 VPN 네트워크에서 자동 업데이터 ERR_HTTP2_PROTOCOL_ERROR 오류를 해결하는 방법

Accepted Answer

이 오류는 기업 SSL 차단 프록시가 HTTP/2 스트림을 재설정할 때 발생합니다. HTTP/1.1을 강제하려면 Electron 메인 프로세스(예: `src/main/startup/configure-process.ts`의 다른 appendSwitch 호출 전)에 `app.commandLine.appendSwitch('disable-http2')`를 추가하세요. 이는 `curl --http1.1`과 동일하며 렌더러 네트워킹이 아닌 메인 프로세스에만 적용됩니다. PR #4450을 통해 수정이 통합되고 있습니다. 임시 해결 방법: 다음 릴리스까지 원라인(one-liner)을 수동으로 적용하세요.

Question 5

Orca v1.4.35이 macOS 26.3.1 (Tahoe)에서 오류 메시지 없이 실행 직후 종료되는 이유는 무엇인가요?

Accepted Answer

이는 특정 macOS 26.3.1 빌드(25D771280a)에 영향을 미치는 알려진 버그로, 다른 Orca 인스턴스가 실행 중이 아닐 때도 Electron의 requestSingleInstanceLock()이 false를 반환합니다. 해결 방법: 잠금 확인 전에 ORCA_E2E_USER_DATA_DIR 환경 변수를 설정하여 대체 사용자 데이터 경로를 강제로 지정합니다. 예: `ORCA_E2E_USER_DATA_DIR=/tmp/orca-profile open -a Orca`. 영향을 받는 시스템에서 이 문제를 우회할 수 있습니다. 영구적인 수정은 Electron 업데이트가 필요하며, 업데이트는 Orca의 이슈 #3464를 참조하세요. 향후 Orca 버전에서는 자동으로 실패하지 않고 눈에 띄는 오류를 기록할 것입니다.

Orca

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트