拖进远程 Agent 的文件不进工作区

Cursor 3.23:把本机文件拖进、粘贴或附加到 SSH、WSL、开发容器上的 Agent 时,Agents Window 会拷到那台机器,并在对话里提到。副本在工作区外的上传目录,不算工作区改动。慢拷贝有进度。云端拖文件夹另算,一次最多 20 个,且跳过隐藏文件。

拖进远程 Agent 的文件不进工作区

远程机器上的 Agent 读不到你拖进对话框、却仍留在笔记本上的那份文件。cursor 远程 agent 拖文件 时,Cursor 3.23 的做法是:从本机拖入、粘贴或附加文件或文件夹到跑在远程机器上的 Agent 提示里,Agents Window 把副本拷到那台机器,并在对话里提到这次拷贝。说明点名的远程环境是 SSH、WSL 和开发容器。

作者:CodePass 技术编辑

副本在工作区外面

发布说明写:副本进入单独的上传目录,位于工作区之外,所以不会出现在工作区改动里。git status 干净,不表示文件没拷过去。要找的是对话里提到的那次拷贝,不是分支上的新文件。目录的具体路径说明没有给出,只叫它上传目录。写作日没有在 SSH 会话里把这个目录名对出来。

拷贝较慢时会有进度通知。没有写失败时对话框里留不留半份文件,也没有写大小上限。对话里没有出现「已拷贝」一类提示时,不要假设 Agent 已经能读到你拖的那份。本机路径和远程路径不是同一个字符串。

只在本机 Agent 的提示里拖文件,不走这段拷贝。这句的主语是「跑在远程机器上的 Agent」。本机仓库里拖进去的文件,仍按你原来的附件方式处理。

云端 Agent 拖文件夹是另一条上限

同一节还有一句,对象是云端 Agent:把文件夹拖到云端 Agent 的提示上,会附上里面的文件,跳过隐藏文件。每次拖放最多 20 个文件。文件夹里更多时,会通知你只加了前 20 个。这不是 SSH 那条「拷到上传目录」。云端这条说的是附加,没有写进工作区外的上传目录。

隐藏文件被跳过之后,Agent 看不到以点开头的那部分。20 个上限按这一次拖放计算。说明没有写先拖 20 个、再拖剩下的能否凑齐,也没有写排序规则,所以「前 20 个」不要理解成按文件名排序后的前 20 个,除非产品之后补了这句话。

远程开发时,要给 Agent 看的配置放在非隐藏文件里,或在提示里写明远程路径让它自己读。不要把只存在于本机、且没出现在拷贝提示里的文件,当成远程 Agent 的上下文。

参考资料