MinaSaad1/pbi-cli

解決的問題

pbi-cli 提供 Power BI 的命令列介面，讓使用者能自動化語意模型與報表的建立與管理。它消除了使用 Power BI Desktop GUI 時重複的手動操作，例如批量建立度量值或手動建構視覺元素，透過程式化存取 Power BI 的內部結構來實現。

工作原理

此專案採用雙層架構與 Power BI 互動：

• 語意模型層：使用 Python 直接呼叫 .NET 互操作，透過 TOM/ADOMD 與 Power BI Desktop 通訊，實現 DAX 查詢與模型變更的亞秒級執行。
• 報表層：直接讀取與寫入 PBIR（增強報表格式）JSON 檔案，無需連接 Power BI Desktop 應用程式即可處理 .pbip 專案。

它還包含一個「技能」系統，註冊了 13 種特定的 Power BI 能力（如 DAX、建模與視覺），以便與 Claude Code 搭配使用，使 AI 代理能自主執行這些任務。

適用對象

希望自動化工作流程、對報表使用版本控制，並利用 Claude Code 等 AI 代理建構與管理資料模型與報表的 Power BI 開發者與資料分析師。

主要亮點

• AI 代理整合：專為讓 Claude Code 獲得撰寫 DAX、建立資料表與建構報表的能力而設計。
• 批量操作：支援批量建立度量值與視覺元素，可調試 DAX 並審計模型健康狀態。
• 自訂視覺開發：提供專用迴圈，用於產生 TypeScript 專案，打包 .pbiviz 檔案，並導入報表。
• 全面的工具集：涵蓋 27 個命令群組，從安全角色與分割區到書籤與條件格式化。
• JSON 輸出：支援 --json 選項，輸出機器可讀格式，便於腳本與其他 AI 代理整合。