当问题涉及模块间调用、项目架构梳理，或需要仿照现有目录批量生成新代码时，仅关联单个文件往往不足以让 AI 理解全局。@目录允许你将整个文件夹作为上下文引入对话，使回答具备跨文件的视野。
如何使用
在侧边栏对话面板的输入框中，键入 @ 符号，在弹出的上下文菜单中选择 @目录，随后浏览勾选目标文件夹（如 src/services 或项目根目录）。确认后，该目录下的文件结构树及关键代码内容会被纳入当前对话上下文，供模型一并分析。
典型使用场景
- 项目结构快速梳理：直接
@src或某个业务目录，询问"请梳理这个模块的调用链路"或"找出处理支付回调的核心文件在哪几处"。 - 批量风格仿写：将已有的
modules/user目录作为上下文，要求"参照用户模块的目录结构、命名规范和错误处理方式，生成一个新的订单管理模块"。 - 跨文件依赖排查：绑定根目录或核心目录后，询问"项目中是否存在循环引用"或"哪些组件直接依赖了这个工具函数"。
- 配置冲突定位：将包含多个配置文件的目录（如项目根目录）关联后，让 AI 对比
tsconfig.json、vite.config.ts与package.json中可能冲突的选项。
使用建议与注意事项
- 控制粒度，避免根目录滥用：大型项目直接绑定根目录时，
node_modules、dist、logs等目录即使被过滤，剩余的有效文件仍可能超出上下文长度限制，导致关键文件被截断。建议按业务域选择子目录（如@components/form或@server/api），精准且高效。 - 自动过滤机制：CodeBuddy 默认会遵循
.gitignore规则排除依赖目录和构建产物。如果项目中使用了非标准目录名存放大量资源，可在 设置 > 智能上下文引用 > 索引排除规则 中手动添加排除路径。 - 性能与额度：绑定目录后，首轮索引与解析通常需要 1–5 秒，且会占用更多对话 Token。建议先用
@文件定位关键单文件，确需全局视角时再升级到目录级别。 - 隐私提醒：绑定目录后，该目录下的代码摘要会上传至服务端用于上下文分析。处理含敏感密钥或硬编码凭据的文件时，请先清理或将其移出目标目录。