阅读指南
这是一套围绕 Cube Core 展开的中文教程站。
教程定位
本教程的核心目标不是“把官网逐页翻译成中文”，而是：
- 帮中国读者快速建立 正确的产品心智模型；
- 解释 Cube 在 AI + BI + Embedded Analytics 场景里的真实位置；
- 给出一套适合中文读者的 学习路径、写作结构和实战骨架；
- 最终形成可以长期维护、持续扩展的文档站，而不是一次性的长文。
适合谁看
1. 数据工程 / 分析工程团队
如果你在负责语义层、指标平台、指标治理、埋点数据消费或数据产品建设，这套教程会很适合你。
2. BI 平台 / 数据应用开发者
如果你希望通过 API-first 的方式给前端应用、客户门户、内部系统提供分析能力，Cube 是一个高相关技术选项。
3. 智能问数 / Data Agent 团队
如果你已经发现“Text2SQL 单独用不稳”，需要一个受治理的数据接口层，这套教程也很适合你。
这套教程的写法约定
每篇文档尽量遵循同一结构：
- 这篇要解决什么问题；
- 先讲核心概念；
- 再给最小可运行示例；
- 补充生产建议；
- 最后列出常见误区与延伸阅读。
先记住三个总原则
原则 1：Cube 不是 BI 前端
Cube Core 是 headless semantic layer，它本身不提供完整 BI 前端。
原则 2：Cube 不是“自动写 SQL 的 LLM 工具”
Cube 真正擅长的是 统一业务语义、编译查询、治理权限、加速分析查询。
原则 3：Cube 最适合 SQL 分析型数据源
Cube 官方文档明确指出，它主要面向 可以用 SQL 查询的数据源，不是直接抓 REST / GraphQL API 的工具。