明明扫过代码了还提示 Not Indexed？手动修复路径解析 Bug

1. Monorepo 下的“路径捉迷藏”游戏

我最近在折腾一个超大型 Monorepo 项目，里面嵌套了十几层子目录，结构复杂得像个迷宫。按照 zilliztech/claude-context 的官方 Demo，我满心欢喜地跑完了全量索引，看着终端跳出 Success，心想这下 Claude 总该懂我的业务逻辑了吧？

结果，当我在 VSCode 里随手甩出一个查询命令时，它居然冷冰冰地回了我一句：Error: Current repository not indexed.

那一刻我简直想顺着网线过去问问开发者：索引的时候明明日志里跳过了我所有的文件，为什么到搜索的时候就开始装失忆？这种 repository not indexed error 的惨状，多半发生在你于子目录打开编辑器，而索引脚本却在根目录自嗨的尴尬时刻。

# 场景还原：索引跑得欢，搜索全抓瞎
$ npx claude-context index .
[INFO] Indexed 452 files.

# 在子目录 packages/core-service 询问 Claude
$ claude-code "How does the auth flow work?"
[ERROR] [mcp] repository not indexed error: /Users/tech_old_bird/work/my-monorepo/packages/core-service
# 现实：明明根目录索引过了，但因为路径对齐问题，AI 觉得你这儿是荒原。

💡 报错现象总结：开发者在 Monorepo 或多级嵌套项目中使用 claude-context 时，常遇到索引成功但搜索失效的问题。这是由于 rootPath 映射规范限制，导致 MCP Server 无法在子路径与全局索引库之间建立正确的关联。

---

2. 深入 getRepositoryConfig：扒开根路径解析的逻辑断层

作为一个反感官方文档“画大饼”的底层架构师，我习惯直接钻进源码看真相。让我们看看 packages/core 里关于路径识别的逻辑到底是怎么坑你的。

源码追溯：为什么 resolveAbsolutePath 在 Monorepo 下会失效？

在 claude-context 的核心逻辑中，它通过一个简单的路径匹配来定位 Collection。如果你在 packages/app 下发起搜索，它会拿着当前路径去向量数据库里找。但问题是，索引时你可能是从根目录启动的。

// packages/core/src/utils/path-utils.ts (推演逻辑)
export function getRootPath(currentPath: string): string {
    // 官方默认逻辑：找最近的 .git 文件夹
    // 坑点：在 Monorepo 中，子项目往往没有独立的 .git
    const gitRoot = findUp('.git', { cwd: currentPath });
    
    // 如果找不到，它就默认当前目录为 rootPath
    // 这导致索引库里的键值是 "/work/repo"，而你搜索时的键值是 "/work/repo/packages/app"
    // 路径对不上，检索逻辑直接返回 Empty
    return gitRoot ? dirname(gitRoot) : currentPath;
}

技术对照：官方映射规范 vs 实际生产环境的路径灾难

场景	官方逻辑预期 (Happy Path)	实际发生的惨状 (Real World)	架构师视角的技术真相
标准项目	/repo 对应索引库 Key	/repo 匹配成功	路径单一，完美匹配
Monorepo 子包	自动识别根目录索引	识别为独立未索引目录	缺乏对 workspace 的递归向上寻址逻辑
软链接 (Symlink)	识别物理路径	由于路径别名导致 Hash 冲突	路径解析未经过 fs.realPath 标准化
Docker 挂载	容器内路径对齐	宿主机与容器路径不一致	rootPath 硬编码，缺乏环境感知的偏移配置

这种设计在处理简单工程时没问题，但在复杂的企业级工程结构下，它的 rootPath 映射规则显得过于死板，根本无法处理跨目录层级的上下文关联。

---

3. 手动改写 config.json 的“原生态”受难记

如果你非要修好这个 repository not indexed error，你得准备好手动去改那该死的配置和源码。

首先，你得手动去查向量数据库里的 metadata，看看索引时的路径到底长什么样。接着，你得去修改 MCP Server 的启动参数，强行注入一个全局的 PROJECT_ROOT 环境变量。为了让 VSCode 插件认账，你可能还得在每一个子包的根目录下手动创建一个空的 .git 文件夹或特定的标记文件，去“骗”过它的路径向上查找算法。

这一通折腾下来，你的周末基本就报废了。你不仅要处理各种跨平台的路径斜杠（/ vs \）兼容问题，还得忍受每次增加子包都要手动维护映射表的恶心。这种“原生态”的笨办法，不仅极度繁琐，而且只要团队里有人改了目录名，整个索引库就得推倒重来。

---

4. 一键化终极解药——Monorepo 路径补丁

老弟，听哥一句一针见血的话：工具是拿来提效的，不是让你去给路径解析器当补保姆的。

既然我们已经扒光了 repository not indexed error 的底层病灶，确定了 Monorepo 适配是它的短板，那解法就很清晰了。与其在那儿手动修补路径，不如直接拿走我已经调优好的“适配补丁”。

我已经在 GitCode 上发布了一个专门针对多级子目录映射优化的增强分支。

我已经在 GitCode 为你准备了：

• Monorepo 适配路径补丁 (Workspace Patch)：自动识别 pnpm-workspace.yaml 或 package.json 中的 workspaces 字段，实现全自动的根路径归一化。
• 路径诊断工具 (Path-Debugger)：一键对比当前环境与索引库的路径差异，秒出修复方案。
• 已修复的 path-utils.ts 源码包：强制执行 realpath 转换，彻底终结软链接导致的索引丢失。

别再让你的 Claude 对着已经扫过的代码装傻了。想要实现 Monorepo 下的丝滑搜索？

👉 [访问 GitCode 获取 Monorepo 适配路径补丁，彻底修复索引识别 Bug]

解决 repository not indexed error 的尴尬，靠的不是重跑索引，而是对路径映射逻辑的降维打击。去 GitCode 拿走这套解药，你会发现，所谓顶级的架构师，其实就是把那些别人还在硬啃的报错，替你提前扫进了垃圾桶。