后端前端音视频【免费下载链接】Auto_BangumiAutoBangumi - 全自动追番工具项目地址https://gitcode.com/gh_mirrors/au/Auto_Bangumi点击查看免费下载AutoBangumi 是开源的全自动追番工具3.2 版本2025-01是一次覆盖后端、前端与基础设施的大版本重构。本篇以仓库 docs/changelog/3.2.md及其日文版 docs/ja/changelog/3.2.md为核心骨架结合 backend/src/module/security/webauthn.py、backend/src/module/core/offset_scanner.py、backend/src/module/api/setup.py 等源码实现逐项拆解该版本的新功能、性能优化、异步迁移与升级注意事项帮助你理解 AutoBangumi 3.2 的核心机制并安全地从 3.1.x 升级。一、版本概览3.2 带来了什么3.2 是 AutoBangumi 在 2025 年 1 月发布的里程碑版本核心脉络可以概括为四条主线安全与登录体验引入 WebAuthn Passkey 无密码登录通过认证策略模式AuthStrategy将密码登录与 Passkey 登录统一在同一套认证接口下。番剧数据正确性新增季度/集数偏移自动检测解决字幕组分季习惯与 TMDB 官方季数不一致导致的归档错乱问题同时引入番剧归档功能与 RSS 连接状态追踪。新用户体验新增 7 步首次运行设置向导降低部署门槛新增日历视图与下载器管理界面。工程底座升级后端全面异步化数据库、RSS 引擎、下载器、检查器、解析器、网络请求依赖管理迁移到uv并伴随十余项性能优化与一批关键 Bug 修复。下文将按功能模块逐项展开并在关键节点给出仓库源码级依据。二、WebAuthn Passkey 无密码登录3.2 最核心的安全特性是 Passkey 无密码登录。它并非简单的指纹登录按钮而是一整套基于 WebAuthn 协议的凭证注册、认证与管理闭环。2.1 认证策略模式统一密码与 Passkey文档中提到的认证策略模式在源码中有明确实现抽象基类AuthStrategy定义authenticate(username, credential)接口PasskeyAuthStrategy是其具体实现统一处理 Passkey 认证流程。这一设计让上层登录接口无需关心凭证类型未来扩展其他认证方式时也只需新增策略类。见 backend/src/module/security/auth_strategy.py。2.2 注册与认证流程的源码实现WebAuthn 的核心业务逻辑封装在WebAuthnServicebackend/src/module/security/webauthn.py中包含三个关键环节Challenge 管理服务内置 challenge 存储TTL 为 300 秒、容量上限 100 条过期自动清理、超限按最旧淘汰。注册与认证分别以reg_{username}、auth_{username}作为逻辑键存储 challenge。注册选项生成generate_registration_options会将用户已有凭证转为exclude_credentials排除列表防止同一设备重复注册同时强制resident_keyREQUIRED——这是支持无用户名登录可发现凭证的前提。支持的签名算法为 ES256ECDSA_SHA_256与 RS256RSASSA_PKCS1_v1_5_SHA_256。响应验证verify_registration校验 challenge、rp_id 与 origin 后将凭证以 Base64URL 编码的credential_id、Base64 编码的public_key及sign_count存入Passkey对象。API 层位于 backend/src/module/api/passkey.py提供注册选项、注册完成、认证选项、认证完成、列表与删除等端点。其中_get_webauthn_from_request优先读取settings.security.webauthn_rp_id/webauthn_origin显式配置未配置时按Origin → Referer → Host顺序推断——这正对应文档中修复跨端口开发环境验证问题的变更。2.3 克隆攻击防护与多设备备份检测克隆攻击防护每次认证成功后verify_authentication_response会返回新的sign_count随后通过update_passkey_usage写回数据库。若验证器被克隆其签名计数器不会递增从而暴露克隆行为。这是文档所述sign_count 验证的具体实现。多设备备份检测注册验证时通过verification.credential_device_type CredentialDeviceType.MULTI_DEVICE判断该凭证是否属于可跨设备同步的类型如 iCloud 钥匙串并记录backup_eligible与backup_state。文档还特别指出一个修复点py_webauthn 2.7.0 中aaguid类型已从bytes变为str同时废弃的credential_backup_eligible字段被credential_device_type取代——源码中Passkey对象的构造正好体现了这一变化。2.4 无用户名登录可发现凭证generate_discoverable_authentication_options生成不带allowCredentials的认证选项即进入可发现凭证模式浏览器列出该 rp_id 下所有可用的 resident key用户选择后无需输入用户名即可登录。verify_discoverable_authentication会先从clientDataJSON中解析出实际签名的 challenge 再校验避免并发登录时错误消费他人 challenge。配合PasskeyAuthStrategy.authenticate前端在登录页提供的指纹登录按钮即走此路径。前端部分webui/src/components/ab-change-account.vue 等提供了 Passkey 管理面板WebAuthn 浏览器支持检测、自动设备名识别、Passkey 列表展示与删除。三、季度/集数偏移自动检测这是 3.2 对追番体验影响最直接的功能。字幕组习惯按部分/cour分季如《葬送的芙莉莲》第一季实际分为两部分播出而 TMDB 通常将其归为同一季导致 RSS 解析出的S2E1实际对应 TMDB 的S1E29归档目录因此错乱。3.1 虚拟季度检测原理检测逻辑位于 backend/src/module/parser/analyser/offset_detector.py 与 backend/src/module/parser/analyser/tmdb_parser.pytmdb_parser拉取每季各集的air_date播出日期detect_virtual_seasons遍历相邻集数若播出间隔超过gap_months默认6 个月即判定为虚拟季度断点返回虚拟季度起始集号列表如[1, 29]表示第 1 部分从第 1 集、第 2 部分从第 29 集开始。3.2 偏移计算逻辑detect_offset_mismatch(parsed_season, parsed_episode, tmdb_info)返回OffsetSuggestion含season_offset、episode_offset、reason、confidence遵循两条关键规则简单季度不匹配不再建议集数偏移若 RSS 季度超出 TMDB 总季数先计算季度偏移映射到 TMDB 的最后一季仅当目标季存在虚拟季度断点且当前处于第 2 部分及之后时才设置集数偏移vs_starts[index] - 1。这正是文档所述简单季度不匹配时不再建议集数偏移仅虚拟季度需要。置信度分级当调整后集数超出 TMDB 该季集数、且剧集状态为Returning Series放送中时置信度降为medium提示TMDB 可能尚未更新。3.3 后台扫描与 API 端点后台扫描器OffsetScannerbackend/src/module/core/offset_scanner.py周期性扫描所有活跃番剧通过get_active_for_scan()获取订阅列表并做了合理的跳过策略已标记needs_review的跳过episode_type ! episodeOVA/OAD/SP 等跳过——它们不是周更剧集不应驱动偏移用户已手动配置过偏移的跳过从 Torrent 表解析该番剧真实已知的最新集数作为信号而非猜测。命中高/中置信度建议时调用set_needs_review写入needs_review与needs_review_reason字段数据库迁移见 backend/src/module/database/migrations.py并触发OffsetReviewEvent通知。配套 API 端点在 backend/src/module/api/bangumi.py端点方法作用/bangumi/detect-offsetPOST添加/订阅前由前端调用检测是否需偏移并返回 TMDB 摘要与建议/bangumi/dismiss-review/{id}PATCH用户审查后清除needs_review标记/bangumi/needs-reviewGET获取所有待审查番剧/bangumi/apply-offset/{id}、/bangumi/apply-offset/manyPOST应用建议偏移并触发一次重命名_trigger_rename内部调用Renamer.rename()另外TMDBSummary响应模型会带回virtual_season_starts如{1: [1, 29]}前端偏移检查面板据此展示解析的季度/集数 建议偏移量。3.4 一个重要的路径修复文档强调季度偏移此前未应用到下载文件夹路径。3.2 修复后设置季度偏移会自动更新 qBittorrent 保存路径如Season 2→Season 1RSS 规则的保存路径也同步更新。这意味着偏移不仅影响番剧元数据还落到实际的种子保存目录上。四、番剧归档功能3.2 新增了番剧归档能力用于整理已完结或不再关注的订阅手动归档/取消归档PATCH /bangumi/archive/{id}、PATCH /bangumi/unarchive/{id}对应TorrentManager.archive_rule / unarchive_rule已完结系列自动归档GET /bangumi/refresh/metadata刷新 TMDB 元数据并自动归档已完结番剧前端番剧列表页新增可折叠的已归档分区与骨架屏加载动画。五、搜索源配置 API搜索源从硬编码走向可配置。API 位于 backend/src/module/api/search.pyGET /search/provider/config返回各搜索源的 URL 模板{site: url}映射PUT /search/provider/config批量更新搜索源配置。底层实现见 backend/src/module/conf/search_provider.py默认内置四个搜索源——mikanhttps://mikanani.me/RSS/Search?searchstr%s、anibt、nyaa、dmhy配置持久化到config/search_provider.json。_normalize兼容旧版仅存 URL 字符串的配置格式并自动补齐后来新增的内置源save_provider在传入纯 URL 时会保留该站点已选择的解析器。前端配套搜索源设置面板支持增删改查且默认源mikan、nyaa、dmhy不可删除URL 模板校验确保包含%s占位符。六、RSS 连接状态追踪RSS 订阅从静默失败变为可见诊断。每次刷新后系统记录三个字段connection_statushealthy或errorlast_checked_at最近检查时间last_error最近一次错误详情。数据库迁移在rssitem表上为这三个字段执行ALTER TABLE ADD COLUMN见 backend/src/module/database/migrations.py。前端 RSS 管理页据此渲染连接状态标签健康时绿色已连接错误时红色并通过 tooltip 展示错误详情。七、首次运行设置向导3.2 将新用户的部署体验从手抄配置文件升级为可视化引导。后端 API 位于 backend/src/module/api/setup.py前端为独立向导页面共7 步账户、下载器、RSS 源、媒体路径、通知可跳过稍后在设置中配置。关键机制哨兵文件config/.setup_complete存在即视为设置完成。/setup/status返回need_setup供前端路由守卫自动跳转开发模式VERSION DEV_VERSION下仅检查哨兵文件便于测试。未认证 API 与权限收敛设置 API 首次运行才可用完成后统一返回 403。/setup/complete额外有_require_default_admin_or_authenticated双重防护——要求调用者已有有效会话或admin账户仍为出厂默认密码adminadmin防止升级安装中未跑向导的场景下被未认证调用者覆盖真实管理员凭据。连接测试端点/setup/test-downloader支持 qBittorrent 与 aria2。qBittorrent 通过api/v2/auth/login验证兼容 5.2 的 204 响应与旧版 200 Ok. 响应aria2 通过 JSON-RPCaria2.getVersion一次验证可达性与 RPC secret。仅允许 http/https scheme_validate_scheme原始错误信息不会回显给未认证调用者#1041 安全修复。/setup/test-rss拉取 XML 并解析channel/title与channel/item同时拒绝指向私网/回环 IP 的 URL。/setup/test-notification通过PROVIDER_REGISTRY实例化通知 Provider 并发送测试消息。完成动作complete_setup依次更新用户凭据并吊销所有 pre-setup 会话、写入下载器与通知配置settings.save通过asyncio.to_thread避免阻塞事件循环、通过ctx.reload_settings()重建共享 httpx 客户端/通知器/调度器、可选添加 RSS 源最后创建哨兵文件并启动任务。前端侧由多步骤向导组件进度条 步骤导航实现路由守卫自动检测need_setup并重定向中英文 i18n 双支持。八、日历视图与下载器管理界面日历视图集成 Bangumi.tv 放送时间表前端新增日历页面。同名番剧多个规则合并分组显示点击可选择具体规则未知播出日独立成块海报懒加载。后端提供/bangumi/refresh/calendar与手动设置放送日的PATCH /bangumi/{id}/weekday0-6表示周一至周日空值重置。下载器管理界面新增下载器 API 与管理页面可在 UI 中查看和管理下载客户端连接。九、全面异步迁移3.2 将整个后端从同步阻塞模型迁移到asyncio这是性能提升的基础层面变更源码证据数据库引入 aiosqlitePasskey 操作非阻塞 I/OUserDatabase支持 sync/async 双模式Database上下文管理器同时支持with与async withbackend/src/module/database/passkey.py、backend/src/module/database/engine.py网络请求从requests迁移到httpx.AsyncClient共享连接池复用 TCP/SSL 连接backend/src/module/network/request_contents.pyRSS 引擎pull_rss、refresh_rss、download_bangumi、add_rss全面异步化backend/src/module/rss/engine.py其他模块Checker.check_downloader、TitleParser.tmdb_parser、auth_user、update_user_info转为异步backend/src/module/checker/checker.py并发原语ProgramStatus从 threading 迁移到 asyncioEvent、Lockbackend/src/module/core/loops.py文档还特别注明服务器启动改为后台任务不再阻塞修复 #891、#929、#886、#917、#946解决了程序启动时整个服务无响应的问题。十、性能优化清单3.2 的性能优化有明确的数量级表述且均能在代码结构中找到对应实现RSS 刷新并发化asyncio.gather多源场景约10 倍提速种子文件并发下载多种子约5 倍提速重命名模块并发获取文件列表约20 倍提速通知发送并发化移除 2 秒硬编码延迟解析结果缓存新增 TMDB 与 Mikan 解析结果缓存tmdb_parser中_TMDB_CACHE_MAX 512的 OrderedDict LRU 缓存避免重复 API 调用注意配置变更如tmdb_base_url后需调用reset_cache()数据库索引为Torrent.url、Torrent.rss_id、Bangumi.title_raw、Bangumi.deleted、RSSItem.url添加索引事务批处理RSS 批量启用/禁用改为单事务而非逐条提交预编译正则种子名解析与过滤器匹配使用预编译 pattern去重算法RSS 解析去重从 O(n²) 列表查找改为 O(1) 集合查找内存优化Episode/SeasonInfo数据类使用__slots__减少内存占用认证复用SeasonCollector在循环外创建复用单次认证。十一、升级迁移与兼容性3.1.x → 3.23.2 修复了两个升级相关的严重问题升级前务必了解11.1 配置字段冲突导致设置丢失#956从 3.1.x 升级时旧的配置字段与新配置模型冲突可能导致设置被清空。修复内容包括program.sleep_time/program.times自动迁移为rss_time/rename_time移除废弃的rss_parser字段type、custom_url、token、enable_tmdb修复ENV_TO_ATTR环境变量映射指向不存在模型字段的问题修复DEFAULT_SETTINGS与当前配置模型不一致的问题。11.2 版本感知的迁移分发此前所有升级路径都会错误地调用 3.0→3.1 迁移。3.2 引入基于源版本的迁移分发backend/src/module/update/cross_version.py 中定义了from_30_to_31()与from_31_to_32()后者执行建表与run_migrations()run_migrations()统一入口按源版本调度。数据库 schema 变更needs_review、needs_review_reason、connection_status等字段通过 backend/src/module/database/migrations.py 完成迁移逻辑会自动用模型默认值填充 NULL 值。十二、前端设计系统重构与移动端优先12.1 全新 UI 设计系统统一设计令牌颜色、字体、间距、阴影、动画统一抽象主题深色/浅色主题切换无障碍ARIA、键盘导航、焦点管理移动端优先三层断点系统——移动端640px、平板640-1023px、桌面端≥1024px取代原单一 1024px 断点移动端底部导航栏、平板迷你侧边栏56px 图标导航、弹窗自动切换为底部抽屉、下拉刷新、水平滑动容器、CSS Grid 卡片布局、触摸目标最小 44px、安全区域与100dvh动态视口高度支持。12.2 新组件组件说明ab-bottom-sheet触摸驱动的底部抽屉拖动关闭、最大高度限制ab-adaptive-modal自适应弹窗移动端底部抽屉 / 桌面端居中对话框ab-pull-refresh下拉刷新包装组件ab-swipe-container水平滑动容器CSS scroll-snapab-data-list移动端友好卡片列表替代 NDataTableab-mobile-nav增强版底部导航栏图标 标签 激活指示器useSafeArea安全区域组合式函数这些组件源码位于 webui/src/components 目录如 webui/src/components/basic 与 webui/src/hooks/useSafeArea.ts。12.3 其他前端功能与优化搜索面板重设计模态框 过滤系统支持字幕组、分辨率标准化为 FHD/HD/4K、字幕类型简/繁/双语、季度过滤多选筛选器智能禁用不兼容选项点击弹窗外自动关闭。同时重构搜索逻辑并移除 rxjs 依赖。iOS 风格通知角标黄色角标 紫色边框标记待审查订阅支持组合显示如! | 2表示有警告且有多个规则卡片黄色发光动画。规则编辑器剧集偏移字段新增自动检测按钮编辑弹窗警告横幅支持一键自动检测与忽略。resolvePosterUrl工具函数统一外部 URL 与本地路径处理修复 #934 海报端点误拦截所有请求的问题。性能下载器 store 用shallowRef替代ref避免大数组深层响应式代理表格列定义移入computedsetInterval替换为useIntervalFn自动生命周期管理布局使用dvh单位。移动端细节修复设置页水平溢出max-width: 100% 折叠面板约束、顶栏弹性布局、搜索弹窗关闭按钮截断、保存/取消按钮加载态、侧边栏动画抖动rotateY → rotate等。十三、CI / 基础设施变更构建测试PR 打开时自动触发构建测试dev 分支 PR 到 main 自动构建Artifact 升级actions/upload-artifact与actions/download-artifact升级到 v4Docker 平台裁剪移除linux/arm/v7构建平台——uv基础镜像不支持该架构这也是 3.2 迁移到uv包管理器backend/pyproject.toml backend/uv.lock的连带调整开发指南新增 CLAUDE.md 开发指南。结语AutoBangumi 3.2 是一个体验与工程双升级的版本面向用户它带来了 Passkey 无密码登录、偏移自动检测、归档、设置向导与日历视图面向开发者它完成了全异步迁移与十余项性能优化并修复了升级路径上的配置丢失与迁移错配问题。如果你正运行 3.1.x升级到 3.2 时请关注 docs/changelog/3.2.md 中的配置字段迁移说明相关测试用例如 backend/test/test_migration.py、backend/test/test_offset_scanner.py、backend/test/test_mcp_security.py可帮助你进一步验证升级后的行为。赞分享后端前端音视频【免费下载链接】Auto_BangumiAutoBangumi - 全自动追番工具项目地址https://gitcode.com/gh_mirrors/au/Auto_Bangumi点击查看免费下载相关推荐AutoBangumi 3.2 版本全解析Passkey 无密码登录、集数偏移自动检测与全异步架构升级AutoBangumi 3.2 版本全解析Passkey 无密码登录、集数偏移自动检测与全异步架构升级 AutoBangumi 3.22025 01 发布后端前端音视频AutoBangumi 3.2 版本全解析Passkey 无密码登录、季度偏移自动检测与全异步化重构AutoBangumi 3.2 版本全解析Passkey 无密码登录、季度偏移自动检测与全异步化重构 AutoBangumi 3.2发布于 2025 年 1后端前端音视频Windows/Cygwin 下 TPM 报 returned 2 怎么解决Windows/Cygwin 下 TPM 报 returned 2 怎么解决 在 Windows / Cygwin 环境下使用 tpmTmux Plug后端前端音视频上一篇android-checkout高级用法自定义购买验证与复杂支付场景处理指南下一篇AI驱动的视频转文字工具提升学习效率的智能解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考