RayHunter项目：手动删除录像文件后Web界面状态显示异常的解决方案

问题现象

在使用RayHunter项目时，用户手动删除了设备上的录像文件以释放存储空间后，发现Web前端界面不再显示录像状态栏和文件下载选项。虽然通过检查确认"开始/停止录像"功能仍然正常工作（录像文件能够正常生成），但前端界面无法正确反映这些信息。

问题根源分析

经过技术排查，发现该问题是由于RayHunter服务器维护了一个记录录像文件信息的manifest（清单文件）。当用户直接删除录像文件目录中的物理文件时，manifest中仍然保留着这些已被删除文件的记录项，导致系统出现以下问题：

1. 前端界面尝试读取manifest中记录的录像信息
2. 服务器发现manifest中记录的文件实际上不存在
3. 浏览器控制台报出"无法找到/访问文件"的错误
4. 前端界面因此无法正确显示录像状态信息

解决方案

针对这一问题，有以下几种可行的解决方法：

方法一：重建manifest文件（推荐）

1. 删除现有的manifest文件
2. 重新运行install.sh脚本
3. 系统会自动创建新的manifest文件，只包含当前实际存在的录像文件信息

方法二：重启服务

1. 重启RayHunter服务器
2. 服务器重启后会重新扫描录像目录并重建内部状态

方法三：重启设备

1. 完全重启运行RayHunter的设备
2. 设备启动时RayHunter服务会自动初始化并重建所有状态信息

最佳实践建议

为避免类似问题，建议用户：

1. 优先使用RayHunter提供的管理界面删除录像文件，而不是直接操作文件系统
2. 如需手动删除文件，应同时清理manifest中的对应记录
3. 定期检查系统存储空间，避免因空间不足导致需要紧急删除文件
4. 重要录像文件建议先备份再删除

技术原理补充

RayHunter采用manifest文件机制来维护录像文件索引，这种设计能够：

• 提高前端界面加载速度（无需每次扫描整个目录）
• 支持更复杂的查询和过滤功能
• 维护录像文件的元数据信息

但当文件被直接删除时，这种机制就会导致状态不一致。理解这一机制有助于用户更好地管理系统和排查问题。