cocoindex-code 三层存储架构解析LMDB、sqlite-vec 与向量库如何协同【免费下载链接】cocoindex-codeA super light-weight embedded code search engine CLI (AST based) that just works - improves speed and efficiency for coding agent Star if you like it!项目地址: https://gitcode.com/gh_mirrors/co/cocoindex-codecocoindex-code 是一个轻量级、基于 AST 的语义代码搜索 CLI 引擎。它的即插即用背后是一套精巧的三层存储架构LMDB 状态库、sqlite-vec 向量表与代码块仓库各司其职让百万行级代码库的索引又快又省。本文用通俗语言带你彻底搞懂这三层是如何协同工作的。为什么需要三层一个索引背后的分工做代码语义搜索本质是把代码切成块 → 转成向量 → 存下来 → 按相似度查。每一步对存储的要求都不一样需求对存储的要求交给谁记住哪些文件改过避免重复索引极快读写、事务可靠LMDB存代码块文本、行号、文件路径结构化、可 SQL 查询SQLite按意思找最相似的代码向量近邻检索KNNsqlite-vec把不同职责拆到不同的引擎是轻量化的关键——不依赖任何外部数据库服务全部嵌入在本地文件里。第一层LMDB 状态库cocoindex.db打开一个已初始化的项目你会在.cocoindex_code/目录下看到cocoindex.db。它由 CocoIndex 的 Rust 引擎管理本质是一个LMDB数据库。它的职责很纯粹记录索引的账本。每当运行ccc index引擎会检查每个文件的指纹只重新处理真正变化的文件新增、修改、删除其余直接跳过。这套增量索引能力正是 cocoindex-code 快、省的核心——你不必每次都在整个仓库上重跑昂贵的向量计算。 LMDB 的容量上限在守护进程启动时就固定默认 4 GiB。如果索引超大代码库时遇到MDB_MAP_FULL报错调大COCOINDEX_LMDB_MAP_SIZE即可。相关说明见 settings.py 中的数据库路径解析逻辑。在代码里这个库通过coco.Settings.from_env(cocoindex_db)初始化见 project.py。守护进程退出时会显式释放 LMDB 与 SQLite 文件句柄保证资源干净回收见 project.py。第二层SQLite 代码块仓库target_sqlite.db第二个文件target_sqlite.db是标准的SQLite数据库用来真正装代码。它把每个代码块存成一行记录结构由CodeChunk数据类定义id代码块唯一标识由内容哈希生成天然去重file_path/language所在文件与语言content代码片段本身start_line/end_line精确行号区间方便跳转embedding该代码块对应的浮点向量这个 schema 定义在 shared.py。索引主流程process_file会先把文件按约 1000 token 切成块保留 150 token 重叠逐块生成向量后写入这张表见 indexer.py。切块参数CHUNK_SIZE / MIN_CHUNK_SIZE / CHUNK_OVERLAP也集中定义在 indexer.py想要更细粒度检索可以调整。第三层sqlite-vec 向量索引vec0 虚拟表真正让按语义找代码成为可能的是sqlite-vec——一个跑在 SQLite 之上的向量检索扩展。索引器挂载表时显式声明了Vec0TableDef把language设为分区键、把文本字段设为辅助列、把embedding作为向量列见 indexer.py。查询时引擎先把你输入的自然语言转成向量再对code_chunks_vec这张 vec0 虚拟表做KNNK 近邻搜索按语言过滤走language分区键在索引层面精确裁剪速度最快按路径过滤退化为全表扫描并用vec_distance_L2实时算距离多语言组合分别查再合并取最优这三种策略的实现见 query.py。值得一提的是引擎还把 L2 距离换算成余弦相似度分数返回让结果排序更直观见 query.py。三层如何协同一次搜索的完整旅程把三层串起来一次ccc search的流程是LMDB 校验状态→ 守护进程确认索引是最新的必要时只补增量查询向量生成→ 用你的自然语言生成查询向量vec0 近邻检索→ 在target_sqlite.db里按相似度找出最相关的代码块SQLite 取出内容→ 拿到文件路径、行号、代码正文返回结果→ 附带相似度分数供 Coding Agent 直接消费整个过程无需任何外部数据库全部落在本地两个文件里——这正是嵌入即用、零配置的底气。索引统计块数、文件数、语言分布也是直接查询code_chunks_vec得到见 project.py。小结cocoindex-code 的三层架构是一次教科书式的按职责选引擎LMDB管变更账本让增量索引又快又省SQLite管代码仓库结构化存储元数据与向量sqlite-vec管语义检索用向量近邻实现以意搜代码三层解耦、协同共同支撑起一个零配置、高性能、本地优先的代码语义搜索引擎。理解了这套架构你就能更好地评估它在你的项目中如何落地与调优。【免费下载链接】cocoindex-codeA super light-weight embedded code search engine CLI (AST based) that just works - improves speed and efficiency for coding agent Star if you like it!项目地址: https://gitcode.com/gh_mirrors/co/cocoindex-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考