用途：管理 Power BI PBIR（增强报表格式）报表项目，覆盖脚手架创建、结构校验、HTML 预览与 Desktop 集成等顶层操作。PBIR 将报表存为 JSON 文件夹结构，含 definition.pbir、version.json、report.json 以及 pages/ 下的页与 visual 目录。
主要能力：pbi report create ./MyProject --name "Sales Report" 可搭建项目骨架，加 --dataset-path 指定数据集引用；pbi report info 查看页面、主题、数据集等元数据；pbi report validate 校验必需文件、JSON 解析、schema URL 与页面引用一致性；pbi report preview 启动自动刷新的 HTML 布局预览（需 pip install pbi-cli-tool[preview]）；pbi report reload 让 Desktop 重新加载当前报表（需 pip install pbi-cli-tool[reload]）；pbi report convert 可把 .Report 文件夹转为可分发的 .pbip。多数报表层操作无需连接 Desktop。
用法：报告命令会按显式 --path、从 CWD 向上查找 *.Report/definition/、或从 .pbip 找同级 .Report 的方式自动定位。写命令默认每次自动同步 Desktop，批量构建时可在 report、visual、filters、bookmarks 命令组上加 --no-sync 抑制，最后统一执行一次 reload。pbi --json report info 可输出 JSON。
限制与注意：validate 只检查 JSON 结构与必需文件，不校验数据集绑定、schema 版本或 visual queryState，可能出现校验通过但 Desktop 打不开的情况。--dataset-path 相对于 .Report 文件夹，移动文件夹会静默断开绑定。reload 依赖窗口焦点，仅建议在批量结束时执行。convert 生成的 .pbip 不打包语义模型，分发时需另附 .SemanticModel 目录。PBIR schema 版本按文件固定，跨版本编辑可能校验失败，应整体升级。--no-sync 只作用于所在命令组，批量时每个涉及的命令组都要加。