用途:这是 Power Platform Skills 中的只读诊断技能,用于在把离线配置文件推送给用户之前,估算设备实际会下载多少数据、多久重新同步一次。它不做任何写操作,适合在 /setup-offline-profile 做最终检查、/assign-offline-profile 避免用户被流量套餐意外扣费、以及 /edit-offline-profile 评估列清单变更影响时使用。
主要能力:先校验项目并定位配置文件,运行漂移检查(verify),再按表统计行数(应用与运行时一致的筛选条件,如全部记录、仅本人、仅团队、仅业务部门、仅相关记录),随后按列类型启发式估算缓存字节数,并计算每日传输量与各表同步间隔次数,最后输出报告。
使用方式:需先阅读 shared-instructions.md 并应用 app-working-directory.md,解析出唯一的绝对 working_dir。读取 <working_dir>/offline-profile.json 获取 profileId,环境 ID 来自 power.config.json。核心命令包括:node "${PLUGIN_ROOT}/scripts/verify-offline-profile.js" <envUrl> --project-root '<working_dir>' --tenant-id "<tenantId>",以及 node "${PLUGIN_ROOT}/scripts/dataverse-request.js" <envUrl> GET "<entitysetname>?$count=true&$top=0&<scope-filter>" --tenant-id "<tenantId>"。行数统计上限为 5000,达到上限时报告加 ≥ 前缀。
适用场景:离线配置推送前的容量与同步频率评估、列清单变更影响对比、数据流量与电池消耗风险提示。
限制:该技能为估算级而非精确值,字节启发式仅为经验规则,真实缓存取决于 Dataverse 存储布局、JSON 序列化与设备端压缩;图片与文件的实际负载不计入启发式,仅计元数据 200 字节/行。精确数据只能来自应用部署后 RM 登录产生的运行时同步日志。若缺少配置文件或上下文冲突,返回 NEEDS_CONTEXT;认证或查询失败返回 BLOCKED。