CodeBuddy需正确识别pnpm workspace结构以支持Monorepo开发：一、确认其能解析pnpm-workspace.yaml并设工作区根路径为Monorepo顶层；二、手动配置包映射关系；三、将构建命令替换为pnpm build等workspace-aware脚本；四、禁用内置依赖解析器，复用pnpm node_modules；五、将pnpm store路径加入缓存白名单并启用符号链接缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用CodeBuddy辅助开发Monorepo项目，但发现其对依赖解析、跨包构建或pnpm workspace协同支持不明确，则可能是由于CodeBuddy未正确识别工作区结构或未适配pnpm的符号链接机制。以下是解决此问题的步骤：
一、确认CodeBuddy对pnpm workspace的元数据感知能力
CodeBuddy需能读取根目录下的pnpm-workspace.yaml文件并据此建立包间拓扑关系。若其仅扫描单一package.json而忽略workspace声明，将无法识别本地包引用（如"@myorg/utils": "workspace:*"）。
1、在项目根目录检查是否存在pnpm-workspace.yaml文件，且内容符合规范格式。
2、运行pnpm ls --depth=0验证pnpm是否能正确列出所有workspace包。
3、启动CodeBuddy时，确保其工作区根路径指向Monorepo顶层目录，而非某个子包内部路径。
二、手动注入workspace上下文至CodeBuddy配置
当CodeBuddy未自动加载workspace信息时，可通过显式配置补全包映射关系，使其理解packages/utils与apps/web间的依赖链路。
1、在CodeBuddy项目设置中查找“Dependency Mapping”或“Workspace Override”字段。
2、添加键值对："packages/utils": "./packages/utils"、"apps/web": "./apps/web"。
3、保存后重启CodeBuddy语言服务器，触发重新索引。
三、利用pnpm脚本桥接CodeBuddy构建流程
CodeBuddy默认调用npm run build，但pnpm workspace需通过pnpm build或pnpm -r build执行递归构建。直接复用原命令会导致子包构建失败或跳过依赖前置步骤。
1、在根目录package.json的scripts中定义统一构建脚本："build": "pnpm -r --filter=./apps/** build"。
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、在CodeBuddy的“Build Command”设置项中，将命令替换为pnpm build。
3、对需类型检查的TS项目，补充"type-check": "pnpm -r tsc --noEmit"并绑定至CodeBuddy的保存时校验钩子。
四、禁用CodeBuddy的独立node_modules解析逻辑
CodeBuddy若启用内置的依赖解析器，会绕过pnpm的硬链接存储（~/.pnpm-store），导致模块路径解析失败或提示“Cannot find module”。必须强制其复用pnpm生成的node_modules结构。
1、在CodeBuddy设置中定位“Node.js Module Resolution”选项。
2、关闭“Use built-in dependency resolver”开关。
3、指定node_modules路径为当前工作区根目录下的node_modules，而非子包内路径。
五、配置pnpm store路径白名单以支持CodeBuddy缓存加速
CodeBuddy在分析大型Monorepo时可能因重复读取全局store中的依赖而卡顿。通过预加载store路径，可显著提升类型推导和跳转响应速度。
1、执行pnpm store path获取当前store绝对路径。
2、在CodeBuddy的“Cache Directories”设置中，添加该路径至白名单列表。
3、勾选“Enable cache for symlinked dependencies”选项，确保硬链接目标被纳入索引范围。
