SuperAPI AI 工具集

assign-offline-profile

通用与其它

查看项目

更新于 10-16 00:31

技能介绍

用途:将现有 Mobile Offline Profile 绑定到一个或多个用户和/或团队。仅创建配置文件无法让终端使用离线同步,必须完成成员绑定,否则应用仍不会使用该配置文件离线同步。成员分配在 Maker Portal 中是与创建配置文件分开的操作。

主要能力:按 UPN 指定用户(--user,可重复)、按名称指定团队(--team)、添加当前用户(--me)、添加环境中所有 System User 角色用户(--all-app-users),以及通过 --unassign-user / --unassign-team 解除绑定。工作流为:验证项目并定位配置文件→选择用户/团队→发现现有成员→确认变更差异(单一确认门)→提交成员关系→验证→输出汇总。

使用方式:技能读取 shared-instructions.md,需先应用 app-working-directory.md 并解析出唯一的绝对 working_dir。环境 ID 从 power.config.json 读取,通过 resolve-environment.js 解析环境与租户,随后所有 Dataverse 请求需带 --tenant-id。配置文件 ID 解析顺序:--profile-id、--profile-name(GET /mobileofflineprofiles 过滤)、offline-profile.json 的 profileId,或列出后让用户选择。成员创建使用 usermobileofflineprofilememberships 与 teammobileofflineprofilememberships 实体,按顺序逐一 POST,删除用 DELETE。团队查询使用 teamtype eq 0,仅 Manage Teams 可获分配。

限制与注意:成员关系逐条提交,非事务性,中途失败会留下部分已添加成员;重复 POST 返回 409 Conflict,被包装器视为幂等成功,可安全重跑。用户需在下次移动应用登录后才会收到配置文件,已登录会话需注销再登录才能触发拉取。规划阶段调用只能发现并建议差异,必须在确认门之前返回。若无法确定 profileId,需先运行 /setup-offline-profile 或传入 --profile-id。本技能未提供收费、价格等其它信息。