跳转到主要内容
为 AI 对话添加上下文,让 AI 准确理解需求并生成符合项目规范的代码。支持添加代码文件、项目目录、本地附件和项目规则。

添加上下文的方式

上下文类型

@file

引用项目中的代码文件,支持查询和修改。

添加方式

  • 输入 @file 后输入文件名搜索
  • 从资源管理器拖拽文件到聊天框
规则文件(如 .qoder/rules 目录中的文件)也可通过 @file 搜索。

@folder

引用整个目录,适合需要理解或修改一组相关文件的场景。

添加方式

输入 @folder 后输入目录名搜索

@attachments

引用本地文件或图片,让 AI 分析文档内容、根据设计稿生成代码或处理表格数据。

支持的文件类型

添加方式

  • 输入 @attachments 选择本地文件
  • 直接拖放或复制粘贴文件到聊天框
  • 图片会在输入框顶部独立展示,支持预览

@rule

引用项目规则,让 AI 遵循特定的编码风格、框架约定或业务规范。 规则会嵌入到每次模型调用的系统提示中,提供持久、可复用的上下文。适合定义编码风格、命名规范、框架使用约定等需要在整个项目中保持一致的指导信息。

添加方式

  • 输入 @rule 选择已配置的规则
  • 规则列表为空时,可通过快捷入口直接创建新规则,无需跳转到设置页面
规则文件(如 .qoder/rules 目录中的 .md 文件)既可作为 @rule 类型引用(持久上下文),也可通过 @file 类型搜索(普通文件)。

Add to Chat

文件(包括代码文件和 Spec 文件)支持细粒度的选中编辑。你可以在文件中选中任意内容片段,通过以下方式将其添加到当前会话:
  • 点击浮窗中的 Add to Chat
  • 使用快捷键 Command+L(macOS)/ Ctrl+L(Windows/Linux)
选中的内容将作为上下文附加到输入框,帮助智能体更精准地理解你的意图。 会话流中的内容同样可以添加到当前对话——在会话流中选中一段回复或引用某段内容后,通过 Add to Chat 一并附加到输入框,便于在同一对话中承接上下文,减少重复输入。

使用技巧

组合多种上下文

在同一个提问中组合多种上下文类型:

利用推荐列表

输入 @ 后,列表上方会推荐常用文件:
  • 当前文件:正在编辑的文件
  • 最近打开:最近访问的 2 个文件
点击推荐文件可快速添加,无需搜索。

实时检索

输入 @ 后继续键入,Qoder 会实时检索匹配的文件、目录和规则,并高亮显示匹配字符。