与通用 AI 对话不同，CodeBuddy 支持在提问时通过 @ 符号直接引用项目内的真实资源。这能显著减少 AI"瞎猜"的情况，让生成的代码、诊断结论与重构建议都基于你当前项目的实际内容。
3.4.1 @文件：关联单文件代码内容
在侧边栏对话框中输入 @，选择"文件"，或直接输入文件名关键词，即可将某个文件的完整内容绑定到当前对话上下文中。
- 典型用法：
- 让 AI 解释某个复杂函数的实现逻辑（无需手动复制粘贴）。
- 基于现有实体类生成对应的 DAO 或 Service 代码。
- 同时
@多个文件，让 AI 对比差异或找出接口定义与实现的不一致之处。 - 操作建议：引用单文件时，如果文件过长，AI 会自动聚焦在关键函数与接口定义上。若你想针对文件中某一段落深入追问，建议先在编辑器内选中该段代码，再打开对话，AI 会自动将其作为当前上下文优先参考。
3.4.2 @目录：绑定项目全局上下文
通过 @目录 可以将整个文件夹（如 src/services、utils）加入对话。这适用于需要跨文件理解或批量修改的场景。
- 典型用法：
- 新接手项目时，让 AI 梳理某个模块的调用链路。
- 批量为某个目录下的所有接口生成统一风格的单元测试。
- 在多个文件间抽取公共函数，统一重构。
- 注意事项：目录内容较多时，系统会进行智能摘要，优先提取关键文件（如入口、配置、接口定义）。如果你发现某些边缘文件未被纳入分析，可单独再
@该文件作为补充。
3.4.3 @终端：引用运行报错与输出结果
程序运行报错或测试失败时，无需手动复制终端里的堆栈信息。直接在对话中 @终端，CodeBuddy 会自动捕获当前终端面板的最新输出（包括报错日志、编译输出、脚本打印等）。
- 典型用法：
- 服务启动崩溃，直接
@终端询问"这个报错是什么原因"。 - 单元测试失败，引用终端输出让 AI 定位具体断言语句的问题。
- 构建脚本异常，结合终端日志询问修复步骤。
- 实用技巧：如果终端输出特别长（如数千行日志），建议先手动清理终端或只保留最近一次报错，再执行
@终端，以便 AI 精准定位最近一次的异常，而非被历史日志干扰。
3.4.4 @规则：导入团队编码规范
团队通常对命名、注释、代码格式有统一要求。通过 @规则 可以绑定项目内的规范文件（如 coding-standard.md、.prettierrc、ESLint 配置或企业私有规则集），让 AI 在后续生成或重构时自动遵循。
- 典型用法：
- 要求 AI 生成代码时必须使用团队指定的前缀命名法或特定异常处理模式。
- 强制生成的注释遵循 Javadoc / JSDoc 等固定格式。
- 在重构旧代码时，自动将不符合新规范的写法统一调整。
- 配置方式：首次使用时，在设置中指定规则文件路径，或直接在对话框
@规则并选择对应文件。规则一经绑定，在同一会话内持续生效，直到你主动取消或切换规则。