常见问题
产品定位
什么是分析资产？
分析资产是可以被查证、重跑、修改与交接的完整分析上下文。它不只包含最后的 Report，也包含数据源指向、指标口径、Plan、完整执行步骤、SQL 证据、验证步骤、血缘与操作记录；原始数据是否随分析一起保存，则取决于导出类型与选项。
→ Lantide Data 是什么？换另一个 Agent 如何继续分析？
Agent 先读工作区分析上下文索引，再按导航查阅文档与历史，之后以相同范围的 cursor 增量读取。相同连接配置可用私有 owner key 跨对话或工作区继续，保留有效 Plan 批准。key 是私有凭据，交出后不会自动停止原 Agent，请先协调停止操作。
→ 阅读指南本地数据改名或移动后怎么办？
先刷新 Data 检查来源位置。支持的本地跟踪可尝试恢复能够识别的同卷移动，无法判定时用 Locate folder 或 Locate file。未保存 SQL 编辑会保留；历史 SQL 不改，读取时附当前来源映射，不代表内容未变。跨磁盘、外接盘、网络与云同步位置不保证自动恢复。
→ 阅读指南Workspace 导出增加了什么？
未加密 Workspace 使用 .lantide.zip，附可阅读 README、文档索引与可用的分析上下文快照；导入以 main/ 与 additional/<alias> 还原数据并重建上下文。稳定来源 ID 会随包携带，原生跟踪 token 不会。直接 Workspace 导出缺少实体文件时默认阻止，明确允许不完整导出才会保留警告后继续。
→ 阅读指南Lantide 是分析工具、IDE，还是分析资产平台？
目前最准确的说法是「本地优先的 AI 分析工作台」。Lantide 的核心价值，是把一次性的分析过程保存成可复用的分析资产；平台则是这套能力向团队部署与集成延伸后的长期方向。
→ 产品定义我完全不会写 SQL，也不懂 Python，可以用 Lantide Data 吗？
可以。您只需要用白话描述想分析的问题，Lantide Data 会协助产生 Plan 与 SQL，并在您确认后执行。您负责审阅分析方向与结果，不需要自己从零撰写程式。
→ 快速开始既然一般 AI 聊天工具也能分析 CSV，为什么还需要 Lantide Data？
一般聊天通常交付一次性的答案；Lantide Data 把分析沉淀成可审阅的 Plan、可核对的 SQL 证据、完整执行步骤、Report、Source Run 与数据血缘。之后仍能回顾指标口径、理解依赖并接续分析。
→ 为什么分析结论不能停在聊天里已经在用 Claude Code／Codex，什么时候还需要 Lantide？
您不必更换常用的 Agent 界面。当分析需要审阅正式 Plan 与证据、调整指标口径、追查旧数字、依血缘重跑或交接给别人时，可让 Claude Code／Codex 通过 MCP Server 使用 Lantide，并把 Plan、Report、SQL 证据与操作记录留在可追溯的 Workspace。
→ 外部 AI Agent 与 MCP Server有些云端 AI 工具也能连 Google Drive 或外部数据库，Lantide Data 差在哪？
核心差别是分析 Workspace 与执行边界。Lantide Data 采用本地优先架构，通过 DuckDB 在您的设备上读取、查询与缓存数据，并把 Plan、SQL 证据、Report 与血缘留在同一 Workspace。AI 功能发送到模型端点的内容则取决于您选择的功能与设置。
→ Lantide 在数据架构里的位置Lantide Data 的 Harness 包含哪些机制？
Lantide Data 的 Harness 包含状态机、领域工具、Context 工程、IDE 集成与本地数据平面。这些机制共同限制 AI 何时能起草、查询、执行与交付，让分析不只是一次回答，而是可审阅、可重跑、可交付的工作流程。
→ AI 助手外部 Agent 与 MCP
MCP Server 和 MCP Sources 有什么不同？
两者方向相反。MCP Server 让 Claude Code、Codex 等外部 Agent 连入 Lantide，使用本地分析环境并留下可审阅成果；MCP Sources 则是 Lantide 连接外部数据或 API，将结果物化为可查询的表。
→ 让外部 AI Agent 安全连入 Lantide没有 LLM API Key，也能使用 Claude Code／Codex 操作 Lantide 吗？
可以走外部 Agent + MCP Server 路径，不需要在 Lantide 另外设置 LLM API Key；外部 Agent 本身仍按其订阅方案与 MCP 支持条件运行。若使用 Lantide 内建 Agent，则仍需设置自己的 LLM API Key 或其他可用模型端点。
→ 外部 AI Agent 与 MCP Server外部 Agent 可以读取其他 Workspace 吗？
可以，但只能读取另一 Workspace 的只读安全快照，包括 Plan、Report、Reference、HTML 成果、External Delivery 指向信息与血缘。它不会对另一 Workspace 发起实时查询或写入；当前绑定的 Workspace 仍是唯一可写 Workspace。
→ 跨 Workspace 安全读取Skills
Lantide 支持 Skills 吗？Skill 会增加 Agent 权限吗？
支持。您可以从 Skill Library 导入方法论，以「/」在内建对话中显式加载，也可选择 Share with external agents。Skill 只提供做事方法，不是工具授权；它不会提高 MCP access mode，也不能绕过 Plan 确认或审计。
→ Skills（Skill Library）工作流
Plan → Approve → Execute 和口头叫 AI 先写计划有何不同？
一般聊天工具多半只是提示词约束。Lantide Data 则把流程做成产品层级的工程边界：Plan 阶段 AI 只能协助起草，只有人类能按正式 Execute；执行当下的 Plan 会被锁定留存，方便审阅与追溯。
→ Plan → 批注 → Execute → ReportQuick 和 Project 差别？
Quick Analysis 适合临时查询与轻量 SQL 问答；Project Analysis 适合需要 Plan、批注、Execute 与 Report 的正式分析。您可以按问题复杂度选择，不必一开始就进入完整项目流程。
→ Quick Analysis 与 Project Analysis数据更新后，可以按正确顺序重跑分析吗？
可以。Lantide Data 会记录分析步骤之间的数据血缘与 DAG 依赖；数据或查询更新后，Source Run 可按依赖顺序重新执行中间缓存与下游结果。系统负责可重跑的执行路径，最终指标口径与结果仍由用户审阅。
→ 缓存与 Source Run接手离职同事留下的一堆 Skills、Markdown、HTML 与 SQL，连 AI Agent 都很难理清时，Lantide 有什么不同？
一般环境里的项目上下文常散落在聊天记录、Skills、Markdown、HTML、Notebook 与不同版本的 SQL 中。Lantide 按项目保存 Plan、Report、SQL 证据、完整执行步骤、Source Run 血缘与操作记录，让人直接查看、Agent 按需读取。若上游原始数据已删除或覆盖，除非保留了当时的数据或包含数据的 Workspace 包，否则不能保证复现完全相同的结果。
→ .lantide 导出、导入与重新绑定分析结果可以怎么分享给主管或客户？
正式分析会产出 Report，保留方法、发现、证据与建议。您也可以生成独立 HTML 报告，用浏览器展示、输出为 PDF，或分享给非技术利害关系人，减少复制贴上与重新排版。
→ 把 Report 变成 HTML 报告：周会分享与微调可以回到已经导入过的 Workspace bundle 吗？
可以，前提是该 bundle 与本地工作区的 snapshot 相同。选择 Restore …from this bundle 后，共享内容与分析历史会回到 bundle 所带的状态，版本不变。还原前状态会成为唯一一份 recovery，可用 Restore Previous Version 取回你的修改。系统不会自动选择还原，且只还原 bundle 内已打包的实体文件，未打包的外部文件不受影响。
→ Workspace 导入与还原记忆
Knowledge 会不会自动成为团队口径？
不会。AI 从对话中整理出的候选规则会先进入 Queued Knowledge，必须由用户明确确认后，才会成为可用的 Knowledge 并用于后续 Agent 上下文。
→ Agent Memory 与 Plan 别搞混可以关闭记忆吗？
可以。Agent Memory 有总开关，可按项目或合规需求完全关闭。关闭后，AI 不会把新知识写入或用于上下文，适合敏感数据或高度受控的分析场景。
→ Agent Memory（Knowledge）技术
支持哪些数据格式？
Lantide Data 支持 CSV、Excel、Parquet 等本地文件，并以 DuckDB 作为统一查询层。常见数据可以直接放进 Workspace，快速映射成可查询数据表。
→ 欢迎使用 Lantide Data数据一定要下载成文件吗？可以使用公司数据库或外部数据服务吗？
不一定。PostgreSQL、MySQL、SQLite 等可通过 DuckDB ATTACH 查询，MCP Sources 可将外部数据与 API 结果物化为本地表。SQL Server 与 Azure SQL 采用 staged 模式：每次远程查询只能读取单一远程来源，需先物化到本地，再与其他来源 JOIN；不支持透明的跨来源单条语句 JOIN。
→ 数据浏览器与数据来源本地优先的情况下，AI 是怎么运行的？
数据查询与计算会在本地 Workspace 由 DuckDB 执行。使用 AI 功能时，提示词、对话内容、数据结构、字段信息或其他必要上下文可能直接发送至您设置的模型端点；实际范围取决于您选择的功能与设置。
→ AI 助手AI 助手会不会改坏或删除我的 Excel、CSV 或数据库？
SELECT-only 守卫不允许 AI 修改、删除或覆盖原始文件和数据库。它可以读取数据并建立计算缓存；在 Execute 或 Admin 模式及相应人工确认下，也可以创建或修改 Plan、Report 等工作区成果。
→ 备份、安全边界与常见问题0.3.4 的 Workspace 包默认包含什么？
Workspace 包默认包含本地数据文件夹中的文件、MCP cache 与 Agent query ledger，并使用 Balanced 压缩。只有去重后的实体数据严格超过 200 MiB 时才要求绑定摘要的额外确认。远程数据库和 Cloud Folder 内容、凭据不会被自动打包。Full backup 的默认选项不同，实体数据与 MCP cache 仍需逐项选择。
→ Workspace 包与 Full backupExternal Delivery 会上传或管理外部报告吗？
不会。External Delivery 只保存 Report 指向 P4、KM、URL 或其他外部位置的指向信息，便于复制、编辑或解除关联；Lantide 不会因此上传、读取、验证或删除外部内容，也不会获得外部服务的访问权限。
→ External Delivery 边界Plan 的执行记录会因对话太长而缺失吗？
0.3.4 会将完整 Plan-local steps 保存为执行快照，不再受对话账本最近 50 步的上下文窗口限制。旧版本已经生成的快照可能不完整，应用会在这种情况下提示。
→ Plan 执行与 Report需要联网吗？
本地查询不需要联网，数据处理会在您的 Workspace 中完成。AI 功能可调用您配置的 LLM API；企业也可使用自部署端点，或搭配 Ollama 实现不出外网的使用模式。
→ AI 助手什么是「自带密钥（BYOK）」？
BYOK 是为 Lantide 内建 Agent 设置自己的 LLM API Key，让您自行控制模型与用量成本。若改用 Claude Code、Codex 等外部 Agent 通过 MCP Server 操作 Lantide，则不需要在 Lantide 另设 LLM API Key；外部服务本身的方案仍各自适用。
→ AI 助手下载
现在支持哪些操作系统？
目前支持 macOS 12+ 与 Windows 10+。Windows 版从 0.3.1 更新到 0.3.2 时可能还会最后一次显示安装向导；之后将采用静默重启安装，UAC 或 SmartScreen 提示仍可能出现。
→ 安装与设置下载后要怎么开始？
下载并安装后，先建立或选择本地数据 Workspace，放入 CSV、Excel 或 Parquet 文件，再按 Quick Start 执行第一个分析。建议先用小型数据集熟悉 Plan → Execute 流程。
→ 快速开始自动更新如何运作？
App 约每 24 小时检查一次，提供 Update and restart、Skip this version、Later。Skip 只抑制该版本，Later 于 24 小时后再提示；Help → Check for Updates 随时可用，也能看到明确标示的 Preview 版本。重启前会检查主窗口与 compare 的未保存内容，默认返回 App。Preview 是公开的手动通道，不是内部账号试用。
→ 更新