自动扫描实验功能:让 Kikoeru 监控文件夹变动自动入库
版本说明
自动扫描是 v0.6.14 及以上 Docker 镜像的实验性功能,默认关闭。npm 源码版和 Windows exe 版不一定包含。
开启方法
- Web 界面进入设置 → 配置(或直接编辑
config/config.json) - 找到自动扫描相关的开关(键名可能是
autoScan或类似) - 设为
true保存 - 重启服务器让配置生效
开启后会发生什么
- Kikoeru 定期(或通过文件监控)检查根文件夹
- 发现新的子目录 → 自动创建数据库条目 → 自动抓元数据
- 日志里能看到自动扫描的进度
注意事项(官方提示)
自动扫描进行过程中不要手动扫描,两边同时跑可能导致数据冲突。暂时只能在日志里看到扫描进度,没有 Web 界面的进度条。
删除文件夹不会从数据库移除相关数据。要清理数据库里已失效的条目,还是需要手动触发一次扫描(扫描器会检测到文件不存在,标记为清理)。
适用场景
- 你的音声库在持续增长(比如定期下载新专辑)
- 不想每次手动点"扫描"
- 库的更新频率不高(一天几次、不是一小时几次)
不适合的场景
- 频繁批量增删文件夹(自动扫描 + 手动扫描容易打架)
- 需要精确控制什么时候扫描、扫描哪些
- 对数据库一致性非常敏感
如果你对数据严谨性有要求,还是坚持手动扫描更稳。自动扫描属于"图省事"的便利功能,但毕竟是实验性的。