读时间： 约 9 分钟 · 系列： 分析师实践 · 上一步： Quick vs Project · 下一步： SQL-first 或跟做 USER_GUIDE §2
全流程一览
接題 → 探索 schema → 草擬 Plan → （必要時短問答對齊口徑）→ 你批註修訂 → 你按 Execute
→ Agent 逐步 SQL → Report（含數字 + limitations）→ 可 HTML / follow-up Plan
对照 USER_GUIDE 五阶段表：你在 2–3 阶段控口径，在 4 阶段授权取数，在 5 阶段验收交付。聊天若切成 Ask，Agent 仍可解释与跑查询，但不会改 Plan／Report／HTML——要改档请切回 Agent（USER_GUIDE §12.1.1）。
双萤幕或宽萤幕时，可在 Execute 与 Report 验收阶段用 Compare view 并列唯读对照（见下文与 USER_GUIDE §11.10）。
阶段 1–2：接题与探索
你做什么：
- 在 AI 面板用自然语言说清楚：分析目标、时间范围、分母直觉（若已有）
- 若 Agent 用互动问题追问，补齐再往下走
- 确认 Agent 先查表结构，而不是凭空假设栏位名
Agent 做什么：
- 看可用表、grain、join key、明显体质问题
- 开始写 Plan 草稿（尚未 Execute）
- 若分母、筛选边界等仍未写死：用对话一次一题对齐（附建议答案），确认后写回 Plan，再请你审阅——不是一次丢一长串澄清题。可查表结构的事实应自己查完再问决策。见 USER_GUIDE §2.5。
状态列： Project Focused 或 Planning。
分析师要点： 这阶段可以快，但 Plan 里应开始出现 stage 定义、分母、checkpoint——不是只有「我们来分析一下漏斗」。
阶段 3：审 Plan、留批注（Execute 前）
Plan 里你至少该看到：
- 分析目标
- 各 stage / 指标定义
- 分母（denominator） 与 粒度（grain）
- 验证 checkpoint（例如最大流失段、NULL 检查）
口径不对时：
- Visual 模式选取段落 → 批注
- 或对话说明，但重要共识仍建议落在 Plan 批注
- 多条批注可用 Resolve (N) 一次处理（
N为 sidecar 中 open 批注数）
Agent 只改被批注段落，避免整份重写把没问题的段落也改坏。Resolve 后可用 View changes 对照；已处理批注可 Archive 清面板。若正文大改导致 锚点失效，需 Re-anchor 重新反白原文。
分析方向若大转折（换指标、换群体），Agent 也可能先短问答对齐新口径，再改 Plan——与草案后对齐同一节奏。
铁律：Planning 阶段不要按 Execute。 Agent 也不会在对话里假装你已批准而偷跑正式取数。口径未定就 Execute，等于把争议留到 Report 才爆。专案尚无 Plan 档时，Agent 在 Planning 可用 add_plan 建立新 Plan。
本轮 Agent 动了哪些档？（文件变更条）
Agent 依批注 patch_plan、Execute 时连续建 SQL tab、或产出 Report 时，你可能要展开好几个 Tool Call 才知道动了什么。每则 AI 回复结束后，若该回合有写入持久 SQL、Plan、Report 或 HTML Report，讯息底部会出现文件变更条：每列一个文件、绿 +N 红 -N 行数统计，点档名可开启对应分页。
发现 patch 错了、或 Execute 中某步 SQL 写坏？在该则回复的列上点 Undo，可把该档一次还原到这则回复开始前（同一则内对同一档多次修改会合并统计）。若你已在 Agent 写入后手动改过正文，撤回会被阻挡——改用手动还原或再请 Agent 修。完整限制（新建档清空不删、add_report 与 Plan Executed 等）见 USER_GUIDE §12.14。
阶段 4：Execute——只有你按
审完 Plan 后，在 Plan 工具列点 Approve & Execute：
- Plan → Executing（正文唯读）
- 系统自动通知 Agent 开始（你不必手打「开始执行」）
- Agent 问 前台 / 混合（仅二选一；后台代理分析仅 Quick Analysis 提供；只问一次）
- Pipeline Stages 所列阶段一律建立 SQL 分页；混合模式下其余步骤多在对话
run_query - Progress 面板可看 Todo 与查询步骤；有更新时红点提示
执行中你可以：
- 盯 SQL 分页（前台模式）
- 看中断后用 Continue 续跑（不必回 Planning 重来）
- 在 AI 回复底部的文件变更条核对本轮新建／修改了哪些 tab 与 Report，必要时 Undo 撤回单则写入（见上文）
如果数据不可用、口径或决策前提已改变，请选 Stop & Replan…，不要把未完成的 Plan 标成完成。你需要填写停止原因与目前部分成果；旧 Plan 会以 Stopped 保留 Progress 与正式 evidence。可立即让 Agent 草拟替代 Plan，或稍后从 Stopped Plan 的 New Plan 重新开始。替代 Plan 是新的 Planning artifact，仍须重新审阅并由你按 Execute。
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 以琥珀色 md 标记，与 Plan（蓝）、Report（绿）一致。
阶段 5：Report 验收
Execute 完成后，专案内会有一份 Report（通常与 Plan 一对一配对）。正式收尾是新增 Report：Executing 期间不会用改写旧 Report 来结案。
内建与外部 Agent 都须由本次核准并执行的 Plan 产出正式 Report；Draft mode 先把交付大纲写进 Plan。快速问答与探索不需每次建 Plan。GUI 人工建立 Report 仍可使用，但不会自动取得正式执行证据。
合格的漏斗类 Report 应有：
- 各 stage 定义与分母说明
- 具体数字（counts / rates），不是只有「某阶段流失严重」
- limitations——数据答不了什么、口径假设、相关≠因果
Report 可批注修订、可 HTML Report 汇出分享（周会对外、对方不必装 Lantide）。若成果另行发布到 P4、KM、URL 或其他位置，可在 Report 右键选 Link External Delivery…；已有连结时从列上的 overflow 或右键选 Show External Delivery…，即可 copy、edit 或 unlink。这只保存 Report-owned pointer metadata（provider、label、location、source revision、note），不会自动抓取或验证外部内容；只有 HTTP／HTTPS location 可由使用者主动点击开启，unlink 不会删除外部成果。若要让同事在 Lantide 内批注 Plan、延续同一专案，用 Export project… 打包 .lantide（共享分析脉络与结果；不含 SQL 分页与本机数据）——见 USER_GUIDE §11.1.0。若要交接整个工作区（含 SQL 分页、连线设定），用 Workspace 汇出。若要深挖下一题，可在同一专案建立新 Plan，并让 Agent 把一份或多份既有 Report 设为上游输入；Plan 仍须重新审阅与 Execute。
Analysis Lineage： 从 Plan 或 Report 工具列开启，可看到 Plan、作为新 Plan 上游的既有 Report、正式产出的 Markdown Report 与 HTML Report。它会标出 authority、缺漏关系，以及 Report 在连结后是否已变更；点选节点可直接开档。这是验收时回看交付物关系的工具，不会把未储存修改或模糊的手动关联伪装成已验证证据。
换人接手前的检查
交接时请让下一位分析师或 Agent 读目前 Plan、Report 与分析脉络变更，而非只贴聊天摘要。若数据已改名或搬移，先核对历史快照附带的目前来源对应，再重新执行；来源仍相同不等于内容未变。需要完整工作环境时使用 Workspace bundle，并检查包内 README 与缺失警告。
用 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、+N/-N 与开启动作符合预期；可安全回退的单次内容变更会提供 Undo，若文件已被后续修改则会阻挡，不会强制覆写。
外部 connection 的 mode 是能力上限，不等于 Plan 已被核准。
- Execute 双开：正式分析仍须在 Lantide 按 Approve & Execute（或经 GUI review 流程）。
- Admin 单开（进阶）：当下审阅可在外部对话完成；你明确确认执行后，外部 Agent 可呼叫
claim_plan_approved将 Plan 推进为 Executing——效果等同 Approve，但之后正式 SQL 仍须带execution_plan_ref才写入 Steps。
连线选择、Activity 与回复方式见 外部 Agent Integration；完整操作见 USER_GUIDE §13.8。
分析师常见问题
Q：能不能跳过 Plan 直接叫 Agent 跑 SQL？ 在 Quick 可以探索性跑；在 Project 正式交付应走 Plan → Execute，否则周会追问时缺契约。
Q：Execute 后发现 Plan 错了？ 若尚在执行中且前提已变，使用 Stop & Replan 保留部分成果并开替代 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。