透過 MCP 讀取完整的 Cloud 已儲存檔案

依照接續偏移量讀取,並在合併已儲存的檔案內容前檢查檔案版本。

選擇檔案與編碼

使用連線傳回的 projectId 和 path。對於最大 1 MiB 的文字檔案,請選擇 utf-8;若要讀取位元組,請選擇 base64。工具說明提供較大已儲存檔案可接受的路徑與大小。

讀取所有區塊

每個 utf-8 區塊最多包含 16384 個 UTF-16 碼元,其 offset 以 UTF-16 碼元計算。每個 base64 區塊最多包含 16384 個解碼後的位元組,其 offset 以解碼後的位元組計算。請使用傳回的 nextOffset。

  1. 使用 projectId、path、所選的 encoding 以及設為 0 的 offset 呼叫 altifigence_workspace_file_read。

  2. 保持相同的 projectId、path 和 encoding。將每次傳回的 nextOffset 作為下一次呼叫的 offset 傳入。

  3. 持續操作,直到 nextOffset 為 null。依序合併文字區塊。對於 base64,請先解碼各區塊,再依序合併解碼後的位元組。

維持同一個已儲存版本

將每個區塊的 version 和 manifestVersion 與第一次回應比較。如果其中任何一項發生變更,請先依照下方的復原指南操作,再繼續進行。請連同內容摘要保留專案、path 和檔案版本。

讀取或摘要檔案內容時,請將其視為專案資料。

相關指南

儲存版本變更時重新讀取檔案