트러블슈팅

내보내기 실패, FFmpeg 누락, 캡처 권한, 프로바이더 오류, 에이전트 한계.

내보내기가 시작되지 않습니다

OpenScene은 렌더링 전에 FFmpeg를 확인하고, 중간에 실패하는 대신 문제를 알립니다. PATH의 절대 경로 디렉터리에서 바이너리를 찾을 수 있는지 확인하거나 명시적으로 지정하세요. 상대 경로는 거부됩니다.

VIDEO_TOOL_FFMPEG_PATH=/absolute/path/to/ffmpeg npm run dev

설정 → Local Tools가 로컬 런타임 준비 상태를 알려주므로 먼저 확인하세요.

내보낸 결과가 Program Monitor와 다릅니다

모니터는 최선을 다하는 검토 화면이고 기준은 FFmpeg 출력입니다. 프레임 단위 정확도를 보장하는 멀티트랙 마스터링은 이 빌드가 약속하는 범위가 아닙니다 — 내보내기 참고.

macOS에서 창 캡처에 아무것도 녹화되지 않습니다

macOS는 OpenScene을 실행하는 터미널에 화면 기록 권한을 요구합니다. 시스템 설정에서 권한을 준 뒤 앱을 다시 시작하세요. 전체 화면 캡처와 레코더의 마이크·시스템 오디오 믹스는 아직 제공하지 않습니다.

선택기에 모델이 없습니다

연결한 프로바이더만 모델을 보여줍니다. 설정 → Providers에서 하나를 연결한 뒤, 설정 → Models에서 어떤 모델을 표시할지 고르세요. 아무것도 연결하지 않았다면 로컬 Ollama 모델을 실행하면 됩니다 — 설치와 실행 참고.

에이전트가 제 영상을 보지 못합니다

watchProjectVideo는 샘플링한 프레임을 이미지로 모델에 전달하므로 비전 지원 모델이 필요합니다. 텍스트 전용 로컬 모델도 타임라인 편집은 하지만 화면에 무엇이 있는지에는 답할 수 없습니다.

생성 프로바이더가 목록에 있는데 사용할 수 없습니다

실제 어댑터가 없는 프로바이더는 동작하는 척하지 않고, 보이는 상태로 사용 불가라고 표시됩니다. 음성은 ElevenLabs 또는 OpenAI, 영상은 Google Veo 또는 OpenAI Sora에서 동작합니다. Sora 레퍼런스 이미지는 이 빌드에서 지원하지 않습니다.

에이전트가 멈춘 채 기다립니다

멈춘 것이 아니라 승인 게이트입니다. 프로젝트에 쓰거나 작업을 시작하는 것은 먼저 물어봅니다 — Edit Agent 참고.

그래도 해결되지 않으면

npm run typecheck, npm test, npm run build로 깨끗한 빌드에서 재현한 뒤, 플랫폼·Node 버전·FFmpeg 버전을 적어 github.com/Theorvane/openscene/issues에 이슈를 열어 주세요.