Archived
snowy-yang
6288a98ecc
为什么：单文件 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/ 指纹未变；忽略注释的逐字等价性校验通过。
71 lines
2.9 KiB
Python
71 lines
2.9 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""集中配置与常量（框架无关）。
|
||
|
||
仅常量、配置类与路径定义；分层重构未改变任何取值。
|
||
不导入 fastapi，不持有任何运行时可变状态（运行时状态见 core.state）。
|
||
"""
|
||
|
||
import os
|
||
from dataclasses import dataclass
|
||
|
||
# 站点统一版本号（/health、/api/info、前端 CHANGELOG 全部以此为准，别处不得硬编码）
|
||
APP_VERSION = '2.4.0'
|
||
|
||
# 交付结果保留期（/D-1：服务端与前端「领取」入口统一 35 分钟——前端入口保留 35 分钟，
|
||
# 原 30 分钟会在最后 5 分钟让领取必 404）。终态任务记录、任务目录、下载缓存均按此回收。
|
||
RESULT_RETENTION_SECONDS = 35 * 60
|
||
|
||
|
||
@dataclass
|
||
class Settings:
|
||
"""服务配置类（保留 APIConfig 别名以兼容既有引用）"""
|
||
|
||
host: str = '0.0.0.0'
|
||
port: int = 5000
|
||
debug: bool = False
|
||
downloads_dir: str = 'downloads'
|
||
# 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 '*' # 可经环境变量收敛同源（空值回落默认）
|
||
|
||
|
||
# 向后兼容别名：既有代码/文档沿用 APIConfig 名称
|
||
APIConfig = Settings
|
||
|
||
|
||
# 游客个人登录使用的独立 Cookie 文件（与管理员全局 Cookie 分离）。
|
||
# 这是有意的隔离——QRLoginClient 的默认值恰是全局 cookie.txt，
|
||
# 显式传参防误写全局文件；起本站任何路径都不再写它（仅构造参数）
|
||
USER_COOKIE_FILE = 'user_cookie.txt'
|
||
|
||
|
||
# 设备心跳时序：超时未上线则暂停其批量任务让出排队名额；超过取消窗口则取消并删文件
|
||
PAUSE_AFTER_SECONDS = 40
|
||
CANCEL_AFTER_SECONDS = 30 * 60
|
||
HEARTBEAT_INTERVAL = 15
|
||
|
||
# 每用户同时在途（排队/运行/暂停）任务上限与全站任务表上限（资源上限）
|
||
MAX_ACTIVE_TASKS_PER_USER = 5
|
||
MAX_TOTAL_TASKS = 200
|
||
# 终态任务要留表 35 分钟供领取，容量闸只数在途任务——旧口径把
|
||
# 终态记录计入 200 上限会把全站吞吐封顶在约 5.7 任务/分钟；终态另设更大的滞留
|
||
# 上限保内存有界（1000 ≈ 28 任务/分钟的领取窗口，远高于在途处理能力）
|
||
MAX_TERMINAL_TASKS = 1000
|
||
|
||
# 全局批量打包并发上限（同时构建的 ZIP 数量）
|
||
BATCH_ZIP_CONCURRENCY = 3
|
||
|
||
|
||
# 音频直链多重防护（HMAC 签名 + 时效 + 代理流）
|
||
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')
|
||
|
||
|
||
# 可解析音质档位（顺序即前端展示顺序）
|
||
VALID_QUALITY_LEVELS = ['standard', 'exhigh', 'lossless', 'hires', 'sky', 'jyeffect', 'jymaster', 'dolby']
|