Справочник по продолжению чтения файлов 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; сохраняйте тот же проект, путь и кодировку. Следуйте nextOffset до значения null. Сравнивайте 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. Если инструмент сообщает, что файл требует двоичного кодирования, начните чтение файла заново с offset: 0, указав encoding: "base64".

Настройка описана в разделе Подключение к MCP.