SuperAPI AI 工具集

make-env-setup

部署与运维

查看项目

更新于 10-15 21:40

技能介绍

用途:在开发前准备或更新本地 Make 开发环境,包括选择合适工具链、验证 Make 登录状态,并仅对新建 App 初始化项目目录。建议在新机器上运行,并在工具需要更新时再次运行。资源与部署操作使用 makecli,具体实现由相应技能负责。

主要能力与规则:不得打印或存储令牌、Cookie、Authorization 头、密码等机密;不得手动创建 PRD、DSL、Service 或 UI 文件,只运行 makecli app init;机密需用户自行交互输入,不要粘贴到聊天中;不得通过 npm 安装 pnpm。新建或明确迁移的 App 使用固定基线,已有的兼容 npm 或 Yarn App 保留其声明的安装器与锁文件。

项目模式:新 App 或用户明确要求迁移运行时,采用固定 Node.js 22.20.0、Corepack 0.34.0、pnpm@10.20.0 基线;运行时迁移本身属于 make-app-runtime。已有 App 需先检查 packageManager、Node engines、锁文件与 CI,保持兼容的 Node 与包管理器,遇不一致应停止并上报。目录或新旧模式不明确时先询问用户。

工具安装:支持 macOS、Linux、Windows。确保精确 Node.js 22.20.0 与 git 可用,缺失时经用户确认后按平台方式安装。安装 pnpm 前验证基线: node -e 'if (process.versions.node !== "22.20.0") { throw new Error(Make Apps require Node.js 22.20.0; got ${process.versions.node}) }' node -e 'const { execFileSync } = require("node:child_process"); const actual = execFileSync("corepack", ["--version"], { encoding: "utf8" }).trim(); if (actual !== "0.34.0") { throw new Error(Corepack must report 0.34.0; got ${actual}) }' 然后: corepack enable corepack install -g pnpm@10.20.0 node -e 'const { execFileSync } = require("node:child_process"); const actual = execFileSync("corepack", ["pnpm", "--version"], { encoding: "utf8" }).trim(); if (actual !== "10.20.0") { throw new Error(pnpm must report 10.20.0; got ${actual}) }' 安装或更新 makecli:已有则 makecli update --skip-skills;否则 npm install -g @qfeius/makecli。macOS/Linux 上 EACCES 时不要用 sudo,改用用户级全局前缀。每次运行更新平台技能:npx skills add qfeius/make-platform-skills --all -y。

验证与登录:新 App 或迁移模式运行 node --version、npm --version、corepack --version、corepack pnpm --version、git --version、makecli version,版本须严格匹配。检查令牌:makecli configure verify --output=json;失败则 makecli login --timeout=60s 并引导浏览器登录,超时则请用户完成登录后回复“已经完成登录”;不便时可回退 makecli configure token,由用户自行输入。

初始化:已有 App 不重新初始化,仅报告位置。新 App 选目录并确认“是否使用 <app-folder> 作为 App 目录?请回复 “是” 或 “否”。”后运行 makecli app init <app-folder>,当前目录可省略参数;命名不合规时按规则调整后重试。全部通过后输出简洁就绪报告。