用途：排查 Power BI 模型性能问题、跟踪查询执行、管理缓存，并验证 pbi-cli 运行环境。
前置条件：pipx install pbi-cli-tool；pbi-cli skills install；pbi connect。
环境检查：pbi setup 验证 pythonnet 与 .NET DLL；pbi setup --info 查看版本、DLL 路径与 pythonnet 状态；pbi --version 查看 CLI 版本。
主要能力：模型健康检查（pbi --json model get、model stats、table list）；查询跟踪（pbi trace start / stop / fetch / export）；缓存管理（pbi dax clear-cache）；连接诊断（pbi connections list / last、pbi connect -d、pbi disconnect）；导出模型（pbi database export-tmdl）。
典型流程：慢查询分析先 clear-cache，再 trace start，执行 DAX 查询（可加 --timeout），trace stop 后 export 并 fetch 事件。模型审计则依次查看 model get/stats、table list、relationship list、security-role list，并导出 TMDL。
注意事项：Desktop 重启后本地 Analysis Services 端口会变化，需重新 pbi connect，避免连到旧端口读到错误模型；pbi setup --info 仅表示 DLL 已加载，需用 EVALUATE ROW("test", 1) 冒烟查询确认连通；trace 事件异步到达，stop 后立即 fetch 可能为空，需等待或重试；clear-cache 只清公式引擎缓存，存储引擎缓存仍在，冷基准需重启 Desktop 或重连；model stats 会统计隐藏对象；--timeout 单位为秒，默认 60 秒。
适用场景：Power BI 模型性能调优、DAX 查询剖析、环境排障与自动化监控脚本（可用 --json 输出）。限制：依赖 pbi-cli 与本地 Power BI Desktop 环境，具体平台与收费信息暂未提供。