 snowy-yang
|
b089dadac2
|
refactor: geo 走原生异步 HTTP，清掉短链展开死链
「同步转异步」的残留清理：
1) auth_system/geo.query_ip_province 原经 core.sync_http 同步门面（在后台
事件循环桥接）查询归属地，但其唯一调用方 record_login_location 的入口
本来就是 async 的登录链路（web/routers/auth 里还套了一层 to_thread）。
改为直接 await core.http_client——桥接纯属多余，顺带把 record_login_location
转 async，落库仍走同步 sqlite 但经 asyncio.to_thread 卸载，避免 sqlite busy
等待（最长 15s）冻结事件循环。
调用方两处（普通用户/管理员登录）去掉 to_thread 包装，直接 await。
2) MusicAPIService._extract_music_id 是死代码：ID 归一化早已迁到
web.request_utils（注释里明说是它的迁移口径），全仓零调用。它也是
core.utils.expand_shortlink 的唯一调用方——一并删除，core.utils 由此
彻底不再 import core.sync_http。
门禁：ruff 全过 / pyright 0-0 / pytest 387 项全绿（0 失败）。
|
2026-09-28 19:10:45 +08:00 |
|
|
snowy-yang
|
0569b50737
|
refactor: 清理 13 处生产死代码
为什么：用 AST 级引用分析（而非文本 grep——同名符号会互相掩盖）确认这些
符号全项目零引用。文本 grep 查不出的原因是它们都有「活着的同名兄弟」：
services/downloads.py（共 6 个，93 行）
_parse_cookie_str / _global_music_u / _vip_name / _detect_vip /
_admin_client / _user_client
—— 活的是 core.media.parse_cookie_str、web/routers/music.py、account.py 的版本
随之失效的 import：USER_COOKIE_FILE / GLOBAL_MUSIC_U_CACHE / VIP_PROBE_LOCK /
account_info / detect_vip_by_probe / QRLoginClient
services/api_service.py
APIResponse 类（29 行）—— web/response.py 才是活的响应封装
services/_shared.py
_rate_ok —— 逐字复制 web.ratelimit.rate_ok
core/utils.py
safe_int / safe_console_print —— 活的是 web/request_utils.safe_int
core/repo.py
all_settings / get_user_by_name —— auth_system.get_user_by_name 才是活的
core/db.py / web/auth_state.py / web/request_utils.py
execute_many / _safe_register_credits + secrets_rand / dedup_ids
结果：生产代码死代码候选 13 → 0（余下 118 个全是 pytest 测试函数，属正常）。
|
2026-09-26 18:54:11 +08:00 |
|
|
snowy-yang
|
7a70eef636
|
refactor: 删除 services.runtime 兼容门面，7 处调用点直连真实子模块
为什么：上一次分包重构把 1900 行巨石按职责拆成 9 个子模块后，留了一个
runtime.py 作为「原样再导出」的兼容门面，好让调用点零改动。但迁移期结束后
没有一个调用点迁走——门面成了永久中间层：每次读代码都要先跳一层才知道
符号真正住在哪，pyright 也无法从门面追溯定义位置。
改法：保持「函数内延迟导入」的形式不变，只把导入目标换成真实子模块。
**刻意不提到模块顶部**——services/__init__.py 里有依赖自检
（缺 auth_system/podcast_api/music_api/music_downloader/qr_login 就 sys.exit(1)），
提到顶层会让「import web.*」这一步就触发该自检，改变启动语义，超出本次范围。
7 处调用点（AST 精确扫描确认全集）：
- web/routers/download.py ×4：download / download_batch_zip / podcast_download /
podcast_batch_zip，分别直连 services.downloads / batch / podcast / tasks
外加 _shared._build_download_base 与 api_service.api_service
- web/routers/tasks.py ×2：_semaphores 取 _shared.BATCH_ZIP_SEM + api_service，
topen 取 _shared.ENDPOINT_NAMES
- web/tasks_registry.py ×1：start_task 直连 _taskcore._start_task_thread
子模块短名统一加 `services_` 前缀别名（services_tasks 等），避免与函数内
既有局部名相撞。
顺带清理：9 个子模块 docstring 里「（自 services/runtime.py 拆出……）」的
历史说明在门面删除后已成悬空引用，一并去掉；包的模块划分说明改为
「不再有兼容门面层」。
验证：
- 符号可达：11 个被引符号在真实子模块上全部 hasattr 通过；
services.runtime 已 ModuleNotFoundError；api_service 仍是同一实例对象
- 三个调用方模块均可正常 import
- 门禁：ruff 0 · pyright 0 errors 0 warnings · pytest 175 passed
- 真实 uvicorn 冒烟 8/8（含 POST /auth/login 400），临时数据目录独立落库
9 张表，生产 data/ 指纹三项一致
|
2026-09-26 14:48:05 +08:00 |
|
|
snowy-yang
|
6288a98ecc
|
refactor: 拆分 4 个巨石模块为包，清理过时注释并删除作废文档
为什么：单文件 1100~1900 行的巨石模块让「改一处要通读全文」；同时注释里残留
大量已删台账的编号，以及「Flask/FastAPI 双栈迁移期」这类已失实的架构描述，
会误导后来者按不复存在的架构去改代码。
拆分（对外导入路径不变，行为零变更）：
- music_downloader.py -> music_downloader/（models/downloader/cover/_http/_log/_concurrency）
- auth_system.py -> auth_system/（db/security/users/credits/ledger/mail/cards/backup...）
- music_api.py -> music_api/（api/client/crypto/qr/cookies/compat/constants/errors）
- services/runtime.py -> services/（api_service/_shared/_taskcore/downloads/batch/podcast/
streaming/tasks）；services/runtime.py 保留为兼容门面
兼容性做法：各包用 __init__.py 以 __all__ 原样再导出全部符号，既有调用点
（auth_system.xxx / services.xxx / from music_api import Y）零改动；路径常量改为经包属性
动态读取（auth_system.DB_PATH），否则测试的 monkeypatch 会静默失效并写到生产库。
修复 9 处代码损伤（上一轮注释清理把 `()` 当「空括号残留」删掉所致；用「与拆分前逐字
等价」校验逐一定位，静态检查只会报出其中 4 处）：
- core/config.py ).strip() or '*'
- core/state.py threading.Lock() x2
- qr_login.py datetime.now() / .strip()
- music_downloader/downloader.py .lower()
- services/podcast.py set() / time.time() x2
清理与删除：
- 删除 部署文档.md / 功能介绍.md / README_私有包警告.txt
- 清理指向已删台账与文档的过时编号注释；把「迁移期 / 两栈 / 双框架 / 已迁移」等
失实描述改写为现状描述（保留 `<-> Flask /path` 映射表等仍有价值的契约来源说明）
- _mkpkg.py：公开包剔除清单去掉已不存在的文档名；私有包警告改为自包含
- pyproject.toml：补 pythonpath = ["."]，使裸跑 pytest 不再 import core 失败
验证：ruff 全通过；pyright 0 errors / 0 warnings（102 文件）；pytest 144 passed；
真实 uvicorn 冒烟 6 条路由符合预期且生产 data/ 指纹未变；忽略注释的逐字等价性校验通过。
|
2026-09-26 12:37:48 +08:00 |
|