读时间： 约 6 分钟 · 系列： 平台启用（数据工程）实践 · 上一步： 数据源与连线 · 下一步： .lantide 汇出汇入
工作区是什么
每个 Workspace 是独立环境，各自拥有：
- SQL 分页与快取
- 初始文件夹（每工作区一个本机根）
- 专案（Plan / Report）
- 连线与 MCP 设定（含 Additional folder 绑定；存于该工作区设定档）
分析师用工作区隔离 不同专案线或不同数据环境（例如「大促复盘」vs「日常 adhoc」）。
初始文件夹 vs Additional folder
| 初始文件夹 | Additional folder | Cloud folder | |
|---|---|---|---|
| 入口 | Data 区本机文件夹列 → Change data folder | Connections → Additional folder | Connections → Cloud folder |
| 数量 | 每工作区 一个 | 可多个；各有 alias | 可多个；各有 alias |
| 可用性 | 完整可用 | 完整可用 | 完整可用 |
| 查询 | "file.csv" 等（相对初始根） |
"alias"."file.csv" |
"alias"."file.parquet" 等 |
| 刷新 | Data Refresh | Connect 重扫 | Connect 重建索引；degraded 时亦需 Connect |
| 变更路径 | 右键 Change data folder（有 SQL 引用时须勾选确认） | Connections Edit 改路径（同上） | Connections Edit 改 bucket／prefix 等 |
Additional folder 不搬移、不删除来源档；它提供独立 alias、Connect／Disconnect 与可携管理——不是本机文件 DRM（使用者仍可能改初始文件夹指向等方式读多路径）。细节见 USER_GUIDE §4.5。
常用操作
| 操作 | 方式 |
|---|---|
| 建立 | 侧边栏 Workspace ＋ |
| 切换 | 点其他工作区名称或右键 Switch |
| 重新命名 | 右键 → Rename（1–40 字元；英数、简繁汉字、_ - .；不可用空白、中文标点或全形符号） |
| 删除 | 右键非使用中工作区 → Delete |
| 变更初始文件夹 | Data 区本机文件夹列右键 → Change data folder（有 SQL 引用时须勾选确认） |
| 挂额外本机根 | Data → Connections → Additional folder |
详见 USER_GUIDE §3。
隔离意味著什么
- 切换工作区 → 快取表会清掉，切回需重跑查询或 Source Run
- 分页、侧边栏展开状态 依工作区分别记住
- 汇入 Workspace 时，若 bundle 与本机既有工作区属于同一版本历史，可明确选择更新既有工作区或汇入为独立副本；不相符时建立新工作区
规划时建议：一个业务域或一个数据环境一个工作区，减少分析师误用错误文件夹。
数据目录最佳实践
- 初始文件夹指向团队 共用或同步 的稳定路径（NAS、云端同步目录等）
- 多个不相邻本机根、又不想合并目录 → 使用 Additional folder，并约定 alias 命名
- 换机汇入 Workspace 时：
- Rebind： bundle 未含 physical data 时，在新机指定对应文件夹／额外根
- Extract： 汇出勾选 Include physical data files（含初始与 additional）；汇入时选择一个专用位置，预设数据还原至
main/，Additional 还原至additional/<alias>/。所选位置内的main、additional都必须未被占用；需要时可在进阶选项改选 Additional 自订基底（见 .lantide 汇出汇入）
- 桌面版可用 Reveal in Finder / Show in File Explorer 确认目前初始文件夹
文件搬移后如何接续
数据改名或搬移后先按 Data → Refresh。可可靠追踪的本机同 volume 来源会尝试恢复；无法判定时使用 Locate folder／Locate file，不要靠同名档猜测。单档恢复不能超出原来源文件夹；改到另一根目录应先 Rebind。
来源恢复可能更新目前 SQL 分页的引用，未储存编辑会保留并提示。历史 SQL 保持原文，读取时另附目前来源对应；这不证明数据内容没变，仍须重新执行。跨磁碟、外接碟、NAS 与云端同步位置不保证自动恢复。
你现在可以做一件事
为团队建立一个命名规范范例：ws_prod_analytics、ws_campaign_618，并在 wiki 注明各工作区对应的初始文件夹路径与（若有）Additional folder alias。
Local data、Additional folder 与 Cloud folder 父列可拖到外部 Agent，指定「看看这个来源下的数据表」。Agent 先列目前可查询文件／工作表，再按需求读 schema 或抽样；遵守既有扫描与索引设定，Cloud 不会因拖移自动 Refresh。改绑目录／云端位置或 rename alias 后请重新拖移。来源父列不插入内建聊天 chip、不进 @，也不提供 Add to chat。