用途：集中管理 Power BI 报表主题，把重复的格式选择（数据系列色板、语义色、字体层级、容器与视觉类型默认格式）收敛到主题层，减少视觉对象级漂移，便于改版、差异对比与维护。
主要能力：审计颜色与字体（pbir theme colors、pbir theme fonts、pbir color list、pbir fonts list）；检查视觉对象生效值与来源（pbir visuals format）；用 pbir theme set-colors、set-fonts、set-formatting 设置色板、语义色与重复格式；从模板套用主题（pbir theme list-templates、pbir theme apply-template）；把设计良好的视觉对象提升为类型默认（pbir theme push-visual，先 --dry-run）；清理视觉对象覆盖（pbir visuals clear-formatting，配合 --keep-cf 保留条件格式）；颜色归一化（pbir theme colors --normalize）；复制主题（pbir cp）并校验（pbir theme validate、pbir validate --all）；渲染验证（pbir desktop refresh、pbir desktop screenshot）。
用法：始终用 pbir 执行所有报表与主题变更，禁止直接编辑 theme.json、visual.json 或序列化 .Theme 片段，也不回退到 jq、shell 替换或 JSON 编辑技能；只通过 pbir cat、pbir get 或只读示例读取 JSON。先审计再改动，改动前确认会清除覆盖等破坏性操作，并在不熟悉的格式属性上用 pbir schema describe 查询。
限制：资料未提供 pbir 的安装方式、版本要求与收费信息；若 pbir 缺少所需操作，应停止并报告缺失能力。Desktop 刷新不会重新加载主题资源，判定主题改动前需关闭并重新打开报表后再截图。主题格式化层级为 Power BI 默认、主题通配默认、主题视觉类型默认、所选样式预设、视觉对象实例覆盖，最后者生效。