项目配置

用版本控制管理项目契约

marivo.toml 是可选文件。缺少时，项目名使用项目根目录名，semantic.layer_paths 为空，并启用 本地遥测。缺少表或字段时也使用这些默认值；已有但 TOML 非法或显式字段非法的配置会严格失败。 项目配置中没有 version 字段。

如需加载由其他仓库维护的语义层包，请在 marivo.toml 的 [semantic].layer_paths 中加入各自已编写的 models/ 目录：

[semantic]
layer_paths = [
  "../sales-domain/models",
  "/opt/company/finance-domain/models",
]

Marivo 始终先加载当前项目的 models/ 目录，再按声明顺序加载各个语义层根目录。 相对路径以 marivo.toml 所在目录为基准，绝对路径按原样使用。每个外部语义层根目录都必须 同时包含 datasources/ 和 semantic/。

所有已配置根目录中的数据源名称、领域名称和语义 ID 必须全局唯一；出现重复时， 语义层无法加载。marivo doctor、语义层预览、验证和分析会话都会通过这些已配置的根目录解析 语义对象及其数据源。

需要让配置或声明随项目流转时，请将 marivo.toml 和 models/ 纳入版本控制；将 .marivo/ 加入 .gitignore，其中保存的是本地会话、证据、遥测和缓存元数据，而不是可共享的声明。