Cherry Studio Agent 工作目录,给它一个文件夹它就能读写生成
为什么要工作目录
Agent 能读写文件是它和对话助手最大的区别——但这个能力需要被约束。如果不给它一个范围,它可能误删系统文件、覆盖你的重要文档、或者在 C 盘根目录乱生文件。
工作目录就是给 Agent 画的安全圈:它只能在你指定的文件夹范围内读写。在这个目录里它可以自由创建、修改、删除文件;目录外它读不到、写不进。
怎么选工作目录
在 Agent 工作区顶部,选中 Agent 后旁边有工作目录选择器。点击后可以:
- 从最近使用的目录列表里选
- 浏览文件系统选择任意文件夹
- 新建一个子目录专门给这个 Agent 用
选好后,Agent 的文件读写操作就被限制在这个目录里了。如果你的 Agent 不需要操作本地文件(比如只是帮你查知识库、调 MCP 工具),可以留空用默认工作区。
Agent 在工作目录里能做什么
| 操作 | 说明 |
|---|---|
| 读取文件 | 读工作目录内的任意文件内容(txt、md、json、代码文件等) |
| 创建文件 | 在工作目录里新建任意格式文件 |
| 修改文件 | 读取后改写再保存(增量写入或整文件重写) |
| 创建子目录 | 在工作目录下创建新的子目录结构 |
| 删除文件 | 删除工作目录内的文件(谨慎!) |
| 列目录 | 查看工作目录下的文件列表 |
典型场景
| Agent 任务 | 工作目录建议 |
|---|---|
| 从会议纪要提取待办事项并生成表格 | 新建 /agent-outputs/todo-extractor/,让它只写这里 |
| 帮你重构项目代码 | 项目根目录(~/projects/my-app/),谨慎! |
| 整理知识库里的资料并生成总结 | 新建 /agent-outputs/kb-summaries/ |
| 批量处理一批 Excel 数据 | 数据文件所在目录的父级,让它能读数据、在同级建输出目录 |
文件安全建议
- 新建专用目录:第一次用新 Agent 时,先给它建一个空目录,而不是直接指向你已有的项目目录
- 权限模式配合:用"逐次确认"模式跑第一轮,确认 Agent 的操作都在预期内再切换到放手模式
- 重要目录先备份:如果让 Agent 操作已有项目目录,先 Git commit 或手动备份
- 只在明确需要时给文件权限:如果 Agent 的任务不需要文件操作(比如只是帮你查知识库、调 API),工作目录可以留空
工作目录和 MCP 文件系统的关系
如果你挂载了 MCP 文件系统工具(比如远程服务器上的目录),Agent 同时拥有两个文件空间:本地工作目录 + MCP 文件系统。Cherry Studio 会在右侧面板的工具调用链里标注清楚每次文件操作是在哪个空间发生的。