文档会话与项目
文档目录

附加目录

让 Agent 访问项目外的文件夹;会话级只属于当前会话,项目级同项目会话共享。

更新于 2026年11月10日

场景

需要的文件不在项目目录里,又不想为它单开一个项目:把那个文件夹附加进来。附加后 Agent 可以在里面读文件、改文件、执行命令,右侧文件区也能像项目目录一样展开浏览。

两个层级

  • 会话级:只在当前会话有效,其他会话不可见。右侧「文件」面板顶部的「附加文件夹」加进来,也可以直接把文件夹拖到面板里。
  • 项目级(附加项目文件夹):登记在项目上,同一项目下的所有会话共享。适合一个项目要长期参考的固定外部目录。

两层用同一套交互:文件树里展开、点文件预览、右键加到对话,也可以对该目录单独开一个终端。

权限边界

附加目录算授权范围:Agent 的读写和终端命令都限于「项目根 + 附加目录」,没附加的路径不会主动读取。

注意

  • 会话级附加信息存在会话元数据里,重开这个会话仍然有效。
  • 不要附加整个用户目录或系统根目录:授权范围过大时,误改无关文件的风险较高。
  • 跨项目长期要用的东西,正确做法是建项目或把文件放进项目,而不是每次手动附加。
本页内容