用途：为语义搜索应用提供 Chroma 向量数据库集成指导，覆盖本地部署与 Chroma Cloud 两种方式。
主要能力：创建与查询集合（get_or_create_collection / getOrCreateCollection）、添加与查询文档、元数据过滤、更新与删除、错误处理、正则过滤、元数据数组、集合分叉（Cloud）、Schema() 与 Search() API（仅 Cloud，支持稠密、稀疏及混合检索，稀疏可用 SPLADE）。
使用方式：先确认部署目标（本地或 Cloud）、检索类型、嵌入模型与数据结构。Cloud 可用 CLI 初始化：chroma login、chroma db create <my_database_name>、chroma db connect <my_database_name> --env-file，生成含 CHROMA_API_KEY、CHROMA_TENANT、CHROMA_DATABASE 的 .env。客户端按环境导入 CloudClient 或 Client，接口一致。TypeScript 需为每个嵌入函数单独安装包，如 @chroma-core/default-embed、@chroma-core/openai、@chroma-core/chroma-cloud-qwen；Python 默认内置，Qwen 需 pip install httpx。
适用场景：按用户、团队或组织划分集合的多租户检索；关键词较多的查询可用混合检索。
限制：Schema() 与 Search() 仅 Chroma Cloud 可用；get_or_create_collection() 只能接受 embedding_function 或 schema 之一，不可同时使用；默认嵌入函数通常非最佳选择。更多文档见 https://docs.trychroma.com/llms.txt。