讀時間： 約 8 分鐘 · 系列： 平台啟用（數據工程）實踐 · 上一步： 工作區與資料目錄 · 下一步： MCP Sources 入門
四層邊界（先記這張表）
| 套件類型 | 回答的問題 | 包含 | 不包含 |
|---|---|---|---|
| Project | 這次分析的脈絡與結果能分享嗎？ | Plan、Report、Reference（含圖片資產與來源備份，若有）、專案知識、批註／HTML／viz sidecar | 工作區 SQL 分頁、連線、實體資料檔 |
| Workspace | 要在同一套環境上接續工作或換機嗎？ | 設定、專案、連線/MCP 設定（無密碼）、預設含 ledger、MCP cache 與初始／Additional folders 的完整本機檔案 | 不含 user_knowledge、全域 config、Cloud Folder／資料庫遠端內容；chat 可選 |
| Application profile | 跨工作區的 Agent 記憶？ | User Memory、知識/memory 設定、可選 AI 偏好 | license、資料檔、工作區本體 |
| Full backup | 換機一次搬齊？ | 多個 Workspace 嵌套 + Application；各工作區可選 physical data | physical data／MCP cache 預設不帶；仍須 Rebind／解壓資料夾、重填密碼 |
產品承諾： Projects 帶分析產物（共享脈絡與結果）；Workspaces 帶工作環境（協作接續、換機，預設含完整本機工作檔）；Application 帶你是誰；都不含授權與 live 連線密碼——新機上仍要重連外部來源。
完整選型表見 USER_GUIDE §11.1.0。
常見場景：Project 還是 Workspace？
| 場景 | 建議 |
|---|---|
| 給 PM／業務審 Plan、驗 Report（可批註） | Project |
| 週會只對外呈現數字、對方不必裝 Lantide | Report HTML（見 業務：HTML Report） |
| 分析師 A → B 接手（含 SQL 分頁、連線設定） | Workspace（可勾 chat sessions） |
| 本機換電腦 | Workspace 或 Full backup |
| 只搬 Plan／Report，收件方自行連 DB | Project |
匯出入口（概要）
頂部列 UsersRound → Export… / Import…：
- Project — 專案右鍵 Export project… 亦可
- Workspace — 預設包含 ledger、MCP cache 與 Include files from local data folders；scope 為 All files in data and Additional folders，壓縮為 Balanced。可取消本機檔案或縮小至 Referenced／All registered data
- Application profile — User Memory merge/replace
- Full backup — 多工作區 + Application；physical data 與 MCP cache 仍由使用者選擇，預設不帶
操作細節見 USER_GUIDE §11.1.0–11.1.3。
工作區交付格式與獨立閱讀
未加密的 Workspace 匯出使用 .lantide.zip，可由一般 ZIP 工具解開；加密工作區維持 .lantide 自訂容器。兩者都可在 Lantide 匯入，舊版未加密 .lantide 也繼續支援。Project、Application 與 Full backup 外層命名維持既有格式。
工作區包根目錄的 README.md 由程式依匯出快照產生，提供 Project／文件索引、實際包含項目、資料來源入口及分析歷史涵蓋範圍。可交給其他人或 Agent 從此開始閱讀；完整閱讀與編輯建議從 官方下載頁取得最新 Lantide Data 客戶端。獨立閱讀不代表能離線重跑所有分析，直接改包也不保證可重新匯入。
交接時保留什麼脈絡
Workspace bundle 會攜帶可用的分析脈絡快照與來源穩定 ID，讓接手 Agent 能從目前文件與變更紀錄繼續查證，而不只依賴原對話。匯入後會重建索引；來源在新機仍須重新綁定，本機追蹤 token 與機器路徑不隨包移轉。
直接 Workspace 匯出包含實體資料時，缺失或超出範圍的檔案預設阻擋匯出。若你明確選擇不完整匯出，請把 warning 清單一起交接，勿稱為完整資料備份。
Workspace 匯入：更新、複製與 Rebind
選擇 bundle 後，Lantide 會先比對工作區身分與版本歷史：
- 同一工作區歷史： 可選 Update existing workspace，以 bundle 的共享內容與已打包實體檔更新本機，同時保留本機資料夾位置、相容 credentials 與治理設定；或選 Import as separate copy 保留兩邊。更新成功會保留前版，可從工作區右鍵 Restore Previous Version 回復。已證明同源的 related fork 可用 Replace fork from source 捨棄 fork shared changes，同時保留 machine-local paths、credentials、caches 與 recovery；無關或不安全的分岔仍會拒絕。
- 同 snapshot 還原： snapshot 相同時另有 Restore …from this bundle。本機改壞了 SQL、文件或分析歷史，就用它回到 bundle 當時的狀態：版號不變，還原前狀態成為唯一一份 recovery，可再以 Restore Previous Version 取回。系統不會自動選取；只有 bundle 內已打包的實體檔會還原，metadata-only bundle 不碰外部原始檔。
- 沒有相符工作區： 走新工作區匯入與下列 Rebind 精靈。
- 更新時若偵測到 local changes、bundle 較舊或分支歷史，預覽會明確警告；不會自動逐檔合併。作業中斷時，下次啟動會依 journal 恢復一致狀態。
新工作區 Rebind 精靈（五步或六步）
未含實體資料（五步）：
- 選
.lantide.zip或既有／加密.lantide並預覽 - 指定 新工作區名稱（不可與既有同名）
- 選本機 資料夾 對應原 load dir（顯示匹配 / 缺失檔案）
- 確認連線與 MCP 列表（皆 disconnected；Sidebar 不顯示 offline 綁定）
- 執行匯入 → 依提示 Reconnect databases、在 Connections Connect folder／cloud、Reconfigure MCP、Run Source Run、必要時 Refresh schema
含實體資料（六步）： 在上述步驟 3 之後多一步 Review files to extract——選擇專用的匯入位置，確認實際還原路徑。預設資料會放進該位置的 main/；若套件含 Additional folder 實體檔，會放進 additional/<alias>/ 並自動 rebind。所選位置內的 main、additional 都必須未被占用，包括空目錄、同名檔案與符號連結；若已存在，請另選位置，或先移走／重新命名既有項目，Lantide 不會自動刪除。需要時可開啟 Advanced: choose a custom folder 改指定容器外的 Additional 基底目錄，再處理該處的檔名衝突（Replace / Rename imported / Keep existing）。其後再接連線確認與匯入。
後續更新： 既有來源保留目前路徑；以新配置匯入的 Workspace，新增 Additional alias 預設放進原容器的 additional/（初次使用自訂基底時則延續該位置）。若已手動改變預設 data folder，新增來源需要明選位置。舊 Workspace 維持原有配置，不自動搬檔。這個容器只包含本機資料；搬動它不等於搬動完整 Workspace。
密碼不會寫進套件——匯入後必須在 Connections 重填（含 SQL Server）。選擇 All files in data and Additional folders 時會連 Python、XMind、隱藏檔等一起打包，但不跟隨 symlink；匯入採 overlay，不刪除目的地額外檔案。若匯出時勾選 Encrypt bundle，還需保管好 passphrase（見 備份與安全）。
常見誤解
| 誤解 | 實際 |
|---|---|
| 「匯入就能查」 | 無 physical data 時要先 Rebind 資料夾 + 重連 DB + 常需 Source Run；有 physical data 時仍要重連外部 DB |
| 「手動 copy workspaces 資料夾」 | 路徑綁定、易半成品；請用官方 .lantide |
| 「Project 匯出含資料」 | 不含 CSV 本體；收件方也要有資料或連線 |
| 「Workspace 一定不帶 CSV」 | Workspace 目前預設包含完整本機資料夾檔案；不應分享時請取消包含或縮小 scope |
| 「分享分析＝Workspace」 | 跨角色審 Plan／Report 通常用 Project；Workspace 是整包工作環境 |
| 「匯入同一 Workspace 一定再建一份」 | 同一版本歷史可選更新既有工作區，或明確匯入為獨立副本；更新後仍可 Restore Previous Version |
外部 Execute／Admin Agent 也可透過 managed Workspace 流程 prepare → stage／poll → save，或 inspect → immutable plan → approval／apply。Execute 的敏感套用需 GUI 核准；Admin 可保留 warning、Activity 與 audit 後 direct apply。此路徑目前只處理單一 Workspace，不支援 Project／Application／Full backup，也不接受 plaintext passphrase。
你現在可以做一件事
用測試工作區做一次 Export Workspace → Update existing workspace → Restore Previous Version 演練；再試 Import as separate copy 與需要的 Rebind。若測試套件不應包含完整本機檔，匯出前取消 Include files from local data folders 或縮小 scope。