cloudbase-operator

name	cloudbase-operator
description	小程序/小游戏云开发操作：云环境、云函数部署、云数据库、云存储。 用户提到云环境、云函数、集合/文档、云存储上传下载时使用。

cloudbase-operator

用途

云资源查询与变更。env 不明确时先 cloud_env_list，禁止自动选环境。

通用约束

• 云数据库 / 云存储工具必须显式传 appid + env（不再要求本地 project 路径）
• 写操作走确认门；用户拒绝或超时后不要重试破坏性操作
• 临时下载链接仅用于当前任务，勿写入代码或长期文档

意图 → 工具

意图	工具
列环境	cloud_env_list（优先 --appid；本地工程已有时也可用 --project）
列/查云函数	cloud_fn_list / cloud_fn_info
完整部署	cloud_fn_deploy（appid + env + 函数目录 path）
增量部署	cloud_fn_inc_deploy（另需相对函数目录的 file）
库结构读/写	cloud_db_read_struct / cloud_db_write_struct
文档读/写	cloud_db_read_doc / cloud_db_write_doc
存储读	cloud_query_storage（list/info/url/read）
存储写	cloud_manage_storage（upload/download/delete；upload/delete 需确认，delete 建议 force=true）

wechatide -c <clientName> cloud_env_list --appid <appid>
wechatide -c <clientName> cloud_fn_deploy --appid <appid> --env <envId> --path <cloudFunctionDir> --remote-npm-install
wechatide -c <clientName> cloud_fn_inc_deploy --appid <appid> --env <envId> --path <cloudFunctionDir> --file index.js
wechatide -c <clientName> cloud_db_read_doc --appid <appid> --env <envId> --collection-name <collection> --query-file ./query.json
wechatide -c <clientName> cloud_query_storage --appid <appid> --env <envId> --action list --cloud-path <cloudPath>

复杂 JSON 参数用 --*-file。更新文档优先 $set/$inc/$unset。完整参数见 --help。

边界

• 部署固定 appid + path；目录名即函数名
• cloud_query_storage 的 url 与 upload 返回的临时链接不是永久 URL；勿依赖返回里的 publicUrl/note
• 删除存储目录须明确 cloudPath 范围并传 --is-directory
• 部分成功时保留真实返回结构

失败快表

情况	处理
env 不明 / 多环境	cloud_env_list 后让用户选；禁止自动挑
环境未开通 / 无权限	说明需公众平台开通或换有权限账号；勿死循环部署
User denied / 确认超时	停住；不要重试写操作
--project 相关错误	project-tool-error-guide.md
部署/写库部分成功	原样保留返回结构，说明已成功与失败项

移交

目标	还需
project-config	需改 cloudfunctionRoot 等本地配置时
debugger	云调用失败且要对照小程序侧日志时：project + 现象
结束	appid、env、已做读写操作摘要

备注

小程序/小游戏侧 FileId 形如 cloud://<envid>.<bucketid>/xxx/。