Power BI PBIP ↔ PBIX MCP Demo

把已有 PBIX 成品导成可编辑 PBIP 工程，也把完整 PBIP 工程保存为 PBIX。网页与 MCP 接入同一持久队列，由受控 Windows 桌面上的 Power BI Desktop 实际执行 Save As，再用新进程重新打开产物。

微软没有提供公开的 PBIP/PBIX 程序化转换 API。这是受控 Desktop 自动化 Demo，不是官方无头转换服务，不靠重命名 ZIP、PBIT 或在线报表代替成品。

为什么需要 / 能做什么

PBIP 的文本定义适合编辑、代码审阅与版本管理；PBIX 适合 Desktop 文件交付。本项目连接这两种工作方式，转换本身不调用大模型。

Related MCP server: timeverse-omni-converter-mcp

架构

Browser / HTTP MCP
        |
  App Service HTTPS gateway
        | private VNet
  Authenticated portal + MCP ---- SQLite / per-owner job files
                                         |
                              one interactive Windows worker
                                         |
                              Power BI Desktop Save As
                                         |
                              fresh-process reopen
                                         |
                              PBIX / PBIP ZIP + verification

管理员另用 Bastion / SSH 维护环境；普通用户不领取 SSH 密钥。portal 与 worker 分别启停：网页可达不等于桌面就绪。2026-09-14 部署核对时，worker 使用 IdleTimeout=0、计划任务 ExecutionTimeLimit=PT0S，保留 ReviewSeconds=20；不再因空闲 30 分钟或任务运行两小时而退出，但执行转换仍必须保持 RDP Active 且未锁定。

同日确认线上已启用 RecoveryMode=SessionAware 会话恢复模式：短暂断连/锁定时保留真实心跳、暂停接单，桌面恢复后处理尚未过期的排队任务；计划任务为同一用户配置登录触发及最多三次、一分钟间隔的失败重启。显式 Stop 会留下持久停机标记，只有管理员 Start 可清除。新安装仍默认 Manual，必须由管理员显式启用恢复模式。它不创建或解锁 Windows 会话，不重新执行失败任务，也不能在无人登录的 VM 重启后保证转换可用。额外的云端会话控制器未启用，不属于本次可交付运行链路；配置与验收边界见日常运维。

在线演示

入口：https://pbip-mcp-bidir-2d79425f.azurewebsites.net

受控试用需要维护者单独分配个人访问凭证，仓库不提供登录密码或 token。它不是微软账号登录，也未接入企业 SSO。可用性取决于演示窗口与交互桌面状态；操作步骤见 线上版本使用说明。

快速开始

开发环境：Windows、Python 3.12 x64；网页 JavaScript 行为及网关测试另需 Node.js 22+。真实转换还需标准版 Power BI Desktop、Visual C++ x64 运行库、英文 Desktop UI，以及保持连接且解锁的专用普通用户桌面。先由有权人员处理首次启动、格式选项和法律 / 安全提示。

在仓库根目录 PowerShell 安装并运行本地测试（不会触发真实转换）：

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.lock
.\.venv\Scripts\python.exe -m pip install --no-deps -e .
.\.venv\Scripts\python.exe -m unittest discover -s tests -t . -q
npm --prefix .\deploy\public-gateway test

部署不要直接从开发目录启动公网服务。按 环境与安装指南 将代码部署到专用 Windows 节点；分别准备 worker 管理、portal 管理 与 App Service 网关。公网脚本要求显式提供本机私网地址，不能照抄别人的部署参数。转换输入使用 sample\Synthetic.zip / sample\Rich.zip，不是整个仓库 ZIP。

文档与样例

安全边界

只接受获准的受信任工程。worker 必须在 Interactive + Limited、已连接且解锁的普通用户桌面中串行工作，不能用 SYSTEM / Session 0 代替。共享 Windows 账户不是恶意 M 查询沙箱；不可信客户或不同安全域应使用独立 worker、存储、网络和操作系统隔离。

definitions 不等于脱敏：M、TMDL、参数及连接定义仍可能有内嵌数据或敏感内容；portable 还携带模型缓存。非内置 PBIP 工程不自动刷新，所引用语义模型目录缺少非空 .pbi/cache.abf 时，在创建任务、写入队列和保留上传文件之前返回 DATA_CACHE_REQUIRED；只有逐文件精确匹配的内置样例可例外。

definitions 导出仍经过真实 Save As、剔除缓存与本机设置、独立副本新进程复开。关闭该复开进程时，仅对本任务拥有且已识别的保存决定窗口有界响应：最多两个不同窗口，每个仅丢弃一次；未知登录、安全、法律或保护提示不自动绕过。凭据、用户库、队列、运行诊断及内部部署回执不进入仓库。

状态与许可证

源码以 rc7 / 0.2.4 为基线，新增原名称保留、网页故障诊断与可选会话恢复；本次同步不改写已有版本号或历史合成结果，具体源码修订以 Git 提交为准。公开副本保留将私有部署参数改为显式输入的处理。样例观察不代表任意模型语义等价或生产级无人值守承诺。

未附加许可证，使用前请联系维护者。 Public 可见不等于已授予开源许可证。