仪表盘显示访客数为零

原因： 最常见的原因是缓存插件向跟踪脚本端点返回了缓存版本。

解决方案： 将 Statnive 的采集端点（/wp-json/statnive/v1/hit、/wp-json/statnive/v1/event、/wp-json/statnive/v1/engagement）添加到缓存插件的排除列表。如果使用 Cloudflare，请创建一条 Page Rule，对 /wp-json/statnive/* 绕过缓存。

访客数似乎过低

原因： Statnive 使用每日轮换的哈希值识别访客。如果站点在同一天有较多回访访客，计数应当是准确的。如果计数偏低，最可能的原因是某条排除规则过滤掉了合法流量。

解决方案： 打开 Statnive 仪表盘，进入设置，查看排除规则区块。请确认您实际希望统计的已登录角色未被列入排除的角色，并确认排除的 IP 中没有真实在用的 IP 段。

实时计数器未更新

原因： 实时计数器依赖 WordPress REST API。某些安全插件会阻止未经身份验证的用户访问 REST API。

解决方案： 请确保端点 wp-json/statnive/v1/realtime 可访问。登录状态下在浏览器中直接访问该 URL 进行测试。如果看到 JSON 响应，说明端点工作正常；如果看到 403 错误，请检查安全插件的 REST API 设置。

启用后 WooCommerce 收入报表为空

原因： v1.0.0 首次启用时，历史订单回填通过 Action Scheduler 在后台运行。对于大型商店，收入报表可能需要几分钟才能填充完毕。

解决方案： 打开 WooCommerce → 状态 → 已安排操作，按 statnive/wc/backfill/chunk 筛选。应能看到一个或多个已排队或正在运行的操作。如果希望从命令行触发或监控此过程，请运行：

wp statnive woocommerce-backfill

该命令具有幂等性（在回填进行中重复运行会返回 409）。每个 Action Scheduler 钩子的批次大小为 500 个订单；processing、completed 和 refunded 状态的订单均会被统计。详见 WooCommerce 集成文档。