#工作记录
Fosowl/agenticSeek：完全本地的 Manus AI。
部署排错参考资料在文末 或查找往期笔记。
AgenticSeek 本地部署教程（Windows 系统）
一、环境准备
1. 安装必备工具
-
Docker Desktop
下载地址：Docker Desktop 官网
安装后启动 Docker 服务，确保后台运行。 -
Python 3.10+
下载地址：Python 官网
安装时勾选 “Add Python to PATH”，建议安装后创建虚拟环境管理依赖。 -
Ollama（语言模型服务）
下载地址：Ollama 官网
安装后启动 Ollama 服务，默认监听端口11434。
2. 克隆项目并初始化
# 克隆项目
git clone https://github.com/your-username/agenticSeek.git
cd agenticSeek
mv .env.example .env
# 创建并激活虚拟环境（Windows）
python -m venv .venv
.venv\Scripts\activate
# CMD安装 如果是powershell则.\install.bat
install.bat
二、Docker 容器配置与启动
1. 修改 Docker 配置文件
路径：docker-compose.yml
操作说明：
-
重命名容器：避免与其他项目容器名称冲突
services: redis: container_name: agenticseek_redis # 重命名 Redis 容器 searxng: container_name: agenticseek_searxng # 重命名搜索引擎容器 frontend: container_name: agenticseek_frontend # 重命名前端容器 -
修改端口映射：解决端口占用问题（以 8080 为例）
services: searxng: ports: - "8081:8080" # 主机端口 8081 映射到容器端口 8080 frontend: ports: - "3000:3000" # 前端端口（默认即可，如需修改请同步前端代码）
2. 启动 Docker 容器
# 执行启动脚本（项目根目录）
start_services.cmd
# 验证容器状态
docker ps
# 预期输出：agenticseek_redis、agenticseek_searxng、agenticseek_frontend 状态为 "Up"
三、后端服务配置与启动
1. 解决配置文件编码问题
路径：api.py
操作：
修改读取配置文件的代码，强制使用 UTF-8 编码：
# 原代码
# config.read('config.ini')
# 修改后
config.read('config.ini', encoding='utf-8')
备选方案：
使用文本编辑器（如 VS Code）打开 config.ini，另存为 UTF-8 编码（无 BOM）。
2. 创建工作目录
操作：
在项目根目录创建后端工作目录（解决启动警告）：
mkdir workspace_for_agenticseek
3. 修改后端服务端口（可选）
路径：api.py
操作：
若默认端口 8000 被占用，修改为其他端口（如 8001）：
# 原代码
# uvicorn.run(app, host="0.0.0.0", port=8000)
# 修改后
uvicorn.run(app, host="0.0.0.0", port=8001)
4. 启动后端服务
# 确保虚拟环境已激活
.venv\Scripts\activate
# 启动后端
python api.py
# 预期输出：显示服务监听地址（如 http://0.0.0.0:8001）
四、配置前端与后端连接
1. 修改前端 API 地址
路径：frontend/agentic-seek-front/src/config.js（或环境变量文件）
操作：
确保前端代码中的后端地址与实际端口一致：
// 原配置（若端口为 8000）
// export const API_BASE_URL = 'http://localhost:8000';
// 修改后（端口为 8001）
export const API_BASE_URL = 'http://localhost:8001';
2. 重启前端服务
# 在 Docker 启动脚本中已包含前端启动，若修改代码需重新构建
docker-compose up frontend
五、配置 Chromedriver 路径（虚拟环境）
问题现象：
虚拟环境中执行 chromedriver 提示 “命令未找到”。
解决方案：
-
编辑激活脚本
路径：.\.venv\Scripts\activate.bat
在文件末尾添加 Chromedriver 路径：set PATH=D:\chromedriver;%PATH% # 替换为实际路径 -
重新激活虚拟环境
.venv\Scripts\activate
六、配置 Ollama 语言模型服务
1. 修改配置文件
路径：config.ini
操作：
确保 Ollama 地址正确（默认端口 11434）：
ollama_url = http://localhost:11434 # 若 Ollama 服务在其他主机或端口，需对应修改
2. 验证 Ollama 服务
在浏览器中访问 http://localhost:11434，若显示 API 文档则表示服务正常。
七、完整启动与验证
1. 启动所有服务
# 1. 启动 Docker 容器（Redis、搜索引擎、前端）
start_services.cmd
# 2. 启动后端服务（新终端窗口）
.venv\Scripts\activate
python api.py
2. 访问前端界面
打开浏览器，访问 http://localhost:3000
- 若显示界面且无 “后端未部署” 提示，说明部署成功。
- 若提示连接失败，检查浏览器开发者工具（F12）的网络请求，确认后端接口返回状态码
200。
3. 测试后端接口
在浏览器中访问 http://localhost:8001/health，应返回：
{"status": "healthy"}
八、常见问题与解决方案
| 问题 | 解决方案 |
|---|---|
| Docker 容器启动失败（端口冲突） | 修改 docker-compose.yml 端口映射，使用 netstat -ano 排查占用端口的进程。 |
| 后端配置文件编码错误 | 确保 config.ini 为 UTF-8 编码，或在代码中显式指定编码。 |
| Chromedriver 无法找到 | 检查虚拟环境激活脚本中的路径是否正确，或直接将路径添加到系统环境变量。 |
| Ollama 模型加载失败 | 确保 Ollama 服务运行，重启 Ollama 或更换模型（如 ollama run llama2）。 |
九、卸载与清理
# 停止并删除 Docker 容器
docker-compose down
# 退出虚拟环境
deactivate
# 删除虚拟环境（可选）
rmdir /s /q .venv
通过以上步骤，可在 Windows 系统中完成 AgenticSeek 的本地部署与配置。如有其他问题，可参考项目官方文档或提交 Issues 反馈。
十、参考资料
【笔记】Windows 下载并安装 ChromeDriver -CSDN博客
【笔记】解决虚拟环境中找不到 chromedriver 的问题-CSDN博客
【笔记】部署 AgenticSeek 项目问题：端口 8000 被占用-CSDN博客
