参考来源与核对说明

本教程的内容以官方文档与官方代码仓库为主，以下信息已在 2026-05-22 核对。

官方仓库

Cube GitHub README
https://github.com/cube-js/cube

官方文档

产品与入门

Introduction
https://cube.dev/docs/product/introduction
Getting started with data modeling
https://cube.dev/docs/product/data-modeling/overview
Concepts
https://cube.dev/docs/product/data-modeling/concepts

数据源与建模

Connecting to data sources
https://cube.dev/docs/product/configuration/data-sources
Cubes reference
https://cube.dev/docs/product/data-modeling/reference/cube
Measures reference
https://cube.dev/docs/product/data-modeling/reference/measures
Pre-aggregations reference
https://cube.dev/docs/product/data-modeling/reference/pre-aggregations

API

缓存、权限、部署

Using pre-aggregations
https://cube.dev/docs/product/caching/using-pre-aggregations
Refreshing pre-aggregations
https://cube.dev/docs/product/caching/refreshing-pre-aggregations
Row-level security
https://cube.dev/docs/product/auth/row-level-security
Deployment overview
https://cube.dev/docs/product/administration/deployment
Multitenancy
https://cube.dev/docs/product/configuration/multitenancy

代码结构核对

上游仓库目录结构（核对日期：2026-05-22）显示：

packages/ 下包含 cubejs-server-core、cubejs-schema-compiler、cubejs-query-orchestrator 与各类 drivers；
rust/ 下包含 cubestore、cubesql 等 Rust 组件；
examples/recipes/ 下包含 active users、role-based access、multiple data sources、non-additivity 等示例。

这些信息用于支撑本教程对 Cube 内部组成与扩展示例的描述。

官方 Blog（本教程精读专区使用）

The Future of Cube Core and Cube
https://cube.dev/blog/cube-core-and-cube
Deep dive: What the heck is the Semantic Layer
https://cube.dev/blog/what-the-heck-is-the-semantic-layer
Semantic Layer: The Backbone of AI-powered Data Experiences
https://cube.dev/blog/semantic-layer-the-backbone-of-ai-powered-data-experiences
Semantic Layer and AI: The Future of Data Querying with Natural Language
https://cube.dev/blog/semantic-layer-and-ai-the-future-of-data-querying-with-natural-language
Semantic Layers are the missing piece for AI-Enabled Analytics
https://cube.dev/blog/semantic-layers-the-missing-piece-for-ai-enabled-analytics
Introducing Cube Store
https://cube.dev/blog/introducing-cubestore
Query pushdown in Cube’s semantic layer
https://cube.dev/blog/query-push-down-in-cubes-semantic-layer
The Modern Data Stack for Embedded Analytics
https://cube.dev/blog/modern-embedded-analytics
Where should a semantic layer be built?
https://cube.dev/blog/where-should-a-semantic-layer-be-built
The Need for an Open Standard for the Semantic Layer
https://cube.dev/blog/the-need-for-an-open-standard-for-the-semantic-layer

官方 Recipes / Examples（本教程中文实战专区使用）

active-users
examples/recipes/active-users
role-based-access
examples/recipes/role-based-access
column-based-access
examples/recipes/column-based-access
mandatory-filters
examples/recipes/mandatory-filters
multiple-data-sources
examples/recipes/multiple-data-sources
non-additivity
examples/recipes/non-additivity
refreshing-select-partitions
examples/recipes/refreshing-select-partitions
using-different-schemas-for-tenants
examples/recipes/using-different-schemas-for-tenants

站点发布参考

GitHub Pages custom workflows
https://docs.github.com/en/pages/getting-started-with-github-pages/using-custom-workflows-with-github-pages
VitePress deploy guide
https://vitepress.dev/guide/deploy
MkDocs deploy guide（用于对比）
https://www.mkdocs.org/user-guide/deploying-your-docs/