用途：从分析输入构建 IPPF 品牌的 Power BI 产物，适用于构建、搭建或更新 Power BI 仪表板、语义模型与 DAX 的场景。
主要能力（v1）：通过 pbi CLI 写入 DAX 度量值（pbi measure create）、操作表/列/关系结构、执行并校验 DAX；将 IPPF 主题 JSON 直接写入 .pbip 文件夹；把页面配方保存为 JSON 暂存产物。pbi CLI 仅封装语义模型操作，没有 theme、page、visual 命令，页面与视觉对象需在 Power BI Desktop 中手动创建，完整页面自动化属于 v2。
使用方式：先做预检——确认已安装 pbi（pipx list | grep pbi-cli-tool）、Power BI Desktop 已打开 .pbip 项目、品牌层可导入。连接需用显式名称：pbi connect -d localhost:<port> -n PBIDesktop-<pbip-basename>-<port>。每次 pbi 写入后须在 Desktop 中按 Ctrl+S 保存，否则写入可能丢失。主题 JSON 写入 .Report/StaticResources/SharedResources/BaseThemes/ 与 RegisteredResources/ 两处，并在 report.json 中注册；重试时改用带版本号的文件名以避免缓存。
另一条路线：当来源是 Excel 且需要完整可用的仪表板时，可用 Python 生成器从零编写整个 .pbip（含 TMDL、PBIR、主题与页面），参考脚本 gen_cerv_dashboard_pbip.py。
限制：仅支持文本格式 .pbip，不支持旧版 .pbix；pbi CLI 无法导入 Excel 数据；PBIR 格式仍为预览且模式不稳定；部分 pbi-cli 0.5.6 已知上游缺陷（刷新、References 参数）需手动绕过。分发建议：面向新手交付 .pbix，敏感数据不可用“发布到 Web”。