檔案附件指南

附件用於為長期記憶補充來源材料。TokST 將受保護的物件儲存在 Cloudflare R2，並在已授權工作區中保存可檢索的中繼資料。

用戶後台上傳

在用戶後台開啟一筆記憶，使用附件面板上傳檔案。後台顯示上傳進度、已生效附件和檔案生命週期操作。上傳敏感材料前，請確認記憶所屬工作區和知識庫，並使用有意義的檔名。

雲端 MCP 上傳

使用 tokst_attach_file 為既有記憶加入附件，傳入記憶 ID 與可下載的 HTTPS URL。ChatGPT 可透過 files[].download_url 提供已託管檔案。本機檔案請透過後台附件面板上傳；遠端服務無法讀取客戶端本機路徑或 file:// URL。公開端點為：

https://api.tokst.com/mcp

{
  "memoryId": "mem_example",
  "fileUrl": "https://example.com/architecture.png"
}

雲端 MCP 向已授權呼叫方回傳檔案中繼資料和短期有效的簽名下載連結。支援檔案參數的聊天客戶端也透過同一治理流程加入上傳內容。

雲端 MCP 僅接受公開可下載的 HTTPS 來源。系統會拒絕本機路徑、file:// URL、私有網路位址、重新導向至私有網路的位址、空檔案、無法確定大小的來源和超過 100 MB 的檔案。失敗回應會回傳階段化錯誤碼，例如 attachment_source_unreachable、attachment_upload_authorization_failed、attachment_storage_quota_exceeded、attachment_storage_upload_failed 或 attachment_confirmation_failed，並附帶下一步建議。

檔案生命週期

上傳初始狀態為 pending。TokST 確認 R2 物件並驗證大小和 MIME 類型後，將其標記為 active。缺失、空白或過期的待處理上傳保留可診斷狀態，並按保留策略清理。

存取與限制

工作區成員關係控制檔案存取。簽名上傳連結有效期為一小時，簽名下載連結有效期為十五分鐘。用戶後台按帳戶儲存配額執行限制。雲端 MCP 單個附件最大為 100 MB。

請勿上傳憑證、私鑰、瀏覽器 Cookie、存取 token，或工作區策略不允許離開來源設備的資料。

儲存路徑

TokST 使用以下範圍化路徑儲存附件物件：

{workspace_id}/{atlas_id}/{memory_id}/{attachment_id}-{filename}

該範圍可避免跨工作區衝突，並支援在 Dashboard 封存檢視手動永久清除已封存記憶或知識庫時清理物件。

Runtime 邊界

Cloud MCP 是智能體附件介面，使用者後台是人工檔案管理入口。可選 CLI Runtime 管理裝置、智能體 Binding、工作階段、任務、溝通與診斷。