前端整理: 合并文件管理页 + 新增导航页

1. 合并 files-page 与 pdf-admin 为统一文件管理页 /api/files-page:
   - 新增 GET /api/admin/files/with-pdf 接口，以 uploaded_files 为基础，
     用 pdf_jobs.source_file_id / output_file_id 内存匹配，为关联文件标注
     转换状态、用户软删标记与角色(源epub/产物PDF)
   - PdfJobOut 补 source_file_id / output_file_id 字段
   - file_browser 新增 PDF 任务列(状态徽标/软删标记/硬删任务按钮)
   - 删除 /api/pdf-admin 路由及 static/pdf_admin.* 三个文件

2. 新增导航页 /api/index，卡片式收集所有页面入口；
   各子页(upload/whiteboard/system_status/files-page)脚注加返回导航链接

3. 更新 docs/routes.md、docs/configuration.md 同步说明

测试: pytest tests/test_pdf_service.py 7 passed; 手动校验各页面路由与合并接口响应

app/controllers/file_admin_controller.py

@@ -14,8 +14,15 @@ from pydantic import BaseModel, Field
 from sqlalchemy.orm import Session
 
 from ..database import get_db
+from ..dao.pdf_job_dao import PdfJobDAO
 from ..dao.uploaded_file_dao import UploadedFileDAO
-from ..schemas.file import FileListResponse, UploadedFileOut
+from ..schemas.file import (
+    FileListResponse,
+    FileWithPdfListResponse,
+    PdfJobBrief,
+    UploadedFileOut,
+    UploadedFileWithPdfOut,
+)
 from ..security import require_docs_auth
 from ..services.upload_service import UploadService
 
@@ -57,6 +64,53 @@ def list_files(
     return FileListResponse(total=total, items=items)
 
 
+@router.get(
+    "/with-pdf",
+    response_model=FileWithPdfListResponse,
+    summary="列出已上传文件并附带 PDF 转换任务关联（需鉴权）",
+    description=(
+        "合并管理页使用：以 uploaded_files 为基础分页拉取，再内存匹配 pdf_jobs，"
+        "为每个文件附带它作为 PDF 任务「源文件(epub)」或「产物(PDF)」时的状态、"
+        "进度与用户软删标记。匹配键为 pdf_job.source_file_id / output_file_id -> uploaded_file.id。"
+        "返回前会触发磁盘扫描（频率限制 3s），把 SFTP 上传但未入库的文件补录进来。"
+    ),
+)
+def list_files_with_pdf(
+    limit: int = Query(100, ge=1, le=10000, description="每页条数，1-10000"),
+    offset: int = Query(0, ge=0, description="偏移量"),
+    service: UploadService = Depends(_service),
+    db: Session = Depends(get_db),
+    _: str = Depends(require_docs_auth),
+) -> FileWithPdfListResponse:
+    service.scan_sftp_files()  # 频率限制内置：3s 内重复只返回 DB 缓存
+    total, items = service.list_files(limit=limit, offset=offset)
+
+    # 拉全部 pdf_jobs（数据量小，不分页），建反查 map
+    jobs = PdfJobDAO(db).list_all(limit=10000, offset=0)
+    by_source: dict[int, list] = {}
+    by_output: dict[int, list] = {}
+    for j in jobs:
+        by_source.setdefault(j.source_file_id, []).append(j)
+        if j.output_file_id is not None:
+            by_output.setdefault(j.output_file_id, []).append(j)
+
+    out_items: list[UploadedFileWithPdfOut] = []
+    for f in items:
+        briefs: list[PdfJobBrief] = []
+        for j in by_source.get(f.id, []):
+            briefs.append(PdfJobBrief(
+                job_id=j.id, role="source", status=j.status,
+                progress=j.progress, user_deleted=j.user_deleted, deleted_at=j.deleted_at,
+            ))
+        for j in by_output.get(f.id, []):
+            briefs.append(PdfJobBrief(
+                job_id=j.id, role="output", status=j.status,
+                progress=j.progress, user_deleted=j.user_deleted, deleted_at=j.deleted_at,
+            ))
+        out_items.append(UploadedFileWithPdfOut(**f.model_dump(), pdf_jobs=briefs))
+    return FileWithPdfListResponse(total=total, items=out_items)
+
+
 @router.post(
     "/batch-delete",
     response_model=BatchDeleteResult,