Learn 版本： 0.3.0（2026-09-02）· 對齊 USER_GUIDE 0.3.0 定位： 試用轉化與 onboarding 入口——依角色說明 Lantide Data 是什麼、對你意味著什麼，並規劃入門 → 實踐 → 進階閱讀路徑。設計 rationale 見 0. 系列導讀與產品定位，按鈕與步驟見 USER_GUIDE。Release 變更見 /changelog（獨立層，不屬 Learn）。
從你的角色開始
| 角色 | 引言（完整正文） | 讀完後 |
|---|---|---|
| 分析師 | 分析師引言 | 跟做 USER_GUIDE §2 |
| 產品經理 / 決策者 | 產品經理引言 | 請分析師 demo 或自行掃 §2 |
| 業務 / 運營 | 業務與運營引言 | 請分析師分享專案：批註 Plan + 讀 Report |
| 平台啟用（數據工程） | 平台啟用（數據工程）引言 | 跟做測試連線 + Workspace .lantide 演練 |
每篇引言包含：場景痛點、Lantide 對該角色的意義、建議閱讀路徑表、試用檢查清單。0.3.0 含四角色共 37 篇正文（另有本 Hub）。Harness 貢獻者 onboarding 見 系列閱讀地圖 §六（不在 Learn 範圍內）。
App 內 Help 預設進 文件導覽 Hub，側欄分 Learning Center / User Guide / Product Design 三層。
閱讀路徑總覽
分析師（10 篇 + 跟做）
| 階段 | 文章 |
|---|---|
| 引言 | introduction |
| 入門 | 為什麼分析結論不能停在聊天裡 · Quick vs Project |
| 實踐 | Plan → Execute → Report · SQL-first · 快取與 Source Run · 用 @ 精確指向資料與分析產物 |
| 進階 | 統計分析工具 · Reference docs · Memory 分工 · Skills |
產品經理（8 篇 + 跟做）
| 階段 | 文章 |
|---|---|
| 引言 | introduction |
| 入門 | 誰該用 · vs Chat / BI |
| 實踐 | 跨角色協作 · 品質底線 · Memory 治理 |
| 進階 | 試點與推廣 · 電梯簡報 |
業務與運營（9 篇 + 跟做）
| 階段 | 文章 |
|---|---|
| 引言 | introduction |
| 入門 | 為什麼要在 Plan 上簽名 · Quick 與正式數字 |
| 實踐 | 怎麼審 Plan · 怎麼驗收 Report · Report 轉 HTML · 批註 Plan |
| 進階 | 與 BI / 週會分工 · 常見反模式 |
平台啟用（數據工程）（9 篇 + 跟做）
| 階段 | 文章 |
|---|---|
| 引言 | introduction |
| 入門 | Lantide 在資料架構裡的位置 · 與分析師分工 |
| 實踐 | 資料源與連線 · 工作區與資料目錄 · .lantide 匯出匯入 |
| 進階 | 外部 Agent Integration · MCP Sources 入門 · 備份與常見問題 |
0.3.0 內容範圍
| 類型 | 數量 | 說明 |
|---|---|---|
| 角色引言 | 4 篇 | 分析師、PM、業務與運營、平台啟用（數據工程） |
| 路徑文章 | 33 篇（分析師 10 + PM 7 + 業務與運營 8 + 平台啟用 8） | 正文已完成 |
| Hub | 本 README | |
| assets | 截圖占位規格 |
0.3.0 不含： 英文版、截圖與 onboarding 影片、Harness 貢獻者 Learn 路徑（見系列文章 0–5）。App 內 Docs 見 /docs/learn（學習中心 37 篇 + 使用者指南 + 產品設計理念）。
內容憲法（SSOT）
規則： Learn 可比喻、可場景化；行為與數字以 USER_GUIDE 為準；設計取捨以系列文章 0–5 為準。Learn 不重複 USER_GUIDE 逐步操作。 讀者假設： 試用 onboarding 正文以「第一次聽見 Lantide」為前提；維護表與 skill 供貢獻者使用，不搬進引言。
撰寫準則（摘要）
| 寫 | 不寫 |
|---|---|
| 現在式產品事實、角色場景 | Phase 編號、release gate 演進、「我們以前…現在…」 |
| 使用者可感知的行為與價值 | hard/soft signal、未解釋的 Harness 分層 |
| 選讀連結系列文章 / USER_GUIDE | 內部報告、測試目錄細節（留 contributing） |
完整條文：.cursor/rules/learn.mdc
SSOT 對照表
| 主題 | Learn（本目錄） | 系列文章 0–5 | USER_GUIDE | releases/ |
|---|---|---|---|---|
| 品類 / 競品 / Harness | PM 引言 · vs-chat-and-bi | 0 §一 權威 | — | — |
| Quick vs Project | 分析師 · business-ops quick-vs-formal | 1 §二 | §1.2 · §12.5 | 功能變更時列點 |
| Plan / Report / Execute | 分析師 · PM · business-ops 路徑（含草案後短問答對齊口徑、Stop & Replan） | 1 §四–§八 | §11 · §2.5–2.7 · §12.7 | 0.3.0 |
| 業務審 Plan / 驗 Report | business-ops 路徑 | 1 §六（選讀） | §2.5–2.7 · §11.7 | — |
| HTML Report 週會交付 | business-ops/report-to-html-report（含加刪區塊／標註） | 1（選讀） | §10 · §10.5.1–10.5.3 | 0.3.0 Custom Script、Quick Edit 與隔離預覽 |
| Built-in Agent ↔ Ask | 分析師引言 · plan-execute；平台勿與 Observe 混淆 | 3 §3.1 | §12.1.1 · §18 FAQ | 0.3.0 |
| Setup Mode / 首次啟動 | platform-admin external-agent-integration | 0 選讀 | §2.1 · §15.3.1 | — |
| Secondary model | — | 3–4 選讀 | §12.3 | — |
| SQL Server preflight / ODBC staged | platform-admin database-connections · analyst sql-first | 5 §9 | §4.5 · §12.6 | — |
| 連線 impact / 資料夾變更確認 | platform-admin database-connections · workspace-and-data-folder | — | §3.2 · §4.5 | — |
| 批註協作（sidecar / 生命週期） | plan-execute-report · annotate · accept-report | 1 §六 · 2 §十一 | §11.7–11.9 · §11.10.3 | 0.3.0 |
| Compare view | analyst plan-execute · business-ops accept-report | 1 §六 | §11.10 | 0.3.0：批註唯讀、SQL 主題與可拖曳分割 |
| Reference docs | analyst/reference-docs-for-analysts | 1 §四（選讀） | §11.3.1 | 0.3.0：本機匯入、資產、Copy image 與原生建立 |
| Persist SQL tab metadata | analyst sql-first · plan-execute | 1 §三 | §5.6 | 0.3.0：list_sql_tab／Metadata、側欄專案分組、Archive 與 Focus 組 |
| SQL-first | sql-first-workflow | 1 §三 | §5 · §12 | — |
| Skills / Skill Library | analyst/skills-for-analysts | — | §14 | 0.3.0 Agent preview／確認建立 |
| 知識 / Queued Knowledge | analyst/pm memory 路徑 | 2 全文 | §15 | — |
| persist vs agent 快取 | cache-and-source-run | 5 §八 · 0 附錄 | §7 FAQ | — |
| 連線 / 工作區 / MCP | platform-admin 路徑（含 All data sources、跨工作區來源匯入、Agent 控制） | 5（選讀） | §3–4 · §4.5–4.6 | 0.3.0 資料來源全面開放、MCP Source 統一控制 |
| 外部 Agent scope / mode / Activity / Undo | platform-admin external-agent-integration；四角色入口（含選定工作區預設切 GUI） | — | §13 · §13.9 | 0.3.0 固定 session catalog、capability search／invoker、All-workspaces 單線與審批 handoff |
.lantide 遷移 / export 選型 / physical data |
PM team-collaboration · analyst plan-execute · platform-admin lantide-export · backup | 0 選讀 | §11.1.0–11.1.4 | 0.3.0：可選加密與 physical data |
| Agent runtime / 查詢層 | — | 3–5 | §12.11 | — |
| Prompt / ReAct / QEM | — | 3–4 | §12.11 | — |
| 版本更新說明 | 不寫 | — | §20 | releases/X.Y.Z.md 權威 |
維護： 功能迭代後，在撰寫 /changelog 之前依 .cursor/skills/learn-docs-sync 檢查 Learn 是否過期。
目錄結構
Docs/Learn/
├── README.md ← 本 Hub
├── roles/
│ ├── analyst/
│ ├── product-manager/
│ ├── business-ops/
│ └── platform-admin/
└── assets/
建議試用路徑（Day 0）
- 選角色，讀對應引言（約 8 分鐘）
- 依角色讀入門 2 篇
- 分析師 / PM： 跟做 USER_GUIDE §2 業務與運營： 請分析師分享專案，試批註 Plan 平台啟用（數據工程）： 測試連線 + Workspace 匯出匯入演練
- 需要設計深度時，依引言「設計深度（選讀）」進 Articles_v2
0.3.0 驗收清單（維護用）
- 0.3.0：Electron 整包 updater、Custom Script HTML 報告、統一 MCP Source 控制、跨工作區來源匯入、外部 MCP capability search／read-write invoker 與固定 session catalog
- 0.3.0：Stop & Replan／Analysis Lineage、Plan／Report 品質 receipt、Reference 原生建立、Skill preview、Codex 一鍵配對、資料來源全面開放、MCP Source 統一控制／跨工作區匯入、HTML Custom Script，以及標準 Electron 整包更新
- Cloud folder
degraded、ODBC staged 敘事（platform-admin + analyst） - 分析師 10 篇路徑（含 Reference docs、Skills、物件提及）
- platform-admin 與 USER_GUIDE 對齊 physical data / Rebind 五步·六步
- 0.3.0：批註協作、View changes／Archive 與錨點失效處理
- 外部 Agent 專文：雙軌 onboarding、scope / mode、Activity、Undo、保存與 recovery
- 四角色入口與 Agent Integration / MCP Sources 分流
- Hub SSOT 表、37 篇計數、Docs Hub 三層說明
- App 內 Docs 整合（
/docs/learn導覽 + 學習中心四角色側欄）
建議試用路徑（Day 0）
- 選角色，讀對應引言（約 8 分鐘）
- 依角色讀入門 2 篇
- 分析師 / PM： 跟做 USER_GUIDE §2 業務與運營： 請分析師分享專案，試批註 Plan 平台啟用（數據工程）： 測試連線 + Workspace 匯出匯入演練
- 需要設計深度時，依引言「設計深度（選讀）」進 Articles_v2