| name | bmob |
| description | Use whenever the user mentions Bmob backend cloud (Bmob, BmobApp, bmobapp.com, Bmob 后端云) for ANY task: design data tables, perform CRUD, sign up / login users, upload files, push notifications, send SMS, accept payments, write or invoke cloud functions, configure ACL / roles, debug error codes, or operate the project via the Bmob MCP server. This is the routing entry — it dispatches to platform-specific skills: bmob-database-{javascript,android,ios,swift,flutter,restful}, bmob-auth-*, bmob-storage-*, bmob-cloud-function-*, bmob-mcp, bmob-error-codes, bmob-bql, bmob-acl-and-roles. For operation-level MCP vs SDK vs REST routing, read shared/operation-routing.md. NOT a substitute for those sub-skills — once the platform and feature are clear, read and follow the matching sub-skill before writing code. |
| metadata | {"author":"bmob","version":"0.1.0","homepage":"https://www.bmobapp.com","docs":"https://github.com/bmob/BmobDocs/tree/master/mds","docs_raw":"https://raw.githubusercontent.com/bmob/BmobDocs/master/mds","console":"https://www.bmobapp.com/login"} |
Bmob 后端云 — 总入口
Bmob 是一个 BaaS（Backend as a Service）平台，提供 NoSQL 数据库、用户系统、文件存储、云函数、推送、短信、支付、IM、AI 等开箱即用的后端能力。客户端覆盖 JavaScript / Android / iOS / Swift / Flutter / HarmonyOS / 小程序 / Python / Go / PHP / C#，加上语言无关的 REST API 与 MCP Server。
路由顺序：先走下方 入口决策树 → 再查 路由决策表（选 sub-skill）→ 具体操作查 shared/operation-routing.md（MCP / curl / SDK·REST 三通道对照）。
核心原则
1. 永远先确认平台再写代码。 Bmob 各端 SDK 的 API 形态差异很大（JS 是 Bmob.Query、Android 是 extends BmobObject、旧 iOS 是 BmobObject objectWithClassName、纯 Swift 是 try await BmobObject.save()、REST 是 HTTP /1/classes/<name>），不要把 JS 的代码塞进 Android skill 的回答里。先看用户用什么平台 / 框架，再读对应 sub-skill。
2. 不要在前端泄漏 Master Key。 Bmob 控制台 → 应用密钥里有四个值：
| 密钥 | 安全级别 | 使用场景 |
|---|
| Application ID | 公开 | 所有端 |
| REST API Key | 半公开 | 浏览器 / 小程序 / 移动端 / 服务端 |
| Secret Key | 中等 | 加密授权场景的客户端，配合 SecurityCode |
| Master Key | 最高 | 仅服务端 / 后台脚本，永不出现在前端 bundle |
3. 写之前先看 changelog。 SDK 在演进，方法签名会变。开始一项任务前用 raw URL 拉对应平台的 update_log.md（路径见 sub-skill 的 metadata.docs_raw）确认无破坏性变更。
4. 错误不要循环重试。 2-3 次同样的尝试失败后停下，重新评估：
- HTTP 4xx：先把响应体里的
code 拿去查 bmob-error-codes。
- 权限/ACL 报错（9015、9016 等）：见下方 P1 临时路径 或将来
bmob-acl-and-roles。
- "找不到方法"：可能 SDK 版本过旧或文档与你使用版本不匹配，去仓库 release 页对比。
入口决策树（先走这里）
flowchart TD
Start([用户提到 Bmob]) --> Err{响应里有错误 code?}
Err -->|是| EC[bmob-error-codes]
Err -->|否| Ship{代码要写进应用并发版?}
Ship -->|否| McpCfg{IDE 已配置 Bmob MCP?}
McpCfg -->|是| MCP[bmob-mcp<br/>9 个可调用工具]
McpCfg -->|否| RestOnly[bmob-database-restful<br/>或 generate_code 需 MCP]
Ship -->|是| Plat{平台 / 语言?}
Plat -->|JS Web Node 小程序 Cocos JS 等| JS[bmob-database-javascript]
Plat -->|Android Kotlin Java| AND[bmob-database-android]
Plat -->|Pure Swift BmobSwiftSDK async/await| SWIFT[bmob-database-swift]
Plat -->|Legacy iOS ObjC Swift Bridging Header| IOS[bmob-database-ios]
Plat -->|Flutter Dart| FLUT[bmob-database-flutter]
Plat -->|curl Python Go PHP 后端等| REST[bmob-database-restful]
Plat -->|RN Uni-app JS 桥接| JS
JS --> Schema{需要真实表字段名?}
AND --> Schema
SWIFT --> Schema
IOS --> Schema
FLUT --> Schema
REST --> Schema
Schema -->|是且已配 MCP| MCP
Schema -->|否| Done([读对应 sub-skill 写代码])
MCP --> OpTable[[shared/operation-routing.md<br/>操作级三通道表]]
路由决策表（命中后立即去读对应 sub-skill）
| 用户意图 | 平台线索 | 路由到 |
|---|
| 新建/查看表结构、加测试数据、生成 curl 样板、实操数据库 | — | bmob-mcp（前提：用户已配置 MCP） |
| 一键部署网站 / 静态托管（HTML 或 dist 到 CDN） | — | bmob-mcp → deploy_static_site（或 generate_code 仅生成 curl） |
| NoSQL 增删改查、条件查询 | JS / TS / Web / Node / 微信/支付宝/字节/QQ/百度小程序 / 快应用 / Cocos Creator JS / Electron / Tauri / 混合 App | bmob-database-javascript |
| NoSQL 增删改查 | Android / Kotlin / Java | bmob-database-android |
| NoSQL 增删改查 | 纯 Swift SDK / BmobSwiftSDK / SPM / import BmobSDK / async/await | bmob-database-swift |
| NoSQL 增删改查 | 旧 iOS SDK / Objective-C / Swift Bridging Header / BmobSDK.xcframework / saveInBackground | bmob-database-ios |
| NoSQL 增删改查 | Flutter / Dart（bmob_plugin） | bmob-database-flutter |
| NoSQL 增删改查 / 任意没 SDK 的语言 | curl / Python / Go / PHP / C# / Rust / Ruby / Java 后端 | bmob-database-restful |
| React Native / Uni-app（JS 层接 Bmob） | — | bmob-database-javascript 或 REST |
| HarmonyOS ArkTS | — | bmob-database-restful + BmobDocs |
| 用户注册 / 登录 / SMS 验证 / 三方登录 / 邮箱验证 | 各端 | bmob-auth-{platform}（P1，见下表） |
| 文件上传下载 / CDN | 各端 | bmob-storage-{platform}（P1，见下表） |
| 调用云函数 | 各端 | bmob-cloud-function-{platform}（P1，见下表） |
| 编写运行在 Bmob 服务器上的云函数代码 | — | bmob-cloud-function-development |
| ACL / 角色 / 权限 / 行级安全 | — | bmob-acl-and-roles（P1，见下表） |
| BQL 查询（类 SQL 语法） | 任意 | bmob-bql（P1，见下表） |
| 排查报错 code 9015 / 101 / 105 等 | — | bmob-error-codes |
| 推送 / 短信 / 支付 | 各端 | bmob-push-* / bmob-sms-* / bmob-pay-*（P2） |
具体操作（增删改查、登录、上传、部署）用哪条通道，见 shared/operation-routing.md。
P1 / P2 尚未发布时的临时路径
专用 sub-skill 未安装时，不要空等，按此表降级：
| 用户意图 | 目标 skill（未发布） | 当前可用替代 |
|---|
| 注册 / 登录 / 短信验证码 | bmob-auth-* | REST：bmob-database-restful/references/users.md；已配 MCP：generate_code（注册 / 用户名密码登录 / 手机号验证码登录 等） |
| 文件上传 / CDN URL | bmob-storage-* | REST：references/files.md；MCP：generate_code → 上传文件 |
| 调用已有云函数 | bmob-mcp → invoke_cloud_function（执行）；generate_code → 调用云函数（curl） | REST /1/functions/<name>；各端 SDK |
| 编写并部署云函数源码 | bmob-cloud-function-development | 已配 MCP：deploy_cloud_function → invoke_cloud_function；未配 MCP：BmobDocs + 控制台 |
| ACL / 行级权限 / 9015·9016 | bmob-acl-and-roles | REST 创建/更新 body 内 "ACL":{...}；bmob-error-codes |
| BQL / 跨表聚合 | bmob-bql | REST GET /1/cloudQuery；bmob-database-restful |
| 推送 / 短信 / 支付 | P2 skills | REST 对应模块 + BmobDocs mds 目录树 |
通用安全清单（被所有 sub-skill include）
FAQ 与反模式
应用场景食谱
端到端场景（表设计 + ACL + 流程），再进各 platform skill 写代码：
文档查找方法
各 sub-skill 的 references/snippets/（由 BmobDocs 同步提交）与手写 references/*.md 覆盖大部分 API。仍不够时再 fetch 上游文档：
-
按文件名定位：上游文档树在 github.com/bmob/BmobDocs/tree/master/mds，按 <feature>/<platform>/ 组织。
-
agent 直接 fetch（绕过 GitHub 渲染层）：
https://raw.githubusercontent.com/bmob/BmobDocs/master/mds/<feature>/<platform>/<filename>.md
已验证可被 WebFetch 工具直接拉为纯 markdown。
-
列目录（不知道文件名时）：
https://api.github.com/repos/bmob/BmobDocs/contents/mds/<feature>/<platform>
-
仍找不到：去 https://www.bmobapp.com/docs/。
与 MCP 的协作（关键）
如果用户在 IDE 里配置了 Bmob MCP Server（见 shared/mcp-install-snippets.md），任何涉及「读真实表结构 / 写测试数据 / 设计 schema / 生成样板 curl / 一键部署网站」的任务都应 优先 MCP，不要凭猜测写字段名。
tools/list 共 10 个工具；agent 只调用其中 9 个（get_project_tables、create_table、add_single_data、update_single_data、delete_single_data、generate_code、deploy_cloud_function、invoke_cloud_function、deploy_static_site）。mcp_endpoint_mcp_post 为服务端内部回环，不要调用。- 工具参数与话术对照：
bmob-mcp；操作级三通道表：shared/operation-routing.md。
flowchart LR
User[User prompt mentioning Bmob] --> Root[bmob root SKILL.md]
Root --> OpRoute[shared/operation-routing.md]
Root -->|"schema / live CRUD / deploy"| McpSkill[bmob-mcp]
Root -->|JS / Web / Mini Program| JsDb[bmob-database-javascript]
Root -->|Android / Kotlin| AndDb[bmob-database-android]
Root -->|Pure Swift SDK| SwiftDb[bmob-database-swift]
Root -->|Legacy iOS / ObjC| IosDb[bmob-database-ios]
Root -->|Flutter / Dart| FlutDb[bmob-database-flutter]
Root -->|curl / Python / Go| RestDb[bmob-database-restful]
Root -->|error code| Err[bmob-error-codes]
McpSkill -.get_project_tables.-> JsDb
McpSkill -.get_project_tables.-> AndDb
McpSkill -.get_project_tables.-> SwiftDb
McpSkill -.get_project_tables.-> IosDb
McpSkill -.get_project_tables.-> FlutDb
McpSkill -.get_project_tables.-> RestDb
一句话总结
用户提到 Bmob → 读本 skill 的 入口决策树 → 路由决策表 选 sub-skill → shared/operation-routing.md 选 MCP / curl / SDK·REST；端特化代码在 sub-skill 的 references/ 与 SKILL.md 里。
