القائمة
小程序/小游戏云开发操作：云环境、云函数部署、云数据库、云存储。 用户提到云环境、云函数、集合/文档、云存储上传下载时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
微信开发者工具任务根入口。先完成环境与登录检查，再路由到创建项目、初始化、项目管理、项目配置、 编译、预览、页面自动化、调试或云开发操作。适用于小程序与小游戏。用户提到微信开发者工具、 小程序/小游戏模拟器、新建项目、预览上传、自动化点击、console/network、云函数/云数据库时使用。
小程序/小游戏页面自动化：点击、输入、滚动、导航、断言、生成 automator 脚本。 用户要点按钮、填表、页面验证、自动化测试时使用。不负责 console/network 深度排查。
小程序/小游戏编译与模拟器刷新：打开指定页面、编译 WXML/WXSS、构建 npm、刷新模拟器。 小游戏以刷新模拟器与构建 npm 为主；单文件 WXML/WXSS 编译仅小程序页面适用。 用户说编译一下、跳到某页看效果、构建 npm、模拟器没刷新时使用。
排查小程序/小游戏运行问题：console/network 日志、模拟器截图、运行时状态、wx API 诊断、清缓存。 用户提到报错日志、接口失败、截图取证、模拟器卡住时使用。
初始化微信开发者工具环境：打开/关闭项目窗口、扫码登录、获取 AppID、读取运行时上下文。 用户说打开项目、接管项目、登录、有哪些 AppID、退出开发者工具时使用。不负责自动化、预览或云操作。
小程序/小游戏预览与发布：自动推送手机预览、生成预览二维码、上传体验版。 用户说预览、发到手机、扫码预览、上传代码、发布体验版时使用。
| name | cloudbase-operator |
| description | 小程序/小游戏云开发操作：云环境、云函数部署、云数据库、云存储。 用户提到云环境、云函数、集合/文档、云存储上传下载时使用。 |
云资源查询与变更。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/notecloudPath 范围并传 --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/。