@关联上下文
更新时间:2026-03-04
自主识别上下文
Comate会根据当前正在打开的文件和你的Prompt识别对话的相关性,并自动添加到上下文中。分为3种情况:
- 弱引用整个文件:Comate自动捕捉当前的打开的文件,并在输入框中以「虚线」的方式提示你这个文件被弱引用。
文件的弱引用是指这个文件的路径会被组装到Agent的上下文中,文件的内容不会被组装,当Agent根据你的输入判断需要获取文件内容时,它会根据文件路径读取内容。
- 强引用整个文件:你可以直接在弱引用的文件(虚线文件)上点击,点击后将变成强引用,「虚线」变成「实线」。
强引用是指这个文件的路径和内容都会被组装到Agent的上下文中。

- 弱引用某段代码块:通过光标选中正在打开的文件中的某段代码,Comate会自动捕捉当前代码片段,并在输入框中以「虚线」的方式提示你这段代码被弱引用。
代码块的弱引用是指这个文件的路径和选中的代码块行号会被组装到Agent的上下文中,文件的内容不会被组装,当Agent根据你的输入判断需要获取代码块内容时,它会根据上述读取内容。

- 强引用某段代码块:通过光标选中正在打开的文件中的某段代码或终端输出,然后「右键」选择
Add Selected Code To Chat或Add Selected Terminal To Chat,此时选中的内容将被强引用。
手动添加上下文
你还可以手动为Comate添加更多的上下文,以帮助Agent更准确地理解当前任务,使用@快速调起可添加的上下文列表。
| 类型 | 作用 |
|---|---|
@Files |
指定具体的文件,给出 Agent 需要明确参考或者理解的代码范围,避免 Agent 发散理解。 |
@Folders |
指定具体的目录,给出 Agent 需要明确参考或者理解的代码范围,避免 Agent 发散理解。 |
@Terminal |
获取当前终端的信息,包括命令执行结果、日志输出或报错信息。Agent 可以基于真实的运行反馈进行分析、定位问题并给出下一步操作建议,而不是仅凭静态代码推断。 |
@Git Diff |
只针对Git仓库有效,用于获取git diff信息,通过 Git Diff,Agent 可以聚焦于“发生了什么变化”,更准确地进行代码评审、问题定位或后续修改,减少对无关代码的干扰。 |
@Rules |
用于手动关联Rules文件,用于约束 Agent 的行为方式和输出结果,包括编码规范、技术栈限制、架构原则、安全要求或业务规则等。规则类上下文会在整个任务过程中持续生效,确保生成结果符合既定约定。 |
@Docs |
@Docs功能可以让你利用文档来帮助编写代码,将本地文档上传到知识集中,即可在Comate中引用,可以引用一个知识集或某个具体的文件。 |
管理上下文
随着对话持续深入、引用越来越多上下文(文件、日志、文档等),模型 Tokens(消耗会快速增长,进而影响 Agent 响应质量、记忆能力和整体稳定性。Comate 提供可视化的 Tokens 使用反馈与手动/自动压缩上下文的能力,帮助你直观监控对话“记忆”状态并主动控制上下文规模。你可以通过三个维度去使用这个能力:
- Tokens 用量可视化:在对话界面的输入区域内,实时展示当前会话已占用的上下文比例,用于直观反映模型当前“可记住的信息量”。
- 自动压缩上下文:随着对话不断增长,Comate 会持续计算上下文占比,并在合适的时机自动进行上下文压缩。系统会保留关键结论和必要信息,对冗余细节进行总结或裁剪,在释放上下文空间的同时尽量保持对话语义的连续性。
- 手动管理上下文:当上下文占比超过 70% 时,Comate 会在界面中进行提示,引导开发者主动管理上下文,例如触发压缩或调整当前对话内容,以避免上下文过载影响后续交互质量。

