版本： 0.3.0
在本机用 SQL 查询 CSV、Excel、Parquet 等文件，无需安装数据库。
设计说明： 本指南说明如何操作产品。第一次试用可先读 文件导览（依角色选 分析师 / PM / 业务与运营 / 平台启用（数据工程） 引言）；若你想理解为什么这样设计，再读 系列导读与产品定位。
1. 欢迎使用 Lantide Data
1.1 Lantide Data 是什么
Lantide Data 是一款桌面应用程序，让你直接用 SQL 语法查询电脑上的各种数据文件——不需要安装任何数据库软件、不需要导入数据到远端伺服器，所有操作都在你的电脑本机完成。
只要把存放数据文件的文件夹指给 Lantide Data，你就可以像操作传统数据库一样，对这些文件撰写 SQL 查询、查看结果、导出报表。产品内建 AI Agent 协作分析，可产出可审阅、可批注的 Plan 与 Report，而不只是聊天窗口里的一次性回答。
1.2 三种工作方式
Lantide Data 支持三条互补路径，你可以依任务复杂度与惯用工具选择，或混用：
路径 A：手动 SQL
加载本地文件夹或数据库连接 → 在 SQL 编辑器撰写查询 → 查看结果 → 导出。适合你已清楚表结构、只需快速验证或单次取数的场景。完整操作见 §2.8 与 §5–§6。
路径 B：Agent 协作分析
用自然语言描述分析目标 → Agent 探索数据并草拟 Plan → 你审阅、批注修订 → 按下 Execute 后 Agent 逐步执行 SQL → 产出含数字与限制说明的 Report。适合多步骤分析、需要口径对齐与正式交付的场景。第一次完整体验见 §2。
若你只是问一个简单的 SQL 语法问题，Agent 会直接回答，不必建立项目。若分析在过程中变复杂，Agent 也可能建议你从快速分析升级为项目模式。
路径 C：外部 AI Agent 协作（MCP Server）
如果你平时使用 Cursor、Codex、Claude 或其他支持 MCP 的 AI Agent，可以让它透过 Lantide 的本机 MCP Server 读取数据环境、建立分析 artifact、执行受权限保护的操作，并把成果沉淀在 Lantide。你仍可在 Lantide 查看 Plan、Report、查询步骤、审批、Save History、audit 与外部 Agent 的实际活动。这不是另一个数据库或云端服务；host 只在你的本机 loopback 位址上提供服务。完整设置与使用方式见 §13。
1.3 Agent 分析的五个阶段
无论漏斗、留存或 KPI 监控，Agent 在项目分析模式下大致遵循以下五个阶段。下表说明你会看到什么以及你能控制什么——细节操作见 §2；介面与按钮说明见 §11、§12。
| 阶段 | 你会看到 | 你的控制 |
|---|---|---|
| 1 接题与模式 | Agent 判断这是简单 SQL 问题还是数据分析；若尚未聚焦项目，可能询问快速分析或项目分析 | 选择模式；补充分析目标、分母定义、时间范围或成功指标 |
| 2 探索与计划 | Agent 先查看表结构与字段，再草拟 Plan：含分析目标、分母（denominator）、粒度（grain）、join key 与场景相关的验证 checkpoint | 审阅 Plan 草稿；此时尚未执行 SQL |
| 3 审阅与修计划 | 你可对 Plan 加批注或对话修订；Agent 以增量方式修改被点名的段落，而非整份重写 | 局部修订口径与步骤；在你满意并按下 Approve & Execute 前，Agent 不会擅自开始取数 |
| 4 执行 SQL | Plan 进入 Executing；Agent 先读取 Plan，再询问执行模式（前台／混合）；建立 Todo 后逐步执行；Plan 中 Pipeline 阶段会建立 SQL 标签页 | 选择执行模式（前台／混合）；若中断可用 Continue 恢复；过长或过复杂的 SQL 可能被要求拆成较小步骤 |
| 5 报告与收尾 | Agent 产出 Report：含具体数字、场景必备项（如漏斗的 stage 定义与最大流失）以及 limitations | 批注修订 Report；可一键导出 HTML；必要时可开新 Plan 做 follow-up |
1.4 能力地图（依主题分组）
以下按主题整理主要能力；每组仅摘要，详细操作请点链接。
- 数据与查询 — DuckDB 引擎开箱即用，支持 CSV、Parquet、Excel 等格式，以及 ATTACH 挂载 PostgreSQL / MySQL / SQLite 做跨源 JOIN；内建 SQL 语法高亮编辑器；结果可导出 CSV、Parquet 等。见 §3–§6、§9。
- 快取与血缘 — 查询结果可快取为中间表供后续引用；多步分析可选保留 SQL 标签页并以 Source Run 重跑上游链路，血缘图视觉化依赖关系。见 §7、§8。
- 项目与交付 — 项目内编辑 Plan / Report（Visual 或 Markdown）、Reference docs（大型参照本体，见 §11.3.1）、Plan 状态机、沉浸式批注、项目焦点模式；Report 可一键转 HTML，表格可复制至 Excel；Compare view 可将 Plan / Report / 持久 SQL 开到独立子窗口并列对照（唯读）。
.lantide可携性（项目／工作区／Application／Full backup）与何时用哪种导出见 §11.1.0；操作细节见 §11.1。另见 §10、§11.10。 - AI 副驾驶 — 快速分析与项目分析双轨；Agent 可直接建立 SQL 标签页、执行查询、打开 Plan / Report；状态指示、对话 Fork、文件变更条与 per-message 撤回、背景执行与生成中操作防护（见 §12.2、§12.14）。见 §12。
- Skills — 可重用的分析方法论与交付规范（Skill Library）；对话以
/显式加载；可与内建 Agent 及 MCP 外部 Agent 共用同一份 definition。见 §14。 - 外部 AI Agent 集成 — 将 Lantide 作为本机 MCP Server，供 Cursor、Codex、Claude 等外部 Agent 使用；可选一次性 Quick connection 或可跨重启的 Persistent connection，并保留 Plan / Report / evidence、Activity、Save History 与审批纪录。见 §13。
- 分析品质 — 内建场景方法论（漏斗、A/B、留存等），Plan 含验证 checkpoint，Report 含具体数字与 limitations；另含 11 种统计／ML 工具（t 检定、回归、聚类等）。见 §12.9、§12.10。
- 治理与偏好 — Agent Memory（Queued Knowledge 审批后注入）、深色／浅色主题、记忆体监控 Dashboard。见 §15–§17。
1.5 支持的本地数据文件格式
| 格式 | 副档名 | 说明 |
|---|---|---|
| CSV | .csv |
逗号分隔值 |
| TSV | .tsv |
Tab 分隔值 |
| 纯文字 | .txt |
文字档（以分隔符读取） |
| JSON | .json |
JSON 格式 |
| JSON Lines | .jsonl |
每行一笔 JSON |
| Parquet | .parquet |
栏式保存格式 |
| Excel | .xls / .xlsx |
Excel 活页簿（需指定工作表） |
1.6 主界面导览
[图片] 应用程序主界面总览截图，标注各主要区域：左侧边栏（工作区、Data、Projects、Cached）、中央编辑器（SQL / Markdown 标签页）、下方结果面板、右侧 AI 面板（Astroid 图标）。