cloudbase-init

初始化 CloudBase 项目

为新项目下载 CloudBase 模板、配置环境 ID、生成 cloudbaserc.json，并按场景类型给出后续指引。适合从零开始的项目。

Preflight

运行以下检查，失败时停止并给出可执行指引。

1. MCP 连接检查 — 确认 cloudbase-mcp server 已连接。

   • 调用 queryEnv({action:"list"}) 验证连接。若失败，提示用户完成授权。

2. 目录空检查 — 检查当前工作目录是否为空（或仅包含 .git 等无关文件）。

   • 若目录非空：提示用户当前目录已有文件，模板可能覆盖现有文件。询问是否切换到新目录或继续。
   • 推荐做法：创建新子目录（如 mkdir my-cloudbase-app && cd my-cloudbase-app）。

3. 场景选择 — 使用 AskUserQuestion 工具让用户选择项目场景：

   场景	模板类型	说明
   Web 项目	web	React/Vue/原生 JS 前端项目，使用静态托管
   微信小程序	miniprogram	小程序云开发项目，使用云函数 + 数据库
   云托管	cloudrun	CloudBase Run 后端服务，支持 Java/Go/Python/Node.js 等

4. 环境选择 — 若用户有多个环境，调用 queryEnv({action:"list"}) 让用户选择目标环境，用于后续 cloudbaserc.json 配置。

Plan

根据用户选择的场景执行：

1. 下载模板 — 调用 downloadTemplate 下载对应场景的项目模板。
2. 复制文件 — 将模板内容复制到当前目录（含隐藏文件，如 .gitignore、.env.example）。
3. 生成配置 — 使用 queryEnv 获取的 EnvId 生成 cloudbaserc.json。
4. 小程序场景 — 检查 project.config.json 的 appid 字段，缺失则询问用户。
5. 生成 README — 生成包含项目结构、CloudBase 资源说明的 README.md。

无破坏性操作（仅创建文件，不修改已有项目），但目录非空时需确认覆盖风险。

Commands

1. 下载模板

根据用户选择的场景调用模板下载：

downloadTemplate({
  templateName: "<scenario-template-name>"
})

模板类型映射：

• Web 项目 → 对应 web 模板名
• 微信小程序 → 对应 miniprogram 模板名
• 云托管 → 对应 cloudrun 模板名

下载完成后，将模板文件复制到当前目录。注意包含隐藏文件（如 .gitignore、.env.example、.editorconfig 等），这些文件对项目正常运行至关重要。

复制脚本示例（当 downloadTemplate 下载到临时目录时）：

# 复制所有文件，包括隐藏文件
cp -a /tmp/template/. ./

2. 生成 cloudbaserc.json

使用 queryEnv({action:"info"}) 获取的 EnvId 生成配置文件：

{
  "envId": "<当前环境 ID>",
  "functionRoot": "cloudfunctions",
  "framework": "<框架名>",
  "version": "1.0.0"
}

• envId — 自动填入查询到的环境 ID，无需用户手动替换
• functionRoot — 云函数目录路径（小程序/云托管场景）
• framework — 根据模板类型自动设置

3. 小程序场景检查

若场景为微信小程序，检查 project.config.json 中的 appid 字段：

# 检查 appid 是否已配置
node -e "const c = require('./project.config.json'); console.log(c.appid || 'MISSING')"