用途：面向浏览器或 Web 应用，通过 @cloudbase/js-sdk 操作 CloudBase 云存储对象，包括上传、下载、生成临时 URL、删除文件等。不适用于小程序文件 API、后端或 MCP 直连存储管理、静态网站托管部署及数据库操作。
主要能力：app.uploadFile() 上传（cloudPath 需含文件名，可用 / 建目录，支持 onUploadProgress 进度）；app.getTempFileURL() 生成临时预览/下载链接（maxAge 控制有效期）；app.deleteFile() 删除；app.downloadFile() 触发浏览器下载。PG/pgstore 模式改用 app.storage.from('bucket').upload(key,file) 与 createSignedUrl(path,expiresIn)，公开桶可用 getPublicUrl。
使用方式：用 cloudbase.init({env, accessKey}) 同步初始化并共享实例，accessKey 通过 queryAppAuth/manageAppAuth 获取 publishable key 后写入 .env.local 的 VITE_PUBLISHABLE_KEY，禁止硬编码。上传前须确认存储桶已存在；本地开发需用 queryEnv(action="domains") 检查安全域名，并用 envDomainManagement(action="create") 添加实际 host:port，变更可能需数分钟生效。PG 模式还需通过 managePgDatabase 配置 storage.objects 的 RLS 策略，否则报 STORAGE_PERMISSION_DENIED。
限制与注意：临时 URL 非永久链接；STORAGE_NOT_EXIST 表示桶未就绪，不应伪造 URL；PG 模式旧 NoSQL 桶不算有效 pgstore 桶，缺失桶会报 STORAGE_BUCKET_NOT_FOUND 并出现 PUT https://undefined/；上传失败须让上层流程一并失败，不得用占位 URL 继续写库或提示成功。建议规范目录、上传前校验类型与大小、及时清理无用文件，批量管理任务交由后端或 MCP 处理。