应启用多包上下文感知模式、手动注册导出声明、配置ts项目引用、使用craft mode跨包生成、禁用隔离沙箱。具体包括调设context awareness level为workspace-wide，创建.exports.json声明路径，子包tsconfig加composite:true并配置references，用/craft指令驱动多包协同生成，关闭isolation mode并重建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 开发 monorepo 项目时发现跨包补全失效、类型推导不准或依赖路径识别错误，则可能是由于 CodeBuddy 对多包工程的上下文感知范围未正确扩展。以下是处理该问题的多种策略：
一、启用多包上下文感知模式
CodeBuddy 默认以单文件为单位进行补全分析，而在 monorepo 中需主动激活跨包语义理解能力，使其能解析 workspace 配置、包间依赖关系及导出接口。
1、在 VS Code 或 JetBrains IDE 中打开项目根目录，确保存在 pnpm-workspace.yaml、lerna.json 或 nx.json 等工作区配置文件。
2、进入 CodeBuddy 设置面板，将 "Context Awareness Level" 调整为 "Workspace-wide"。
3、重启 IDE 并等待状态栏显示 "Monorepo context loaded (X packages)" 提示。
二、手动注册包内导出声明
当自动解析失败时，可通过显式声明方式引导 CodeBuddy 识别包间 API 边界，尤其适用于未使用标准导出语法（如 index.ts 全量 re-export）的子包。
1、在项目根目录下创建 .codebuddy/exports.json 文件。
2、按如下格式录入关键包的公共接口路径：
3、填写内容示例：{"@myorg/ui": ["src/components/index.ts", "src/hooks/index.ts"], "@myorg/utils": ["src/index.ts"]}。
4、保存后执行命令行指令：codebuddy reload-exports。
三、配置 TypeScript 项目引用（Project References）
利用 TypeScript 原生的 composite: true 和 references 机制，使 CodeBuddy 复用 tsc 的增量构建上下文，提升跨包类型补全精度。
1、为每个子包的 tsconfig.json 添加 "composite": true 字段。
2、在根目录 tsconfig.json 中添加 "references" 数组，列出所有子包 tsconfig 路径。
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 问题
3、确保各子包 package.json 的 "types" 字段指向有效声明文件（如 "types": "./dist/index.d.ts"）。
4、运行 tsc --build 完成首次增量编译，触发 CodeBuddy 自动加载项目引用图。
四、使用 Craft Mode 进行跨包代码生成
对于需同步修改多个包的场景（如新增一个共享 Hook 并在 UI 包中调用），Craft Mode 可基于自然语言指令驱动多文件协同生成，绕过传统补全的局部性限制。
1、在任意编辑器位置输入指令：/craft add useAuthState hook to @myorg/utils and consume it in @myorg/ui/LoginPage。
2、确认指令后，CodeBuddy 将自动分析依赖拓扑，定位目标包路径与导出规范。
3、生成内容包含：@myorg/utils/src/hooks/useAuthState.ts 实现文件、@myorg/utils/src/index.ts 导出更新、@myorg/ui/src/pages/LoginPage.tsx 调用插入。
4、所有生成代码均通过 tsc --noEmit 类型校验后再提交至编辑器。
五、禁用隔离沙箱以启用全局符号索引
部分 monorepo 构建工具（如 Nx）默认启用沙箱化执行环境，导致 CodeBuddy 无法访问其他包的源码树。关闭沙箱可强制其建立完整符号索引。
1、在 IDE 设置中找到 CodeBuddy 的 "Execution Environment" 选项。
2、将 "Isolation Mode" 切换为 "Disabled"。
3、在终端中执行：npx nx reset && codebuddy rebuild-index（适用于 Nx 工作区）。
4、观察日志输出中是否出现 "Global symbol index built: X symbols from Y packages"。
