# 本地文件夹怎么交给 AI 使用？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：主页与内容。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/folder_mounts/

## 添加目录（Pro）

在设置中搜索 **文件夹挂载**，打开后选择 **添加文件夹**，通过系统选择器选择目录，设置名称及只读／读写权限。依赖设备与系统的文件夹选择能力；提示不支持时仍可通过聊天附件提供文件。

## 在对话中使用

在普通对话工具栏点击 **挂载文件夹**（或输入框 **＋ → 文件夹**），启用本对话要使用的目录；若 **文件操作** 尚未开启，启用目录时会自动开启并轻提示；禁用全部目录不会关闭文件操作。通过 **管理挂载文件夹** 添加或管理目录，也可点击工具栏的 **挂载文件夹**，逐项启用或禁用；没有挂载目录时，工具栏与附件菜单均不显示文件夹入口。仅添加挂载不会自动向对话提供目录。若希望重复使用，可在文件夹管理中开启该目录的 **新对话默认启用**：之后的新对话会自动选择该目录并开启文件操作，已有对话不受影响。也可在 **助手设置 → 工具 → 挂载文件夹** 中关闭该助手的目录访问，或选择独立的新对话默认目录；未单独设置时沿用文件夹管理页的默认项，独立选择为空表示不自动启用。默认目录选择仅保存在本机，不随助手传送到其他设备。仍遵循目录读写范围和操作授权，可在单个对话中关闭。AI 只能访问当前对话已选择且系统授权有效的目录。PDF、Office 等文档可直接通过文件操作按需解析；开启读取图片后，可直接查看已选文件夹里的图片。无需先复制到工作目录，只读授权即可使用这些读取能力；视频不提供抽帧或内容理解。

## 新建子目录与保存文档

在 **设置 → 文件夹挂载 → 浏览文件** 中，点击文件夹逐层进入，点击顶部路径返回上级；读写模式下可在当前目录 **新建文件夹**。

在对话中可以说：“把刚才的总结保存到「学习资料」的「鸿蒙开发/知识总结」子目录，文件名为「目录授权.md」。”AI 会按文件操作权限请求写入；缺失的中间目录会一并创建。Markdown、TXT 可直接写入，已生成的 Word、PDF 等文件可以复制到指定子目录。只读目录不能新建、写入或删除。

## 删除与移除挂载的区别

- **删除原文件…**：通过文件或文件夹右侧菜单操作，先核对路径、文件及文件夹数量，再确认永久删除；不会进入回收站。AI 删除也每次单独确认，“始终允许”不能跳过。内容发生变化后需要重新核对；挂载根目录不能删除。
- **移除挂载**：只撤销访问，不删除本地文件。

当前支持列出、读取、复制、写入、文本编辑、新建及删除，暂不支持移动原文件。写入或删除失败可能已有部分变更，请以实际结果及恢复副本提示为准。

## 授权失败怎么办

目录选择依赖设备能力。若提示“系统未能保存文件夹授权”，表示系统返回的长期授权复核未通过，不代表选中了系统目录。可重新选择自己新建的普通文件夹；若仍失败，请反馈设备型号、系统版本及是否为模拟器。

## 管理与迁移

在对话中取消选择即可停止该对话访问；也可以切换读写模式、重新授权或移除挂载。移除不会删除原目录文件。授权失效时需重新选择确认；本地挂载不随备份、同步或碰一碰迁移，换设备后需重新授权。NAS、坚果云等网络存储见「怎么把 NAS 或网盘接进对话？」。