pbi-cli
让 Claude 获得操作 Power BI 语义模型和报告的能力
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pbi-cli。 它的用途是：让 Claude 获得操作 Power BI 语义模型和报告的能力 完整的 Skill 内容见：https://321skill.com/skills/pbi-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“为销售表创建一个名为‘上月环比增长率’的新度量值。”，它会通过 pbi-cli 连接到你的 Power BI 文件，并生成相应的 DAX 代码或直接完成创建。你也可以说：“把柱状图的颜色主题改成公司品牌色，并把图例移到顶部。”，AI 会操作报告层代理完成这些格式调整。
介绍
pbi-cli 是一个专为 Claude 设计的命令行工具，旨在解决 AI 助手无法直接与 Power BI 桌面应用交互的痛点。它通过安装一个本地 CLI 工具并注册为 Claude 的技能，在 Claude 和运行中的 Power BI Desktop 之间建立了一座桥梁。
使用时，用户只需在终端安装 pbi-cli，运行一次技能注册命令，然后通过 pbi connect 连接到已打开的 Power BI 文件。之后，用户就可以直接用自然语言指示 Claude 对 Power BI 的语义模型（如创建度量值、修改表关系）和报告（如调整视觉对象、修改格式）进行操作。
这个工具非常适合经常使用 Power BI 进行数据建模和报告开发的数据分析师、商业智能工程师以及需要快速迭代数据产品的产品经理。它极大地提升了在 Power BI 中进行探索性数据分析和报告制作的效率。
需要注意的是，该工具目前仅支持 Windows 系统，且要求本地已安装 Python 3.10+ 和正在运行的 Power BI Desktop。初次使用需按照指引完成环境配置和连接步骤。
核心特点
与同类工具相比，pbi-cli 的核心区别在于其“双代理架构”：一个代理处理语义模型层（DAX、数据模型），另一个代理处理报告层（视觉对象、格式），实现了对 Power BI 全栈的精细控制。它并非简单的 API 封装，而是深度集成了 Claude 的自然语言理解能力，将用户指令直接转换为对 Power BI 对象的操作。
注意事项
目前仅支持 Windows 操作系统，且必须依赖本地运行的 Power BI Desktop 实例。
常见问题
pbi-cli 支持 Mac 或 Linux 吗？
不支持，目前仅支持 Windows，因为它需要与 Power BI Desktop 桌面应用交互。
安装后 `pbi` 命令找不到怎么办？
推荐使用 pipx 安装以自动处理 PATH 问题，若用 pip 安装，需手动将 Python 的 Scripts 目录添加到系统环境变量 PATH 中。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pbi-cli/raw/index.md 读取 pbi-cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pbi-cli/raw/index.md（查看排版版本）