读时间: 约 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;无关或不安全的分岔仍会拒绝。
- 没有相符工作区: 走新工作区汇入与下列 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。