app-builder

用途：将自然语言意图转化为已部署的模型驱动 Power Apps 应用，并支持后续编辑。多轮对话中先与用户确认生成可审阅的 App Spec（JSON），再由内置引擎（cds-maker-sdk）执行构建；同一份 spec 同时驱动创建与编辑，可把已部署应用下载回 spec 修改后重跑（幂等）。\n\n主要能力：数据模型（表、各类型列、1:N / N:N 关系、示例数据）；记录 UI（表单含子网格、快速创建/查看，视图与图表）；列的自定义网格渲染（RadialDial、LineChart、HeatMap、StarRating）；操作（现代命令栏按钮、Web 资源）；无代码表单逻辑（业务规则）；引导流程（businessProcessFlows）；界面（生成式页面、经典仪表板、外部 URL）；应用外壳（应用模块与站点地图）；安全与访问（按角色生成安全角色）；管理员可控的 AI 功能（表单填写辅助、自然语言搜索、M365 Copilot 等）。\n\n使用方式：先运行 node "${PLUGIN_ROOT}/scripts/check-version.js"。交互流程必须在主对话中运行，不要派发子代理；工具输出默认折叠，用户看不到，须将预览、干跑计划、lint 结果原样粘贴到聊天回复中。先解析交互模式：node "${PLUGIN_ROOT}/scripts/resolve-interaction-mode.js" [--non-interactive]。无人值守时不要调用 AskUserQuestion、EnterPlanMode、ExitPlanMode；对非破坏性选择使用文档默认值；记录 Unattended default；把 lint、预览、设计文档和干跑视为已批准计划；遇到歧义环境、应用身份或破坏性结构编辑应停止而非猜测。无人值守仍需在通常需要 --allow-destructive 的地方显式提供该参数。\n\n前置条件：node --version 与 pac help（要求高于 2.10.0）。环境：pac auth list，多个且无活动时询问，无则 pac auth create，用 pac org who 捕获组织 URL。已有对象用 pac model list-tables --search … 与 pac model list 检测。\n\n工作流：Phase 0 由 $ARGUMENTS 派生短 kebab-case slug，创建目录存放 app-spec.json、model-app-plan.md、workflow-log.md。Phase 1 按 references/authoring-flow.md 在主线交互编写 App Spec：先读 references/app-spec-schema.md 与 samples/app-spec.support-desk.json，条件功能另读 references/app-spec-schema-advanced.md；依次确认 personas 与 jobs、数据模型、artifacts + 页面意图 + 设计、访问权限，每级用 AskUserQuestion 确认并持久化 app-spec.json；渲染的角色与实体访问须以表格粘贴到回复。整应用预览运行 node "${PLUGIN_ROOT}/scripts/preview-app.js" --spec @<工作目录>/app-spec.json，并把完整渲染输出原样粘贴。\n\n限制：生成式页面每条须放入站点地图，未放入会被校验拒绝；仅导航页面不支持；声明 pageInput 的页面必须声明 directEntry；v1 业务流程流为单实体线性，跨实体阶段、分支与阶段操作会被拒绝；命令和 Web 资源编辑在重建时不会重新部署；列级安全与访问团队暂未支持；AI 功能受管理员控制。原文内容在预览输出处被截断，完整渲染输出的后续部分暂未提供。