Monorepo多仓库场景下如何使用LeanCTX：多root共享索引实战指南

Monorepo多仓库场景下如何使用LeanCTX多root共享索引实战指南【免费下载链接】lean-ctxLeanCTX — Context Intelligence for AI systems.项目地址: https://gitcode.com/gh_mirrors/le/lean-ctxLeanCTX 是一个开源的「AI 上下文智能」工具它为 AI 编程助手构建代码索引、知识图谱与记忆系统。当你手头有多个仓库或多个 workspace rootmonorepo、多 repo 工作区时LeanCTX 通过多 root 共享索引让一个 AI 会话同时检索多个项目避免来回切换目录。本文面向新手带你用 5 个配置项完成多仓库实战配置。为什么多仓库场景需要共享索引日常开发中常见的痛点 改 A 仓库的接口B 仓库的调用方也需要同步AI 助手却看不见B 仓库 每个仓库单独建索引重复劳动上下文频繁丢失 多个 AI Agent 同时操作时缓存互相污染、搜索互相干扰LeanCTX 的应对思路是索引共享 边界隔离。多个 root 共用一套检索与图谱能力同时每个包/仓库保持自己的配置互不串扰。官方 Monorepo 指南位于 docs/guides/monorepo.md推荐配合阅读。 LeanCTX 还能自动识别多 root 工作区当当前目录没有项目标记但包含 2 个以上带.git、Cargo.toml、package.json等标记的子目录时会自动把全部子项目加入白名单见 CHANGELOG.md。三种方式让 LeanCTX 识别多个 root方式一extra_roots 添加额外项目根在config.toml中一行搞定extra_roots会把列出的目录加入白名单并且ctx_tree、ctx_search、overview 都会把它们当作额外的项目根来扫描——这正是多 root 共享索引的核心开关extra_roots [~/work/api, ~/work/web]它和普通白名单allow_paths的区别很关键allow_paths只让工具能读写这些目录但不会去扫描它们extra_roots则是真正参与多根检索详见 docs/reference/appendix-paths-and-config.md。也支持环境变量LEAN_CTX_EXTRA_ROOTS配置~、$VAR均可正常展开。方式二linkedProjects 关联兄弟项目当你故意希望一个工作区能看见旁边的项目比如共享 UI 库在项目根目录创建.lean-ctx.json{ linkedProjects: [../packages/ui, ../packages/config] }这是最轻量级的共享索引方式适合 monorepo 中按需可见的场景。官方建议谨慎使用它能提升跨包搜索效果但也会扩大搜索面参见 docs/guides/monorepo.md。方式三ctx_multi_repo 跨仓库融合搜索需要一个会话服务多个独立仓库时LeanCTX 提供了专门的ctx_multi_repoMCP 工具支持add_root、remove_root、list_roots、search、status、save_config六种操作跨仓库搜索结果通过RRFReciprocal Rank Fusion融合排序让 A、B 两个仓库的命中结果公平地合并展示实现见 rust/src/core/multi_repo.rs、rust/src/tools/ctx_multi_repo/mod.rs。命令行侧同样支持一条命令启动多仓库 HTTP MCP 服务lean-ctx serve --root ~/work/api:api --root ~/work/web:web根目录上限为 16 个配置持久化在~/.config/lean-ctx/multi-repo.toml更多细节见 docs/reference/05-advanced.md。Monorepo 五步配置清单完成多 root 识别后按下面清单保证大仓库又快又稳摘自 docs/guides/monorepo.md步骤操作说明1️⃣每个活跃包下放一个.lean-ctx.tomlLeanCTX 会自动合并项目本地配置与全局配置2️⃣填extra_ignore_patterns排除node_modules/**、dist/**、target/**等构建产物索引更干净3️⃣设置memory_cleanup shared多个 IDE/Agent 共用仓库时避免互相干扰4️⃣容器场景加.lean-ctx-id文件Docker/DevContainer 中多仓库都挂在/workspace时用它区分项目身份防止缓存与知识串台5️⃣仅在确实需要时加linkedProjects跨包搜索是加分项不是默认项.lean-ctx.toml的示例长这样pnpm/Turborepo 工作区extra_ignore_patterns [dist/**, .next/**, coverage/**] memory_profile balanced memory_cleanup shared graph_index_max_files 12000常见问题与调优建议 索引太大、变慢了先加 ignore 规则再考虑提高graph_index_max_files上限配置改了没生效运行lean-ctx doctor它会报告配置解析错误和失效的路径白名单条目机器内存紧张把memory_profile调成low图谱覆盖不够深适度上调graph_index_max_filesAgent 之间互相踩脚最简单可靠的模式是一个 Agent 负责一个包根目录需要跨包时用上面三种共享索引方式显式声明小结一句话总结多仓库实战用extra_roots或linkedProjects让 LeanCTX 看见多个 root用ctx_multi_repo做跨仓库融合搜索再用每个包下的.lean-ctx.toml做隔离与调优。这套组合能让你的 AI 助手在 monorepo 和多 repo 工作区中拥有完整、干净、可控的共享索引上下文。【免费下载链接】lean-ctxLeanCTX — Context Intelligence for AI systems.项目地址: https://gitcode.com/gh_mirrors/le/lean-ctx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考