deploy

用途

Deploy 是 Microsoft Power Platform Skills 中的一个技能，用于将当前目录下的 Power Apps 代码应用（code app）构建并部署到 Power Platform。它适用于部署变更、重新部署已有应用，或推送应用更新。

主要能力

该技能围绕一个四步工作流展开：

1. 检查 Memory Bank：在项目根目录查找 memory-bank.md。如果找到，从中读取项目名称和环境信息；如果未找到，则继续执行——项目可能是在没有该插件的情况下创建的。
2. 构建：运行 npm run build。
3. 部署：在用户确认后，通过 CLI 将应用推送到 Power Platform。
4. 更新 Memory Bank：如果 memory-bank.md 存在，更新最后部署时间戳和应用 URL（若已捕获）。

使用方式

第 1 步：检查 Memory Bank

检查项目根目录中的 memory-bank.md。如果找到，读取其中的项目名称和环境。如果未找到，继续执行。

第 2 步：构建

运行：

npm run build

如果构建失败：

• TS6133（未使用的导入）：移除未使用的导入并重试。
• 其他 TypeScript 错误：报告错误及文件与行号并停止。不要部署损坏的构建。

继续之前，确认 dist/ 目录存在且包含 index.html。

第 3 步：部署

先询问用户：“Ready to deploy to [environment name]? This will update the live app.”（准备部署到 [环境名称] 吗？这将更新线上应用。）在继续之前等待用户明确确认。

先解析 CLI（参见 cli-binary.md）：以 $PA app push 方式运行（即 npx --no-install pa …），绝不使用裸 pa。在仅含 power-apps 的项目上，转换为 power-apps push。

pa app push

如果输出中存在应用 URL，则捕获它。

如果部署失败，报告错误并停止——不要静默重试。常见修复方式：

• 认证错误 / 令牌过期 → 运行 pa auth logout（或在仅含 power-apps 的项目上运行 power-apps logout），然后重试——CLI 会重新提示浏览器登录。
• 环境不匹配 → 将 power.config.json 中的 environmentId 更新为正确的值并重试。

第 4 步：更新 Memory Bank

如果 memory-bank.md 存在，更新：

• 最后部署时间戳
• 应用 URL（如果已捕获）

适用场景

• 部署 Power Apps 代码应用的新变更。
• 重新部署已有应用。
• 向 Power Platform 推送应用更新。

限制

• 构建失败时不会继续部署，尤其是存在未解决的 TypeScript 错误时。
• 部署前必须获得用户的明确确认。
• 部署失败时不进行静默重试，需报告错误并停止。
• 该技能依赖 memory-bank.md 与 power.config.json 等文件；若缺失，部分步骤（如读取项目名称、环境或更新部署记录）无法执行。
• 关于收费、价格、平台支持范围等更多信息，资料中暂未提供。