# [Unreleased] ## Backend ### Added - 新增 `Security` 配置模型，支持登录 IP 白名单、MCP IP 白名单和 Bearer Token 认证 - 新增登录端点 IP 白名单检查中间件 (`check_login_ip`) - MCP 安全中间件升级为可配置模式：支持 CIDR 白名单 + Bearer Token 双重认证 - 认证端点支持 `Authorization: Bearer` 令牌绕过 Cookie 登录 - 配置 API `_sanitize_dict` 修复：仅对字符串值进行脱敏，避免误处理非字符串字段 - 新增番剧放送日手动设置 API (`PATCH /api/v1/bangumi/{id}/weekday`)，支持锁定放送日防止日历刷新覆盖 - 数据库迁移 v9：`bangumi` 表新增 `weekday_locked` 列 ### Changed - 重构认证模块：提取 `_issue_token` 公共方法，消除 3 处重复的 JWT 签发逻辑 - `get_current_user` 简化为三级认证（DEV 绕过 → Bearer Token → Cookie JWT） - `LocalNetworkMiddleware` 重命名为 `McpAccessMiddleware`，从硬编码 RFC 1918 改为读取配置 ### Tests - 新增 101 个单元测试覆盖安全、认证、配置、下载器和 MockDownloader 模块 ## Frontend ### Added - 新增日历拖拽排列功能：可将「未知」番剧拖入星期列，自动设置放送日并锁定 - 拖入后显示紫色图钉图标，鼠标悬停显示取消按钮 - 锁定的番剧在日历刷新时不会被覆盖 - 使用 vuedraggable 实现流畅拖拽动画 - 新增安全设置组件 (`config-security.vue`)，支持在 WebUI 中配置 IP 白名单和 Token - 前端 `Security` 类型定义和初始化配置 --- # [3.2.3] - 2026-02-23 ## Backend ### Added - 新增 MCP (Model Context Protocol) 服务器，支持通过 Claude Desktop 等 LLM 工具管理番剧订阅 - SSE 传输层挂载在 `/mcp/sse`，支持 MCP 客户端连接 - 10 个工具：list_anime、get_anime、search_anime、subscribe_anime、unsubscribe_anime、list_downloads、list_rss_feeds、get_program_status、refresh_feeds、update_anime - 4 个资源：anime/list、anime/{id}、status、rss/feeds - 本地网络 IP 白名单安全中间件（RFC 1918 + 回环地址），无需 JWT 认证 - 新增通知系统重构，支持多通知渠道同时启用 - 支持 Telegram、Bark、Server 酱、企业微信、Discord、Gotify、Pushover、Webhook 八种渠道 - 新增通知管理 API：`GET/PUT /api/notification/providers` - 新增 E2E 集成测试套件，覆盖 RSS→下载→重命名全流程 ### Fixes - 修复第 0 集（SP/OVA）被错误重命名为第 1 集的问题 (#977) - Episode 0 现在免受集数偏移影响，不再覆盖正常集数文件 - 修复 RSS 过滤器包含特殊字符（如 `[字幕组`）时导致程序崩溃的问题 (#974) - 无效正则表达式自动降级为字面量匹配 - 修复聚合 RSS 解析时 `title_raw` 为空导致 `TypeError` 崩溃的问题 (#976) - 修复解析器处理无括号种子名称时 `IndexError` 崩溃的问题 (#973) - 修复删除番剧时未清理关联种子记录的问题 - 修复认证路由、JWT 刷新和 WebAuthn 注册流程的多个安全问题 - 修复程序生命周期管理和后台任务取消逻辑 - 修复数据库迁移在部分场景下未正确执行的问题 ### Performance - 优化日志系统：`RotatingFileHandler` 轮转（5 MB × 3）、`QueueHandler` 异步写入、`GET /api/log` 限读 512 KB - 优化重命名器：批量数据库查询，并发获取种子文件列表 - 所有 `logger.debug(f"...")` 转为惰性 `%s` 格式化（~80 处） ### Tests - 新增 26 个回归测试覆盖 #974、#976、#977、#986 - 扩展 raw_parser、torrent_parser、path_parser 测试覆盖率 ## Frontend ### Fixes - 修复认证路由守卫和 i18n 初始化顺序问题 - 修复通知设置组件与项目设计系统的对齐问题 - 修复组件生命周期管理问题 ## Docs - README 移除未实现的 Aria2 和 Transmission 下载器 (#987) --- # [3.2.0-beta.13] - 2026-01-26 ## Frontend ### Features - 重新设计搜索面板 - 新增筛选区域，支持按字幕组、分辨率、字幕类型、季度分类筛选 - 多选筛选器，智能禁用不兼容的选项（灰色显示） - 结果项标签改为非点击式彩色药丸样式 - 统一标签样式（药丸形状、12px 字体） - 标签值标准化（分辨率：FHD/HD/4K，字幕：简/繁/双语） - 筛选分类和结果变体支持展开/收起 - 海报高度自动匹配 4 行变体项（168px） - 点击弹窗外部自动关闭 --- # [3.2.0-beta.12] - 2026-01-26 ## Backend ### Features - 偏移检查面板新增建议值显示（解析的季度/集数和建议的偏移量） ### Fixes - 修复季度偏移未应用到下载文件夹路径的问题 - 设置季度偏移后，qBittorrent 保存路径会自动更新（如 `Season 2` → `Season 1`） - RSS 规则的保存路径也会同步更新 - 优化集数偏移建议逻辑 - 简单季度不匹配时不再建议集数偏移（仅虚拟季度需要） - 改进提示信息，明确说明是否需要调整集数 --- # [3.2.0-beta.11] - 2026-01-25 ## Backend ### Features - 新增季度/集数偏移自动检测功能 - 通过分析 TMDB 剧集播出日期检测「虚拟季度」（如芙莉莲第一季分两部分播出） - 当播出间隔超过6个月时自动识别为不同部分 - 自动计算集数偏移量（如 RSS 显示 S2E1 → TMDB S1E29） - 新增后台扫描线程，自动检测已有订阅的偏移问题 - 新增搜索源配置 API 端点： - `GET /search/provider/config` - 获取搜索源配置 - `PUT /search/provider/config` - 更新搜索源配置 - 新增 API 端点： - `POST /bangumi/detect-offset` - 检测季度/集数偏移 - `PATCH /bangumi/dismiss-review/{id}` - 忽略偏移检查提醒 - 数据库新增 `needs_review` 和 `needs_review_reason` 字段 ## Frontend ### Features - 新增搜索源设置面板 - 支持查看、添加、编辑、删除搜索源 - 默认搜索源（mikan、nyaa、dmhy）不可删除 - URL 模板验证，确保包含 `%s` 占位符 - 新增 iOS 风格通知角标系统 - 黄色角标 + 紫色边框显示需要检查的订阅 - 支持组合显示（如 `! | 2` 表示有警告且有多个规则） - 卡片黄色发光动画提示需要注意 - 编辑弹窗新增警告横幅，支持一键自动检测和忽略 - 规则选择弹窗高亮显示有警告的规则 - 首页空状态新增「添加 RSS 订阅」按钮，引导新用户快速上手 - 日历页面海报图片添加懒加载，提升性能 - 日历页面「未知播出日」独立为单独区块，优化视觉节奏 ### Fixes - 修复移动端设置页面水平溢出问题 - 输入框添加 `max-width: 100%` 防止超出容器 - 折叠面板添加宽度约束和溢出隐藏 - 设置栅格添加 `min-width: 0` 允许收缩 - 修复移动端顶栏布局 - 搜索按钮改为弹性布局，填充 Logo 和图标之间的空间 - 减小图标按钮尺寸和间距，优化紧凑型布局 - 添加「点击搜索」文字提示 - 修复移动端搜索弹窗关闭按钮被截断问题 - 减小弹窗头部内边距和元素尺寸 - 搜索源选择按钮缩小至适配移动端 - 修复设置页面保存/取消按钮缺少加载状态 - 修复侧边栏展开动画抖动（rotateY → rotate） - 移动端底部导航标签字号从 10px 增至 11px，提升可读性 - 登录页背景动画添加 `will-change: transform` 优化 GPU 性能 --- # [3.2.0-beta.8] - 2026-01-25 ## Backend ### Features - Passkey 登录支持无用户名模式（可发现凭证） ### Fixes - 修复搜索和订阅流程中的多个问题 - 改进种子获取可靠性和错误处理 ## Frontend ### Features - Passkey 登录支持无用户名模式（可发现凭证） --- # [3.2.0-beta.7] - 2026-01-25 ## Backend ### Features - 数据库迁移自动填充 NULL 值为模型默认值 ### Fixes - 修复下载器连接检查添加最大重试次数 - 修复添加种子时的网络瞬态错误，添加重试逻辑 ## Frontend ### Features - 重新设计搜索面板，新增模态框和过滤系统 - 重新设计登录面板，采用现代毛玻璃风格 - 日志页面新增日志级别过滤功能 ### Fixes - 修复日历页面未知列宽度问题 - 统一下载器页面操作栏按钮尺寸 --- # [3.2.0-beta.6] - 2026-01-25 ## Backend ### Features - 新增番剧归档功能：支持手动归档/取消归档，已完结番剧自动归档 ### Fixes - 修复 `add_all()` 方法缺少去重检查导致重复添加番剧规则的问题 - 去重逻辑基于 `(title_raw, group_name)` 组合，同时支持批量内部去重 - 新增剧集偏移自动检测：根据 TMDB 季度集数自动计算偏移量（如 S02E18 → S02E05） - TMDB 解析器新增 `series_status` 和 `season_episode_counts` 字段提取 - 新增数据库迁移 v4：为 `bangumi` 表添加 `archived` 字段 - 新增 API 端点： - `PATCH /bangumi/archive/{id}` - 归档番剧 - `PATCH /bangumi/unarchive/{id}` - 取消归档 - `GET /bangumi/refresh/metadata` - 刷新元数据并自动归档已完结番剧 - `GET /bangumi/suggest-offset/{id}` - 获取建议的剧集偏移量 - 重命名模块支持从数据库查询偏移量并应用到文件名 ## Frontend ### Features - 番剧列表页新增可折叠的「已归档」分区 - 日历页新增番剧分组功能：相同番剧的多个规则合并显示，点击可选择具体规则 - 番剧列表页新增骨架屏加载动画 ### Fixes - 修复弹窗 z-index 层级问题，新增 CSS 变量管理层级系统 - 改善无障碍体验：按钮最小触摸区域 44px、焦点状态可见、添加 aria-label - 规则编辑弹窗新增归档/取消归档按钮 - 规则编辑器新增剧集偏移字段和「自动检测」按钮 - 新增 i18n 翻译（中文/英文） - 优化规则编辑弹窗布局：统一表单字段对齐、统一按钮高度、修复移动端底部弹窗 z-index 层级问题 - 修复下载器页面仅显示季度文件夹名的问题，现在会显示「番剧名 / Season 1」格式 --- # [3.2.0-beta.5] - 2026-01-24 ## Backend ### Features - RSS 订阅源新增连接状态追踪：每次刷新后记录 `connection_status`（healthy/error）、`last_checked_at` 和 `last_error` - 新增数据库迁移 v2：为 `rssitem` 表添加连接状态相关字段 ### Performance - 新增共享 HTTP 客户端连接池，复用 TCP/SSL 连接，减少每次请求的握手开销 - RSS 刷新改为并发拉取所有订阅源（`asyncio.gather`），多源场景下速度提升约 10 倍 - 种子文件下载改为并发获取，下载多个种子时速度提升约 5 倍 - 重命名模块并发获取所有种子文件列表，速度提升约 20 倍 - 通知发送改为并发执行，移除 2 秒硬编码延迟 - 新增 TMDB 和 Mikan 解析结果的内存缓存，避免重复 API 调用 - 为 `Torrent.url`、`Torrent.rss_id`、`Bangumi.title_raw`、`Bangumi.deleted`、`RSSItem.url` 添加数据库索引 - RSS 批量启用/禁用改为单次事务操作，替代逐条提交 - 预编译正则表达式（种子名解析规则、过滤器匹配），避免运行时重复编译 - `SeasonCollector` 在循环外创建，复用单次认证 - `check_first_run` 缓存默认配置字典，避免每次创建新对象 - 通知模块中的同步数据库调用改为 `asyncio.to_thread`，避免阻塞事件循环 - RSS 解析去重从 O(n²) 列表查找改为 O(1) 集合查找 - 文件后缀判断使用 `frozenset` 替代列表，提升查找效率 - `Episode`/`SeasonInfo` 数据类添加 `__slots__`，减少内存占用 - RSS XML 解析返回元组列表，替代三个独立列表再 zip 的模式 - qBittorrent 规则设置改为并发执行 ## Frontend ### Features - RSS 管理页面新增连接状态标签：健康时显示绿色「已连接」，错误时显示红色「错误」并通过 tooltip 显示错误详情 ### Performance - 下载器 store 使用 `shallowRef` 替代 `ref`，避免大数组的深层响应式代理 - 表格列定义改为 `computed`，避免每次渲染重建 - RSS 表格列与数据分离，数据变化时不重建列配置 - 日历页移除重复的 `getAll()` 调用 - `ab-select` 的 `watchEffect` 改为 `watch`，消除挂载时的无效 emit - `useClipboard` 提升到 store 顶层，避免每次 `copy()` 创建新实例 - `setInterval` 替换为 `useIntervalFn`，自动生命周期管理，防止内存泄漏 - 共享 `ruleTemplate` 对象改为浅拷贝，避免意外的引用共变 - `ab-add-rss` 移除不必要的 `setTimeout` 延迟 ### Fixes - 修复 `ab-image.vue` 中 `