用途:在开发 Web 前端页面、部署静态托管、集成 CloudBase Web SDK(数据库、云函数、认证)时使用,也适用于搭建 Vite、Webpack 等现代前端构建系统与静态托管路由、构建配置。小程序开发和后端服务开发不适用(分别使用 miniprogram-development、cloudrun-development),纯 UI 设计应使用 ui-design 技能,可与本技能组合。
主要能力与约定:源码放在 src 目录,构建产物在 dist 目录,云函数在 cloudfunctions 目录;使用 Vite 等现代构建系统,通过 npm 安装依赖;涉及路由时默认使用 hash 路由,以解决静态托管刷新 404 问题。使用 SDK 时通过 @cloudbase/js-sdk@latest 引入,认证必须使用 SDK 内置能力(短信登录、匿名登录、自定义登录等),禁止用云函数实现登录逻辑;环境 ID 可通过 envQuery 工具查询。初始化应使用同步方式,不懒加载 SDK,不把初始化包进异步缓存,应用内保持单个共享的 app/auth 实例,且只调用官方文档中已有的方法。
使用方式:先执行 npm install 再按项目文档构建;本地预览可进入输出目录使用 npx live-server。publicPath 等配置应使用相对路径而非绝对路径,以适配静态托管 CDN。部署前先本地预览,再与用户确认是否部署到 CloudBase 静态托管;用户未特别要求时一般不直接部署到根目录,可部署到子目录,并以 markdown 链接返回部署地址。所有认证操作需包含完整错误处理,登录后可通过 auth.getCurrentUser() 获取用户信息并存入数据库。
限制:资料未提供具体收费、价格或效果数据。