用途：通过 Omni CLI 自上而下探索 Omni 语义模型，先了解存在什么，再构建、查询或修改。建议从 Shared 模型入手，它包含经过整理的 analytics 层。
前置与认证：需先安装并配置 Omni CLI（omni config show、omni config use <profile-name>、omni whoami）。配置用 API key 或 OAuth；若返回 401，请用户在本地交互机器运行 omni config login <profile>，不要在无浏览器的 headless/CI 中自行运行。
主要能力：omni models list（可用 --model-kind SHARED --name 精确解析共享模型，--include activeBranches 查看分支）；omni models list-topics <modelId>；omni models get-topic <modelId> <topicName> 获取视图、维度、度量、关系、默认筛选与 AI 上下文；omni models yaml-get <modelId> 读取完整模型 YAML，支持 --file-name 正则、--branch-id、--include-schemas。
使用方式：先用 omni models --help 或 <operation> --help 查命令，用 -o json 或 -o human 控制输出。yaml-get 的 files 以完整路径为键（如 MARTS/order_items.view），编辑时须复用该键，否则会创建重复文件。字段命名 view_name.field_name，日期粒度用 orders.created_at[week]。
模型架构：Schema Model（从数据库自动生成、只读）、Shared Model（分析工程师定制）、Workbook Model（按仪表盘临时定制）；探索时用 combined 视图看全部。
适用场景：查询“有哪些数据”“表如何关联”“有哪些度量”；检查 AI 上下文（ai_context、sample_queries、ai_fields）；字段迁移前的影响面分析（create-branch、yaml-create、validate、content-validator-get，必要时 --force-full-validation true）。
限制：计算字段用 calc_name / sql_expression，而非 name / sql。--include-schemas 每次只接受一个 schema。composite topic 没有 base_view_name。大型内容上 validator 可能仅检查引用而不规划查询。若预期视图缺失，可先 get-schemas 再用 --include-schemas 加载。定价、收费与平台支持等信息暂未提供。