SuperAPI AI 工具集

makecli

部署与运维

查看项目

更新于 10-15 21:40

技能介绍

用途:makecli 是 Make 智能体开发平台的 CLI,管理 Apps、Entities、Relations、Records、Schema 与代码部署。

安装与前置检查:brew tap qfeius/makecli; brew install makecli; makecli update。执行任何命令前先确认已安装,并运行 makecli configure verify --output=json 检查 token;未配置或过期需用户自行运行 makecli login(浏览器 OAuth,交互式,须由用户通过 ! 前缀执行)。配置报错提示陈旧键时用 makecli doctor(只读),makecli doctor --fix 原地迁移。

概念区分:context 指 CLI 连接的后端(dev/test/production),可用全局 --context、profile context 或 makecli context use 切换;environment 指应用的部署目标(beta/production)。app deploy 只推送到 beta,production 仅能通过 app promote(beta→prod)到达,没有直接推送 production 的方式。

主要工作流:声明式 schema(首选)——在 apps/dsl/ 写 DSL YAML,先 makecli diff -f apps/dsl 预览,确认后 makecli apply -f apps/dsl;Entity/Relation 存在则更新,App 仅创建不更新;diff 退出码 0 表示无差异、1 表示有差异。部署代码——先 makecli preflight,提交后 makecli app deploy --wait,deploy 只推送已提交的 HEAD,脏工作区会被拒绝;退出码 0 成功、2 失败或取消、124 超时(默认 5m),超时重跑会按 HEAD commit sha 重新附着同一构建。查看进度可用 app deploy --status / --status --wait。

发布到 Prod:使用 makecli app promote --yes --wait,发布的是 Beta 的 Console 配置和最近一次成功部署的 commit,不推送本地代码;超时后保留 promote ID 并用 app promote --status --id <promoteId> --wait 续接,不要重复发起。

其它命令:app create/delete/list/info、entity 与 relation 的 create/list、record 的 create/list/aggregate/update/delete(多数 create 支持 --dry-run),以及 whoami。

配置:configure 管理 profile 键(context、meta-server-url 等),settings 管理全局键(context、channel 等);profile context 优先于全局;--context 只选后端,不选 Beta/Prod 环境。命令支持 --profile,默认 default;配置文件为 ~/.make/credentials 与 ~/.make/config。

注意事项:apply 前必须 diff;批量 schema 用 YAML+apply 而非命令式;不要猜 flag,查 references/cli-reference.md;交互式命令(login、configure token)须由用户执行;无明确同意不要对 app delete/app promote 加 --yes;beta 未部署验证前不要 promote;不要用脏工作区部署;不要手写轮询,用 --wait。资料未提供具体收费、价格与效果数据。