DeepSeek-Reasonix的@引用功能：如何把文件和MCP资源精准喂给AI
【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix
DeepSeek-Reasonix是一个面向终端的 DeepSeek 原生 AI 编码智能体，其核心卖点之一是前缀缓存稳定设计。对新手来说，最容易上手的提效技巧就是@ 引用功能：在消息里敲一个@，即可把本地文件、目录、图片甚至 MCP 资源精准"喂"给 AI，省去大段复制粘贴，让模型在正确的上下文中一次做对。
为什么要用 @ 引用？
直接让 AI"看一下 src 里那个文件"，它只能自己去猜、去翻；而@引用是发送前由客户端解析的确定性动作：Reasonix 会把每个引用展开成带标签的上下文块，随消息一起注入模型。好处有三：
- 🎯精准：引用的是磁盘上真实存在的内容，不是模型的"印象"
- ⚡省 token：自动截断超大文件，不会撑爆上下文窗口
- 🧩多源：本地路径与 MCP 资源共用同一套
@语法
两类 @ 引用语法一览
| 语法 | 指向 | 注入内容 |
|---|---|---|
@path/to/file | 本地文件 | 文件文本内容（上限 64KB） |
@dir | 本地目录 | 递归目录清单（≤100 项、≤16 层） |
@<server>:<uri> | MCP 资源 | 资源正文 |
@.reasonix/attachments/img.png | 图片附件 | 视觉输入（64MB 内） |
💡 关键规则：本地路径只有真实存在时才会被当作引用，普通
@mention（如邮箱、昵称）原样保留，不会误伤。
引用本地文件与目录：一步到位
在消息中直接写路径即可，例如：
帮我把 @internal/control/refs.go 里的截断逻辑解释一下
几个值得知道的细节：
- 📦大文件自动截断：单个文件最多注入 64KB，保留头部并标注截断，见 refs.go 中的
maxFileRefBytes常量 - 🌲目录只给清单：引用目录得到的是"目录清单+提示"，不会把每个文件都塞进来，需要哪个文件再点名引用
- 🗑️噪音过滤：
node_modules、.git、build等目录自动跳过；二进制文件（头部含 NUL）只给说明，不倾倒乱码 - 🛠️带空格的路径：补全菜单会自动用反斜杠转义空格，你不需要手动处理
- 🏷️路径级指令：引用某个目录/文件时，位于其路径链上的
AGENTS.md等指令文档会一并附加，见 refs.go
引用 MCP 资源：@<server>:<uri>
Reasonix 把 MCP（Model Context Protocol）服务器的resources也接入了@语法：
- 先在 reasonix.toml 的
[[plugins]]或项目根目录的.mcp.json中配置服务器 - 会话启动后服务器自动连接，用
/mcp查看已连接服务器及其暴露的资源 - 在消息中写
@stripe:invoices/123之类的@<server>:<uri>，发送时资源正文就被拉进上下文 - 某个资源拉取失败时，会给出逐条引用错误提示，而不是整条消息失败
资源补全逻辑见 complete.go 的resourceItems。官方参考实现reasonix-plugin-example自带一个 style-guide 资源可以照抄学习，相关说明在 docs/GUIDE.zh-CN.md。
补全菜单与拖拽：不记语法也能用
敲@或/会弹出补全菜单：@菜单提供逐层文件导航（一次只列当前一层，可下钻子目录）外加 MCP 资源；方向键移动、Tab/Enter选中、Esc关闭。
更顺手的是两个"无感"能力（实现在 refs.go）：
- 📄拖拽/粘贴文件：把文件拖进来或粘贴纯路径，Reasonix 会自动改写成
@引用附上 - 📍报错定位：以绝对路径开头的诊断信息（如编译器错误），原文保留的同时自动附上该文件上下文
新手上手清单
- 先跑通
@README.md这类简单文件引用，观察回复中引用的效果 - 引用一个目录
@docs/，看看清单格式，再点名其中一个文件 - 配置一个 MCP 服务器后，用
/mcp找到资源 URI，再尝试@server:uri - 想引用历史会话？参考架构文档 docs/SESSION_REFERENCE_ARCHITECTURE.md 中的
@菜单扩展设计
延伸阅读
- 官方指南 @引用 章节：docs/GUIDE.zh-CN.md
- 引用解析核心源码：internal/control/refs.go
- MCP 服务器配置与
.mcp.json兼容说明：docs/GUIDE.zh-CN.md - CLI 命令参考：docs/CLI.zh-CN.md
掌握@引用后，你会发现和 AI 协作的沟通方式从"描述"变成了"点名"——上下文越精准，前缀缓存越稳定，这正是 DeepSeek-Reasonix 的设计初衷。
【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
