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。