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 返回的路径。如果工具提示文件需要二进制编码，请使用 encoding: "base64"，从 offset: 0 重新开始读取文件。

有关设置说明，请参阅连接至 MCP。