任务与日志
实时监控后台系统任务执行状态，查看底层系统日志，便于排查扫描或服务异常。
系统任务监控
当您添加储存库、执行增量扫描或触发 AI 分类等耗时较长的后台操作时，系统会自动生成后台任务。
任务状态查看
管理员可以在网页端或移动端进入“系统管理” -> “任务列表”页面：
- 运行中：实时显示当前任务的进度条（如扫描文件夹的百分比）。
- 排队中：显示等待执行的任务。
- 已完成/失败：查看历史任务的最终结果，如果有任务失败，会显示简要的错误原因。
按储存库查看
- 从储存库卡片进入：如果您是在某个储存库上点“任务管理”进入，本页会自动只看该储存库相关任务
- 适合排查单库问题：例如只想看某个 WebDAV 源当前是否还在扫描、清理或导入
常见任务类型
- 全量扫描 (
scan_directory)：重新扫描当前储存库，识别新增书籍和章节 - 元数据刮削 (
scrape_metadata)：处理在线元数据补全或相关刮削步骤 - 章节完善 (
generate_chapters)：补全章节信息 - 数据清理 (
cleanup_books)：清理数据库里已经失效的记录 - 书籍导出 / 导入：处理导入导出任务
实时刷新
- 网页端：优先通过 SSE 实时推送任务变化，连接异常时再退回普通刷新
- 移动端：优先实时订阅，连接异常时自动切到轮询
- 状态指示：页面会明确显示当前是“实时”还是“轮询”模式
任务控制
在任务列表中，您可以：
- 暂停/恢复：对支持暂停的长耗时任务进行控制。
- 取消任务：强制终止正在执行的扫描或刮削任务。
- 清理记录：一键清除已完成的历史任务记录。
- 查看失败项：如果任务部分失败，可直接展开或查看失败明细，定位是哪个目录、书籍或条目报错
系统日志排查
如果系统发生未知错误、刮削不到书籍、或网盘挂载失败，您可以直接通过“系统日志”进行深层排查。
日志级别与过滤
在日志页面，您可以根据需求筛选：
INFO(信息)：正常的系统运行轨迹。WARN(警告)：潜在的问题，例如某个封面抓取超时。ERROR(错误)：严重的故障，例如数据库写入失败或网络请求被拒绝。
库日志与系统日志的区别
- 库日志：从某个储存库卡片进入时，只看该储存库相关日志，适合排查单个源的扫描、连接和同步问题
- 系统日志：不带储存库过滤时，更多用于看系统级或登录相关日志
什么时候先看任务，什么时候先看日志
- 任务一直不动：先看任务管理，确认是否卡在等待、暂停或失败状态
- 任务失败但原因不清楚：再去对应的库日志或系统日志里看详细报错
- 只怀疑某一个储存库有问题：优先从该储存库卡片进入“任务管理”和“库日志”
日志导出
当您遇到无法解决的 Bug，需要向社区求助时，可以通过网页端日志页面右上角的“导出日志”功能，将最近的日志打包下载，附在 Issue 中以便开发者定位问题。