SuperAPI AI 工具集

make-app-runtime

编程与开发

查看项目

更新于 10-16 09:53

技能介绍

用途:该技能负责 Make App 的运行时与打包契约,包括项目运行时结构、工作区清单、构建产物、Service 启动入口、Service 端口基线、运行时配置文件位置、Docker/K8s 运行时入口对齐,以及发布就绪脚本与检查。它不负责 UI 布局、认证实现、单应用权限逻辑、Make 适配器环境变量语义、DSL 建模、Make 资源部署或画布表格行为。

主要能力与用法:新建或显式迁移的 App 使用固定运行时三元组 Node.js 22.20.0、Corepack 0.34.0、pnpm 10.20.0,工作区根 apps/package.json 需声明 packageManager 与 engines,并包含 .nvmrc。命令通过 corepack pnpm 执行,如 corepack pnpm install --frozen-lockfile。工作区包含 apps/ui、apps/service、apps/dsl、apps/docs 及按需的 apps/packages/*。前端产物位于 apps/ui/dist;Service 默认入口为 apps/service/dist/server.js,端口固定 3000,运行时配置集中在 apps/service/src/config.ts。发布前可运行项目本地 verify:publish 脚本,依次执行运行时检查、测试、auth 审计、trace 审计、构建产物检查与 schema diff,再通过 makecli app deploy 部署到 Beta,经用户授权后用 makecli app promote 发布到 Prod。

限制:现有 App 在无关工作中保留其已声明的 Node 与包管理器版本,不得擅自重写 packageManager、engines、锁文件或 Node 选择文件;如需迁移应作为独立变更并配合测试与 Beta 部署。若声明、锁文件、工作区/CI 流程或目标平台构建要求冲突,应停止并报告兼容性阻塞,不得生成第二个锁文件或静默转换为 pnpm。verify:publish 是项目本地质量门,不应描述为通用 makecli 钩子。本地 3000 端口被占用时应报告冲突,不得静默更改端口。域名映射、网关路由与密钥注入不属于本技能范围。