文档对话
文档目录

附件与引用

输入框里用 @ 文件、& 会话、/ Skill、# MCP、~ 待办日程,加上附件和拖拽,决定这一轮 Agent 拿到什么材料。

更新于 2026年11月10日

给 Agent 材料有两种方式:附件把内容放进上下文,引用只给一个指针,由 Agent 按需读取。输入框里五个触发符加上拖拽,覆盖了全部入口。

触发能引用什么候选来源
@文件项目目录、附加目录、会话文件
&历史会话会话索引与全文
/Skill当前项目已启用的 Skills
#MCP 服务当前项目 MCP 配置里已启用且验证通过的服务
~ 或 ~待办和日程未完成的清单项与近期日程

附件

  • 点输入框左下的「附加文件」按钮选文件;粘贴超长文本也会自动变成附件。
  • 附件条目显示在输入框上方,可以预览、单独删除,发送时内容一起进上下文。
  • 一次性参考材料落在会话草稿区,不进项目目录。
  • 粘贴超过 2000 字的长文本会自动转成附件,设置里可以关掉这条。
  • 输入框开启 Markdown 渲染时,附件与引用都以 chip 形式显示,点开能看详情。

拖拽进来的文件默认不是附件,而是引用,见下文「拖拽」。

@ 引用文件

  • 输入 @ 出候选,继续敲路径片段筛选,回车选中。可以一次引用多个文件。
  • 只传路径不传正文,Agent 自己决定读哪一段,大文件只需其中一小段时,用引用比粘贴更省。
  • 候选范围包含项目目录、附加目录和会话文件;不在这些范围内的文件,先附加目录或拖成附件。

& 引用历史会话

  • 输入 & 搜索历史会话。会显示最近 200 条,输入关键词后走全文匹配,最多返回 20 条。
  • 也可以从左侧会话列表的「引用此会话」选,或直接把会话拖进输入框。
  • 当前这一条会话不会出现在候选里,避免自己引用自己。

/ 引用 Skill

  • 输入 / 列出当前项目可用的 Skill,只含已启用的。
  • 选中后 Skill 名以 chip 插入提示,Agent 按这个 Skill 的说明执行。

# 引用 MCP 服务

  • 输入 # 列出当前项目 MCP 配置里的服务。
  • 只有已启用并且连接验证通过的才会出现。没候选通常是还没在 MCP 管理里完成启用和握手验证。
  • 引用后提示里点名该服务,Agent 会沿它的工具调用。

~ 引用待办和日程

  • 输入 ~(或全角 ~)列出未完成的清单项和近期日程。
  • 适合「把这条待办拆成步骤」「围绕这个会准备材料」这类指代明确的请求。

拖拽

每种拖拽落点逻辑不同,不要默认都按附件处理:

  • 会话行(左侧列表)拖进输入框:插入会话引用,等价于 &。拖当前这一条会被拒绝并提示。
  • 右侧文件面板的文件拖进输入框:插入文件引用。
  • 文件夹拖进输入框或右侧面板:先附加成目录,再插入引用——失败不会留下指向不可访问路径的空引用。
  • 系统文件管理器的文件拖进输入框:先复制到会话私有目录,再插入引用;超过大小上限或还没有项目时,退回成附件。

注意

  • 划词引用是另一条路径:选中消息里的文字可以直接就该段追问,不用复制粘贴。
  • 附件会把文件复制进草稿区,引用只给指针;同一个材料反复用时的归属选择见「附加目录」。
  • 同一段结论被反复 & 引用,说明它应沉淀进 AGENTS.md 或记忆,而不是每次把整个会话拖进来。
本页内容