Archived
snowy-yang
8446166120
## uv 环境管理 - pyproject.toml 声明 dependencies + [dependency-groups].dev，uv.lock 精确锁定 - 删除 requirements.txt / requirements-fastapi.txt / requirements-dev.txt - .python-version = 3.12；Dockerfile 改用 uv sync --frozen（可复现构建） - 新增 jinja2（首页渲染） ## 删除 Flask 技术债 - 从 main.py 用 ast 精确剥离 56 个 Flask 节点（路由/中间件/错误处理/启动）， 框架无关的服务层落为 services/runtime.py（MusicAPIService、下载/打包 worker、 任务监控、缓存清扫），零 Flask 依赖 - 删除 main.py（4527 行）与 auth_routes.py（1050 行） - auth_system.py 移除会话/请求上下文层（login_session/current_user/login_required/ admin_required/_client_ip 等），保留数据与业务层 - 新增 core/net.py（IP 解析）、web/auth_state.py（登录锁定/2FA 票据/发码限流） - FastAPI 侧改直接依赖 services.runtime，不再 import main - web/app.py 去掉 Flask fallback；入口默认根路径模式（API_PREFIX 可选） ## 删除 requests 技术债 - 新增 core/sync_http.py：requests 风格的同步门面（底层 aiohttp 连接池， 流式读取经有界队列背压），含 Session/headers/(connect,read) 元组超时兼容 - core/utils、auth_system、podcast_api、music_downloader、services 全部切换 - 实测真实下载 5.2MB 音频完整成功 ## 质量门禁归零 - ruff：0 错误（B904 全部修复，不再忽略） - pyright：0 错误（类型收窄修复） - pytest：140/140（含 golden 契约回归、root 模式 66 项路径覆盖） - 真实 uvicorn 启动：/health、/、/static、受保护端鉴权全部正确 新增 tests/golden/responses.json：删除 Flask 前捕获的 32 例响应快照， FastAPI 逐字段复现——删除巨石后行为回归仍有硬证据。
15 lines
780 B
Bash
15 lines
780 B
Bash
#!/bin/sh
|
||
# F59：exec 让 python 成为 PID 1 直接接收 SIGTERM，容器停止不再经 shell 转发而超时
|
||
# 第 93 条（P2-4）：compose 挂载 ./user_cookie.txt 时若宿主不存在该文件，Docker 会
|
||
# 在启动前创建同名**目录**并挂载——容器内 touch 只对无卷 docker run 有效。
|
||
# 第 97 条（P3）：检测到同名目录直接报错退出（fail-fast），不再静默带病运行
|
||
for f in user_cookie.txt cookie.txt; do
|
||
if [ -d "/app/$f" ]; then
|
||
echo "FATAL: /app/$f 是目录（宿主机缺文件时 Docker 挂载会建同名目录）。请在宿主机先 touch 该文件再启动。" >&2
|
||
exit 1
|
||
fi
|
||
[ -f "/app/$f" ] || touch "/app/$f"
|
||
done
|
||
# 生产服务器：uvicorn（FastAPI）。
|
||
exec python3 web/main.py
|