Archived
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/ 指纹未变;忽略注释的逐字等价性校验通过。
This commit is contained in:
1 parent
838d635bc5
commit
6288a98ecc
89 files changed
+5806
-5112
No files matched your search
+12
-12
@@ -1,35 +1,35 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""集中配置与常量(框架无关)。
|
||||
|
||||
自 main.py 原样迁出,语义不变:仅常量、配置类与路径定义。
|
||||
不导入 flask/fastapi,不持有任何运行时可变状态(运行时状态见 core.state)。
|
||||
仅常量、配置类与路径定义;分层重构未改变任何取值。
|
||||
不导入 fastapi,不持有任何运行时可变状态(运行时状态见 core.state)。
|
||||
"""
|
||||
|
||||
import os
|
||||
from dataclasses import dataclass
|
||||
|
||||
# 站点统一版本号(P3-12/P3-22:/health、/api/info、前端 CHANGELOG 全部以此为准,别处不得硬编码)
|
||||
# 站点统一版本号(/health、/api/info、前端 CHANGELOG 全部以此为准,别处不得硬编码)
|
||||
APP_VERSION = '2.4.0'
|
||||
|
||||
# 交付结果保留期(P1-3/D-1:服务端与前端「领取」入口统一 35 分钟——前端入口保留 35 分钟,
|
||||
# 交付结果保留期(/D-1:服务端与前端「领取」入口统一 35 分钟——前端入口保留 35 分钟,
|
||||
# 原 30 分钟会在最后 5 分钟让领取必 404)。终态任务记录、任务目录、下载缓存均按此回收。
|
||||
RESULT_RETENTION_SECONDS = 35 * 60
|
||||
|
||||
|
||||
@dataclass
|
||||
class Settings:
|
||||
"""服务配置类(原 main.APIConfig;迁移期保留 APIConfig 别名以兼容既有引用)"""
|
||||
"""服务配置类(保留 APIConfig 别名以兼容既有引用)"""
|
||||
|
||||
host: str = '0.0.0.0'
|
||||
port: int = 5000
|
||||
debug: bool = False
|
||||
downloads_dir: str = 'downloads'
|
||||
# 第 98 条:max_file_size/request_timeout 两个架空字段已删除——请求体上限真实
|
||||
# max_file_size/request_timeout 两个架空字段已删除——请求体上限真实
|
||||
# 生效点是 _body_size_limit(业务 2MB/备份 200MB),上游超时在 music_api 各调用点
|
||||
log_level: str = 'INFO'
|
||||
cors_origins: str = (
|
||||
os.environ.get('CORS_ORIGINS') or '*'
|
||||
).strip() or '*' # 第 100 条:可经环境变量收敛同源(空值回落默认)
|
||||
).strip() or '*' # 可经环境变量收敛同源(空值回落默认)
|
||||
|
||||
|
||||
# 向后兼容别名:既有代码/文档沿用 APIConfig 名称
|
||||
@@ -37,8 +37,8 @@ APIConfig = Settings
|
||||
|
||||
|
||||
# 游客个人登录使用的独立 Cookie 文件(与管理员全局 Cookie 分离)。
|
||||
# 第 100 条:这是有意的隔离——QRLoginClient 的默认值恰是全局 cookie.txt,
|
||||
# 显式传参防误写全局文件;第 91 条起本站任何路径都不再写它(仅构造参数)
|
||||
# 这是有意的隔离——QRLoginClient 的默认值恰是全局 cookie.txt,
|
||||
# 显式传参防误写全局文件;起本站任何路径都不再写它(仅构造参数)
|
||||
USER_COOKIE_FILE = 'user_cookie.txt'
|
||||
|
||||
|
||||
@@ -47,10 +47,10 @@ PAUSE_AFTER_SECONDS = 40
|
||||
CANCEL_AFTER_SECONDS = 30 * 60
|
||||
HEARTBEAT_INTERVAL = 15
|
||||
|
||||
# 每用户同时在途(排队/运行/暂停)任务上限与全站任务表上限(F20:资源上限)
|
||||
# 每用户同时在途(排队/运行/暂停)任务上限与全站任务表上限(资源上限)
|
||||
MAX_ACTIVE_TASKS_PER_USER = 5
|
||||
MAX_TOTAL_TASKS = 200
|
||||
# 第 97 条(P2-2):终态任务要留表 35 分钟供领取,容量闸只数在途任务——旧口径把
|
||||
# 终态任务要留表 35 分钟供领取,容量闸只数在途任务——旧口径把
|
||||
# 终态记录计入 200 上限会把全站吞吐封顶在约 5.7 任务/分钟;终态另设更大的滞留
|
||||
# 上限保内存有界(1000 ≈ 28 任务/分钟的领取窗口,远高于在途处理能力)
|
||||
MAX_TERMINAL_TASKS = 1000
|
||||
@@ -60,7 +60,7 @@ BATCH_ZIP_CONCURRENCY = 3
|
||||
|
||||
|
||||
# 音频直链多重防护(HMAC 签名 + 时效 + 代理流)
|
||||
AUDIO_TOKEN_TTL = RESULT_RETENTION_SECONDS + 60 # 第 93 条(P2-4):= 36 分钟——原 30 分钟
|
||||
AUDIO_TOKEN_TTL = RESULT_RETENTION_SECONDS + 60 # = 36 分钟——原 30 分钟
|
||||
# 大于交付/解析结果 35 分钟保留期 60 秒:交付窗口末段试听不再 403(旧 30 分钟口径矛盾已修)
|
||||
AUDIO_URL_KEYS = {'url', 'audioUrl'}
|
||||
AUDIO_HOST_MARKS = ('126.net', 'music.126.net', '.netease')
|
||||
|
||||
Reference in new issue
Block a user