NeteaseUrl

67 Commits 1 Branch 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
snowy-yang	838d635bc5	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，未被写入。	2026-09-26 11:52:06 +08:00
snowy-yang	c77ef40fd5	feat(db): 同步栈读写并发（_q 去锁）+ core.db 并发/跨loop 修复 auth_system._q：单语句读不再持 _DB_LOCK —— WAL 下每连接读一致性快照，读写互不阻塞；旧实现把全部读也串行化且被写挡住。写事务（_x 与 24 个 with _DB_LOCK 块，经扫描均为写事务）仍全程串行，无写-写竞争。 core.db 并发修复（由测试暴露的真实缺陷）： - WAL 切换竞态：并发连接同时执行 PRAGMA journal_mode=WAL 争排他锁 → 专用锁内串行切换 + 二次复查（busy_timeout 前置） - 跨事件循环锁：模块级 asyncio.Lock 绑定首个 loop，多 loop 场景报 "bound to a different event loop" → 锁按 loop 隔离测试：25/25 通过（新增「读不被写锁阻塞」红转绿、读+同步写者并发 WAL、异步并发读）； lint: ruff All checks passed；pyright 0 errors。验收：冒烟 10/10、奇偶校验 2/2、uvicorn 真实启动 Flask 兜底+FastAPI 双通。	2026-09-26 01:03:18 +08:00
snowy-yang	4962542e78	feat(core): requests 兼容异步垫片 + 同步/异步桥 - core/aiohttp_compat.py：以 requests 同形 API（post/get + Response.json/text/ status_code/raise_for_status + HTTPError/RequestException/Timeout）实现异步请求，使既有 requests 风格代码可「加 await + async def」最小改动迁移；4xx/5xx 不抛、仅 raise_for_status() 抛（与 requests 语义一致，保住风控判断逻辑） - core/async_bridge.py：run_sync(coro) 经常驻后台事件循环线程执行协程并阻塞等待，供迁移期同步调用方（遗留 Flask 路由/线程池）复用异步实现验证：pytest 16/16；ruff All checks passed；pyright 0 errors。	2026-09-26 00:27:47 +08:00

Author

SHA1

Message

Date

snowy-yang

838d635bc5

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，未被写入。

2026-09-26 11:52:06 +08:00

snowy-yang

c77ef40fd5

feat(db): 同步栈读写并发（_q 去锁）+ core.db 并发/跨loop 修复

auth_system._q：单语句读不再持 _DB_LOCK —— WAL 下每连接读一致性快照，
读写互不阻塞；旧实现把全部读也串行化且被写挡住。写事务（_x 与 24 个
with _DB_LOCK 块，经扫描均为写事务）仍全程串行，无写-写竞争。

core.db 并发修复（由测试暴露的真实缺陷）：
- WAL 切换竞态：并发连接同时执行 PRAGMA journal_mode=WAL 争排他锁
  → 专用锁内串行切换 + 二次复查（busy_timeout 前置）
- 跨事件循环锁：模块级 asyncio.Lock 绑定首个 loop，多 loop 场景报
  "bound to a different event loop" → 锁按 loop 隔离

测试：25/25 通过（新增「读不被写锁阻塞」红转绿、读+同步写者并发 WAL、
异步并发读）；
lint: ruff All checks passed；pyright 0 errors。
验收：冒烟 10/10、奇偶校验 2/2、uvicorn 真实启动 Flask 兜底+FastAPI 双通。

2026-09-26 01:03:18 +08:00

snowy-yang

4962542e78

feat(core): requests 兼容异步垫片 + 同步/异步桥

- core/aiohttp_compat.py：以 requests 同形 API（post/get + Response.json/text/
  status_code/raise_for_status + HTTPError/RequestException/Timeout）实现异步请求，
  使既有 requests 风格代码可「加 await + async def」最小改动迁移；4xx/5xx 不抛、
  仅 raise_for_status() 抛（与 requests 语义一致，保住风控判断逻辑）
- core/async_bridge.py：run_sync(coro) 经常驻后台事件循环线程执行协程并阻塞等待，
  供迁移期同步调用方（遗留 Flask 路由/线程池）复用异步实现

验证：pytest 16/16；ruff All checks passed；pyright 0 errors。

2026-09-26 00:27:47 +08:00