 snowy-yang
|
f5d1e3c3a9
|
feat: 支持纯 FastAPI 模式（根路径服务前端）+ 修任务端点路径
- web/app.py：create_app(api_prefix=) 参数化前缀——'' 即根路径模式，
87 条路由直接服务前端使用的路径，无需 Flask 兜底
- web/main.py：WEB_MODE=dual（默认，迁移期）/ fastapi（纯 FastAPI）切换
- 修真实路径缺陷：任务类端点漏了 /api 段（Flask 为 /api/topen 等，
原写成 /topen），根路径模式下前端会 404。已改为 /api/topen、/api/queue、
/api/batch_progress、/api/task/*；fe_error 同步修正
- 奇偶校验路径映射同步更新
验证：
- tests/test_root_mode.py 新增 66 项：前端调用的每条路径在纯 FastAPI 模式下
均非 404；root 模式不再暴露 /api/v1
- 纯 FastAPI 模式真实启动（uvicorn, PORT=5002）实测：
/health、/、/static 200，/song、/api/task/list 401（鉴权生效）
- 全套 pytest 135/135；ruff All checks passed；pyright 0 errors；奇偶 36/36
|
2026-09-26 10:25:05 +08:00 |
|
|
snowy-yang
|
52ed8b54fb
|
feat(server): 生产服务器切换 uvicorn（FastAPI + Flask 兜底）
- web/main.py：uvicorn 入口，默认开启 Flask 兜底（未迁移路由回落遗留应用）；
HOST/PORT/LOG_LEVEL 环境变量可配；proxy_headers 按 XFF 取真实 IP（仅信回环）；
server_header=False 抹服务器指纹
- entrypoint.sh：默认 exec web/main.py；WEB_STACK=flask 可应急回退旧入口
- Dockerfile：安装 requirements-fastapi.txt（目标栈）+ requirements.txt（Flask 兜底）
验证（单进程双框架实跑）：/health、/（Flask 兜底）与 /api/v1/site/stats（FastAPI）
均 200；Server 头为 NeteaseUrl；ruff/pyright 干净。
|
2026-09-26 00:35:02 +08:00 |
|
|
snowy-yang
|
9f56f68b66
|
chore(async-infra): 异步基础层 + 工具链 + 清理
异步基础层（core/）：
- db.py aiosqlite + WAL：读路径无锁并发、写路径 asyncio.Lock 串行，
busy_timeout 自旋——实现「读写同时进行」（旧实现用 RLock 全读串行）
- http_client.py aiohttp 连接池 + 有界重试（5xx 重试 / 4xx 不重试）+
响应体上限 + 流式接口；按事件循环隔离 session（支持迁移期双 loop）
工具链：
- pyproject.toml ruff(E/F/W/I/B/UP/C4/ASYNC/S/RUF) + pyright(basic) + pytest(asyncio auto)
- requirements-fastapi.txt FastAPI/aiohttp/aiosqlite/aiofiles 等目标栈
- requirements-dev.txt 开发依赖（pytest/ruff/pyright）
清理：删除无用脚本 _csscheck.py 与产物标记 _css_ok.txt/_pkg_ok.txt，同步 .gitignore
验证：pytest 10/10（含「写 200 条同时 4 读协程零异常」并发用例）；
ruff All checks passed；pyright 0 errors。
|
2026-09-26 00:24:00 +08:00 |
|
|
snowy-yang
|
41356e89c4
|
feat(web): FastAPI 脚手架（strangler 迁移起点）
新增 web/ 包，与 Flask 应用并存、共享 core/：
- web/app.py create_app 工厂；已迁移路由挂 /api/v1，可挂遗留 Flask 兜底
- web/main.py uvicorn 入口（sys.path 补项目根）
- web/response.py 响应工具，与 Flask APIResponse 的 JSON 契约逐字段对齐
- web/routers/system.py 迁移样板：/api/v1/health、/api/v1/api/info
- requirements-fastapi.txt 迁移目标依赖（不影响当前生产 Flask 部署）
验证：
- 奇偶校验（.zcode/refactor/parity.py）Flask /health vs FastAPI /api/v1/health、
/api/info vs /api/v1/api/info —— 状态码/顶层键/响应体全一致
- uvicorn 真实启动 200；Flask fallback 挂载下 /api/v1/* 走 FastAPI、/* 走 Flask 同为 200
当前仅样板端点；生产服务器切换与状态统一见后续迁移阶段。
|
2026-09-26 00:17:56 +08:00 |
|