Team-Shared Graph Artifact

commit 一個壓縮檔,隊友 clone 免重 index

一句話

把單一壓縮檔 commit 進你的 repo,隊友 clone 下來第一次跑 CBM 就直接載入圖,不必重跑完整索引。

它是什麼

.codebase-memory/graph.db.zst 是知識圖譜的 zstd 壓縮快照(SQLite DB、index 剝離、VACUUM INTO 壓實、zstd 壓縮,典型 8–13:1)。住在你 source 旁邊:

兩種 tier

Tier做法何時
Bestzstd -9 + index 剝離 + VACUUM INTO明確呼叫 index_repository
Fastzstd -3watcher 做低延遲增量更新時

Bootstrap

本機沒有 DB 但 artifact 存在時,index_repository 先匯入 artifact,再跑增量索引——省掉完整重索引的成本。

無 merge 痛

首次 export 時自動建立 .gitattributesmerge=ours,並行編輯不會在二進位 artifact 上產生衝突。

可選

不 commit 也行:把 .codebase-memory/ 加進 .gitignore 就大家都重新索引。結果在精神上類似 graphify 的 graphify-out/,但是單一壓縮檔 + 明確兩層 export + 完整性檢查 + 零 merge 摩擦。

看完這頁你應該能說出:graph.db.zst 是什麼、Best/Fast 兩 tier 何時用、bootstrap 如何省掉重索引、merge=ours 為什麼讓二進位不衝突、以及不想共享時怎麼關。