常見問題
產品定位
什麼是分析資產？
分析資產是可以被查證、重跑、修改與交接的完整分析脈絡。它不只包含最後的 Report，也包含資料來源、指標定義、Plan、SQL 證據、驗證步驟、血緣與活動紀錄。
→ Lantide Data 是什麼？換另一個 Agent 如何接續分析？
Agent 先讀工作區分析脈絡索引，再依導航查文件與歷史，之後以相同範圍的 cursor 增量讀取。相同連線設定可用私有 owner key 跨對話或工作區接續，保留有效 Plan 核准。key 是私有憑證，交出後不會自動停止原 Agent，請先協調停手。
→ 閱讀指南本機資料改名或搬移後怎麼辦？
先重新整理 Data 檢查來源位置。支援的本機追蹤可嘗試恢復能辨識的同 volume 搬移，無法判定時用 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 evidence、Report、Source Run 與資料血緣。資料與查詢留在本機工作區，之後仍能回顧指標定義、理解依賴並接續分析。
→ 為什麼分析結論不能停在聊天裡已經在用 Claude Code／Codex，什麼時候還需要 Lantide？
您不必更換慣用的 Agent 介面。當分析需要審閱正式 Plan 與證據、調整指標定義、追查舊數字、依血緣重跑或交接給別人時，可讓 Claude Code／Codex 透過 MCP Server 使用 Lantide，並把 Plan、Report、SQL evidence 與活動紀錄留在可追溯的工作區。
→ 外部 AI Agent 與 MCP Server有些雲端 AI 工具也能連 Google Drive 或外部資料庫，Lantide Data 差在哪？
核心差別是分析工作區與執行邊界。Lantide Data 採用本機優先架構，透過 DuckDB 在您的裝置上讀取、查詢與快取資料，並把 Plan、SQL 證據、Report 與血緣留在同一工作區。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 ServerSkills
Lantide 支援 Skills 嗎？Skill 會增加 Agent 權限嗎？
支援。您可以從 Skill Library 匯入方法論，以「/」在內建對話中顯式載入，也可選擇 Share with external agents。Skill 只提供做事方法，不是工具授權；它不會提高 MCP access mode，也不能繞過 Plan 審批或 audit。
→ 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 可依依賴順序重新執行中介快取與下游結果。Plan-local steps 會完整保存，不受對話活動紀錄視窗裁切；最終指標定義與結果仍由人審閱。
→ 快取與 Source Run 要懂到哪接手離職同事留下的一堆 Skills、Markdown、HTML 與 SQL，連 AI Agent 都很難理清時，Lantide 有什麼不同？
Lantide 把 Plan、Report、SQL evidence、Source Run 血緣與活動紀錄依專案結構保存，並可用 Workspace 套件交接整個工作環境。Project 匯出帶分析脈絡與工作區成果，但不含原始資料檔；Workspace 匯出則預設包含本機資料夾檔案。若原始資料、遠端來源或必要憑證已無法取得，即使成果仍可查證，也無法保證重現完全相同的數字。
→ .lantide 匯出、匯入與重新綁定Workspace 套件預設會包含什麼？
Workspace Export 預設包含初始資料夾與 Additional folders 的本機檔案、MCP cache 及 Agent query ledger，並使用 Balanced 壓縮。去重後 physical data 嚴格大於 200 MiB 時才要求額外確認。Cloud Folder／資料庫遠端內容、可復原密碼、User Knowledge 與全域設定不在套件內；Full backup 的 physical data 與 MCP cache 則預設不包含，須逐項選擇。
→ .lantide 匯出、匯入與重新綁定External Delivery 會把 Report 上傳到外部系統嗎？
不會。External Delivery 是由 Report 擁有的指向資訊，可記錄 P4、KM、URL 或其他外部交付位置。Lantide 不會因此取得供應商存取權，也不會自動上傳、抓取或驗證內容；Unlink 只移除指向資訊，不會刪除外部成果。
→ External Delivery 回綁Agent 可以讀取另一個 Workspace 嗎？
可以，但僅限逐次讀取安全快照中的 Plan、Report、Reference、HTML、External Delivery 指向資訊與 evidence lineage。它不會切換目前的 writer Workspace，也不能對另一個 Workspace 執行即時查詢、讀取 schema／source 或寫入；多次讀取也不保證屬於同一個交易快照。
→ 讓外部 AI Agent 安全連入 Lantide分析結果可以怎麼分享給主管或客戶？
正式分析會產出 Report，保留方法、發現、證據與建議。您可以生成獨立 HTML 報告，在瀏覽器展示或匯出；也能以 External Delivery 保存外部交付位置的指向資訊，而不把外部內容同步進 Lantide。
→ 把 Report 變成 HTML 報告：週會分享與微調可以回到已經匯入過的 Workspace bundle 嗎？
可以，前提是該 bundle 與本機工作區的 snapshot 相同。選擇 Restore …from this bundle 後，共享內容與分析歷史會回到 bundle 所帶的狀態，版號不變。還原前狀態會成為唯一一份 recovery，可用 Restore Previous Version 取回你的修改。系統不會自動選取還原，且只還原 bundle 內已打包的實體檔，未打包的外部檔案不受影響。
→ Workspace 匯入與還原記憶
Knowledge 會不會未經同意就影響 Agent？
不會。AI 從對話整理或主動提案的新規則會先進入 Queued Knowledge，只有使用者 Apply 後才會寫入 User 或 Project Knowledge，並在後續對話中注入。待核准項目不會改變 Agent 行為。
→ Agent Memory 與 Plan 別搞混可以關閉記憶嗎？
可以。Agent Memory 有總開關，可依專案或合規需求完全關閉。關閉後，AI 不會把新知識寫入或注入上下文，適合敏感資料或高度受控的分析場景。
→ Agent Memory（知識庫）技術
支援哪些資料格式？
Lantide Data 支援 CSV、Excel、Parquet 等本機檔案，並以 DuckDB 作為統一查詢層。常見資料可以直接放進工作區，快速映射成可查詢資料表。
→ 歡迎使用 Lantide Data資料一定要下載成檔案嗎？可以使用公司資料庫或外部資料服務嗎？
不一定。CSV、Excel、Parquet 可直接在本機查詢；PostgreSQL、MySQL、SQLite 可透過 DuckDB ATTACH；MCP Sources 可物化外部結果。SQL Server／Azure SQL 採 staged 路徑：先在遠端篩選或聚合並物化為本機 cache，再與其他來源 JOIN，不支援單一 statement 的透明跨來源 JOIN。
→ 資料瀏覽器與資料來源本機優先的情況下，AI 是怎麼運作的？
資料查詢與運算會在本機工作區由 DuckDB 執行。使用 AI 功能時，提示詞、對話內容、資料結構、欄位資訊或其他必要脈絡可能直接傳送至您設定的模型端點；實際範圍取決於您選擇的功能與設定。
→ AI 助手AI 助手會不會改壞或刪除我的 Excel、CSV 或資料庫？
Lantide Data 的唯讀守衛會阻止 Agent 修改、刪除或覆蓋原始資料檔案與來源資料庫。這不代表整個 Workspace 都唯讀：依連線模式與核准，Agent 仍可建立快取，以及新增或修改 SQL 分頁、Plan、Report 等工作區成果。
→ 備份、安全邊界與常見問題什麼是「自備金鑰（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 也可能顯示。
→ 安裝與設定下載後要怎麼開始？
下載並安裝後，先建立或選擇本機資料工作區，放入 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 是公開的手動通道，不是內部帳號試用。
→ 更新