SQL 編輯器與分頁 | Lantide Data

5. SQL 编辑器与标签页

新建标签页： 点击标签栏最右侧的＋按钮。
关闭标签页： 点击标签页上的 ✕ 按钮。关闭时，系统会根据标签页类型和是否有未保存的修改，提示你选择「保存后关闭」或「舍弃变更后关闭」。
重新命名： 双击标签页标题，或右键选择「Rename」。
关闭其他标签页： 右键选择「Close Others」，可关闭同一工作区内的其他所有标签页。
开到对照窗口： 对 持久（Persist）SQL 标签页右键，选择 Open in compare view，可将该标签页开到独立 Compare view 唯读对照（临时标签页不支持）。详见 §11.10。
调整打开顺序： 当同一工作区有 2 个以上打开标签页时，可在 标签栏上拖曳标签页标题，或在标签栏左侧 清单按钮（☰） 弹出的标签页清单中上下拖曳，调整左到右的显示顺序。两处永远反映同一份顺序。
仅限目前工作区的打开标签页： 排序只影响编辑器中的 open tabs，不会改变侧边栏 Persist 列表的磁碟顺序，也不会在重新启动 App 后保留（仅当次 session）。

Agent 关闭标签页： Agent 执行的「关闭标签页」仅关闭编辑器中的标签页，不会从侧边栏工作区列表删除持久（Persist）标签页；你仍可从侧边栏重新打开。

标签栏横向卷动： 当打开的标签页数量超出标签栏宽度时，标签栏支持横向卷动：

Lantide Data 有两种标签页类型：

类型	说明	标记
临时标签页（Temp）	新建立的标签页，SQL 尚未保存至伺服器	无特殊标记
持久标签页（Persist）	已保存的标签页，SQL 会保存在工作区中，重新打开应用程序后仍然存在	标签页标题旁有 `p` 标记

临时标签页在关闭后即消失；持久标签页会出现在侧边栏的工作区列表中，可随时重新打开。Agent 建立持久标签页后，侧边栏列表会即时更新。侧栏 Persist 列表仅含 SQL 持久标签页（不含 agent 物化产生的 markdown 快取 tab）。

未保存的修改会在标签页标题旁显示 * 号。用户手动编辑才会触发 *；Agent 透过工具写入 SQL 或 Markdown 标签页时，内容已落盘至工作区，不会显示未保存标记。

在编辑器中撰写 SQL 语句后，有两种执行方式：

查询执行中时，同一颗按钮会变为 「Running…」（方块图标），可再点一次以送出自订中断，向后端请求中止该次查询。成功中止后结果不视为一般的 SQL Query Error（也不会因此显示红色错误区块）；你随时可再次 Run 重新执行。

提示： Lantide Data 仅支持唯读查询（SELECT、DESCRIBE、SHOW、PRAGMA），不支持 INSERT、UPDATE、DELETE、CREATE 等写入操作。

点击工具列的 Save 按钮，或按下 Cmd + S（macOS）/ Ctrl + S（Windows/Linux）。
如果是临时标签页首次保存，系统会弹出对话框，请你填写 Name（必填）、可选 Label 与 Project，确认后标签页转为持久标签页。
持久标签页保存时会直接更新已有的保存记录（SQL 内容）；Name / Label / Project 请用 Metadata 对话框编辑（见 §5.6）。

注意： 标签页名称不能与已加载的数据文件名称重复，以避免 SQL 查询时产生混淆。

[图片] 标签栏：显示临时标签页、持久标签页（含 p 标记）与未保存标记（*）

持久 SQL 标签页除 SQL 正文外，可维护下列中继数据（供侧栏辨识、Agent list_sql_tab 发现与依项目筛选）：

字段	说明
Name	标签页识别名称（Tab bar 与侧栏主列文字；重新命名请用 Tab bar 双击／右键 Rename）
Label	可选说明（≤200 字元），例如 pipeline 阶段用途；Agent 列举 tab 时一并回传
Project	可选项目归属；聚焦项目下 Agent 执行 Plan 时可 `list_sql_tab(project_id=…)` 复用既有 tab

编辑入口：

首次将临时标签页存成持久标签页时，保存对话框已包含上述字段。旧版未归属项目的 tab 仍可在列表中出现；Agent 必要时可 include_unscoped=true 一并列出。