用途:面向 Power BI / Analysis Services 表格模型的建模操作指南,覆盖设计、构建、刷新与审查四类任务。适用于需要建模(星型架构、关系、度量值、计算组、角色与 RLS、参数、存储模式、增量刷新)、优化(大小与 VertiPaq、DAX 正确性、Direct Lake、刷新成本)、按质量与性能标准审查模型,以及为 Copilot / AI 使用做准备时。不适用于报表视觉对象与页面格式化、独立 DAX 查询调优、TMDL 文件语法本身。
主要能力:以工具级联为核心规则,优先使用最窄可用工具:先用 te CLI,一次一个动词,内存暂存至 --save,保存时执行 DAX 与引用完整性门禁,覆盖度量值/列/关系的增删改移、角色与 RLS 过滤、计算组与项、DAX 格式化(te set <path> --format Expression,或 te script --inline "Model.AllMeasures.FormatDax();")、te bpa、te vertipaq、te query。注意每次 Bash 调用是新 shell,需在每条命令传 --model <path>(远程用 -s/-d),或设置 TE_SESSION;属性写作 -p Name=Value,先用 te get <obj> --properties 读取可设置范围;每次变更在 --save 前都是 dry run。te 无法触及的属性(如 alternateOf、securityFilteringBehavior、crossFilteringBehavior、KPI 子对象、语言架构、日历对象)改用 te script 的 C#(进程内 TOM)、connect-pbid(PowerShell + TOM/ADOMD,且是访问跟踪的唯一途径)或 Power BI Modeling MCP;本地 Desktop 代理无法访问 Direct Lake,需用远程 XMLA 端点。最后才是 fab 与直接 TMDL(配合 tmdl 技能),用于角色成员分配、报表绑定模型、Copilot 文件夹功能、Direct Lake 后端的 Lakehouse/Delta 重塑等。排序门禁:任何用到 RELATED() 或跨表 CALCULATE() 的度量值之前需先添加关系,否则保存门禁报 DAX0002。
使用方式:先建模型元信息(scripts/get_model_info.py 获取存储模式、大小、关联报表、认证、数据源、刷新计划),按 references/ 下的清单与性能方法审查,输出带文件位置的分级问题。审查类别含关键问题(双向歧义、循环依赖、缺失数据类型、孤立表、RLS 失效开放、有限关系丢行)、内存与大小、数据缩减、DAX 正确性、度量值卫生、文档与 AI 就绪、设计、Direct Lake。刷新可用 te incremental-refresh 或 refresh-semantic-model 技能。
限制:本技能不包含 GUI 工具操作指引;不手写 Q&A 短语(Q&A 正在退役,Copilot 不读短语);不应把透视或显示文件夹当安全机制;不支持 PBIT 格式。