bmob-cloud-function-development

Bmob 云函数开发

用于写运行在 Bmob 服务器上的云函数源码，并在已配置 MCP 时走 deploy_cloud_function → invoke_cloud_function 完成上传与验证，或走 list_cloud_functions → get_cloud_function 将线上函数同步到本地。

先判断走哪条通道

1. 已配置 Bmob MCP：优先用 bmob-mcp
   • 上传源码：deploy_cloud_function
   • 单独验证：invoke_cloud_function
   • 同步线上 → 本地：list_cloud_functions → get_cloud_function（agent 写本地文件）
2. 未配置 MCP：按 云函数文档 与 REST /1/functions/<name> / 控制台流程给代码与 curl

语法基线

默认按 Bmob 云函数文档的 Web/Node 风格写：

function onRequest(request, response, modules) {
  response.send("hello");
}

• GET 直连参数：request.query.xxx
• POST / REST 参数：request.body.xxx
• 返回结果：response.send(...)
• 数据库 / 文件 / HTTP / 加密：从 modules 取 oData、oFile、oHttp、oCrypto 等

必须遵守的已知行为

• 通过 REST API 调用时，参数从 request.body 取，不是 request.query
• 云函数里很多回调返回的是字符串，需要 JSON.parse(data) 后再当对象用
• 已知行为：服务端可能把传入 request.body 的值转成字符串；涉及数字、布尔、数组、对象时，在云函数内显式 parseInt / === "true" / JSON.parse
• modules.oData 的 where 是 JSON 对象，不要 JSON.stringify：
  • ✅ 云函数内：db.find({ "table": "Level", "where": { "status": 1 } })
  • ❌ 错误："where": JSON.stringify(where) — 会把条件变成字符串，查询失效或行为异常
  • 仅 REST GET 的 query 参数 where 才需要 URL 编码的 JSON 字符串（见 bmob-database-restful）；不要把 REST 写法套进 oData

默认工作流

1. 写源码

• 函数名与用户要调用的名字一致
• 优先写最小可验证版本，再逐步扩展
• 如果要查表 / 改表，先确认表名与字段名；用户已配 MCP 时先读 get_project_tables

2. 上传源码

已配 MCP 时，优先调用：

• deploy_cloud_function
  • funcName: 云函数名
  • code: 源码原文
  • language: 1=javascript，2=java
  • verify: 需要立即验证时传 1
  • verify_data: 验证入参 JSON 字符串，默认 {}

3. 验证结果

• 如果上传工具已设置 verify=1，直接检查返回里的 verify.response
• 如果需要多次验证，单独调用 invoke_cloud_function
• 验证失败时，优先把上传结果、执行返回、传入参数三者一起对照

4. 部署成功后：告知用户如何调用

deploy_cloud_function 成功时，响应里会带 invokeGuide。向用户说明调用方式时：

1. 禁止只写裸 URL（如 POST https://api.codenow.cn/1/functions/xxx）——REST 必须带完整 headers 与 body
2. 优先直接使用 invokeGuide.rest.curl（已含 X-Bmob-Application-Id、X-Bmob-REST-API-Key、Content-Type 与示例 body）
3. 按当前项目类型只展示一种最匹配的 SDK 示例（从 invokeGuide.sdk 选取）：
   • 读代码库判断：package.json / Vue / React → javascript；app.json / 小程序 → wechat_miniprogram；build.gradle / Android SDK → android；Podfile / ObjC → ios；BmobCloud.run / SwiftPM → swift；pubspec.yaml / bmob_plugin → flutter；无 SDK 或用户要 curl → restful
   • 不确定时：REST curl + 说明「你的项目若是 XX 平台可参考 invokeGuide.sdk.XX」
4. 需要更详细的 curl 样板：可再调 generate_code → type=调用云函数
5. 展示完调用示例后，主动询问用户是否需要试跑（已配 MCP 时）：
   • 话术示例：「云函数已部署。上面是 REST / SDK 调用方式。需要我帮你用 MCP 模拟参数试跑一下吗？」
   • 用户同意 → 根据云函数源码里 request.body 的字段，推断或向用户确认测试参数
   • 调用 invoke_cloud_function：funcName = 函数名，data = 测试入参的 JSON 字符串（如 {"limit":10,"skip":0,"status":1}）
   • 把执行结果（成功 / 报错 / 返回体）反馈给用户；失败时对照「上传结果 + 执行返回 + 传入参数」排查
   • 用户未配 MCP 或未同意试跑：只给调用说明，不自动执行