SQL 編輯器與分頁

5. SQL 编辑器与分页

5.1 建立 / 关闭 / 重新命名分页

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

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

分页列横向卷动： 当开启的分页数量超出分页列宽度时，分页列支援横向卷动：

• 将滑鼠移到分页列上方时，会出现超细（2px）的水平卷动条提示。
• 滑鼠滚轮可直接在分页列上进行水平卷动，快速切换到看不见的分页。
• 触控板的横向滑动手势维持原生行为，不受影响。

5.2 临时分页 vs. 持久分页

Lantide Data 有两种分页类型：

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

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

5.3 撰写与执行 SQL

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

• 执行全部： 当没有选取任何文字时，点击 Run 或按快捷键，会执行编辑器中的全部 SQL。
• 执行选取： 先用滑鼠选取部分 SQL 文字，再点击 Run 或按快捷键，只会执行选取的部分。

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

SQL／Markdown 原始码／Quick Edit HTML 使用本机内建的 Monaco 编辑器（不依赖外网 CDN），离线亦可语法高亮。打包版在少数环境下语言服务（如智慧建议）可能受限，不影响基本编辑与执行。

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

输入方言与历史 SQL： 统一查询入口以 DuckDB SQL 为输入方言，仍相容反引号引用；连线目标的差异由查询路由处理。执行快照保留当时 SQL，不因来源搬移而改写。GUI 与 Agent 读取受影响快照时会附目前来源位置、引用与对应状态；旧快照无法可靠对应时标示未知。可由快照建立使用目前来源的新 SQL tab，但必须重新执行才能取得新结果。

5.4 储存分页

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

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

5.5 常用快捷键一览

[图片] 分页列：显示临时分页、持久分页（含 p 标记）与未储存标记（*）

5.6 持久分页中继数据（Metadata）

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

编辑入口：

• Tab bar：对 持久 SQL 分页右键 → Metadata
• 侧栏：对工作区 Persist 列表中的分页右键 → Metadata

首次将临时分页存成持久分页时，储存对话框已包含上述栏位。旧版未归属专案的 tab 仍可在列表中出现；Agent 必要时可 include_unscoped=true 一并列出。

侧栏分组与归档

Workspace 节点下的 persist SQL tab 按专案分组显示（无专案归属者归入 Unscoped，排在最后）；没有任何 SQL tab 的专案不会出现组头。组头显示专案名称与该组 tab 总数（含已归档）。

• 展开／收合： 一般组头可折叠（非 Focus 组预设收合，展开状态会记住）。有 Project Focus 时，对应组排前且预设展开（可手动收合；再次进入 Focus 时会再预设展开）。Tabs 搜寻命中时，有命中的组与 Archived tabs 子段亦强制展开。
• Archive／Unarchive： 对 active 列 hover 或右键可归档（软藏至该组 Archived tabs）；已归档列可还原。多选后右键可批次 Archive／Unarchive。归档不会关闭已开启的编辑器分页，也不会删除 Plan Progress Steps。
• Delete： 仍为永久移除（含确认）；与 Archive 不同。
• 拖曳排序： 仅限同一组内的 active（未归档）列；搜寻开启时停用拖曳。
• 搜寻（Tabs scope）： 可命中已归档 tab；维持分组，并自动展开有命中的组／Archived 子段。
• Agent 的 list_sql_tab 会回传含 archived 状态的全部匹配 tab（可依 project_id 筛选）。