用途：读取、编辑和创建 PBIP 项目中的 PBIR 格式报表定义文件，覆盖页面、视觉对象、筛选器、切片器、导航、书签、主题、格式、校验、Desktop 重载与截图等具体机制；不负责开放式设计、报表规划或 Fabric 报表项 CRUD，这些需配合 powerbi-report-design、powerbi-report-planning、powerbi-report-management 使用。语义模型元数据或模型侧改动应使用语义模型写作技能、Power BI Modeling MCP 或本地 TMDL。
主要能力与用法：需要 PBIR 事实（视觉类型、数据角色、格式对象、属性名、枚举值、选择器、表达式编码、校验）时以 CLI 为准，不要凭记忆猜测 JSON。前置 Node.js 20 以上；安装：npm install -g @microsoft/powerbi-report-authoring-cli@latest @microsoft/powerbi-desktop-bridge-cli@latest，并用 powerbi-report-author --version、powerbi-desktop --version 确认可用。常用命令包括 catalog list、catalog describe <type>、formatting list-objects <type>、formatting describe-object <type> <object>、formatting search <type> <regex>、validate <path> 及 preview-* 系列。编辑后运行 powerbi-report-author validate <path-to-.Report-dir>（传 .Report 目录而非 .pbip）。渲染输出变更需走 编辑→校验→重载→截图 循环：powerbi-desktop status 选 PID，若 hasUnsavedChanges 为 true 先让用户保存或放弃；再 reload --pid <pid> 并截图复核。主题 JSON 按名称缓存，重载可能不生效，需随机重命名并更新 report.json，或关闭重开 Desktop。
限制：仅覆盖 PBIR 文件机制，PBIR 结构保留原有 $schema 版本，不自行改版本；不提交或依赖 localSettings.json；旧式视觉类型应迁移为 cardVisual、tableEx、pivotTable、azureMap 等现代类型。资料未提供收费、价格与更多平台支持信息。