firebase-firestore

Cloud Firestore 数据库与运维

重要

编写安全规则（firestore.rules） 如果你的 任务需要创建、编写或修改 firestore.rules：

• 如果可以委派给子 Agent，且 firestore-rules-author 子 Agent 可用：将 firestore.rules 的编写工作委派给 firestore-rules-author 子 Agent，而不是由主 Agent 直接编写 firestore.rules。
• 如果无法委派给子 Agent（例如 IDE 中未启用子 Agent），或未安装 firestore-rules-author：阅读并遵循 firestore-rules-creation 技能，直接编写 firestore.rules。

在设置依赖项、编写数据模型或配置安全规则之前，必须始终先确定 Firestore 实例版本。

1. 实例选择与版本检测

运行以下命令，列出当前的 Firestore 数据库：

npx -y firebase-tools@latest firestore:databases:list

A. 找到实例

1. 检查找到的每个数据库的版本和详情：

   npx -y firebase-tools@latest firestore:databases:get <database-id>
   

2. 询问用户想要使用哪个数据库实例，或是否希望创建新实例。

3. 确定目标实例后：

   • 如果 edition 为 STANDARD，请遵循 references/standard/ 下的指南。
   • 如果 edition 为 ENTERPRISE 或原生模式，请遵循 references/enterprise/ 下的指南。

B. 未找到实例（或用户要求新建）

如果不存在数据库，或用户要求新建，默认预配 Enterprise 版数据库，并询问用户要使用哪个位置。运行 npx -y firebase-tools@latest firestore:locations 获取可选位置列表。 如适用，建议与其他资源部署在同一位置。

确定位置后，创建数据库：

npx -y firebase-tools@latest firestore:databases:create <database-id> --edition="enterprise" --location="<selected-location>"

继续遵循 references/enterprise/ 下的指南。

---

2. 专项指南

根据已确定或创建的实例版本，打开并阅读相应的参考指南：

Standard 版（references/standard/）

• 预配：阅读 provisioning.md
• 安全规则：参阅 firestore-rules-creation 技能
• SDK 用法：阅读 web_sdk_usage.md、 android_sdk_usage.md、 ios_setup.md 或 flutter_setup.md
• 索引：阅读 indexes.md

Enterprise 版 / 原生模式（references/enterprise/）

• 预配：阅读 provisioning.md

• 数据模型：阅读 data_model.md

• 安全规则：参阅 firestore-rules-creation 技能

• SDK 用法：

  [!CRITICAL] 必须阅读参考文档 在为 Firestore Enterprise 版编写或修改任何 应用代码之前，必须至少阅读以下与目标 平台/语言相关的参考文档之一，以了解特定的架构要求和 流水线初始化模式。

  阅读 web_sdk_usage.md、 python_sdk_usage.md、 android_sdk_usage.md、 ios_setup.md 或 flutter_setup.md

• 索引：阅读 indexes.md