读时间: 約 7 分钟 · 系列: 平台启用(数据工程)进階 · 上一步: MCP Sources 入门
备份策略建議
| 頻率 | 做什麼 | 套件類型 |
|---|---|---|
| 分析交付前 | 匯出含 Plan / Report 的專案 | Project @@PROTECT0@@ |
| 環境变更前 | 匯出整个工作区 | Workspace @@PROTECT1@@ |
| 換機 / 離職交接 | Full backup + 確认资料策略(Rebind 或 bundle 含 physical data) | Full backup @@PROTECT2@@ |
| Agent 个人化遷移 | Application profile(注意 merge/replace) | Application @@PROTECT3@@ |
依分享分析 vs 接續工作选 Project 或 Workspace 的完整对照,見 USER_GUIDE §11.1.0 与 .lantide 匯出匯入。
实体 CSV / Parquet:
- 预设: @@PROTECT4@@ 不包含本機资料檔——请用 NAS/云端同步或自有备份,并在匯入后 Rebind 指向正確目录。
- 可选: Workspace / Full backup 匯出可勾选 Include physical data files,将已註冊檔案打包进 bundle;敏感资料須搭配加密与存取控管(見下方 passphrase 与 FAQ)。
安全邊界(官方 denylist 摘要)
匯出套件 絕不包含:
- @@PROTECT5@@、授权金鑰
- 可还原的资料庫連线密碼(v1 预设)
- API keys(Application 匯出预设不含;勾选含 keys 需二次確认)
匯入採 staging + 原子提交;失敗不应留下半成品工作区。細節見 data-portability PRD。
可选加密(passphrase,0.3.0)
四種匯出(Project / Workspace / Application / Full backup)在 Export 对話框可勾选 Encrypt bundle,以 passphrase(至少 8 字元)加密外层套件。未勾选时与旧版相同(明文 ZIP,檔頭 @@PROTECT6@@)。
| 你要知道的 | 說明 |
|---|---|
| 为什麼用 | 套件要放云端、郵件、U 盤交接时,多一层保护 Plan / Report / User Memory 等内容 |
| 遺失 passphrase | 无法还原——产品无法代为解密;请用密碼管理器或團隊金鑰託管流程保存 |
| 与 DB 密碼的关系 | 加密保护的是 @@PROTECT7@@ 檔案本身;匯入后 仍須 在 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 | Connections 重連 + Refresh |
| SQL 分页報錯 | 快取未重建 | Source Run |
| 第二條 DB 連不上 | Trial 仅 1 active 連线 | 升級或断开旧連线 |
| 改名后对話丟失 | 旧版已知限制 | 見 0.2.3 release 已知限制 |
| 匯入提示要 passphrase | 匯出时有勾选加密 | 向匯出方索取 passphrase;遺失则无法还原 |
| Unlock 失敗 / Incorrect passphrase | 密碼錯誤或檔案損坏 | 確认大小写与完整 passphrase(≥8 字元);仍失敗则请重新匯出 |
| 解密或匯入很慢 | Argon2 衍生 + 大檔解压 | 正常现象;確保磁碟有暫存空间 |
| Bundle 很大 | 勾选 physical data 或含多工作区 | 匯出前留意大小提示;大于 50 MB 須二次確认 |
| 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;衝突或副作用操作改採手動修復 |
与手動复製资料夾的对比
手動复製 @@PROTECT8@@ 不可靠:絕对路徑、連线狀态、Tab cache 与 DuckDB spill 容易不一致。请以 @@PROTECT9@@ + Rebind(或 official extract) 为唯一官方遷移路徑。
你现在可以做一件事
把本页 匯入后 checklist 五條貼进團隊运维 wiki,并指定換機时由誰執行、誰驗證分析師能跑通一條 @@PROTECT10@@。