用途：作为 Domo 应用平台数据访问的高层入口技能，采用 toolkit/查询优先的规则，把详细查询工作路由到 cap-apps-dataset-query。旧的 endpoint 优先指引已归档到 archive/legacy-rules/domo-data-api.md。
主要能力：在应用中使用 @domoinc/query 进行数据集读取，支持 select、groupBy、orderBy 和 fetch 等链式查询；SQL 仅作为例外情况使用。
使用方式：安装依赖使用 yarn add @domoinc/query，示例中通过 new Query().select(['region','Sales_Amount']).groupBy('region',{Sales_Amount:'sum'}).orderBy('Sales_Amount','descending').fetch('sales') 查询。若必须使用 SQL，可通过 @domoinc/toolkit 的 SqlClient 调用 sqlClient.get，读取 result.body.rows；需注意 SQL 不会自动遵循仪表板页面筛选器。每个数据集必须在 manifest.json 的 datasetsMapping 中声明，且 fields 字段必须存在，可为空数组 []，否则会引发 manifest 解析错误。本地开发使用 @domoinc/ryuu-proxy 进行本地 API 路由，并通过 domo login 认证。规范参考见 .cursor/rules/03-query.mdc、10-performance-optimization.mdc、09-gotchas.mdc。检查清单：datasetsMapping 别名配置有效；查询默认用 Query 而非原始 /data/v1；聚合使用真实数据集字段名；不使用 .aggregate()。本次资料未提供更多收费、平台或效果信息。