☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在trae中编写数据口径文档必须显式声明平台与人群限定条件，首段需用完整句子说明“本口径仅适用于【平台】上的【人群】”，并在yaml frontmatter或注释标签中嵌入platform和audience元信息，最后在sql where子句前端绑定对应过滤逻辑。
在trae中编写数据口径文档时，必须明确限定适用平台（如ios、android、web）和人群（如新用户、付费用户、vip等级3以上），否则下游取数结果会因范围泛化而失真。平台和人群限制不是可选补充项，而是口径定义的必要组成部分，缺失会导致指标无法被准确复用。
在口径定义开头显式声明平台与人群
第一步：在文档首段「定义」或「口径说明」标题下，用独立句子写出平台和人群限定条件，格式为“本口径仅适用于【平台】上的【人群】”。
例如：“本口径仅适用于Android端注册满7天且完成首次充值的用户。”
这一步不可省略，也不能藏在备注或括号里——Trae解析器不识别非主干句中的限定信息，【平台和人群必须出现在首段主谓宾完整的陈述句中】。
使用Trae内置标签语法嵌入元信息
方法一：在文档YAML frontmatter中添加platform和audience字段
在文档最上方用---包裹YAML块，写入：
platform: ["iOS", "Android"]
audience: "user_type IN ('paying', 'vip_level >= 3')"
注意：platform值必须是字符串数组，单平台也要写成["Web"]；audience值必须是可直接用于SQL WHERE子句的表达式，不能写自然语言描述。
方法二：在正文任意位置插入Trae识别的注释标签
在需要强调的位置添加一行：// @platform: iOS, Web // @audience: is_new_user = 0 AND region = 'CN'
Trae会自动提取该行中@platform和@audience后的值，但要求两者必须在同一行，且中间用两个空格分隔。
在指标计算逻辑中绑定平台与人群过滤条件
① 找到指标公式所在段落（通常标记为「计算逻辑」或「SQL实现」）。
② 在WHERE子句最前端插入平台维度过滤，例如：WHERE app_platform IN ('iOS', 'Android') AND ...
③ 紧接着追加人群判定逻辑，例如：AND user_id IN (SELECT user_id FROM dim_user WHERE is_paying = 1 AND first_pay_date
这一步的关键是：平台和人群过滤必须作为WHERE的前置硬条件，不能放在子查询里或用LEFT JOIN间接关联——【Trae执行时不会自动下推外部人群表的JOIN条件到主表过滤】，会导致基数膨胀。
