附件与引用
输入框里用 @ 文件、& 会话、/ 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或记忆,而不是每次把整个会话拖进来。