WiseFlow项目配置与使用指南：解决抓取信息不显示问题

环境配置要点

在WiseFlow项目中，正确配置环境变量是系统正常运行的基础。用户需要根据env_sample文件创建.env配置文件，其中关键配置项包括LLM_API_KEY和PB_API_AUTH。LLM_API_KEY用于接入语言模型服务，而PB_API_AUTH则是首次登录dashboard时生成的认证密钥。

值得注意的是，时区和语言设置需要通过Docker环境变量显式指定。即使已在配置文件中设置，启动容器时仍需通过-e参数传递LANG和LC_CTYPE环境变量，例如：

docker run -e LANG=zh_CN.UTF-8 -e LC_CTYPE=zh_CN.UTF-8 your_image

数据抓取机制解析

WiseFlow采用定时抓取机制，默认配置为每10小时执行一次数据采集任务。这意味着用户需要保持系统持续运行至少10小时以上才能看到初步结果。这种设计考虑了服务器负载和资源消耗的平衡，特别适合长期监控场景。

常见配置问题排查

1. 站点和标签激活状态：在dashboard中配置的sites和tags必须明确设置为"active"状态。任何修改都需要重启容器才能生效。这是很多用户容易忽略的关键步骤。

2. 关键字有效性：标签关键词的设置需要符合实际抓取内容的特点。过于宽泛或过于专业的关键词都可能导致抓取结果不理想。建议从简单明确的关键词开始测试。

3. 时间显示问题：系统默认使用UTC时间，如需显示本地时间，必须在容器启动时正确配置时区环境变量。仅修改配置文件而不传递环境变量会导致设置无效。

最佳实践建议

1. 初次部署时，建议将抓取间隔设置为较短时间（如1小时）进行测试，确认系统工作正常后再调整为生产环境所需的间隔。

2. 对于中文用户，确保系统语言环境完整配置，包括LANG和LC_CTYPE都设置为zh_CN.UTF-8，以避免可能的字符编码问题。

3. 监控系统日志是排查问题的有效手段。通过docker logs命令可以查看容器运行状态和可能的错误信息。

4. 当修改任何配置后，完整的重启流程应该是：停止容器→删除旧容器→用新配置启动新容器。简单的重启命令可能不会加载所有配置变更。

通过理解这些核心概念和遵循正确的配置流程，用户可以充分发挥WiseFlow在信息监控和分析方面的强大功能。系统设计考虑了长期运行的稳定性，因此需要用户给予足够的运行时间才能看到完整效果。