企业官网建设流程全解析

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

【免费下载链接】lean-ctxLeanCTX — Context Intelligence for AI systems.项目地址: https://gitcode.com/gh_mirrors/le/lean-ctx

LeanCTX 是一个开源的「AI 上下文智能」工具，它为 AI 编程助手构建代码索引、知识图谱与记忆系统。当你手头有多个仓库或多个 workspace root（monorepo、多 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六种操作，跨仓库搜索结果通过RRF（Reciprocal 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）：

.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_files
• Agent 之间互相踩脚？最简单可靠的模式是"一个 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