project-run

Project Run — 运行面板配置

.easymint/run.json 由左侧「运行」面板读取，每条 commands 显示为一个可一键启动/停止的按钮（含端口状态）。文件变化时面板自动刷新。

格式

{
  "commands": [
    { "platform": "react", "label": "前端", "cwd": "./client", "run_command": "npm run dev", "url": "http://localhost:5173" },
    { "platform": "spring", "label": "后端", "cwd": "./server", "run_command": "mvn spring-boot:run", "url": "http://localhost:8080" }
  ]
}

字段

• platform：按 run_command 判断（解释器+文件扩展名或首个命令词），不要按项目技术栈硬标。合法值：react/vue/nextjs/nuxt/angular/svelte/spring/django/flask/fastapi/nodejs/rails/laravel/go/rust/dotnet/react-native/expo/flutter/electron/tauri/python/shell/git/java。对应关系：flutter 开头→flutter、git 开头→git、npm/pnpm/yarn/node→nodejs、python→python、bash/sh/./xx.sh→shell、mvn/gradle/java→java、cargo→rust、go→go、dotnet→dotnet、docker→shell；脚本文件按扩展名（.py→python、.sh→shell、.js/.ts→nodejs、.java→java、.rb→rails、.go→go、.rs→rust、.dart→flutter）。mac 桌面脚本用 shell，桌面应用用 electron。（面板显示时也会按此规则推断，写对避免跳变）
• label：显示名，如"前端"、"后端"、"Android"（命名规则见下方「脚本标题命名」）
• cwd：工作目录（相对项目根），默认 "."
• run_command：运行命令，如 npm run dev、python main.py、flutter run、flutter build apk、bash deploy.sh
• install_command（可选）：依赖安装命令，如 flutter pub get、npm install。保留记录用，面板当前仅展示不提供安装按钮
• url（可选）：启动后访问地址，如 http://localhost:3000（仅运行类脚本需要，构建/打包/安装类不填）

规则

• 多入口（前后端分离、跨平台）写多条
• 静态 HTML 页面（纯 HTML/CSS/JS，无构建工具、无 npm 依赖）不需要开发服务器：run_command 用 open index.html（mac 直接打开）或 python3 -m http.server 8000（本地静态托管），url 对应 file:// 路径或 http://localhost:8000。不要为静态页面无谓创建 dev server 或引入框架构建
• 用户提出相关需求时，直接读现有 run.json 追加/更新——不必等任务全部完成，项目可运行即可生成；项目完成时生成（每次回到 done 更新）

脚本管理（不只限于启动项目）

• 脚本形式分工：
  • 简单单行命令（构建/打包/运行等一步到位）→ 直接写在 run_command：flutter build apk、npm run build
  • 复杂多步脚本（条件/循环/多命令串联，如发版部署）→ 先写脚本文件到 scripts/ 下（如 scripts/release.sh，加执行说明注释），run_command 写 bash scripts/release.sh 引用路径——脚本可版本管理、可独立测试、可复用
  • 面板编辑弹窗内 run_command 可直接改，简单命令无需单独建文件
• 脚本内不要手动重定向输出（如 > file 2>&1、| tee）：面板运行时会自动收集 stdout/stderr（日志面板实时显示 + 落盘），重定向会绕过收集导致面板无输出（与 bash 工具规则一致）