用途：通过 pbi-cli 在 PBIR 报表的页面或视觉对象上管理筛选器。筛选器保存在 page.json（页面级）或 visual.json（视觉对象级）的 filterConfig 中，无需连接 Power BI Desktop。
主要能力与用法： 查看：pbi filters list --page page_abc123；加 --visual visual_def456 查看视觉对象筛选。 分类筛选：pbi filters add-categorical --page page1 --table Sales --column Region --values "East" "West"。 TopN：pbi filters add-topn --page page1 --table Product --column Name --n 10 --order-by-table Sales --order-by-column Revenue；--direction Bottom 为升序取最低 N。--table/--column 是要保留的维度，--order-by-* 是排序依据，可属不同表。 相对日期：pbi filters add-relative-date --page page1 --table Calendar --column Date --period days --count 30 --direction last；period 支持 days/weeks/months/quarters/years，direction 为 last 或 next。 视觉对象级：加 --visual vis_abc 即作用于单个视觉对象而非整页。 移除：pbi filters remove --page page1 --name filter_abc123；清除全部用 pbi filters clear --page page1。 批量：写命令默认自动同步 Desktop；顺序改多个页面时用 filters --no-sync，最后执行一次 pbi report reload。 JSON 输出：pbi --json filters list --page page1。
限制与注意：TopN 的 --table/--column 与 --order-by-* 写反可编译但会排序错误维度，CLI 无法检测。相对日期以 Service 中用户本地时区为基准，跨时区审计报表结果可能不同，建议改用绝对日期。filters clear 会清掉全部筛选，包括此前书签设置的页面级筛选，书签引用的旧 ID 失效后会静默变为无筛选。自动生成的筛选名含 GUID，每次 TMDL/PBIR 重新导出都会变化，脚本中移除前应先重新 list。视觉对象级筛选会静默覆盖页面级筛选，得到空视觉而非冲突提示，排查时用 list 加 --visual 同时查看两个范围。仅用 --no-sync 而忘记最后 reload，磁盘文件正确但 Desktop 内存状态陈旧，后续手动编辑可能覆盖。