cloudbase-deploy

部署 CloudBase 资源

将当前项目的云函数、静态托管或云托管服务部署到 CloudBase 环境。包含项目类型自动检测、生产环境门控确认和部署后验证。

Preflight

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

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

   • 调用 queryEnv({action:"info"}) 验证连接和登录状态。若失败，提示用户完成授权。

2. 环境选择 — 确认当前操作的 EnvId（CLOUDBASE_ENV_ID 或会话中已选定）。若未设置，先调用 queryEnv({action:"list"}) 让用户选择。

3. 项目类型检测 — 扫描当前目录结构，判断部署目标：

   目录/文件标记	部署目标	说明
   cloudfunctions/ 目录存在	function	云函数项目，目录下每个子目录为一个云函数
   dist/ 或 public/ 或 build/ 存在	hosting	静态托管项目，需先构建再部署
   Dockerfile 存在	cloudrun	云托管项目，基于容器镜像部署
   project.config.json 存在	小程序	提示使用微信开发者工具上传，非 MCP 部署

   若 "$ARGUMENTS" 指定了子命令（function/hosting/cloudrun），以参数为准；否则根据检测结果提示用户确认。

4. Git 状态检查 — 运行 git status --porcelain。

   • 若输出非空：提示用户未提交的改动不会进入部署产物（MCP 直接读取本地文件，不经过 git）。询问是否先提交再部署。
   • 若非 git 仓库，跳过此检查。

5. 构建产物检查（hosting 部署时）— 检测 dist/、public/、build/ 是否存在且非空。

   • 若不存在：提示用户先运行构建命令（npm run build / pnpm build 等）。

Plan

根据项目类型确定部署策略：

子命令	MCP 工具	说明
function	manageFunctions({action:"deploy", ...})	部署 cloudfunctions/ 目录下的云函数
hosting	manageHosting({action:"uploadFiles", ...})	上传静态文件到静态托管
cloudrun	manageCloudRun({action:"deploy", ...})	部署云托管服务

生产环境门控：

若当前 EnvId 为生产环境（通过 queryEnv({action:"info"}) 的 Alias 或 Source 判断，或用户明确声明），必须获得显式确认：

⚠️ 生产环境部署请求。 当前环境 <EnvId>（<Alias>）为生产环境，此次部署将影响线上服务。 请用户明确回复 "yes" 确认部署。 未获确认前不得执行。

Commands

function — 云函数部署

将 cloudfunctions/ 目录下的云函数部署到 CloudBase：

manageFunctions({
  action: "deploy",
  functionRootPath: "<cloudfunctions 目录的绝对路径>",
  envId: "<current-env-id>"
})

• functionRootPath 指向云函数目录的父目录（例如 cloudfunctions 目录的绝对路径）
• 工具会自动读取 functionRootPath 下每个同名子目录的文件并部署
• 无需手动压缩代码，工具自动处理

部署后，若需要更新单个函数代码：

manageFunctions({
  action: "updateFunctionCode",
  functionName: "<function-name>",
  functionRootPath: "<path-to-single-function-dir>",
  envId: "<current-env-id>"
})