Cloud MCP 파일 연속 읽기 참조

올바른 오프셋과 저장된 파일 버전으로 파일 청크를 읽으세요.

고객용 Cloud MCP는 저장된 파일을 청크로 나누어 반환합니다.

연속 읽기 필드

필드	의미
`encoding`	기본값은 `utf-8`이며, `base64`를 명시할 수도 있습니다.
`content`	이 청크의 텍스트 또는 base64로 인코딩된 바이트입니다.
`offset`	이 청크의 시작 위치입니다.
`nextOffset`	다음 요청의 `offset`입니다. `null`은 완료를 나타냅니다.
`version`	저장된 전체 파일 바이트의 SHA-256입니다.
`byteLength`	저장된 전체 파일의 바이트 단위 크기입니다.
`manifestVersion`	작업 공간 세대를 포함하는 저장된 파일 매니페스트 버전입니다.

인코딩 및 오프셋

인코딩	청크 및 연속 읽기 단위
`utf-8`	청크당 최대 16384 UTF-16 코드 단위입니다. 오프셋은 UTF-16 코드 단위로 계산합니다. 텍스트 청크를 순서대로 연결하세요.
`base64`	청크당 최대 16384 원본 바이트입니다. 오프셋은 디코딩된 바이트 단위로 계산합니다. 각 청크를 디코딩한 다음 바이트를 순서대로 연결하세요.

offset: 0에서 시작하고 프로젝트, 경로 및 인코딩을 동일하게 유지하세요. null이 나올 때까지 nextOffset을 따르세요. version 및 manifestVersion을 첫 응답과 비교하세요. 둘 중 하나라도 변경되면 읽는 도중 파일이 변경된 경우의 안내를 따르세요.

저장된 파일 크기

파일 및 인코딩	허용되는 전체 파일 크기
일반 파일 및 모든 `utf-8` 읽기	최대 1 MiB.
`base64`: `alcad/documents/fab-scene/<name>.alcad-fab-scene.json`	최대 4 MiB.
`base64`: `.gds` 및 `.gdsii` 파일	최대 4 MiB.
`base64`: `rtl/schematic/results/<sha256>.json`	최대 2 MiB.
`base64`: `evolve/analysis/results/<sha256>.json`, `alcad/circuit/rlc/results/<sha256>.json`, `alcad/circuit/digital/results/<sha256>.json`	최대 8 MiB.

altifigence.workspace.files.list가 반환한 경로를 사용하세요. 도구에서 파일에 바이너리 인코딩이 필요하다고 안내하면 encoding: "base64"로 offset: 0에서 파일 읽기를 다시 시작하세요.

설정 방법은 MCP에 연결하기를 참고하세요.