AgenticSeek 的 WORK_DIR 工作目录怎么设置才能让代理读写本地文件？

AgenticSeek 的 WORK_DIR 工作目录怎么设置才能让代理读写本地文件【免费下载链接】agenticSeekFully Local Manus AI. No APIs, No $200 monthly bills. Enjoy an autonomous agent that thinks, browses the web, and code for the sole cost of electricity.项目地址: https://gitcode.com/GitHub_Trending/ag/agenticSeekAgenticSeek 的代理File Agent 等只能在WORK_DIR指向的目录内读写文件目录外的路径会被直接拒绝。要让代理处理你机器上某个具体文件夹里的文件比如把搜索结果保存成rennes_cafes.txt、把 Go 程序保存为factorial.go需要先把这个目录通过WORK_DIR环境变量配置进.env再启动 Docker 服务让 backend 容器挂载它。适用前提已克隆仓库并完成mv .env.example .envDocker 已安装并运行Web 界面模式。设置 WORK_DIR 前必须满足的三个条件start_services.sh 在启动任何容器之前会依次校验WORK_DIR三条不满足都会直接报错退出# 1. WORK_DIR 未设置 Error: WORK_DIR environment variable is not set. Please set it in your .env file. # 2. WORK_DIR 指向仓库根目录脚本用真实路径对比软链接也算 Error: WORK_DIR must not be the AgenticSeek repository root. Set WORK_DIR to a separate folder for agent file access, e.g. ~/Documents/agenticseek_workspace # 3. 目录内容超过 20GB Error: WORK_DIR (...) contains more than 20GB of data (...)也就是说WORK_DIR必须是一个独立于 agenticSeek 仓库根目录的、内容总量不超过 20GB 的本地文件夹。选目录时按脚本提示用一个专用文件夹如~/Documents/agenticseek_workspace是最稳的做法——代理在里面执行 bash 命令和文件操作目录里放了什么它就可能动什么。在 .env 中配置 WORK_DIR在仓库根目录的.env文件由.env.example复制而来中修改WORK_DIR这一行填你本机文件夹的绝对路径WORK_DIR/Users/username/Documents/workspace_with_my_files上面是 .env.example 中的原始示例值README 中给的另一个示例是WORK_DIR/Users/mlg/Documents/workspace_for_ai两者都要替换成你自己机器的路径Linux 下即/home/用户名/...这类绝对路径。如果目标目录还不存在不用手动创建backend 启动时会确保目录存在缺失的WORK_DIR会被自动建出来sources/workspace.py 中的ensure_work_dir()tests/test_workspace.py 中test_ensure_work_dir_creates_missing_directory验证了这一行为。修改.env后必须重启服务才生效——.env只在进程启动时读取Docker 的挂载关系也是在容器创建时确定的。启动服务并确认挂载生效在仓库根目录执行Windows 用start start_services.cmd full./start_services.sh full脚本会先source .env通过上面的三项校验后打印挂载信息这是确认路径被正确读到的第一个信号Mounting /你的/WORK_DIR/绝对路径 (xxxx bytes) to docker.docker-compose.yml 中 backend 服务通过- ${WORK_DIR}:/opt/workspace把宿主机目录挂进容器容器内环境变量固定为WORK_DIR/opt/workspace。所以宿主机路径写.env容器内代理操作的始终是/opt/workspace两边是同一个目录你直接在本地文件夹里就能看到代理写入的文件。注意两点首次运行要下载并构建全部 Docker 镜像README 提示可能长达 30 分钟backend 首次启动也可能需要 5 分钟。发送消息前等 backend 日志出现GET /health HTTP/1.1 200 OK然后浏览器访问http://localhost:3000/打开 Web 界面。验证代理能读写这个目录README 的 Usage 章节给出了直接命中文件工具能力的用法可以直接照着验证。在 Web 界面里发送类似指令Search the web for top cafes in Rennes, France, and save a list of three with their addresses in rennes_cafes.txt.或纯本地任务Write a Go program to calculate the factorial of a number, save it as factorial.go in your workspace判断标准任务完成后去你WORK_DIR配置的本地文件夹里找rennes_cafes.txt/factorial.go文件应出现在这里。代理提示词要求执行命令前先cd到工作目录prompts/base/file_agent.txt所以生成的文件落在WORK_DIR内而不是散落在别处。可选分支CLI 模式与 config.ini 备选项如果你不用 Web 界面而是走 CLI 模式./install.sh后uv run cli.py.env中SEARXNG_BASE_URL改为http://localhost:8080WORK_DIR同样来自环境变量环境变量没设置时解析逻辑会回退读取 config.ini[MAIN]段的work_dir项[MAIN] # Optional: agent workspace when WORK_DIR is not set in the environment. work_dir /path/to/your/workspace仓库自带的config.ini中这一行默认是注释状态README 的 Config 章节把work_dir描述为 “AgenticSeek 读写文件的目录确保路径在本系统有效且可访问”。完整解析顺序是环境变量WORK_DIR→config.ini的work_dir→ 运行时目录下的默认workspace见 sources/workspace.py 的get_work_dir()。README 只把work_dir写成config.ini的一个配置项而config.ini格式不支持注释取消注释填写时不要照抄示例里的注释行。读写范围限制与常见报错代理的文件访问被限制在WORK_DIR内这是设计边界而非配置疏漏sources/workspace.py 的resolve_workspace_path()会把相对路径解析到WORK_DIR下任何解析后逃出该目录的路径包括../../outside.txt这类遍历都会抛出PermissionError消息为 “Path ... is outside the agent workspace (...)”。File Agent 的文件工具对目录外文件返回的错误文本是 “outside the agent workspace”tests/test_workspace.py 的test_cannot_read_file_outside_workspace验证了这一行为。所以下次代理说读不到某个文件时先确认该文件是否真的在WORK_DIR内。运行时数据日志、截图、会话记录不走WORK_DIR而是放在AGENT_RUNTIME_DIRDocker 下为/opt/agent-runtime命名卷宿主机默认为.agent-data见 .env.example 注释。验证文件读写时不要在.agent-data里找业务文件。WORK_DIR与AGENT_RUNTIME_DIR保持分离仓库源码树在 Docker 中可保持只读——不要把WORK_DIR指回仓库目录这也正是start_services.sh明确禁止的第二条。【免费下载链接】agenticSeekFully Local Manus AI. No APIs, No $200 monthly bills. Enjoy an autonomous agent that thinks, browses the web, and code for the sole cost of electricity.项目地址: https://gitcode.com/GitHub_Trending/ag/agenticSeek创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考