技能介绍

要解决什么问题

你在浏览器、Node、各类小程序或 Electron 里接 Bmob 云数据库时，最容易踩坑的是：混用两代 SDK（旧 bmob-min.js 的 Bmob.Object.extend 回调 vs 新 hydrogen-js-sdk 的 Bmob.Query Promise）、初始化方式写错（Secret Key + API 安全码 vs Application ID + REST API Key 混用），以及把 REST API Key 打进前端 bundle 或 忘记表级 ACL。

本技能只覆盖 hydrogen-js-sdk 3.0+（同一 Bmob-.min.js 跨端），明确 不要回退 旧版 API。

技能如何组织内容

初始化：方式 A（Secret Key + API 安全码，公开客户端推荐）与方式 B（Application ID + REST API Key，迁移或与 REST 共用 Key）；密钥走环境变量，CDN 用动态 latest 而非写死版本号。
数据操作：新增 / 按 objectId 读写 / 改字段 / 删行 / 删字段；查询默认 100 条、单次上限 1000，更多用 skip + limit 或 BQL。
条件查询：equalTo、containedIn、matchesQuery 等组合；include 关联、order、分页。
安全清单：不用 Master Key、生产关 Bmob.debug(true)、小程序配域名白名单与 wx.login() 后再 Bmob.User.login、批量操作 ≤50、写入表配 ACL。
保留字段：objectId、createdAt、updatedAt 不可手填；读主键用 res.objectId；时间比较需考虑微秒精度（比较时 +1 秒）。

适用边界

Node 服务端须源码引入，不能当浏览器 CDN 脚本用。
微信小程序 npm 引入需先在开发者工具 构建 npm。
复杂统计、全表扫描应走 BQL 或 REST，别一次 limit(1000) 硬拉。
ACL、错误码、各宿主引入细节见关联 skill（如 bmob-acl-and-roles、bmob-error-codes、references/platform-init.md）。