chroma-core/chroma
打开原仓库 Chroma
阅读真实向量数据库客户端，理解集合、过滤和持久化。
进阶Apache-2.0学习估计 4–6 小时尚未记录
本次学习产物
给集合示例增加过滤与更新回归，验证数据生命周期。
开始前
Python 字典、向量检索、文件路径。
运行环境本地 Python；先传入固定向量，避免默认 embedding 下载或服务调用。
STEP 01 / 04
读懂源码
沿 api/client.py 到 api/models/Collection.py，比较 add、upsert、query 的职责和校验。
从这两个入口读起
先在纸上画出输入 → 处理 → 输出，再用断点或日志验证调用顺序。记录你读到的函数名与行号，不要求通读整个仓库。
准备自己的源码副本
git clone https://github.com/chroma-core/chroma.git
cd chroma
git checkout 52ce8448cb38a498f1660d55ea80df25b78f000a
git switch -c study/chroma在新的学习目录运行；固定提交用于对应源码导读，不承诺它是最新稳定发行版。
留下这一步的学习依据
访客手记仅保存在此浏览器；登录后可主动导入到账号，原件保留。清除浏览器数据前请导出。不保存密钥或敏感资料。
修订历史 0 版
保存会追加历史，保留之前的失败与修订依据；访客最多 50 版，不自动清理。
还没有保存记录。可以先记录一个问题，再慢慢修订。