目录

• 项目身份 - 能力边界 - 证据与来源政策 - 安装前验证路径 - AI 宿主交接 - Doramagic 踩坑日志 - 验收清单

标准仓库：chroma-core/chroma

来源 URL：https://github.com/chroma-core/chroma

它是什么：Chroma 是面向 embeddings、元数据过滤、混合搜索和 RAG 检索工作流的向量数据库。

最适合：正在构建语义搜索、RAG 或检索工作流，并需要向量存储和元数据过滤的开发者。

不适合：不适合尚未定义文档、元数据和检索质量检查的检索场景。

这个 canary 页面用于让搜索引擎和 AI 检索系统稳定识别项目身份。页面必须保留上游仓库链接、可见来源证据和用户可执行的验证边界，不能暗示 Doramagic 已完成新的生产部署、实时基准或本地安装验证。

主要风险：主要风险是把未测试的 embedding、过滤条件或检索质量当成可靠生产搜索。

语义标签：Chroma、向量数据库、Embeddings、RAG、混合搜索、元数据过滤

1. 集合 Schema：先定义文档、chunk、embedding 和 metadata schema，再写入真实内容。
2. 检索验证：用极小样本验证一次写入、metadata filter 和检索查询，再扩大数据规模。
3. RAG 验收：记录召回预期、失败样例和回滚方式，再连接真实知识库。

边界必须保持窄。用户应该能判断项目是否相关、复制 prompt 给 AI 宿主、阅读说明书，并在安装前验证一个很小的可回滚任务。

缺少命令、风险或社区证据时，页面必须暴露缺口并引导用户做沙箱验证，不能补写成功故事。

• 确认 chroma-core/chroma 是目标上游项目。
• 先阅读能力边界：向量集合设置、embedding 流程检查、metadata filter 复核、检索验收标准和回滚指引。
• 用公开样本、无密钥、固定超时和可删除产物做第一次验证。
• 记录输出、失败条件、清理方式和仍缺失的证据。

AI 宿主交接

把这个包当成可携带上下文，不要当成自动安装指令。安全交接应包含来源 URL、能力边界、第一步安全动作、已知风险，并要求 AI 在触碰凭据、文件、网络或持久状态前先请求确认。

Doramagic 踩坑日志

• 风险：主要风险是把未测试的 embedding、过滤条件或检索质量当成可靠生产搜索。 - 影响：如果没有边界，用户可能把未验证的能力接入真实数据或生产环境。 - 回滚要求：第一次验证必须能删除数据、停止服务或撤销配置。 - 证据要求：成功声明必须来自可复核命令、trace、artifact manifest 或上游文档。

验收清单

• 页面标题遵循 Doramagic.ai 格式。 - 页面暴露 SoftwareSourceCode、TechArticle、BreadcrumbList 和 FAQPage 结构化数据。 - 页面链接回 https://github.com/chroma-core/chroma。 - 页面为 AI 消费者提供 Markdown alternate route。