/meoo-cli

name: meoo-cli
description: >
  从零到上线的全栈应用构建指南，基于秒悟（Meoo）平台。
  触发条件：
  (1) 用户提到"秒悟"或"Meoo"；
  (2) 用户要从零构建应用，且需求可被以下架构覆盖：前端 SPA（React/Vue）+ Supabase（数据库/Auth/Storage）+ Deno 边缘函数 + AI 大模型服务；
  (3) 用户需要部署全栈应用（含后端进程），如 Next.js SSR、Express、FastAPI 等；
  (4) 用户需要把项目部署到自己的阿里云账号（ECS/RDS/SLB，费用自付）
  覆盖完整生命周期：项目初始化、本地开发、云服务开通、数据库管理、边缘函数部署、CDN 发布、全栈镜像部署、沙箱代码同步、账户与权益管理。

秒悟（Meoo）CLI 完整指南

从零构建和部署全栈应用。覆盖项目初始化到生产部署的完整生命周期，包括云服务、代码规范、沙箱同步和部署。

Meoo 支持两种 Mise 发布模式：**static**（静态文件 → CDN）和 **server**（全栈服务 → 容器）。

| 项目类型 | 部署模式 | 命令 | |---|---|---| | 单 HTML、多 HTML、前端 SPA | static | `meoo deploy` | | 前端 + Supabase + Edge Functions | 静态部署 | `meoo deploy` | | 含后端进程（Express、FastAPI、Next.js SSR、Go 等） | server | `meoo deploy` |

**先分流，不强制迁移**：`meoo init react-design` 等标准静态模板及已有非 Mise 项目保留原 Push/Deploy 链路，不需要添加 `mise.toml`。新全栈模板已自带 Mise 配置；已标记 Mise 的云端项目或显式包含 `mise.toml` 的工程才执行 Mise 校验。首次接入的外部 Web 工程先读取 `references/mise-import.md`，由 Agent 做最小适配；不要仅凭 React 依赖或包名判断来源。CLI 不会自动改造业务源码。

Install

npm install -g @aliyun-meoo/cli

Verify: `meoo --version`

**版本兼容**：GitHub Skill 更新不代表 npm 已发布对应 CLI。标准 React 免 Mise、新全栈模板自带协议和增强失败诊断，需使用包含这些修复的 CLI。先升级并核对实际版本、模板和命令输出；若最新可安装版本仍不包含修复，报告版本限制并等待发布，不要为绕过旧版 CLI 的校验而强制迁移标准 React，也不要把未发布的能力当成已可用。

Project lifecycle

Static deploy (SPA)

meoo login                      # 1. Authenticate (opens browser)
meoo init react-design          # 2. Initialize from template
meoo projects create "My App"   # 3. Create remote project and bind this directory
pnpm install                    # 4. Install dependencies
pnpm dev                        # 5. Local dev server (port 3015)
meoo deploy                     # 6. Build and publish to CDN

`init` 和项目绑定最终都必须完成，但顺序可以互换：既可以先 `init` 再 `projects create/use`，也可以在纯空目录先执行 `projects use`，随后 `init`。CLI 会在模板落盘后重新协调云环境与官方模板源码。

Server deploy (full-stack)

meoo login                      # 1. Authenticate
meoo init nextjs-app            # 2. Initialize from template (or bring your own project)
meoo projects create "My App"   # 3. Create project and bind to current directory
# ... develop your app locally ...
meoo deploy                     # 4. Upload, build remotely, deploy to container

`meoo init nextjs-app`、`nuxt-app`、`python-app`、`go-app`、`java-app` 已包含完整 `mise.toml` 和对应 Agent 指引，无需手工改配置即可 Push/Deploy。已有非 Mise 全栈工程保留旧 runtime 和发布方式，不强制迁移；要接入新预览时再按 `references/mise-import.md` 适配。不要把未验证的老工程预览报告为成功。

旧全栈工程接入 Mise 时，发布前必须逐项执行 `references/mise-import.md` 的“旧全栈迁移检查表”：Mise 构建不会自动执行项目 Dockerfile，不能只补 dev/start 就发布。保留原依赖安装、环境默认值、资源文件和解释器语义，在干净环境验证预览和生产启动；不要影响没有选择 Mise 的标准 React 老项目。

Common steps (both modes)

**Cloud services are OPTIONAL** — only enable when the project needs database, user auth, or file storage:

meoo cloud enable               # Provision cloud services (PostgreSQL + Auth + Storage)
meoo cloud pull-env             # Pull Supabase keys to local .env

Do NOT run `meoo cloud enable` for purely frontend projects (static sites, CSS demos, calculators, etc.).

Cloud services are independent of deploy mode — see `references/cloud-patterns.md` for calling patterns.

Run `meoo info` or `meoo --json info` anytime to check environment constraints.

Publishing & deployment targets

Meoo has three deployment targets. Understanding them prevents common confusion.

• **Sandbox（沙箱）**：秒悟应用内的测试运行环境。标准 React 沿用平台原有 dev server；Mise 项目由 `mise run dev` 在 3015 提供预览。两者都支持 `meoo sandbox push` 和 Deploy 附带同步。
• **CDN（公网静态）**：static 模式专属。标准静态项目发布 dist/build/out，Mise 项目发布 `output` 声明的产物。
• **FC 容器（公网服务）**：server 模式专属。通过 `meoo deploy` 将源码上传到远程构建机，按 Mise 构建并部署到函数计算容器。

| | Sandbox（沙箱） | CDN（静态部署） | FC 容器（镜像部署） | |---|---|---|---| | 用途 | 秒悟应用内预览、调试、协作 | 公网正式访问（静态） | 公网正式访问（全栈） | | 更新方式 | `meoo sandbox push` 或 `meoo deploy` | `meoo deploy` | `meoo deploy` | | 访问入口 | `meoo.com/chat/<projectId>` | `<id>.meoo.fun` | `<id>.meoo.fun` |

**`meoo deploy` 流程**：先按项目实际策略分流，仅 Mise 项目做 Mise 前置校验；默认尝试同步 Sandbox，再执行正式发布。Sandbox 同步失败必须告知用户，但不影响正式发布结果；静态项目会回退到本地产物 CDN 发布。

静态云服务项目同步成功后，从已确认的 Sandbox Git HEAD 构建并发布；DUAL 环境随后同步生产云服务。默认同步云函数，不同步 Auth 与定时任务。`--skip-push` 只跳过 Sandbox 并走本地产物发布；`--skip-build` 使用已有 Mise output；`--no-dev` 同步源码但不触发预览重启。不要把 Sandbox 未更新或预览为空报告为完整成功。

静态项目若要在秒悟应用内预览或协作，源码必须通过 `meoo sandbox push` 或 `meoo deploy`（不加 `--skip-push`）同步到沙箱。新全栈模板由 Mise server 模式决定正式发布，并由同一次 `meoo deploy` 尝试同步 Sandbox；已有非 Mise 全栈项目保留原 image 发布方式。

Migrating an existing project

已有标准模板和非 Mise 项目不要重建脚手架，也不要为了正常 Push/Deploy 增加 Mise。首次接入的外部单/多 HTML、SPA 或全栈工程才先读 `references/mise-import.md`，保留技术栈并做最小运行适配；静态细节见 `references/static-deploy.md`，服务端细节见 `references/image-deploy.md`。

---

Platform constraints

Constraints differ by deploy mode. **Read the relevant reference before starting any project work:**

• **Mise 项目及首次接入的外部 Web 工程**：先读 `references/mise-import.md`；标准模板和已有非 Mise 项目不强制迁移。
• **Static deploy**：再读 `references/static-deploy.md`。
• **Server deploy**：再读 `references/image-deploy.md`。

---

CLI command reference

All commands support `--json` for structured output. Run `meoo <command> --help` for details.

Authentication & Account

meoo login                         # Browser-based login (recommended, opens browser for authorization)
meoo login --ak <key>              # Login with API Key (for CI/CD or manual setup)
meoo logout                        # Clear credentials
meoo whoami                        # Current user info + plan tier
meoo account                       # Full account info: plan, benefits, credits

`meoo login` (without `--ak`) opens the browser for one-click authorization. The server auto-creates an API Key and the CLI saves it locally. For CI/CD environments, use `--ak` or set `MEOO_API_KEY` / `MEOO_API_URL` environment variables.

`meoo account` shows your plan tier (FREE/PRO/MAX), credit balance (available, granted, consumed), and detailed benefit quotas (cloud instances, storage, projects, etc.).

Project management

Project binding is **per-directory** — each project directory has