用途:把结构化条件翻译为合法的 FilterQL 语法。接收(字段、运算符、值)元组及 AND/OR/NOT 分组,输出语法正确的 FilterQL 字符串,适用于编写、构建或校验 FilterQL 查询与过滤表达式。
主要能力:按字段类型与运算符的兼容矩阵映射写法,例如字符串 equals 映射为 field = "X"、contains 映射为 field CONTAINS "X"、IN、LIKE;布尔值 is true/false 映射为 field = true/false;数值大小比较映射为 > >= <;日期支持相对时间运算,如 after N days ago 映射为 field > "now-Nd"、within last N hours 映射为 field > "now-Nh";集合类型 has/doesn't have 映射为 INTERSECTS/NOT INTERSECTS;存在性映射为 EXISTS field / NOT EXISTS field。
使用方式:输入条件列表与分组(AND/OR/NOT),指定目标表(默认 user)与别名;单条件直接写 FILTER condition FROM table ALIAS slug,多条件默认 AND,AND/OR 分组需加括号并用逗号分隔。别名转换为 slug:小写、空格替换为下划线、移除特殊字符。输出完整语句,例如 FILTER AND (country = "US", visitct > 5) FROM user ALIAS us_active_visitors。日期支持 "now-Nh/Nd/Nw/NM/Ny" 等形式。
限制:为纯构建过程,无需环境或 API 调用;依赖引用文件 ../references/filterql-grammar.md 与 ../references/field-types.md。若字段类型与请求的运算符不兼容,会提示正确运算符;值含引号时需转义;语法无效时会定位并修正。