读时间： 約 9 分钟 · 系列： 分析師实踐 · 上一步： Quick vs Project · 下一步： SQL-first 或跟做 USER_GUIDE §2
全流程一览
@@PROTECT0@@@@PROTECT1@@@@PROTECT2@@
对照 USER_GUIDE 五階段表：你在 2–3 階段控口徑，在 4 階段授权取数，在 5 階段驗收交付。
双螢幕或宽螢幕时，可在 Execute 与 Report 驗收階段用 Compare view 并列唯读对照（見下文与 USER_GUIDE §11.10）。
階段 1–2：接題与探索
你做什麼：
- 在 AI 面板用自然语言說清楚：分析目标、时间範圍、分母直觉（若已有）
- 若 Agent 用互動問題追問，補齊再往下走
- 確认 Agent 先查表结構，而不是憑空假设欄位名
Agent 做什麼：
- 看可用表、grain、join key、明显体質問題
- 开始写 Plan 草稿（尚未 Execute）
狀态列： Project Focused 或 Planning。
分析師要点： 这階段可以快，但 Plan 里应开始出现 stage 定義、分母、checkpoint——不是只有「我們來分析一下漏斗」。
階段 3：審 Plan、留批註（Execute 前）
Plan 里你至少該看到：
- 分析目标
- 各 stage / 指标定義
- 分母（denominator） 与 粒度（grain）
- 驗證 checkpoint（例如最大流失段、NULL 檢查）
口徑不对时：
- Visual 模式选取段落 → 批註
- 或对話說明，但重要共识仍建議落在 Plan 批註
- 多條批註可用 Resolve (N) 一次處理（@@PROTECT3@@ 为 sidecar 中 open 批註数）
Agent 只改被批註段落，避免整份重写把沒問題的段落也改坏。Resolve 后可用 View changes 对照；已處理批註可 Archive 清面板。若正文大改导致 錨点失效，需 Re-anchor 重新反白原文。
铁律：Planning 階段不要按 Execute。 Agent 也不会在对話里假裝你已批准而偷跑正式取数。口徑未定就 Execute，等于把爭議留到 Report 才爆。專案尚无 Plan 檔时，Agent 在 Planning 可用 @@PROTECT4@@ 建立新 Plan。
本轮 Agent 動了哪些檔？（檔案变更條）
Agent 依批註 @@PROTECT5@@、Execute 时連續建 SQL tab、或产出 Report 时，你可能要展开好几个 Tool Call 才知道動了什麼。每则 AI 回覆结束后，若該回合有写入持久 SQL、Plan、Report 或 HTML Report，讯息底部会出现檔案变更條：每列一个檔案、綠 @@PROTECT6@@ 紅 @@PROTECT7@@ 行数統計，点檔名可开启对应分页。
发现 patch 錯了、或 Execute 中某步 SQL 写坏？在該则回覆的列上点 Undo，可把該檔一次还原到这则回覆开始前（同一则内对同一檔多次修改会合併統計）。若你已在 Agent 写入后手動改过正文，撤回会被阻擋——改用手動还原或再请 Agent 修。完整限制（新建檔清空不刪、@@PROTECT8@@ 与 Plan Executed 等）見 USER_GUIDE §12.14。
階段 4：Execute——只有你按
審完 Plan 后，在 Plan 工具列点 Approve & Execute：
- Plan → Executing（正文唯读）
- 系統自動通知 Agent 开始（你不必手打「开始執行」）
- Agent 問 前台 / 混合（仅二选一；后台代理分析仅 Quick Analysis 提供；只問一次）
- Pipeline Stages 所列階段一律建立 SQL 分页；混合模式下其餘步驟多在对話 @@PROTECT9@@
- Progress 面板可看 Todo 与查詢步驟；有更新时紅点提示
執行中你可以：
- 盯 SQL 分页（前台模式）
- 看中断后用 Continue 續跑（不必回 Planning 重來）
- 在 AI 回覆底部的檔案变更條核对本轮新建／修改了哪些 tab 与 Report，必要时 Undo 撤回单则写入（見上文）
若资料不可用、口径或决策前提已改变，请用 Stop & Replan…，不要把未完成的 Plan 标为完成。填写停止原因与部分成果后，旧 Plan 会成为 Stopped，并保留 Progress 与正式 evidence。可立即草拟有明确关联的替代 Plan，或稍后按 New Plan；替代 Plan 从 Planning 开始，仍须重新审阅并执行。
Agent 不能代替你按 Execute；并且进入 Executing 的 Plan 不可以再次编辑，这是为了保證「契約簽核」的永远可靠。
若 SQL 过长或过复杂，Agent 可能被要求拆成較小步驟——方便你逐步審查，不是为了形式而形式。
用 Compare view 对照 Plan（建議場景）
Execute 时主视窗常在 SQL 分页与 Progress 之间切換，口徑卻写在 Plan 里。典型做法：
- 对 Plan 右鍵 → Open in compare view → New compare view（或选已开的 Compare view 1）。
- 将 Compare view 拖到副屏（或螢幕另一半）；主视窗保留 SQL / Agent。
- Compare view 内 Plan 为唯读；主视窗若仍开著同一 Plan 分页，编辑会即时鏡像到 Compare view（未存檔时 compare tab 旁会出现 Info 提示）。
亦可把持久 SQL 分页开入同一 Compare view，与 Plan 并列（最多 5 个 tab），方便对照「契約写什麼」与「SQL 实际怎麼写」。臨时 SQL 分页不支援开启。持久 SQL 在 Compare view 内跟隨深／淺色主題；有查詢结果或錯誤时，SQL 与结果区可拖曳分割高度。
注意： Compare view 不能 Run SQL、不能改 Plan；一切编辑留在主视窗。Reference 分页在 Compare view 以琥珀色 @@PROTECT10@@ 标記，与 Plan（藍）、Report（綠）一致。
階段 5：Report 驗收
Execute 完成后，專案内会有一份 Report（通常与 Plan 一对一配对）。
合格的漏斗類 Report 应有：
- 各 stage 定義与分母說明
- 具体数字（counts / rates），不是只有「某階段流失嚴重」
- limitations——资料答不了什麼、口徑假设、相关≠因果
Report 可批註修訂、可 HTML Report 匯出分享（周会对外、对方不必裝 Lantide）。若要让同事在 Lantide 内批註 Plan、延續同一專案，用 Export project… 打包 @@PROTECT11@@（共享分析脈絡与结果；不含 SQL 分页与本機资料）——見 USER_GUIDE §11.1.0。若要交接整个工作区（含 SQL 分页、連线设定），用 Workspace 匯出。若要深挖下一題，在同一專案新建 Plan 迭代即可。
Analysis Lineage： 从 Plan 或 Report 工具列开启，可查看 Plan → Markdown Report → HTML Report 的脉络。它区分正式 evidence 与历史背景、显示不完整关联，并可直接开启每个 artifact；未储存修改或含糊的手动关联不会被当成已验证证据。
用 Compare view 驗收 Report vs Plan
驗收时常要对：Report 数字是否覆蓋 Plan 里的 checkpoint、stage 定義是否一致。
- 主视窗开启 Report 繼續批註或微調。若 Report 已与 Plan 配对，可在 View options 点 Linked plan: … 直接开启來源 Plan；未配对时可用 Link source plan 选擇同專案尚未配对的 Plan。
- 需要并列对照时，对同專案 Plan（側邊欄或已开分页）右鍵 → Open in compare view，与 Report 并列。
- 在 Compare view 内切換 compare tab，对照口徑段落与数字表格。
- 若磁碟上 Plan 已被外部更新而 Compare view 显示較旧，tab 旁 Info 会提示；点 Refresh 从磁碟重載。
已 Executed 的 Plan 也会在 View options 显示 Linked report: …，或在尚未配对时提供 Link generated report。手動配对只補上 Plan / Report 关聯，不会把 Plan 标成 Executed、凍结 steps 或完成 Todo；正式執行仍須走 Approve & Execute。
若这轮由外部 Agent 協作
驗收标准不因对話介面改变：仍要核对 Plan、正式 SQL evidence、Report 与 limitations。額外打开 External MCP Activity，確认实际修改的 artifact、@@PROTECT12@@ 与开启動作符合预期；可安全回退的单次内容变更会提供 Undo，若檔案已被后續修改则会阻擋，不会強制覆写。
外部 connection 的 mode 是能力上限，不等于 Plan 已被核准。即使使用 Execute 或 Admin，正式分析仍須由人按 Approve & Execute。連线选擇、Activity 与回復方式見 外部 Agent Integration；完整操作見 USER_GUIDE §13.7。
分析師常見問題
Q：能不能跳过 Plan 直接叫 Agent 跑 SQL？ 在 Quick 可以探索性跑；在 Project 正式交付应走 Plan → Execute，否则周会追問时缺契約。
Q：Execute 后发现 Plan 錯了？ 执行中若前提已变，请用 Stop & Replan 保留部分 evidence 并草拟替代 Plan。Executed 后 Plan 正文锁定；大改通常 新 Plan。小修 Report 可用批註（依狀态，見 USER_GUIDE §11.6）。
Q：Planning 时 Agent 会跑統計檢定嗎？ Planning 階段以探索与修 Plan 为主；正式統計在 Execute 后、且 Agent 会先跟你確认参数（見 統計分析工具）。
Q：Compare view 里能改批註嗎？ 不能。批註卡片仅供閱读与 hover 对照；View changes 可檢视已 Resolve 批註的修改对照。新增／编辑批註、Re-anchor 请回主视窗。
Q：Compare view 里錨点失效的批註怎麼看？ Compare view 会显示 錨点失效（与主视窗 Anchor outdated 同義）的卡片与 metadata，但不能 Re-anchor——请回主视窗處理。
Q：关掉主视窗某个 SQL 分页，Compare view 还看得到嗎？ 可以。Compare view 会保留关閉当下的内容快照，仍可唯读对照；需要最新结果时在 Compare view 点 Refresh。