알려진 오류
edit_item 업데이트 raw shape:
- 잘못됨:
{ "id": "abc", "fromFrame": 30 } - 올바름:
{ "json": "{\"updates\":[{\"id\":\"abc\",\"fromFrame\":30}]}" } - 일반적인 이동, 트림 및 트랙 변경에도 동일한
updatesshape를 사용하십시오.
edit_item 추가 raw shape:
- 새 항목은
json트랜잭션의adds배열 안에 들어갑니다:{ "json": "{\"adds\":[{...}]}" }. - 간단한 비디오 배치에는
edit_item을 사용하십시오. 예:{ "json": "{\"adds\":[{\"type\":\"video\",\"assetId\":\"...\",\"fromFrame\":0}]}" }.
타임라인 오버랩:
- 오류 텍스트:
Overlap: updated item at ... would overlap existing item at ... on this track. - 쓰기를 강제하거나 충돌하는 항목을 조용히 삭제하지 마십시오.
- 명시적인 사용 가능한
trackId(예:"trackId":"V2"를 포함한 업데이트)로edit_item트랜잭션을 재시도하거나, 사용자에게 어떤 레이어가 우선해야 하는지 물어보십시오.
작업공간 경로 제한:
- 외부 MCP의
push_asset은filePath로 공개 http(s) URL만 허용합니다. 로컬 경로, 작업공간 경로 및 채팅 첨부 파일 경로를 거부합니다. - 모션 그래픽 자산의 경우
create_motion_graphic_from_code({ code:"...", name, width, height, durationInFrames })를 통해 JSX 소스를 전달하십시오.push_asset은 더 이상 인라인code인수를 허용하지 않습니다. - 로컬 미디어를 작업공간에 복사하는 것은 비디오/오디오/이미지/GIF 가져오기에 대한 해결책이 아닙니다. 대신
asset-import와import_media를 사용하십시오. import_media action=create_session을 사용한 후, 클라이언트가 보유한 파일에 대해 반환된 토큰으로 OpenChatCut 미디어 가져오기 헬퍼를 한 번 실행하십시오.
브라우저 비디오 변환 실패:
- 오류 텍스트에는 종종
Unable to convert video without dropping audio/video tracks또는unknown_source_codec이 포함됩니다. - OpenChatCut 미디어 가져오기 헬퍼를 다시 실행하십시오. 이 헬퍼는 프론트엔드 정렬 변환을 담당하며, 변환이 불가능한 경우 사용자가 조치할 수 있는 오류를 표시합니다.
- 해결 방법으로 사용자에게 동일한 파일을 편집기 UI를 통해 다시 가져오도록 요청하지 마십시오. 변환 경로는 동일하며 오류가 반복됩니다. 소스를 수정하거나(
ffmpeg로 로컬에서 재인코딩) 다른 파일을 선택하십시오. - 대체 자산이 업로드/전사된 후, 사용되지 않는 실패한 원본 자산을 삭제하십시오. 최종 미디어 풀은 실패한 가져오기와 대체 자산이 아닌, 성공적인 가져오기처럼 보여야 합니다.
모션 그래픽 요구 사항:
push_asset(type:"motion-graphic")에는width,height,duration또는durationInFrames가 필요합니다.- MG 코드는 OpenChatCut 검증기를 통과해야 합니다.
- 생성된 MG 코드에는 루트
AbsoluteFill이 유효하지 않습니다. 대신 스케일링 루트div를 사용하십시오. - MG 코드 내에서 최상위 로컬 변수 이름으로
scale을 선언하지 마십시오. 검증기/런타임에서 이미 해당 식별자를 예약했을 수 있습니다.uiScale과 같은 특정 이름을 사용하십시오.
로컬 개발 Zero 주의사항:
- 백엔드가 기본 포트가 아닌 포트에서 실행될 때는 일치하는 Zero 뷰-싱크 구성(config)을 사용하십시오.
- 이 POC에서는 백엔드
3010, 편집기5177, 뷰-싱크4850이 이전3000/5173/4848스택과 의도적으로 격리되어 있습니다.
타임라인 프레임 렌더러 주의사항:
view_timeline_frames가 한 프레임에 대해 실패하더라도 프로젝트 쓰기 경로는 여전히 정상일 수 있습니다. 결론을 내리기 전에 더 적은 프레임이나 다른 시간으로 재시도하십시오.blob:플레이스홀더(업로드 진행 중)에 있는 자산은 빈 상태로 렌더링됩니다. 빈 프레임을 버그로 간주하기 전에track_progress target=upload가 완료될 때까지 기다리십시오.- 도구가 대상 프레임을 시각적으로 확인하는 이미지 콘텐츠를 반환하지 않으면 시각적 증명 성공을 보고하지 마십시오.