概述
te-meta 是 te-cli 中用于查询 ThinkingEngine 平台元数据的技能域，主要帮助使用者在分析前了解项目中有哪些事件、属性、实体、指标以及可查询的 SQL 表结构。它覆盖以下核心元数据对象：
| 对象 | 命令 | 说明 |
|---|---|---|
| 事件目录 | +list-events | 获取项目的完整事件列表 |
| 事件属性 | +load-event-props | 加载事件的可筛选属性 |
| 度量属性 | +load-measure-props | 加载事件的可度量属性 |
| 分析实体 | +list-entities | 获取分析实体列表 |
| 预定义指标 | +list-metrics | 获取预定义指标列表 |
| SQL 表 | +list-tables | 获取可查询的 SQL 表列表 |
| 表字段 | +get-table-columns | 获取指定表的字段定义 |
主要能力
- 查询项目内所有事件名称与事件清单。
- 按事件加载可筛选属性，用于后续分析查询的筛选条件准备。
- 按事件加载可度量属性，用于后续分析查询的度量准备。
- 查询分析实体列表。
- 查询预定义指标列表。
- 查询可用的 SQL 表列表，并进一步获取指定表的字段定义。
所有命令均为只读操作（risk: read），无需确认即可直接执行。
使用方式
前置条件：先阅读 ../te-shared/SKILL.md，了解认证、全局参数和输出格式。
1. 了解项目有哪些事件
te-cli meta +list-events --project-id 1
2. 为分析查询准备属性列表
先获取事件列表，再加载对应的可筛选 / 可度量属性：
加载筛选属性
te-cli meta +load-event-props -p 1 --events '[{"eventName":"login"}]'
加载度量属性
te-cli meta +load-measure-props -p 1 --events '[{"eventName":"login"}]'
3. 查询 SQL 表结构
先列出可用表，再获取目标表的字段定义：
te-cli meta +list-tables -p 1 te-cli meta +get-table-columns -p 1 --table "v_event_1"
4. 结合 jq 做字段提取
只输出事件名称
te-cli meta +list-events -p 1 --jq '.events[].eventName'
只输出指标名称和描述
te-cli meta +list-metrics -p 1 --jq '.metrics[] | {name, description}'
适用场景
- 在编写分析查询前，先探查项目的事件、属性、实体与指标范围。
- 需要了解可查询 SQL 表及其字段结构时。
- 配合 jq 对元数据结果进行字段提取与筛选，快速获得名称、描述等关键信息。
限制
所有命令均为只读操作。详细命令参数说明见 references/ 目录中的 +list-events、+load-event-props、+load-measure-props、+list-entities、+list-metrics、+list-tables、+get-table-columns。