用途:在 Power BI PBIR 报表页面上创建和管理可视化对象,通过 pbi-cli 直接操作 JSON 文件,无需连接 Power BI Desktop。
主要能力:用 pbi visual add --page <页面> --type <类型> 添加视觉对象,支持别名(如 bar、card、scatter)解析为 PBIR 类型,可指定位置尺寸(像素)和名称。用 pbi visual bind 以 Table[Column] 记法绑定语义模型,绑定选项随类型不同,如柱状图用 --category 和 --value,卡片用 --field,矩阵用 --row/--value/--column,KPI 用 --indicator/--goal/--trend。支持 visual list/get/update/delete,容器属性设置背景、边框、标题,视觉计算 calc-add/calc-list/calc-delete。批量操作 where、bulk-bind、bulk-update、bulk-delete 可按 --type 或 --name-pattern 等过滤。
使用方式:默认每次写操作自动同步 Desktop,可用 --no-sync 批量修改后执行 pbi report reload 一次。所有命令支持 --json。
限制与注意事项:bind 依据角色推断 Measure 还是 Column,若实际为列却按 Measure 引用会渲染空白且无报错;批量命令必须提供 --type 或 --name-pattern,但过宽松模式可能误伤无关视觉;位置坐标为报表设计像素;视觉计算在视觉范围内于度量值之后运行;视觉名称即文件夹名,创建后不能通过 CLI 重命名;bulk-delete 不可逆且无确认提示。