用途：构建可分发的 Power BI 开发者视觉对象——用 TypeScript/D3 编写、基于 powerbi-visuals-api、由 pbiviz CLI（powerbi-visuals-tools）打包为 .pbiviz 文件，覆盖脚手架、开发、实时预览、打包、认证与发布全流程。当需求是可在多个报表复用、可交互、可分发并带自有格式窗格的视觉对象时适用；若只是单个报表里的一次性图表，同级方案（deneb-visuals、python-visuals、r-visuals、svg-visuals）通常更快更轻。
前置条件：Node.js 20.19 或更高（powerbi-visuals-tools 引擎最低要求）；pbiviz CLI 可用 npx -y powerbi-visuals-tools <command> 运行或全局安装；实时预览需在 Power BI Desktop 启用开发者视觉对象，或在 Power BI 服务开启开发者模式。
核心工作流：用 pbiviz new <VisualName> 创建项目（生成 src/visual.ts、capabilities.json、pbiviz.json、tsconfig.json、package.json、style/、assets/）；在 src/visual.ts 实现 IVisual 接口，类名须与 pbiviz.json 的 visualClassName 一致，核心方法有 constructor、update、getFormattingModel、destroy；在 capabilities.json 声明 dataRoles、dataViewMappings、objects；用 powerbi-visuals-utils-formattingmodel 构建格式模型（card 名对应 objects，slice 名对应属性）；pbiviz start 实时预览；pbiviz package 生成 dist/ 下的 .pbiviz 并导入报表。
MCP 服务器：插件自带 .mcp.json 启动 pbiviz MCP（npx -y powerbi-visuals-tools mcp），提供 get_available_apis、get_best_practices、add_feature、implement_feature、list_visual_info、check_vulnerabilities、prepare_certification 等工具。
认证与发布：认证可解锁导出 PowerPoint 与邮件订阅，关键门槛包括小写认证分支、eslint-plugin-powerbi-visuals 通过、无 eval/fetch/XMLHttpRequest、npm audit 干净、使用最新 API；可用 pbiviz package --certification-audit 审计，发布经 Partner Center 到 AppSource，基于 R 的视觉对象无法认证。
限制与未提供：具体命令参数、项目布局、IVisual 生命周期与格式模型模式见 references/pbiviz-toolchain.md，MCP 细节见 references/mcp-server.md，认证与发布流程见 references/certification-publishing.md，示例见 references/community-examples.md；费用、价格与性能数据暂未提供。