跳转至

常见问题

如何更新 Cookie？

直接修改 config.yml 中的 Cookie 值，无需重启容器或程序。系统支持配置热重载，会在约 5 秒内自动检测并应用新配置。

监控任务没有执行怎么办？
  1. 查看日志：logs/main_*.log（总日志）或 logs/task_{job_id}_*.log（任务专属日志），也可在 Web 日志页面切换查看
  2. 确认 config.yml 格式正确（YAML 语法）
  3. 检查网络与 Cookie 是否有效
  4. 确认监控任务已启用（如 enable: true，或对应监控块已配置）
如何调整监控频率？

在 config.yml 中修改对应间隔（秒）即可，无需重启： - 微博：weibo.monitor_interval_seconds（默认 300） - 虎牙：huya.monitor_interval_seconds（默认 65） - 哔哩哔哩：bilibili.monitor_interval_seconds（默认 60） - 抖音：douyin.monitor_interval_seconds（默认 30） - 斗鱼：douyu.monitor_interval_seconds（默认 300） - 小红书：xhs.monitor_interval_seconds（默认 300）

数据库和日志文件在哪里？
部署方式 数据库位置 日志位置
Docker 部署 ./data/ 目录 ./logs/ 目录
本地部署 ./data/ 目录 ./logs/ 目录

日志目录内含： - main_YYYYMMDD.log：当日总日志 - task_{任务ID}_YYYYMMDD.log：各任务专属日志

Web 界面无法访问怎么办？
  1. 确认程序已正常启动（看控制台或日志）
  2. 确认端口 8866 未被占用
  3. Docker 部署时确认端口映射为 8866:8866
  4. 检查防火墙是否放行 8866
免打扰时段内会遗漏消息吗？

免打扰时段内，监控任务会照常执行并更新数据库，但不会推送通知。若担心遗漏，可查看日志或数据记录，或关闭免打扰配置。

青龙面板如何部署？

在青龙「环境变量」中添加 WEBMONITER_* 前缀的变量（如 WEBMONITER_CHECKIN_ENABLE、WEBMONITER_CHECKIN_EMAIL），拉取或克隆项目后，在「定时任务」中添加 task ql/ikuuu_checkin.py 等脚本。推送自动走青龙内置通知（QLAPI）。详见 青龙面板兼容指南。

如何启用 AI 助手？
  1. 执行 uv sync 安装依赖（已包含 AI 相关包）
  2. 在 config.yml 中配置 ai_assistant 节点，设置 enable: true 以及 provider、api_key、model 等
  3. 重启或等待热重载后，在配置管理、任务管理、数据展示页面底部即可看到「问 AI」入口

支持 OpenAI、DeepSeek、通义千问、智谱、Moonshot、Ollama 等 OpenAI 兼容 API。详见 AI 助手使用指南。

Docker 部署下雨云签到如何启用？

精简镜像（由根目录 Dockerfile 构建，latest 等标签）不包含 Chromium 与雨云相关 Python 依赖；若启用 rainyun.enable: true，请改用 full 镜像（由 Dockerfile.full 构建，如 fengyu666/webmoniter:full）或 docker compose -f docker-compose.full.yml up -d。完整镜像已内置 Chromium；在 config.yml 中配置 rainyun.accounts 即可；默认 /usr/bin/chromium 与 /usr/bin/chromedriver。路径不同时可配置 rainyun.chrome_bin / rainyun.chromedriver_path，或环境变量 CHROME_BIN、CHROMEDRIVER_PATH。

定时任务为什么显示「当天已经运行过了，跳过该任务」？

定时任务默认会检查当天是否已运行过（通过 task_run_history 表记录），若已运行则跳过，避免重复执行。程序重启或定时触发时都会进行此检查。若需立即再执行一次，可通过 Web 管理界面「任务管理」页面的「立即运行」手动触发，会绕过该检查并强制执行。

Docker 下 RAG 向量库更新失败或报「database is locked / no such table: tenants」？

镜像已通过 docker-entrypoint.sh 在启动前为挂载的 data/、logs/ 及其子目录赋予读写权限，避免 bind mount 导致 SQLite / Chroma 只读。若仍报错：

  1. 确认使用含入口脚本的镜像：重新构建或拉取最新镜像后执行 docker compose up -d
  2. Chroma schema 不兼容：若曾升级 Chroma 版本，可删除宿主机上的 ./data/ai_assistant_chroma 目录后重启容器，由启动时自动重建向量库
  3. 宿主机权限：在 Linux 宿主机上可执行 chmod -R 777 ./data ./logs 后再启动容器