feat: SFTP 上传的文件经磁盘扫描补录后可在文件浏览页展示

SFTP 上传的文件直接落盘到 upload_root（chroot 根），不经 HTTP 路径，无 DB 记录，
文件浏览页（读 uploaded_file 表）看不到。新增磁盘扫描机制：

- UploadService.scan_sftp_files(force=False)：遍历 uploads/ 下所有文件（排除 .work/
  与 .part 残品），与 DB 已有 storage_path 比对，磁盘有 DB 无的补录（source="sftp"，
  流式算 size + sha256）。
- 频率限制：模块级 _last_scan_time，两次扫描间隔 < 3s 则跳过返回 0（只读 DB 缓存），
  force=True 强制扫。
- file_admin_controller 的 list 接口返回前触发 scan_sftp_files()，文件浏览页打开/
  刷新即自动同步 SFTP 文件（受 3s 频率限制，不会每次翻页都扫磁盘）。
- UploadedFileDAO 加 list_storage_paths() 批量查已记录路径集合供比对。

SFTP 文件补录后可正常下载/删除（与 HTTP 上传文件一致）。

app/controllers/file_admin_controller.py

@@ -43,7 +43,8 @@ class BatchDeleteResult(BaseModel):
     "",
     response_model=FileListResponse,
     summary="列出已上传文件（需鉴权）",
-    description="供文件浏览页使用；字段同公开 /api/files，但要求 docs Basic Auth。支持分页。",
+    description="供文件浏览页使用；字段同公开 /api/files，但要求 docs Basic Auth。支持分页。"
+    "返回前会触发磁盘扫描（频率限制 3s），把 SFTP 上传但未入库的文件补录进来。",
 )
 def list_files(
     limit: int = Query(100, ge=1, le=10000, description="每页条数，1-10000"),
@@ -51,6 +52,7 @@ def list_files(
     service: UploadService = Depends(_service),
     _: str = Depends(require_docs_auth),
 ) -> FileListResponse:
+    service.scan_sftp_files()  # 频率限制内置：3s 内重复只返回 DB 缓存
     total, items = service.list_files(limit=limit, offset=offset)
     return FileListResponse(total=total, items=items)