2. 快速开始
以下以 Agent 专案分析（订单漏斗范例）示范完整流程。若你只想手动跑 SQL，见 §2.8。
2.1 启动与首次设定
开启 Lantide Data，应用程式会自动启动后端服务并进入主画面。首次启动时会自动建立一个预设工作区。
首次启动体验：
- 启动完成后，先阅读并确认 Terms of Service 与 Privacy Policy；两项都勾选后才能进入 App。Trust Center 说明 Lantide 的数据保护方式。Terms 或 Privacy 更新时，会在下次启动要求重新确认相应文件。
- 日后可从 Help → Legal Information 查看目前接受的 Terms／Privacy 版本、生效日期与最后确认时间，或重新开启 Terms、Privacy Policy 与 Trust Center。
- 面板依 Setup Mode 显示：Built-in 显示内建 Agent，External 显示外部 Activity；可从 View → Agent Panels 改为显示其中一个或两者。
- Setup Mode Choice 对话框预选 External Agent (MCP)，你也可选择 Built-in Agent (BYOK)（在 Lantide 内聊天）或 External Agent (MCP)（在 Cursor 等外部 client 聊天，Lantide 作本机 MCP host）。
- Built-in 路径：先弹出 Agent Preferences（可 Save / Skip）→ Welcome 引导 Open AI Settings 设定 Profile（OpenAI / Ollama / Custom）→ 完成后可开始聊天。Preferences 详见 §15.3.1。
- External 路径：自动开启 Agent Integration → 暴露 MCP；使用 Codex 时可从 App 以 GUI 确认后直接配对并合并本机设定，其他 client 可用 Copy connection kit（复制成功即视为 first-run 完成）→ 可一键 Copy onboarding prompt 贴到外部 Agent。Welcome 不引导 Open AI Settings。详见 §13 与 Learn External Agent Integration。
- 既有使用者升级时会自动迁移（曾看过旧版影片、已配 LLM、或已连上 MCP 者通常不会再看到 Setup Mode Choice）。
[图片] 应用程式启动后的初始画面
2.2 载入数据
- 在侧边栏展开 Data 区块。
- 若尚未绑定初始文件夹，会看到 「No local folder — click to choose」 列：点击后会先确认，再开启文件选择器。
- 选择存放数据文件的文件夹（例如含
orders.csv的目录）后，Lantide Data 会扫描支援的文件并列在 Data 之下。初始文件夹每个工作区一个，所有方案皆可用。 - 若要变更初始文件夹，在文件夹名称列上按右键 → Change data folder。更多选项（Reveal in Finder、列表排序）见 §3.2、§4.1。
- 若还需要挂第二个（或更多）本机数据根、而不想搬档，可在 Connections 新增 Additional folder；见 §4.5。
[图片] 选择文件夹后，侧边栏显示文件列表
2.3 建立专案并聚焦
- 在侧边栏 Projects 区块点击 ＋，输入专案名称（例如「Order Funnel」）并确认。
- 在专案名称上按右键 → New File，建立一份 Plan 文件。
- 点击专案列右侧的眼睛图示聚焦该专案——图示变绿、列背景高亮。聚焦后 Agent 自动进入专案分析模式，不再询问快速分析或专案分析。详见 §11.1、§11.4。
[图片] 新建专案并聚焦
2.4 用自然语言提出分析需求
在 AI 面板输入分析需求，例如：
分析订单漏斗，找出流失最多的阶段。分母以「建立订单」为起点，时间范围为最近 90 天。
Agent 可能先确认目标、分母或时间范围（透过对话中的互动问题区块）。AI 状态指示器会显示 Project Focused 或 Planning。Agent 会先探索 orders.csv 等表的 schema，再开始撰写 Plan——不会凭空假设栏位名称。
若你只是问「这张表有哪些栏位？」这类简单问题，Agent 会直接回答，无需完整 Plan 流程。
2.5 审阅 Plan：口径与 checkpoint
Agent 草拟 Plan 后会请你审阅。一份合格的漏斗分析 Plan 通常包含：
- 分析目标 — 例如找出漏斗中流失最多的阶段。
- Stage 定义 — 每个漏斗阶段的筛选条件（如「已付款」「已出货」）。
- 分母（denominator） — 各阶段转化率的分母如何定义（以上一阶段通过数还是固定起点）。
- 粒度（grain） — 以订单为单位还是以用户为单位。
- 验证 checkpoint — 例如确认最大流失阶段、检查 NULL 或异常状态。
草拟后的短问答（Plan Grilling）： 若口径、分母、数据边界或假设仍未写死，Agent 会在对话中用 ask_user 一次只问一题，并附上建议答案与简短理由；你确认后，Agent 以增量方式把共识写进 Plan，再请你到 Plan 分页做最终审阅。可透过看表结构或探数查到的事实，Agent 应自己查完再问决策，而不是拿事实来考你。分析方向若发生大转折（换指标、换群体），Agent 也可能先短问答、再改计划。若你在提示中已把口径说清楚，Agent 可略过问答、直接进入审阅提示。细节与其他 ask_user 场景见 §12.7。
若某段口径需要修改，在 Plan 的 Visual 模式下选取文字 → 点击批注图示 → 写下修改意见。Agent 只会修改被批注的部分，不会整份重写。批注操作见 §11.7。
在此阶段不要按 Approve & Execute——先确认 Plan 中的口径与步骤符合你的预期。Agent 不会假装你已批准而擅自开始取数。
2.6 执行分析
审阅满意后，在 Plan 工具列点击 Approve & Execute。系统会将 Plan 切换为 Executing 状态，并自动向 Agent 发送开始执行的指令——你不需要手动在 AI 面板输入「开始执行」。这个按钮核准的是目前 Plan 的生命周期与执行范围；若使用外部 Agent，它不会提高 connection 的 Observe / Execute / Admin access mode。
执行过程中你会看到：
- Agent 先读取 Plan，再询问偏好的分析执行模式（前台自动分析／混合模式）。模式说明见 §12.5；在 Executing 阶段同一段对话中只需选择一次（与 Quick Analysis 的后台模式分开）。
- Plan 工具列的 Progress 按钮出现 Todo 清单与查询步骤（有更新时显示红点）。见 §11.6。
- Agent 在执行每个主要 SQL 步骤前先验证语法，再正式取数；探索试错与正式取数分开，避免无意义的重试回圈。
- 若 SQL 过于复杂（例如含 3 个以上 CTE），Agent 会被要求拆成较小的步骤，方便你逐步审查。
若你使用双萤幕或宽萤幕，可将某个 持久 SQL 分页或 Plan 开到 Compare view 对照，主视窗继续编辑或执行下一个步骤。见 §11.10。
若执行中断（用户停止、网路问题、关闭应用等），Plan 会显示 Continue 按钮，点击即可从中断处恢复，无需从头开始。
2.7 阅读 Report 与下一步
分析完成后，Agent 会在专案中新增一份 Report。一份合格的漏斗 Report 应包含：
- 各 stage 的定义与 分母说明
- 最大流失阶段及具体 counts / rates（例如「审核通过 → 交物流：1,623 单，占 1.63%」）
- 限制与注意事项（limitations） — 数据无法回答的问题、口径假设、相关性与因果的区别等
你可以在 Report 上继续加批注请 Agent 修订措辞，或使用工具列 HTML Report 汇出独立 HTML 档在浏览器分享。见 §10。
验收 Report 时，可将同专案的 Plan 开入 Compare view，与主视窗的 Report 并列对照口径与数字（Compare view 内为唯读）。见 §11.10。
若分析自然延伸出下一个问题（例如按商品类别深挖），你可以在同一专案建立新的 Plan 继续迭代。
[图片] 完成的 Plan 与 Report 并列检视
2.8 附录：手动 SQL 快速查询
若你不需要 Agent 协作，以下是最短的手动查询路径：
- （可选）建立工作区 — 在侧边栏 Workspace 区块点击 ＋，输入名称（1–40 字元）并确认。见 §3.1。
- 载入数据 — 同 §2.2。
- 新增 SQL 分页 — 点击分页列 ＋，在编辑器输入 SQL，例如：
SELECT * FROM "orders.csv" LIMIT 10
- 执行 — 点击 Run 或按
Shift + Enter。 - 查看结果 — 结果显示在编辑器下方；可翻页（每页 20–100 笔），画面预览最多 500 笔。完整数据请用汇出。
[图片 / GIF] 在编辑器中撰写 SQL 并执行的操作过程