本地文件夹

何时用本地文件夹

本地文件夹是指向本机目录的具名书签。它适合“偶尔会引用、但不想每次都切换过去”的资料目录，而当前正在推进的项目仍然应该交给工作目录。

本地文件夹不会改变文件的存放位置，它只是给一个已有的目录起一个稳定的名字，让 Agent 与你在对话里都能明确指的是同一份内容。

本地文件夹同样通过来源目录里的 config.json 声明。路径必须是绝对路径，并且指向运行工作台的环境里真实存在的目录。

路径写错时校验会直接失败，这是最常见的问题。本地目录来源不涉及网络，凭据、令牌与授权范围都不需要配置。

试一试

{ "type": "local", "name": "我的笔记", "slug": "my-notes", "enabled": true, "provider": "local", "local": { "path": "/Users/me/Documents/Notes" } }

添加本地文件夹不需要额外的服务或授权，只要路径可读就能完成。添加之后做一次连接校验，确认目录确实存在并且当前运行环境可以访问。

多个本地文件夹可以同时存在，各自指向不同目录。它们互不影响，删除其中一个不会动到其他目录里的文件。

本地文件夹可以附带一份说明文件。它告诉 Agent 这个目录里有什么、该怎么走、有哪些命名与整理习惯，Agent 在读取时就有了上下文，不必每次靠猜。

值得写进说明的内容包括：目录的大类构成、命名规则或分类方式、需要谨慎处理的文件，以及明确不要做的事。写清楚边界比写背景更有用。

试一试

# 桌面临时文件与下载内容。这里存放最近的截图和导出结果。 ## 内容 - 截图文件 - 下载的 PDF 与文档 - 各应用导出的临时文件 ## 约定 - 截图统一放在 /Screenshots 子目录 - 不从这里提交任何内容到代码仓库

默认情况下，本地文件夹在只读模式下就可以使用，但只开放读取类命令，例如列目录、查看文件内容和查找匹配项。写入与删除类操作需要更高的权限档位。

需要放行更多只读命令时，在来源目录里加一份 permissions.json，逐条写明允许的命令模式。命令模式同样会自动限定在当前来源内部。

试一试

{ "allowedBashPatterns": [ { "pattern": "^ls\\s", "comment": "允许列出目录内容" }, { "pattern": "^tree\\s", "comment": "允许显示目录结构" } ] }

两者都能让 Agent 读到文件，但定位完全不同。工作目录是你正在推进的那个项目，本地文件夹是你偶尔会引用的资料。

两者的差别最终落在权限上。工作目录默认给到完整工具权限，适合放开手改代码；本地文件夹默认只读，更适合放需要保持原样的资料。