用途：围绕单一工作目录管理 CloudBase Web 应用，覆盖创建、预览、保存版本、部署与回滚，面向 Vite + React/Vue 项目。
主要能力：由三层组成。CloudBase MCP 工具负责产生 CloudBase 侧效果，如 downloadTemplate（下载 react/vue 模板）、queryEnv 与 auth 绑定环境、manageApps 部署到 CloudApp（独立子域名）、envDomainManagement 配置 CORS，以及通过 searchKnowledgeBase 按需获取 CloudBase 领域技能。cloudbase-sites CLI 负责开发服务器与版本部署流程，提供的命令包括：cloudbase-sites init --start、preview（可加 --status/--restart/--stop）、save -m "<label>"、versions、deploy（含 --post 记录阶段）、rollback [--to-version <n>] 以及 supervisor 系列。标准工具（Bash、git、Edit、Write）用于编辑文件。
使用方式：先解析 CLI 路径，可用 command -v cloudbase-sites，或使用 $CODEX_PLUGIN_ROOT/bin/cloudbase-sites、$CLAUDE_PLUGIN_ROOT/bin/cloudbase-sites。空目录明确要建应用时运行 init --start；已有 Vite 项目可运行 preview 启动预览，并通过 preview.json 或 preview --status 获取内部 URL（端口范围为 17173..17272，不要猜测 5173）。保存与部署分两阶段：save 创建 git 检查点，deploy 本地构建 dist 后桥接 manageApps，再用 deploy --post 记录访问 URL 与构建信息。回滚使用 rollback。
适用与限制：仅适用于基于 Vite 的 React/Vue Web 应用；Next/Nuxt/Astro/Remix、小程序、原生 App、纯后端项目应改用其他指引。CLI 命令的首行 stdout 为 JSON，须按 JSON 解析，错误时向用户展示 logPath。新功能 UI 需先获取 ui-design 规范；数据持久化前需 queryEnv 判断 PostgreSQL 或文档数据库后端；不要自行运行 npm run dev / vite / vite build，生命周期由 CLI 与钩子管理。图标使用预装的 lucide-react。VITE_PUBLISHABLE_KEY 应自动获取并写入 .env.local。