mirror of
https://github.com/jxxghp/MoviePilot.git
synced 2026-05-12 19:06:38 +08:00
c745616495
AsyncRequestUtils 使用按事件循环弱引用持有的共享 AsyncHTTPTransport 作为底层连接池与 TLS 会话；每次请求创建轻量 AsyncClient 承载本次 cookie jar、timeout、follow_redirects， 用完即销毁。共享 transport 由 _NonClosingTransportProxy 包装后 注入 AsyncClient，吞掉 AsyncClient 退出时向底层 transport 传播的 __aexit__/aclose，使底层连接池跨调用持久，从而真正复用 TCP/TLS 握手。 设计要点： - 共享 transport 桶按 (proxy, verify, max_keepalive_connections, max_connections, keepalive_expiry) 区分；每事件循环 32 桶 LRU 上限，超出后异步关闭最久未用桶；关闭 task 由模块级强引用集合 持有以兼容 Python 3.11+ 的任务 GC 行为。 - 通过 FastAPI lifespan shutdown 调用 aclose_shared_async_transports 集中释放底层 transport，避免 ResourceWarning。 - AsyncRequestUtils.request 走三条 path：用户自管 client / 共享 transport + per-call AsyncClient / 兜底临时 client。三条路径 cookie 语义一致；后两条因 per-call AsyncClient 生命周期局限于 单次调用，天然不积累 Set-Cookie，避免跨调用 jar 演化串扰。 - _make_request 对幂等方法（GET/HEAD/OPTIONS）在 RemoteProtocolError / ReadError / WriteError 时单次重试， 容忍 keep-alive stale 连接命中；非幂等方法不重试，但记录 debug 日志。 - get_stream 使用 httpx.AsyncClient.stream() 标准流式 API，与 request 共用三条 path 的 client 选择逻辑；幂等单次重试； yield 体异常透传给 stream 的 __aexit__。 公共 API 表面零变动。插件可通过 max_keepalive_connections / max_connections / keepalive_expiry 三个 limits 参数为自己定制 连接池容量与握手有效期。 TMDB 真实压测（10 部美剧 × 每部 50 集，1020 请求）： 61.96s → 18.15s（3.41×），单请求 p95 149.6ms → 38.1ms。
MoviePilot
简体中文 | English
Redesigned from parts of NAStool, with a stronger focus on core automation scenarios while reducing issues and making the project easier to extend and maintain.
For learning and personal communication only. Please do not promote this project on platforms in mainland China.
Release channel: https://t.me/moviepilot_channel
Key Features
- Frontend/backend separation based on FastApi + Vue3.
- Focuses on core needs, simplifies features and settings, and allows some options to work well with sensible defaults.
- Reworked user interface for a cleaner and more practical experience.
Installation
Official wiki: https://wiki.movie-pilot.org
Local CLI
One-command bootstrap script:
curl -fsSL https://raw.githubusercontent.com/jxxghp/MoviePilot/v2/scripts/bootstrap-local.sh | bash
Manage MoviePilot with the moviepilot command. Full CLI documentation: docs/cli.md
Add Skills for AI Agents
npx skills add https://github.com/jxxghp/MoviePilot
Development
API documentation: https://api.movie-pilot.org
MCP tool API documentation: see docs/mcp-api.md
Development environment setup and local source-run guide: docs/development-setup.md
Plugin development guide: https://wiki.movie-pilot.org/zh/plugindev
Related Projects
Disclaimer
- This software is for learning and personal communication only. It must not be used for commercial purposes or illegal activities. The software does not know how users choose to use it, and all responsibility rests with the user.
- The source code is open source and derived from other open-source code. If someone removes the relevant restrictions and redistributes or publishes modified versions that lead to liability events, the publisher of those modifications bears full responsibility. Public releases that bypass or alter the user authentication mechanism are not recommended.
- This project does not accept donations and has not published any donation page anywhere. The software itself is free of charge and does not provide paid services. Please verify information carefully to avoid being misled.