内容
BI PBIR +视化组件指南
用于分发 MCP `mcp__powerbi_visuals` 并记录其与 Power BI 项目（以 PBIP/PBIR 格式）的使用方法的仓库。
本仓库包含：
- `Informe_Charlas_Microsoft.pbip`：Power BI 项目。
- `Informe_Charlas_Microsoft.Report`：报告的 PBIR 定义。
- `Informe_Charlas_Microsoft.SemanticModel`：TMDL 语义模型。
- `mcp-server/`：MCP 服务器 `mcp_visuales_avanzado` 的可安装源代码。
- `docs/`：使用步骤和已知错误。
- `scripts/Validate-PBIRVisuals.ps1`：本地验证脚本，用于避免在生成可视化组件时出现的错误。
- `.github/workflows/validate-pbir.yml`：可选的自动验证工作流，用于在推送到 GitHub 时进行验证。
## 要求
- 支持 PBIP/PBIR 的 Power BI Desktop。
- 保存为 `.pbip` 的项目。
- Python 3.10 或更高版本。
- 从 `mcp-server/` 安装的 MCP 并在 Codex 中可用。
- 可选的 `pbir` 命令行界面（CLI），用于额外验证。
检查 CLI：
```powershell
pbir --version
```
从仓库安装此 MCP：
```powershell
python -m pip install -e .\mcp-server
```
MCP 的 Codex 配置：
```toml
[mcp_servers.powerbi_visuals]
command = "python"
args = ["-m", "mcp_visuales_avanzado.server"]
cwd = 'C:\path\to\powerbi-mcp-visuals-playbook\mcp-server'
enabled = true
startup_timeout_sec = 20.0
tool_timeout_sec = 120.0
```
## 推荐流程
1. 在 Power BI Desktop 中保存报告。
2. 在从 MCP 编辑 PBIR 之前关闭 Power BI Desktop。
3. 使用 `mcp__powerbi_visuals` 创建/修改页面和可视化组件。
4. 使用以下命令验证：
```powershell
.\scripts\Validate-PBIRVisuals.ps1
```
5. 可选地，还可以使用以下命令验证：
```powershell
$env:PYTHONIOENCODING='utf-8'
pbir validate 'Informe_Charlas_Microsoft.Report'
```
6. 在 Power BI Desktop 中重新打开 `.pbip` 文件。
## 包含的文档
- [安装和重用 MCP](docs/install-and-reuse-mcp.md)
- [将此仓库与另一个 PBIP 报告一起使用](docs/reuse-with-another-report.md)
- [Codex + MCP 的提示配方](docs/prompt-recipes.md)
- [MCP 使用指南](docs/mcp-powerbi-visuals-usage.md)
- [故障排除](docs/troubleshooting.md)
- [将此项目上传到仓库](docs/repo-upload.md)
## 将更改推送到 GitHub
此工作区已经具有远程仓库。要推送更改：
```powershell
git status
git add README.md docs scripts mcp-server .gitignore Informe_Charlas_Microsoft.pbip Informe_Charlas_Microsoft.Report Informe_Charlas_Microsoft.SemanticModel
git commit -m "Add Power BI visuals MCP server source"
git push origin main
```
在其他计算机上更改远程仓库：
```powershell
git remote set-url origin https://github.com/<usuario>/<repo>.git
git push -u origin main
```
## 重要注意事项
- 不要在 Power BI Desktop 中保存具有错误会话的文件，以免在 Desktop 外编辑 PBIR 后出现问题。
- 在切片器、表格和矩阵中，维度应写为 `Column`，而不是 `Measure`。
- 在卡片、仪表和数字轴中，建议使用显式度量。
- MCP 可以列出的某些可视化组件类型如果不是作为自定义可视化组件嵌入，则
