SuperAPI AI 工具集

dev

编程与开发

查看项目

更新于 10-16 00:31

技能介绍

用途:在项目工作目录中运行 ms app dev,启动本地开发环境并输出 App Player URL,供用户在浏览器中打开预览。该技能不部署到云端,部署需使用 /deploy。

主要能力:CLI 会同时运行两个服务器——开发脚本(Vite 或同类,默认端口 8080)和配置服务器,并打印 App Player URL。支持热重载,编辑代码后浏览器标签页自动刷新。

使用方式:先检查项目根目录的 memory-bank.md 获取上下文(缺失可跳过);确认存在 ms.config.json,否则提示不在 Microsoft App 工作区;用 ms auth status 检查登录状态,账号错误或未登录时提示用户执行 ms auth login。默认执行 ms app dev,在后台运行并监控 stdout,直到出现 “Ready. You can play your app locally at: <URL>” 行,捕获该 URL。随后自动打开浏览器(Windows 用 Start-Process,macOS 用 open,Linux 用 xdg-open),失败则回退为打印 URL。

可选参数:--port <n>(-p)在 8080 被占用时换端口;--local-app-url <url>(-l)当开发脚本使用非默认 URL(默认 http://localhost:3000)时使用;--config-only(-C)仅运行配置服务器,适合用户自行运行 npm run dev 的情况。无参数时先运行普通 ms app dev,失败再提示参数。

适用场景:本地启动或重启开发、预览应用、迭代代码。

限制:不推送、不部署,即使用户中途提及也需转交 /deploy(需显式确认)。App Player URL 仅本地可用;代码推送到 main 后可用 /play(ms app play --mode preview)获取云端预览 URL。启动报错(端口冲突、缺少 ms.config.json、认证过期、应用元数据获取失败)时应停止后台任务、原样显示错误并给出对应修复建议。不要展示 git remote URL,只展示 CLI 输出的确切 App Player URL,不要硬编码主机名。