用途：本资料介绍如何在 Web 应用中使用 CloudBase 文档数据库 Web SDK 进行数据操作，涵盖查询、创建、更新、删除，并支持复杂查询、分页、聚合与地理位置查询。
初始化：先引入并初始化 SDK，再获取数据库实例与查询操作符。import cloudbase from "@cloudbase/js-sdk"; 通过 cloudbase.init({ env: "your-env-id" }) 初始化，随后 const db = app.database(); const _ = db.command;。若不用 npm，可改用 UMD 版本，并参考官方快速体验页获取最新版本。查询数据库前必须先完成登录（auth），这是必需步骤。集合通过 db.collection('collection-name') 访问。
主要能力：查询操作符包括 .gt、.gte、.lt、.lte、.eq、.neq、.in、.nin。可按文档 ID 查单条，也可用 where 条件查多条，并支持链式组合：.where(conditions)、.orderBy(field, direction)、.limit(number)、.skip(number)、.field(object)。资料提到的进阶主题包括 CRUD 操作、复杂查询、分页、聚合查询、地理位置查询、实时数据库（watch()）与安全规则，分别见对应参考文件。
使用方式与限制：所有数据库操作均为异步，建议用 try-catch 包裹；操作返回结构含 data 数组等。get() 默认返回 100 条，最多 1000 条。需将 "your-env-id" 替换为真实环境 ID，集合名使用字符串字面量，地理位置查询需要正确建立索引。
规范建议：强烈建议为每个集合建立类型定义与模型层，作为数据库 schema 的单一事实来源；每个集合应有唯一名称，同一项目建议加统一前缀；应按业务为集合的创建、读取、写入、删除配置明确的安全规则。每次操作（含 get、add、update、delete 等）都应检查返回值中的 code 判断错误，例如 const result = await db.collection('todos').add(newTodo); if(typeof result.code === 'string') { ... }，错误需给出详细、可读的提示并配合友好界面。初始化建议在应用启动时完成一次并复用数据库实例，查询时只选择需要的字段，常用查询字段建立索引。部分细节资料暂未提供。