WiseFlow项目部署与数据采集问题排查指南

项目概述

WiseFlow是一个基于Docker容器化部署的信息采集与分析系统，通过配置自定义信源和关注点，系统能够自动执行信息采集、解析和分析任务。该系统采用前后端分离架构，前端基于Vue.js开发，后端使用PocketBase作为数据存储和管理平台。

部署后常见问题分析

数据采集未启动问题

许多用户在完成WiseFlow部署后遇到数据采集不工作的情况，这通常由以下几个原因导致：

1. 配置不完整：用户可能未正确配置tags和sites表单，或者未将相关配置项设置为激活状态。

2. 环境变量设置错误：LLM相关服务的API密钥和基础URL配置不正确，导致系统无法调用语言模型服务。

3. 权限问题：前端应用与PocketBase后台的认证信息不匹配，导致无法正常访问管理界面。

正确配置步骤详解

1. 配置tags表单

tags表单用于指定系统关注的特定主题，配置时需注意：

• name字段：必须具体明确，如"中美竞争动向"比"国际局势"更合适
• activated字段：必须设置为true才能激活该关注点
• 配置变更后无需重启容器，系统会在下次定时任务时自动更新

2. 配置sites表单

sites表单用于指定信息采集的来源，关键配置项包括：

• url字段：应填写文章列表页面而非具体文章页面
• per_hours字段：建议设置为24小时一次，避免过于频繁的采集
• activated字段：同样需要设置为true才能激活该信源

3. 环境变量配置

确保.env文件中包含以下关键配置：

• LLM_API_KEY：语言模型服务的API密钥
• LLM_API_BASE：语言模型服务的完整基础URL
• PB_ADMIN_EMAIL/PB_ADMIN_PASSWORD：PocketBase管理员账户凭证

问题排查方法

1. 日志分析

通过查看容器日志可以获取系统运行状态：

• 检查是否有定时任务执行的记录
• 确认语言模型服务调用是否成功
• 查看是否有权限或配置错误的提示信息

2. 功能验证

• 前端验证：访问情报分析界面(http://127.0.0.1:5173/)时，应使用与PocketBase相同的账户凭证登录
• API验证：可通过curl等工具直接测试语言模型API是否可达
• 数据验证：在PocketBase管理界面检查是否有采集到的原始数据

3. 常见错误处理

1. 模型名称错误：确保配置的模型名称与语言模型服务提供的完全一致

2. 凭证问题：如果忘记密码，可以通过PocketBase的密码重置功能恢复，同时更新.env文件中的对应配置

3. 采集频率问题：系统默认不会立即执行采集任务，而是按配置的时间间隔周期性执行

最佳实践建议

1. 配置测试：先使用简单的tags和少量sites进行测试，确认系统正常工作后再扩展

2. 日志监控：定期检查容器日志，及时发现并解决问题

3. 版本管理：保持项目代码和依赖库的最新版本，避免已知问题的发生

4. 性能考量：根据服务器资源情况合理配置采集频率，避免资源耗尽

通过以上方法和步骤，大多数部署后的问题都能得到有效解决。如遇特殊情况，建议详细记录问题现象和环境信息，便于进一步分析诊断。