用途：路径清理规则用于规范化 $pathname 与 $entry_pathname，使同一模板下的页面（如 /users/123/profile 与 /users/456/profile）在 Web 分析、Paths 洞察及调用 apply_path_cleaning 的 HogQL 查询中合并为一行（/users/<id>/profile）。当某个细分被数千个近似 URL 打散时适用；若用户需要逐 URL 下钻，应改用 $pathname 属性过滤。
数据模型：Team.path_cleaning_filters 是 PathCleaningFilter 的 JSON 列表，每项含 regex（re2 模式，无需转义 /）、alias（替换值，默认用 <id>、<slug>、<uuid>、<date> 等尖括号占位符，也支持反向引用但开销更大）、order（整数，按升序依次应用，前一条输出作为后一条输入）。实际执行是对每条规则链式调用 replaceRegexpAll(pathname, regex, alias)。
工作流：先确认是基数问题而非逐 URL 需求；再用 execute-sql 查询真实路径（如按 $pathname 分组统计 $pageview），识别数字 ID、UUID、slug、日期、locale、分页等模式；然后编写 regex 与 alias，注意仅在需要时用 ^ 锚定开头、用 $ 防止通用规则匹配路径中段；保存前用设置页测试器、HogQL 的 replaceRegexpAll 或内置 AiRegexHelper 验证；规则按从具体到通用排序，避免通用规则吞掉具体规则；最后通过 path-cleaning-rules-update 工具应用，它支持 append、insert、replace、remove、reorder，自动编号 order，未传 confirm: true 时只返回预览，可传 sample_paths 查看实际重写效果。
生效范围：需用户或查询主动启用，包括 Web 分析的 Path cleaning 开关、Paths 洞察的过滤开关，以及任何调用 apply_path_cleaning(path_expr, team) 的 HogQL 查询。规则按项目存储，不限于单个洞察。
限制与注意：优先用占位符而非反向引用，后者每行开销约高 3 倍；反向引用在 JSON 或 SQL 字符串中需双反斜杠（\1）；忘记 $ 会误匹配路径中所有数字段；re2 默认区分大小写，可用 (?i) 开启不区分；path_cleaning_filters 字段是整体覆盖而非追加，直接编辑前务必先读取现有规则合并，否则会静默破坏团队已有配置；规则全局生效，新增规则可能改变所有已启用清理的历史图表数字，应用破坏性变更前应提醒用户。