SuperAPI AI 工具集

pbip

通用与其它

查看项目

更新于 10-15 20:32

技能介绍

用途:PBIP 是 Power BI 的开发模式文件格式,把 .pbix 拆解为可读文本文件,支持 Git diff、外部编辑与多作者协作。本技能聚焦项目结构、重命名、派生与校验,不负责报告编辑;语义模型用 te,报告改动用 pbir,不要手改 PBIR JSON。

主要能力:说明 thick(.Report + .SemanticModel,byPath)与 thin(仅 .Report,byConnection 连远程模型)两种报告;描述 .pbip、.pbir、.pbism、.platform、definition/、.pbi/、DAXQueries/ 等目录结构;涵盖页面文件夹命名规则 ^[\w-]+$(含空格或点会被 Desktop 静默忽略)、pages.json 的 pageOrder 与 activePageName 一致性、SharedResources 主题路径解析、派生项目时更新 .pbip、.pbir、.platform 的 logicalId 与 displayName。

使用方式:用 Power BI Desktop 的“文件 > 另存为 > Power BI Project (.pbip)”完成 PBIX 转换,再把 .pbix 视为不透明产物,不要解压或重打包。校验可用 python3 scripts/validate_pbip.py <path>(支持 --fix、--json、--no-pbir-cli,退出码 0 干净、1 警告、2 错误、3 用法错误)及 pbir validate;重命名后用 grep 检查残留引用。文件需 UTF-8 无 BOM,注意 Git 换行与 Windows 260 字符路径限制,外部重命名后重启 Desktop。

限制:不提供 PBIX 解包/重建;本文未提供收费、价格、平台兼容与效果等信息。部分细节如 Copilot 文件夹、重命名级联示例需查阅对应 references 文档,资料未给出可不在正文展开。