---
name: meoo-cli-setup
description: 秒悟（Meoo）CLI 技能安装引导 — 安装后可在本地 AI 编程助手中使用秒悟平台的全部能力
---

# 秒悟（Meoo）— 技能安装

秒悟是全栈应用构建平台，支持前端 SPA（React/Vue）+ Supabase（数据库/Auth/Storage）+ Deno 边缘函数 + AI 大模型服务。

本文件引导你安装秒悟技能文件。安装完成后，技能将在每次对话中自动加载，你将获得从项目初始化到生产部署的完整能力。

## 技能文件清单

| 文件 | 地址 | 说明 |
|------|------|------|
| **skill-setup.md**（本文件） | `https://meoo.com/skill-setup.md` | 安装引导 |
| **SKILL.md** | `https://meoo.com/skill/SKILL.md` | 完整 CLI 操作指南 |
| **cloud-patterns.md** | `https://meoo.com/skill/references/cloud-patterns.md` | 云服务代码模式（Supabase / Edge Function / AI） |
| **auth-verification.md** | `https://meoo.com/skill/references/auth-verification.md` | 邮箱/短信验证码 + 密码认证 |
| **migration.md** | `https://meoo.com/skill/references/migration.md` | 已有项目迁移指南 |
| **templates.md** | `https://meoo.com/skill/references/templates.md` | 模板约束详情 |

---

## 环境依赖

使用秒悟 CLI 前，请确保以下依赖已安装。

### 1. Node.js（≥ 20.19）

默认模板（react-design）使用 Vite 7，要求 Node.js ≥ 20.19。

```bash
node -v   # 检查是否已安装，需 >= v20.19.0
```

如未安装，推荐使用 nvm 管理版本：

```bash
# 安装 nvm（如已有可跳过）
# 国内用户使用 gitee 镜像，速度更快：
curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash
# 或使用官方源（需科学上网）：
# curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 安装并使用 Node 20（LTS）
nvm install 20
nvm use 20
```

也可从 Node.js 中文网下载安装包：https://nodejs.cn/

### 2. 包管理器

秒悟项目默认使用 **pnpm**（推荐）。如未安装：

```bash
npm install -g pnpm
```

### 3. npm 镜像源配置（国内用户推荐）

如果 `npm install` / `pnpm install` 下载缓慢，可切换为国内镜像源：

```bash
# 方式一：使用 nrm 切换（推荐）
npm install -g nrm
nrm use taobao

# 方式二：直接设置 registry
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry
# 应输出: https://registry.npmmirror.com
```

> 如果仍无法下载，也可以尝试使用 cnpm：`npm install -g cnpm --registry=https://registry.npmmirror.com`

### 4. 其他工具

| 工具 | 用途 | 检查命令 |
|------|------|----------|
| **git** | 版本控制、代码推送 | `git --version` |
| **zip** | `meoo deploy` 打包构建产物 | `zip --version` |
| **curl** | 手动安装技能文件 | `curl --version` |

macOS 用户通常已自带以上工具。Linux 用户如缺少可通过系统包管理器安装（`apt install git zip curl` 或 `yum install git zip curl`）。

---

## 安装方法

### 方法 1: meoo CLI 安装（推荐）

如果已安装 meoo CLI，一条命令即可完成：

```bash
meoo skill install
```

CLI 会自动检测本机已安装的 AI 编程工具并安装到对应目录。如果检测到多个工具，会询问用户安装到哪些。也可以用 `--target` 手动指定：

```bash
meoo skill install --target ~/.your-tool/skills/meoo-cli
```

如果尚未安装 CLI：

```bash
npm install -g @aliyun-meoo/cli
meoo skill install
```

### 方法 2: 手动下载安装

适用于任何 AI 编程助手环境。

**重要：你必须先确认用户当前使用的 AI 编程工具，再决定安装路径。** 不要假设用户使用某个特定工具。如果用户本机存在多个工具的配置目录，必须安装到用户**当前正在使用的**那个工具的目录下。

常见工具的 skills / rules 目录参考（不限于此列表）：

| 工具 | 目录 |
|------|------|
| Claude Code | `~/.claude/skills/` |
| Cursor | `~/.cursor/skills/` |
| Trae | `~/.trae/skills/` |
| CodeBuddy | `~/.codebuddy/skills/` |
| Qoder | `~/.qoder/skills/` |

如果用户使用的工具不在上表中，请询问用户确认其 skills 目录路径。

确定 `SKILLS_DIR` 后执行：

```bash
mkdir -p $SKILLS_DIR/meoo-cli/references
curl -sL https://meoo.com/skill/SKILL.md -o $SKILLS_DIR/meoo-cli/SKILL.md
curl -sL https://meoo.com/skill/references/cloud-patterns.md -o $SKILLS_DIR/meoo-cli/references/cloud-patterns.md
curl -sL https://meoo.com/skill/references/auth-verification.md -o $SKILLS_DIR/meoo-cli/references/auth-verification.md
curl -sL https://meoo.com/skill/references/migration.md -o $SKILLS_DIR/meoo-cli/references/migration.md
curl -sL https://meoo.com/skill/references/templates.md -o $SKILLS_DIR/meoo-cli/references/templates.md
```

---

## 验证安装

安装完成后，开启一个新的对话，输入"秒悟"或"meoo"。如果 AI 能识别并提供秒悟平台相关帮助，说明安装成功。

## 快速开始

安装技能后，典型的项目创建流程：

```bash
meoo login                      # 登录
meoo init react-design          # 初始化项目
meoo projects create "My App"   # 创建远程项目
pnpm install                    # 安装依赖
pnpm dev                        # 启动本地开发
meoo deploy                     # 构建并发布
```

需要数据库、用户认证或文件存储时，再开通云服务：

```bash
meoo cloud enable               # 开通云服务（按需）
meoo cloud pull-env             # 拉取环境变量
```