AI 直连文档
这个页面给 AI 和协作开发工具快速定位 StarEcho BaaS 的开发和维护方式。
一次性读取入口
/llms.txt 是纯文本入口，重点说明如何在 StarEcho BaaS 平台开发云函数、维护数据合集、配置权限组、使用存储、处理跨应用访问，以及 AI 通过 VS Code 插件参与开发的推荐流程。
常用开发文档
VS Code 插件 AI 能力
安装并登录 StarEcho BaaS 开发插件后，支持 AI 通过工具或 MCP 访问：
- 根据应用名称或 Client ID 解析本地路径
- 列出、创建、拉取、上传、测试、禁用或删除云函数
- 创建、查询和更新云函数的
requestMode=raw，并读回第三方 WebhookrawHttpUrl - 列出、写入/轮换和显式删除应用级只写 Secret（任何读取都不返回值）
- 列出、创建、更新、删除数据合集，并读取或修改合集描述
- 列出、读取、新增、覆盖、改名或删除数据文档
云函数可以设置 invokeAccess = cloud_function 作为私有 helper，仅允许其他云函数通过 $invoke 调用，不接受用户、匿名、Basic/Bearer HTTP 或定时任务直接调用。
第三方 Webhook 使用 requestMode = raw、requireAuth = 0 和 invokeAccess = http。 Raw 入口接收顶层 JSON、文本或二进制，提供解析前的 request.rawBody / request.rawBodyBase64，并真正应用 { statusCode, headers, body } 响应描述符。
数据合集遵循 ownerMode：
none：无拥有者文档，不显示也不写入拥有者user：用户绑定文档，界面可以输入 RID 或 UID，服务端存储 UID
本地同步空间
插件会把云函数同步到工作区下的 .starecho/。这是插件的同步空间，可以整体加入 .gitignore；如果需要版本管理，也可以只提交指定应用或指定文件夹下的云函数源码。
resolve_app、pull 和 upload 会优先使用 VS Code 当前工作区（或调用方工作目录向上最近的 .starecho），并返回 clientId、workspaceRoot 和 cloudFunctionRoot。所有写入路径必须位于 选中的工作区内。多工作区存在多个候选时传入 workspaceRoot（兼容别名 localRoot）显式 选择；每个工作区有独立同步元数据和远端哈希，上传发现远端已变化时默认拒绝覆盖。