附加目录
让 Agent 访问项目外的文件夹;会话级只属于当前会话,项目级同项目会话共享。
更新于 2026年11月10日
场景
需要的文件不在项目目录里,又不想为它单开一个项目:把那个文件夹附加进来。附加后 Agent 可以在里面读文件、改文件、执行命令,右侧文件区也能像项目目录一样展开浏览。
两个层级
- 会话级:只在当前会话有效,其他会话不可见。右侧「文件」面板顶部的「附加文件夹」加进来,也可以直接把文件夹拖到面板里。
- 项目级(附加项目文件夹):登记在项目上,同一项目下的所有会话共享。适合一个项目要长期参考的固定外部目录。
两层用同一套交互:文件树里展开、点文件预览、右键加到对话,也可以对该目录单独开一个终端。
权限边界
附加目录算授权范围:Agent 的读写和终端命令都限于「项目根 + 附加目录」,没附加的路径不会主动读取。
注意
- 会话级附加信息存在会话元数据里,重开这个会话仍然有效。
- 不要附加整个用户目录或系统根目录:授权范围过大时,误改无关文件的风险较高。
- 跨项目长期要用的东西,正确做法是建项目或把文件放进项目,而不是每次手动附加。