讀時間： 約 7 分鐘 · 系列： 平台啟用（數據工程）進階 · 上一步： MCP Sources 入門
備份策略建議
| 頻率 | 做什麼 | 套件類型 |
|---|---|---|
| 分析交付前 | 匯出含 Plan / Report 的專案 | Project .lantide |
| 環境變更前 | 匯出整個工作區 | Workspace .lantide |
| 換機 / 離職交接 | Full backup + 確認資料策略（Rebind 或 bundle 含 physical data） | Full backup .lantide |
| Agent 個人化遷移 | Application profile（注意 merge/replace） | Application .lantide |
依分享分析 vs 接續工作選 Project 或 Workspace 的完整對照，見 USER_GUIDE §11.1.0 與 .lantide 匯出匯入。
本機資料與工作檔：
- Workspace Export 預設： 包含 MCP cache，以及初始資料夾／Additional folders 的完整本機檔案；若不應分享原始資料、
.env或 source code，請取消包含或縮小 scope。 - Full backup 預設： 不包含 physical data 與 MCP cache；需要換機搬齊時再逐項啟用。無論哪種套件，匯入不會刪除目的地額外檔案。
安全邊界（官方 denylist 摘要）
匯出套件 絕不包含：
license_cache.json、授權金鑰- 可還原的資料庫連線密碼（v1 預設）
- API keys（Application 匯出預設不含；勾選含 keys 需二次確認）
匯入採 staging + 原子提交；失敗不應留下半成品工作區。細節見 data-portability PRD。
可選加密（passphrase）
四種匯出（Project / Workspace / Application / Full backup）在 Export 對話框可勾選 Encrypt bundle，以 passphrase（至少 8 字元）加密外層套件。未勾選時與舊版相同（明文 ZIP，檔頭 PK）。
| 你要知道的 | 說明 |
|---|---|
| 為什麼用 | 套件要放雲端、郵件、U 盤交接時，多一層保護 Plan / Report / User Memory 等內容 |
| 遺失 passphrase | 無法還原——產品無法代為解密；請用密碼管理器或團隊金鑰託管流程保存 |
| 與 DB 密碼的關係 | 加密保護的是 .lantide 檔案本身；匯入後 仍須 在 Connections 重填資料庫密碼（denylist 不變） |
| Full backup | 僅外層加密；內層嵌套的工作區子套件仍是明文 ZIP——外層 passphrase 仍須妥善保管 |
| 匯入流程 | 選檔 → inspect（加密檔可先看到低敏感摘要）→ 輸入 passphrase Unlock → 完整預覽 → 匯入 / Rebind |
| 磁碟空間 | 解密時會寫入暫存 zip，需要額外空間；完成後自動清理 |
逐步操作見 USER_GUIDE §11.1.4。
何時建議開加密： 含 User Memory、多專案 Plan/Report、physical data、或經非受信管道傳遞的 Full backup。內網當次傳檔、立刻匯入 可視團隊政策不加密。
匯入後 checklist（必做）
完成 Workspace / Full backup 匯入後，依產品提示：
- Reconnect databases（重填密碼）
- Reconfigure MCP sources（若有）
- Run Source Run 重建分頁快取（bundle 未含 physical data 時尤其重要）
- Refresh schema（Data 標題列 Refresh）
- 檢查 AI Settings（含 localhost 相關提示）
分析師回報「表都在但查不了」——多半卡在 1 或 3。
常見問題
| 現象 | 可能原因 | 處理 |
|---|---|---|
| 匯入後本地表缺失 | Rebind 路徑錯誤或檔案未同步到新機 | 修正資料夾或補齊檔案後 Refresh；或改用含 physical data 的 bundle |
| 外部表不見 | 連線 disconnected 或未 Connect |
Connections 或 Sidebar 右鍵 Connect；必要時 Data Refresh |
| SQL 分頁報錯 | 快取未重建 | Source Run |
| 新增 DB 後連不上 | 網路、來源端連線上限、帳密或防火牆問題 | 檢查 Test Connection、來源端限制與網路政策；產品本身不限制 active DB 數量 |
| 改名後對話丟失 | 舊版已知限制 | 見 0.2.3 release 已知限制 |
| 匯入提示要 passphrase | 匯出時有勾選加密 | 向匯出方索取 passphrase；遺失則無法還原 |
| Unlock 失敗 / Incorrect passphrase | 密碼錯誤或檔案損壞 | 確認大小寫與完整 passphrase（≥8 字元）；仍失敗則請重新匯出 |
| 解密或匯入很慢 | Argon2 衍生 + 大檔解壓 | 正常現象；確保磁碟有暫存空間 |
| Bundle 很大 | Workspace 預設含完整本機資料，或 Full backup 選了 physical data | 匯出前檢查 scope；去重後 physical bytes 嚴格大於 200 MiB 時須額外確認 |
| Extract 檔名衝突 | 目標目錄已有同名檔 | 在 Review files to extract 選 Replace / Rename imported / Keep existing |
| 分享 bundle 外洩敏感資料 | physical data 含業務 CSV | 勾選 Encrypt bundle；限制下載管道與存取權 |
| Agent Integration 已 Expose，但 Header 無狀態 | endpoint 在等待 client，尚未建立 session | 重新載入外部 client 的 MCP 設定並 initialize；不要把 Exposed 當 active |
| 外部 Agent 突然無法連線 | connection 已過期、Unexpose、Rotate 或 Revoke | 在 Agent Integration 核對狀態；需要時重新 Expose，並把新 token/config 更新到受信 client |
| Execute / Admin 被另一條 session 阻擋 | 同一工作區已有 writer | 先確認阻擋者與工作內容；取得同意後結束指定 session，再重試，不要靜默搶占 |
| 外部 Agent 改錯檔案 | Activity 顯示該次內容變更 | 若檔案未再被修改，用該 Activity 卡片的 Undo；衝突或副作用操作改採手動修復 |
與手動複製資料夾的對比
手動複製 workspaces/ 不可靠：絕對路徑、連線狀態、Tab cache 與 DuckDB spill 容易不一致。請以 .lantide + Rebind（或 official extract） 為唯一官方遷移路徑。
你現在可以做一件事
把本頁 匯入後 checklist 五條貼進團隊運維 wiki，並指定換機時由誰執行、誰驗證分析師能跑通一條 SELECT。