cherry studio 中文文档 下载 App

Cherry Studio Agent 工作目录,给它一个文件夹它就能读写生成

为什么要工作目录

Agent 能读写文件是它和对话助手最大的区别——但这个能力需要被约束。如果不给它一个范围,它可能误删系统文件、覆盖你的重要文档、或者在 C 盘根目录乱生文件。

工作目录就是给 Agent 画的安全圈:它只能在你指定的文件夹范围内读写。在这个目录里它可以自由创建、修改、删除文件;目录外它读不到、写不进。

怎么选工作目录

在 Agent 工作区顶部,选中 Agent 后旁边有工作目录选择器。点击后可以:

选好后,Agent 的文件读写操作就被限制在这个目录里了。如果你的 Agent 不需要操作本地文件(比如只是帮你查知识库、调 MCP 工具),可以留空用默认工作区。

Agent 在工作目录里能做什么

操作说明
读取文件读工作目录内的任意文件内容(txt、md、json、代码文件等)
创建文件在工作目录里新建任意格式文件
修改文件读取后改写再保存(增量写入或整文件重写)
创建子目录在工作目录下创建新的子目录结构
删除文件删除工作目录内的文件(谨慎!)
列目录查看工作目录下的文件列表

典型场景

Agent 任务工作目录建议
从会议纪要提取待办事项并生成表格新建 /agent-outputs/todo-extractor/,让它只写这里
帮你重构项目代码项目根目录(~/projects/my-app/),谨慎!
整理知识库里的资料并生成总结新建 /agent-outputs/kb-summaries/
批量处理一批 Excel 数据数据文件所在目录的父级,让它能读数据、在同级建输出目录

文件安全建议

  1. 新建专用目录:第一次用新 Agent 时,先给它建一个空目录,而不是直接指向你已有的项目目录
  2. 权限模式配合:用"逐次确认"模式跑第一轮,确认 Agent 的操作都在预期内再切换到放手模式
  3. 重要目录先备份:如果让 Agent 操作已有项目目录,先 Git commit 或手动备份
  4. 只在明确需要时给文件权限:如果 Agent 的任务不需要文件操作(比如只是帮你查知识库、调 API),工作目录可以留空

工作目录和 MCP 文件系统的关系

如果你挂载了 MCP 文件系统工具(比如远程服务器上的目录),Agent 同时拥有两个文件空间:本地工作目录 + MCP 文件系统。Cherry Studio 会在右侧面板的工具调用链里标注清楚每次文件操作是在哪个空间发生的。