codebuddy 默认不支持跨仓库理解，需通过多根工作区、符号链接、mcp协议注入、workspace-aware craft模式或启用hunyuan-pro-128k模型等五种方式增强多仓库上下文感知能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在微服务架构中使用多个独立 Git 仓库（如 user-service、order-service、auth-gateway），并期望 CodeBuddy 能跨仓库理解接口契约、共享 DTO、配置一致性或调用链逻辑，则其默认行为仅限于单仓库上下文。以下是验证与增强该能力的具体路径：
一、确认多仓库上下文加载限制
CodeBuddy 的工程级理解能力基于本地文件系统索引，当前版本不支持自动发现、加载并关联多个分离的 Git 仓库。当工作区仅打开一个服务目录时，其 AST 解析、依赖图谱构建及类型推导均无法感知其他仓库中的类型定义、OpenAPI 规范或 Protobuf 消息结构。
1、检查当前 VS Code 工作区：确认是否为单根目录（如仅打开 /microservices/user-service）。
2、若存在多个服务目录，需手动合并为多根工作区：文件 → 将文件夹添加到工作区 → 分别添加 user-service、order-service 等路径。
3、重启 CodeBuddy 插件后观察状态栏：若仍显示“✅ 已加载 user-service 上下文”，则其余根目录未被纳入索引，需逐个触发加载。
二、通过符号链接构建逻辑统一上下文
该方法在物理隔离的仓库间建立可索引的软连接，使 CodeBuddy 将其视作同一项目结构下的子模块，从而支持跨仓库 import 路径解析与类型跳转。
1、在主工作区根目录下创建 shared-contracts 文件夹。
2、进入该文件夹，执行命令：ln -s /path/to/common-dtos ./dtos（Linux/macOS）或使用 mklink（Windows）。
3、在 user-service 的 tsconfig.json 或 pyproject.toml 中显式声明该路径为类型/模块源："paths": { "@contracts/*": ["../shared-contracts/dtos/*"] }。
4、右键点击 shared-contracts 文件夹 → 选择“CodeBuddy: Load Project Context”。
三、利用 MCP 协议注入外部仓库元数据
MCP 支持通过 JSON-RPC 接口动态注入非本地文件的结构化信息，例如从远程仓库拉取 OpenAPI v3 文档、Protobuf 编译产物或 Thrift IDL，供模型在推理时引用。
1、确保已启用 MCP：设置页中开启 Enable MCP Context Injection。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、在项目根目录下创建 mcp-config.yaml，定义外部服务端点：
3、运行命令：codebuddy mcp inject --from https://raw.githubusercontent.com/org/order-service/main/openapi.yaml --as order-api-spec。
4、在 Craft 模式中输入需求时，可明确引用：“根据 order-api-spec 中的 /orders/{id} GET 接口响应结构，生成 user-service 中的订单关联查询 DTO”。
四、采用 Workspace-aware Craft 模式分步协同
当无法物理合并或协议注入时，可借助 Craft 模式的多轮对话记忆与显式上下文锚定机制，人工构造跨仓库语义连贯性。
1、首次输入中提供完整上下文快照：“当前工作区含 user-service（Java/Spring Boot）与 auth-gateway（Go）两个根目录；user-service 使用 Feign 调用 auth-gateway 的 /v1/token/validate 接口；该接口返回字段包括 ‘uid’, ‘roles’, ‘exp’”。
2、提交后等待 CodeBuddy 返回确认摘要，再追加指令：“请基于上述接口契约，在 user-service 的 JwtTokenValidator 类中实现对 roles 字段的权限校验逻辑”。
3、若生成结果缺失字段引用，追加第三轮指令：“请重新分析 auth-gateway 的 /v1/token/validate 响应体定义，并确保生成代码严格匹配字段名与类型”。
五、启用混元Pro-128K模型并扩展上下文窗口
多仓库理解高度依赖模型的长程依赖建模能力。小上下文模型（如 8K 窗口）会强制截断跨仓库关键信息，导致类型丢失或契约误判。
1、进入 CodeBuddy 设置页 → “Model Selection” → 切换至 HunYuan-Pro-128K。
2、在 Craft 输入框顶部点击齿轮图标 → 启用 “Maximize Context Window for Multi-Repo Analysis” 选项。
3、在需求描述开头添加显式上下文权重标记：[CONTEXT:HIGH] user-service/src/main/java/com/example/UserController.java + auth-gateway/internal/handler/token.go + shared-protobuf/user_profile.proto。
