Menu
负责云操作：云环境、云函数、云数据库、云存储。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | cloudbase-operator |
| description | 负责云操作：云环境、云函数、云数据库、云存储。 |
处理与小程序云开发云资源相关的所有操作。
典型任务：
cloud_db_*、cloud_stor_*）必须传 appid 和 env，不再要求项目本地路径。env 必须是云开发环境 ID；不明确时先用 cloud_env_list，不要猜测或自动选择候选环境。列出小程序可用云环境。
wechatide -c <clientName> -t cloud_env_list --project <project>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project | string | 否 | 项目本地绝对路径 |
appid | string | 否 | 小程序 AppID |
列出目标云环境下的云函数。
wechatide -c <clientName> -t cloud_fn_list --appid <appid> --env <envId>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
env | string | 是 | 云环境 ID |
appid | string | 是 | 小程序 AppID |
查询目标云函数的状态、超时和运行时信息。
wechatide -c <clientName> -t cloud_fn_info --appid <appid> --env <envId> --names fnName
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
env | string | 是 | 云环境 ID |
names | string | 是 | 云函数名称（逗号分隔） |
appid | string | 是 | 小程序 AppID |
完整部署一个或多个云函数。
固定使用 appid + paths 组合：paths 指向云函数目录，函数目录名即函数名称。
wechatide -c <clientName> -t cloud_fn_deploy --appid <appid> --env <envId> --paths <cloudFunctionDir> --remote-npm-install
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
env | string | 是 | 云环境 ID |
appid | string | 是 | 小程序 AppID |
paths | string | 是 | 云函数目录本地绝对路径（逗号分隔多个） |
remote-npm-install | boolean | 否 | 是否远程安装 npm 依赖（推荐 true） |
按云函数目录和变更文件或目录做增量部署。
wechatide -c <clientName> -t cloud_fn_inc_deploy --appid <appid> --env <envId> --path <cloudFunctionDir> --file index.js
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
appid | string | 是 | 小程序 AppID |
env | string | 是 | 云环境 ID |
path | string | 是 | 云函数目录本地绝对路径，目录名即云函数名称 |
file | string | 是 | 变更文件或目录路径，必须相对云函数目录 |
只读查询 NoSQL 集合与索引结构。
wechatide -c <clientName> -t cloud_db_read_struct --appid <appid> --env <envId> --action listCollections
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
appid | string | 是 | 小程序 AppID |
env | string | 是 | 云开发环境 ID |
action | string | 是 | listCollections / describeCollection / checkCollection / listIndexes / checkIndex |
collectionName | string | 否 | 集合名称；查询集合详情或索引时使用 |
indexName | string | 否 | 索引名称；checkIndex 时使用 |
limit | number | 否 | 返回数量限制 |
offset | number | 否 | 分页偏移 |
创建或删除集合，管理集合索引。写操作，必须经过用户确认。
wechatide -c <clientName> -t cloud_db_write_struct \
--appid <appid> --env <envId> \
--action createCollection --collection-name <collection>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
appid | string | 是 | 小程序 AppID |
env | string | 是 | 云开发环境 ID |
action | string | 是 | createCollection / updateCollection / deleteCollection |
collectionName | string | 是 | 集合名称 |
updateOptions | object | 否 | updateCollection 使用；CreateIndexes 添加索引，DropIndexes 删除索引 |
只读查询集合文档，支持条件、投影、排序和分页。
wechatide -c <clientName> -t cloud_db_read_doc --appid <appid> --env <envId> --collection-name <collection> --query-file ./query.json --projection-file ./projection.json --sort-file ./sort.json --limit 10 --offset 0
JSON 文件用途：
query.json：查询条件，用来筛选要读取的文档；不传则查询集合内文档。projection.json：字段投影，用来控制返回哪些字段。sort.json：排序规则，按字段升序或降序排列结果。query.json 示例：
{ "field": "value" }
projection.json 示例：
{ "field": 1, "_id": 1 }
sort.json 示例：
[{ "key": "createdAt", "direction": -1 }]
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
appid | string | 是 | 小程序 AppID |
env | string | 是 | 云开发环境 ID |
collectionName | string | 是 | 集合名称 |
query | object | 否 | 查询条件对象 |
projection | object | 否 | 返回字段投影 |
sort | array | 否 | 排序条件 |
limit | number | 否 | 返回数量限制 |
offset | number | 否 | 跳过记录数 |
插入、更新或删除集合文档。写操作，必须经过用户确认。
# 插入文档：documents 是要插入的文档数组
wechatide -c <clientName> -t cloud_db_write_doc --appid <appid> --env <envId> --action insert --collection-name <collection> --documents-file ./documents.json
# 更新文档：query 负责找文档，update 负责描述怎么改
wechatide -c <clientName> -t cloud_db_write_doc --appid <appid> --env <envId> --action update --collection-name <collection> --query-file ./query.json --update-file ./update.json
# 删除文档：query 负责找要删除的文档
wechatide -c <clientName> -t cloud_db_write_doc --appid <appid> --env <envId> --action delete --collection-name <collection> --query-file ./query.json
JSON 文件用途：
documents.json：insert 使用，必须是数组，每一项是一条要插入的文档。query.json：update / delete 使用，用来筛选要修改或删除的文档。update.json：update 使用，只描述更新动作，不写查询条件；推荐使用 $set / $inc / $unset 等操作符。documents.json 示例：
[{ "field": "value", "count": 1 }]
query.json 示例：
{ "_id": "<docId>" }
update.json 示例：
{ "$set": { "field": "newValue" } }
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
appid | string | 是 | 小程序 AppID |
env | string | 是 | 云开发环境 ID |
action | string | 是 | insert / update / delete |
collectionName | string | 是 | 集合名称 |
documents | array | 否 | insert 操作的文档数组 |
query | object | 否 | update / delete 操作的查询条件 |
update | object | 否 | update 操作的更新内容，推荐使用 $set / $inc / $unset 等操作符 |
isMulti | boolean | 否 | 是否更新或删除多条记录 |
upsert | boolean | 否 | 更新时不存在则插入 |
只读查询云存储文件列表、文件信息、临时下载链接或文本内容。
wechatide -c <clientName> -t cloud_stor_read --appid <appid> --env <envId> --action list --cloud-path <cloudPath>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
appid | string | 是 | 小程序 AppID |
env | string | 是 | 云开发环境 ID |
action | string | 是 | list / info / url / read |
cloudPath | string | 是 | 云端文件路径，例如 files/data.txt 或 files/ |
maxAge | number | 否 | 临时链接有效期（秒），默认 3600 |
返回提醒：
action=url 返回的是 temporaryUrl，按 expireTime 过期，不是永久公开地址。publicUrl 和 note。上传、下载或删除云存储文件。upload / delete 是写操作，必须经过用户确认；download 不触发确认。
wechatide -c <clientName> -t cloud_stor_write --appid <appid> --env <envId> --action upload --cloud-path <cloudPath> --local-path <localPath>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
appid | string | 是 | 小程序 AppID |
env | string | 是 | 云开发环境 ID |
action | string | 是 | upload / download / delete |
cloudPath | string | 是 | 云端文件路径，例如 files/data.txt |
localPath | string | 否 | 本地文件路径；upload / download 时必需 |
force | boolean | 否 | delete 时建议传 true |
isDirectory | boolean | 否 | 是否按目录操作 |
返回提醒：
upload 成功后可能返回 temporaryUrl、expireTime 和 storageCdnDomain。publicUrl 和 note。cloudPath 范围；不要用空路径或过宽前缀做删除。| 用户意图 | 选择 |
|---|---|
| "先看看有哪些环境" | cloud_env_list |
| "当前有哪些云环境候选" | cloud_env_list |
| "把函数列表给我" | cloud_fn_list |
| "查一下这个函数的状态" | cloud_fn_info |
| "把这个函数部署上去" | cloud_fn_deploy（用 appid + paths） |
| "只改了一个文件或目录，增量部署" | cloud_fn_inc_deploy |
| "有哪些数据库集合" | cloud_db_read_struct |
| "创建集合 / 改索引" | cloud_db_write_struct |
| "查询集合里的数据" | cloud_db_read_doc |
| "插入 / 更新 / 删除文档" | cloud_db_write_doc |
| "列出云存储文件" | cloud_stor_read（action=list） |
| "获取云存储临时下载链接" | cloud_stor_read（action=url） |
| "读取云存储文本内容" | cloud_stor_read（action=read） |
| "上传 / 删除云存储文件" | cloud_stor_write |
| "下载云存储文件到本地" | cloud_stor_write（action=download，无需确认） |
cloud_env_listappid + paths 组合，明确传入云函数目录的本地绝对路径appid + path 组合，file 必须是相对该云函数目录的文件或目录路径appid 和 env；先用 cloud_env_list 获取环境 ID$set / $inc / $unset 等操作符appid 和 env；先用 cloud_env_list 获取环境 IDforce=truecloud_stor_read 的 action=url 和 cloud_stor_write 的 upload 返回临时签名链接，不可当作永久公开 URLpublicUrl 和 note；不要基于这两个字段编写后续流程cloud_db_read_struct：读取集合、集合详情、索引列表。cloud_db_write_struct：创建 / 删除集合、添加 / 删除索引（写操作，需用户确认）。cloud_db_read_doc：查询集合文档，支持条件、投影、排序、分页。cloud_db_write_doc：插入、更新、删除文档（写操作，需用户确认）。cloud_stor_read：列出文件、获取文件信息、临时下载链接、读取文本内容。cloud_stor_write：上传、下载、删除云存储文件；upload/delete 需用户确认，delete 还需 force=true。appid + paths 组合--is-directory 并确认范围cloud://<envid>.<bucketid>/xxx/ 拼接 FileId，其中 xxx/ 是资源路径。微信开发者工具 任务执行的根入口。用于在执行前先完成环境检查，再路由到预览、自动化、调试与云相关操作。
负责页面操作：点击、输入、滚动、截图、验证。
负责编译：项目编译、单文件编译、编译到指定页面、构建 npm、刷新模拟器。
负责排查：查日志、查运行时、定位问题原因，也包括模拟器相关的状态检查与刷新。
初始化 微信开发者工具 开发环境与基础信息。用于项目窗口打开或接管、登录信息获取、AppID 信息获取以及运行时上下文读取。
负责预览和发布：推送手机预览、生成预览码、真机预览、上传代码包。