fix: 修复重构遗留缺陷，补齐 pyright 检查盲区

上一次重构（8446166）声称「pyright 0 错误」，但 pyproject 里 pyright 的 include
只覆盖 core/web/services —— 根目录 6 个应用模块与整个 tests/ 从未被检查，而
requests→sync_http 迁移的遗留恰好全部藏在那里。补齐 include 后立刻暴露
7 errors + 9 warnings，其中数处在运行时静默失效。

修复：
- services/runtime.py：删除 _podcast_billing_count/_billing_ids_count 两个
  无调用方的死函数。它们仍调用 api_service._safe_get_request_data()，而该方法
  在剥离 Flask 时已被删除，异常又被 except 吞掉 —— 一旦被调用，播客/歌单计费
  恒为 1 次且不报任何错。路由层已各自实现同口径版本，故整体删除。
- web/routers/admin_site.py：备份上传的类型判定必须用 starlette 的 UploadFile。
  fastapi.UploadFile 是它的子类，而 request.form() 返回基类实例，用错会让
  isinstance 恒为 False，把每一次真实上传都判成「请选择数据库文件」。
  已补 4 例真实 multipart 回归测试，并用变异测试确认能抓住该缺陷。
- auth_system.py：修正 create_user（实返 sqlite3.Row|None）与 list_cards
  （实返 (cards,total) 元组）与实现不符的返回注解；注解一改正，立刻暴露出被它
  掩盖的 register.py 中 int(user['id']) 未做 None 检查的 500 崩溃路径，已补守卫。
- music_downloader.py：修正注解引用的 core.sync_http.Response（正确名应为
  SyncResponse）；封面缓存淘汰不再读类型为 Optional 的 deque.maxlen，改用命名常量。
- services/runtime.py：zip worker 的 result.music_info 可能为 None，原样使用会
  炸掉整批任务，改为按单曲失败处理。
- music_api.py：三处 isinstance 三元表达式收敛为 _as_dict() 帮助函数。
- web/main.py：文档串移除已删除的 Flask 兜底描述，补充 data/ 相对 CWD 解析的提醒。

验证：ruff check 通过；pyright 0 errors / 0 warnings（filesAnalyzed=67）；
pytest 144 passed；真实 uvicorn 启动冒烟通过（/health、/、静态资源 200，
未鉴权管理端点 403）。生产库仅做只读 integrity_check，未被写入。

web/main.py

@@ -4,9 +4,11 @@
 运行（生产/开发一致）：
     python web/main.py
 
-迁移期（strangler）：默认开启 Flask 兜底——未迁移的路由由遗留 Flask 应用处理，
-已迁移的 /api/v1 路由走 FastAPI。全部迁移完成后把 FASTAPI_FLASK_FALLBACK 默认值
-改为 0 即可完全脱离 Flask（届时删除 setdefault 行为）。
+Flask 巨石已删除，本进程是唯一服务端：默认在根路径服务前端（API_PREFIX 留空）；
+把 API_PREFIX 设为非空（如 /api/v1）可把全部路由挂到子前缀下，供契约比对脚本使用。
+
+数据目录 `data/` 是**相对当前工作目录**解析的（可由 SITE_DATA_DIR 覆盖），
+所以务必从项目根启动——否则会在别处新建一份空库。
 """
 import os
 import sys

web/routers/admin_site.py

@@ -16,6 +16,7 @@ from typing import Annotated, Any
 
 from fastapi import APIRouter, Depends, Request
 from fastapi.responses import FileResponse
+from starlette.datastructures import UploadFile
 
 import auth_system as auth
 from web.deps import SiteUser, current_user
@@ -467,7 +468,10 @@ async def backup_upload(admin: AdminUser, request: Request):
     try:
         form = await request.form()
         f = form.get('file')
-        if not f or not getattr(f, 'filename', None):
+        # 必须用 starlette 的 UploadFile 做 isinstance：fastapi.UploadFile 是它的**子类**，
+        # 实测 isinstance(request.form() 取到的对象, fastapi.UploadFile) 为 False，
+        # 换成 fastapi 那个会把所有真实上传判成「未选择文件」（顺带让类型检查器收窄 f）。
+        if not isinstance(f, UploadFile) or not f.filename:
             return error('请选择数据库文件')
         if not f.filename.endswith('.db'):
             return error('仅支持 .db 文件')
@@ -479,7 +483,7 @@ async def backup_upload(admin: AdminUser, request: Request):
             name = f'{base}-{k}.db'
             k += 1
         dest = auth.BACKUP_DIR / name
-        content = await f.read()  # type: ignore[union-attr] - form 校验后必为 UploadFile
+        content = await f.read()
         await asyncio.to_thread(dest.write_bytes, content)
         with dest.open('rb') as hf:
             header = hf.read(16)

web/routers/register.py

@@ -197,6 +197,13 @@ async def register(request: Request):
             await asyncio.to_thread(auth.add_log, 'fail', username, ip, '注册', str(e))
             return error(str(e))
 
+        # 建号事务已提交却读不回（并发删除/库损坏）：按注册失败处理并把验证码还回去，
+        # 不让 user['id'] 直接 TypeError 崩成 500
+        if user is None:
+            await asyncio.to_thread(auth.restore_verify_code, email, code, code_ttl, 'register')
+            await asyncio.to_thread(auth.add_log, 'fail', username, ip, '注册', '建号后读取用户失败')
+            return error('注册失败，请稍后重试')
+
         # 建立会话（login_seq 递增 + 签发 Cookie）
         uid = int(user['id'])
         now = int(time.time())