FlixPilot · 版本记录
更新日志
从 v2.4.8 到 v2.8.5，共 47 个版本。
v2.8
v2.8.5 最新 新增 3修复 11
新增
- 过期账号自动删除系统设置 → 用户 →「过期账号处理」，可选不删除（默认）、过期 7 天或 30 天后删除，会同时删除面板和 Emby 账号。管理员、白名单和未开通会员的账号不受影响。
- 网盘账号掉线通知每小时检查已启用的 115、123、光鸭、Google Drive 和移动云盘账号。确认失效后，通过 Telegram 私聊和站内信通知管理员，恢复后再通知一次，不会发到群组或频道。
- 网盘账号重新扫码光鸭新增「重新扫码」，115 Open 新增「重新扫码授权」。不用移除再添加，原有配置会保留。
修复
抽奖
- 网页端推送抽奖会发到群组或频道，不再误发到管理员私聊
- 奖励文案改为「中奖每人得 N 爆米花」，参与抽奖不扣爆米花
手机首页
- 修复看不到签到按钮
- 修复媒体统计数字被截断
机器人
- 启动时网络不通，恢复后 Telegram 和 QQ 机器人会自动重连，不用重启面板
备份
- 修复自动备份占用大量内存，导致面板或 Emby 被系统杀掉
- 修复备份中的数据库可能前后不一致
- 备份 JSON 不再包含可重新生成的缓存，体积更小，旧备份仍可恢复
Emby 榜单库
- 修复媒体信息插件生成的文件被同步删除，导致 Emby 循环刷新
网盘状态
- 登录失效后，卡片不再显示绿色「已同步」
- 光鸭网络不通时，不再误报「登录状态已失效」
更新镜像huanhq99/flixpilot:2.8.5
v2.8.4 修复 1
修复
- 修复去重中心开启 CD2 删除联动后，云盘文件已经不存在时（CloudDrive2 提示「中未找到该文件」）整项被判失败、STRM 和 Emby 条目一直清不掉的问题。现在会改走本地挂载路径：文件还在就删，确实已经不存在就算删除完成，并继续清理 STRM 与 Emby 条目；连不上 CloudDrive2 等其他错误仍然判失败。
v2.8.3 优化 2修复 2
优化
- 去重中心批量删除：删除结束后（以及进行中），弹窗里新增「失败 / 跳过原因汇总」，按原因归类计数并给出样例名称。之前页面只显示最近 8 条结果，几百个失败、跳过看不出是什么原因。
- 去重中心批量删除：后台生成删除计划时，每处理若干项就更新一次进度（「正在生成删除计划 N/总数」），不再一直停在 0。
修复
- 修复榜单媒体库里的副本会出现在去重中心的问题：榜单库里的副本和原作品指向同一个云盘文件，在去重中心勾选「删除云盘真实文件」删除副本，会把原作品的云盘文件一起删掉。现在去重扫描会跳过榜单媒体库目录，删除预检也会直接拦截榜单库里的条目。
- 修复去重扫描分页在过滤掉部分条目后可能提前结束的问题。
v2.8.2 新增 4优化 1修复 3
新增
- 榜单媒体库（设置 → 媒体运维 → 榜单虚拟库）：把流媒体和各平台榜单做成 Emby 里的独立媒体库，只收录你库里已有的作品，按榜单名次排序。Emby 原端口直接可见，不依赖反代，其他 302 工具照常可用。
- 榜单：Netflix、HBO、Apple TV+、Disney+、Crunchyroll、Amazon Prime、Amazon、Hulu（电影榜 / 剧集榜 / 混合榜，数据来自 TMDB，需先配置 TMDB Key）；热门（IMDb、TMDB 趋势、AniList、Bangumi）；豆瓣（含 Top250、一周口碑榜、北美票房榜等）；猫眼（电影榜、剧集榜）；腾讯视频（热播、电视剧、电影、动漫等）。
- 按 TMDB ID 匹配已入库作品，把原作品目录（所有版本的 STRM、NFO、媒体信息、字幕、图片）复制到「STRM 输出目录」（默认 /strm/榜单），再在 Emby 里为每个榜单建一个媒体库；榜单默认每 6 小时刷新，新建库或目录有变化时只刷新榜单自己的目录，不会触发 Emby 整库扫描。
- 关闭开关或取消勾选后，会删除对应的榜单媒体库和副本，不影响原媒体库。
优化
- 云盘中心任务页：挂载读取记录不再堆积。同一个文件反复读取失败时合并成一条并显示「已重试 N 次」；读取失败的记录保留 30 分钟后自动清掉。
修复
- 修复设置页检测 Emby 服务器名称时，不管填的是哪一台，返回的总是第一台服务器名称的问题。
- 修复海报横幅生成器导入字体后整页报错、一直停在错误界面的问题；字体文件名带空格、中文时也能正常加载，超过 30MB 会明确提示。
- 使用榜单媒体库前，请确认 FlixPilot 和 Emby 都能读到同一个目录（常见写法是两边都把 STRM 根目录挂成 /strm，输出目录留空即可）。榜单库里的是独立的副本条目，观看进度和原条目不互通；第一次刷新作品较多时需要一些时间，作品要等 Emby 扫描完成才会出现。
提示：
v2.8.1 优化 4修复 4
优化
- Emby 302：路径映射选了具体 115 账号时，直接走 115 主链路定位文件并取直链，不再先经过 CloudDrive2 校验；CloudDrive2 只在映射明确选择它、或未配置网盘账号时使用。
- 「自动推导路径映射」选了可用的 115 账号时，直接在 115 里搜索并比对路径，不再因 CloudDrive2 目录结构不同而报「CloudDrive2 中未找到该文件」；弹窗提示文案同步更新。
- 播放用户未识别时，日志首行直接写明原因（例如请求使用的是服务器 API Key、未携带用户 Token 或 UserId、缺少 PlaySessionId/DeviceId 等），便于判断是客户端还是配置问题。
- CloudDrive2 阶段失败时，日志保留 CloudDrive2 返回的原始错误，不再被统一显示成「115 直链解析失败」。
修复
- 修复 115 返回 HTTP 200 但响应为空或非 JSON（多见于账号限频、风控）时，日志只显示「115 服务返回 HTTP 200」、看不出原因的问题；现在会明确提示「多为账号被限频或风控，请稍后重试」。
- 115 目录读取、按文件名搜索、读取完整路径遇到上述空响应时，在同一次定位里等待片刻后重试一次，减少偶发的定位失败。
- 115 按文件名搜索时，关键词只取文件名中 [ 或 { 之前的部分（如去掉 [tmdbid=123456]），请求出错才改用完整文件名重试一次；结果仍按完整文件名精确比对，不会放宽匹配。用于规避搜索接口对带方括号、等号的关键词返回空响应的情况。
- 「自动推导路径映射」遇到 115 空响应时，不再误报「请检查服务器网络」，并同样重试一次。
提示：如果映射的网盘路径比 Emby 路径少一层目录（例如 Emby 有「媒体库」而 115 根目录下没有），请用「自动推导」重新生成映射；自动推导会按公共路径推出正确的前缀。
v2.7
v2.7.10 新增 3优化 5修复 3
新增
- Google Drive 支持「一键授权」：经官方授权中转登录，无需自建 OAuth 客户端（仍可使用自备客户端）。
- 手机底部导航改为 iOS 26 风格的液态玻璃标签栏：按下浮起成透明水滴并折射放大图标，拖动跟手、松手落位并跳转（折射仅 Chrome / Edge，Safari 与 iOS 桌面应用无边缘折射）。
- PWA：新增断网提示页，浏览器 / 状态栏主题色跟随当前主题，安装图标背景色与主题色统一。
优化
- 手机端适配液态 / 深色主题：加深卡片底色，修复文字对比度不足、标签与筛选按钮白底白字看不清。
- 登录页卡片改为更干净的白色卡片，logo 使用品牌原图。
- 电影 / 剧集详情页重做手机布局：全屏显示，海报居上、信息单列。
- 手机抽屉菜单末尾不再被底部导航挡住。
- 移动云盘、Google Drive 插件页，以及 Emby 302 页的「用户 115 账号」，改为统一账号卡。
修复
- 修复个人中心统计块、卡密续费卡在液态主题下几乎透明的问题。
- 修复切换页面时浏览器取消请求被误记成大片「Emby 502」错误日志的问题。
- 用户自助创建 Emby 账号时，若 Emby 已有同名账号，明确提示联系管理员绑定，不再显示笼统的「上游服务请求失败」。
提示：Google 一键授权需授权服务已配置 Google 凭据；应用通过 Google 验证前，仅测试用户可授权。
v2.7.9 新增 9优化 7修复 6
新增
- 云盘中心：文件浏览、上传下载、跨盘复制 / 移动、任务与挂载集中在一处。
- 统一云盘挂载「所有云盘 /」（默认 CloudPilot），支持持久上传队列、暂停 / 重试 / 取消，可视化选择目录。
- 文件页新增「新建 / 上传」菜单与顶部工具栏（复制、移动、下载、改名、删除）；浏览器可多文件上传，多选或文件夹可打包 ZIP 下载。
- 挂载点可单独设置名称、本地目录、UID / GID、权限，支持指定源目录、只读、单账号重挂 / 刷新。
- 115 Open、123 账号密码支持上传、秒传、文件管理与可写挂载，可作为跨盘目标。
- 追剧日历重构：日期条、全部 / 剧集 / 电影 / 番剧筛选，只保留国产、日韩及主流平台内容，并补充平台排期与上映电影。
- 个人中心分为「概览 / 账号绑定 / 通知 / 115 直连」。
- 用户列表支持批量发邮件，邮件主题与 HTML 正文可按通知事件自定义。
- 液态主题新增折射玻璃效果（仅 Chrome / Edge 可见弯折）。
优化
- 全站统一视觉：页头、统计块、标签页、卡片、侧边栏；首页、流媒体、推荐、求片、商城、账户、系统设置等页面重排，流媒体平台使用官方图标。
- 账户页移除「播放器跳转」入口。
- 部署示例改为简洁的目录映射写法，旧实例提供挂载路径迁移入口；挂载点拒绝重叠目录与非空目录。
- 115 / 123 / 光鸭插件页改为统一账号卡。
- 任务页按「全部 / 上传 / 下载」分类，默认只显示待处理与异常项。
- 上传与下载显示真实阶段进度，不再有虚假百分比。
- Emby 302 取流请求减少重复读取配置，拖动进度条更轻；网关与播放日志补齐多线路转发和失败定位。
修复
- 修复 115 掉线导致整个挂载不可用、115 Open 令牌失效不续期、被误判为 Cookie 账号等问题。
- 修复光鸭 / 123 跨盘移动的校验、空文件夹、秒传确认等多处误报，失败时保留源文件。
- 修复上传重复提交、挂载读到旧内容、写入失败后提交不完整内容等问题。
- 修复播放时丢失用户身份、个人策略未生效、CloudDrive2 直链缓存重复搜索等问题。
- 修复容器重建后自身断连的云盘挂载误报「file exists」、123 账号密码被错误限制为只读、115 手动转存未配置账号无提示、QQ 会话重连被记为错误等问题。
- 修复追剧日历中被乱填的词条，以及切换页面后滚动位置不回顶的问题。
v2.7.8
优化个别已知问题
增加批量发送邮件
v2.7.7 新增 3优化 15修复 9
新增
- 媒体信息扫描支持断点继续，中断或服务重启后保留已检查结果；旧版任务需重新检查一次。
- 已保存部分媒体信息的条目支持单项、批量手动联动删除，确认后清理对应网盘文件、STRM 并刷新 Emby，保留进度日志。
- 声道或采样率缺失时，自动扩大音频探测范围，并尝试解码短片段补充参数。
优化
- 批量补齐只更新当前条目的统计，并按批次保存进度，解决大型媒体库中批量操作明显卡顿的问题。
- 批量补齐在按钮附近显示当前条目、已处理、成功、跳过和失败数量，单项失败后继续处理其余条目。
- 一键删除失效 STRM 和批量联动删除改为后端任务，显示删除、跳过、失败和 Emby 扫描进度，支持中途停止。
- 检查结果顶部增加全局批量联动删除，可一次处理所有分页、剧集和电影中的提取异常媒体。
- 批量删除完成后按剧集或目录合并 Emby 刷新请求，避免同一资源被反复扫描。
- 媒体库逐页检查并保存结果，无需等待全部列表读取完毕；进度分别显示已读取和已检查数量。
- 大分页连续失败时，自动改为先读取条目 ID，再分批读取媒体信息，减轻列表请求负担。
- 继续扫描沿用原媒体库和设置，跳过已保存结果；列表顺序变化时重新核对，避免直接沿用失效位置。
- 媒体列表读取失败时保持原媒体库和分页位置重试，逐步缩小每页数量并延长等待时间；鉴权等明确错误直接提示。
- 列表加载显示已读取条数，失败时显示媒体库 ID、分页位置及错误类别，便于排查。
- 音频补探测仅使用当前文件对应音轨的数据，反馈探测进度，不猜测或套用其他集的参数。
- 对缺参数的音轨单独解码，读取实际声道和采样率；片头取不到时尝试中段，并明确显示未完成的音轨及语言。
- 普通探测未识别到整条视频或音频轨道时，按需扩大读取范围并读取媒体帧再次确认，避免云盘文件起始数据不足造成误判。
- 声道、采样率或分辨率仍缺失时，保存已取得的媒体信息并通知 Emby 刷新，保留缺项供后续补齐。
- 不因上述参数缺失判定视频损坏，不覆盖已有完整缓存。
修复
- 修复批量补齐每处理一项都重复遍历并保存整份扫描结果，以及部分失败被显示为整批失败的问题。
- 修复整部剧批量联动删除仍由浏览器逐项调用、只处理当前分页，导致单项可删除但批量无效的问题。
- 修复顶部“删除失效 STRM”把媒体提取失败混为网盘目标不存在，并在没有失效 STRM 时仍可点击的问题。
- 修复后续分页失败导致前面大量条目仍未检查的问题，并明确提示列表请求失败不代表视频损坏。
- 修复未完成扫描的结果容易被误认为全库结果，以及无效列表响应被当成扫描结束的问题。
- 修复读取媒体列表短暂失败就退出，以及所有错误均提示“检查连接”的问题。
- 修复缺少声道或采样率时，整份已提取的媒体信息被丢弃、任务直接失败的问题。
- 修复部分缓存重新检查时，缺失参数被固定显示为分辨率的问题。
- 修复部分缓存标签误写“缺分辨率”，以及缓存本身缺参数时仍提示等待导入的问题。
v2.7.6 新增 4优化 7修复 9
新增
- 媒体信息页面支持批量联动删除无法读取或无法提取时长的视频。
- 批量操作会逐项复核，并显示删除、跳过和失败进度。
- 媒体读取超时的条目支持手动联动删除，确认窗口明确提示超时不代表视频损坏，并展示删除进度。
- 分辨率缺失时自动扩大探测范围，仍未取得则尝试解码短片段读取实际宽高，并反馈提取进度。
优化
- 隐藏 Webhook 开始处理、处理成功和忽略非入库事件等重复日志，历史同类记录也不再展示，保留入库结果和异常。
- 为无法提取时长的条目提供手动联动删除入口，联动处理网盘文件、STRM 和 Emby 扫描。
- 网盘目标不存在时继续只删除失效 STRM，避免误删网盘文件。
- 仅缺分辨率时保存其他已提取的媒体参数，标记部分信息已保存，支持后续再次补齐。
- 分辨率补充按当前文件和轨道分别提取，不套用其他集的参数，也不覆盖原有完整缓存。
- 部分媒体信息已保存时，兜底截图失败不再阻止请求 Emby 刷新；实际导入结果仍以 Emby 检查为准。
- 补齐进度明确区分全部缺失任务与当前剧集条目数，单部资源任务显示名称，日志及停止按钮同步标注任务范围。
修复
- 修复打开系统日志时遇到 warning 或未知日志级别导致白屏的问题，警告日志正常显示并纳入异常筛选。
- 修复部分无法提取时长的媒体没有显示联动删除入口的问题。
- 修复播放访问地址将无协议名称误当有效地址的问题；无效旧值按留空处理，API Token 保持原值。
- 联动删除提示明确区分 FlixPilot 插件开关与 CloudDrive2 API Token 权限。
- 修复缺少分辨率时整份媒体参数不保存、编码标签显示异常的问题；仅缺分辨率不视为坏视频。
- 修复批量联动删除遇到扫描状态短暂变化时部分条目被误报失败的问题，增加逐条重试。
- 修复指定 115 账号后被 CloudDrive2 快速路由抢先接管的问题，优先使用所选账号生成或缓存的 115 直链。
- 修复首次播放缺少用户信息时无法关联账号的问题，提前从登录及 PlaybackInfo 响应关联身份，并区分未识别用户与未绑定账号。
- 直链日志明确标记等待客户端确认播放，返回 302 不再作为客户端已播放的确认。
v2.7.5 优化 4修复 4
优化
- 优化播放器后续媒体请求的用户识别，兼容丢失 Emby Token 或 UserId 的 302 请求。
- 媒体信息补齐在 ffprobe 缺少时长时自动完整读取媒体计算，日志显示处理进度。
- 完整读取仍失败时改用音视频包时间戳计算时长，兼容缺少容器索引的挂载媒体。
- 媒体信息扫描默认单项超时调整为 300 秒，避免云挂载媒体完整读取被 60 秒提前取消。
修复
- 修复 Emby 302 日志显示“未识别用户”并导致个人 115 账号播放失败的问题。
- 修复部分 CD2 挂载 MKV 因容器缺少时长而无法补齐媒体信息的问题。
- 优化无法打开的视频提示，明确指向文件损坏或索引异常，避免误导为路径或 API 配置问题。
- 新增无法打开视频的 CD2 联动删除：确认后删除网盘文件、STRM 并请求 Emby 扫描对应剧集。
v2.7.4 优化 2
优化
- 系统运行日志过滤媒体信息插件的普通轮询和提交成功请求，保留真正失败请求及插件任务日志。
- 自动补齐的详细设置、队列和日志集中到弹窗，减少页面高度，适配手机显示。
插件新增：媒体信息扫描
1.检查结果支持全库一键删除失效 STRM，删除前逐项自查并统计删除、跳过数量。
2.详情弹窗增加按当前剧集批量删除失效 STRM，逐项复核并保留删除备份。
3.失效 STRM 支持核对路径后移除并保留备份，自动请求 Emby 扫描对应剧集，扫描请求失败可重试。
4.新增媒体信息插件，支持按媒体库检查缺失、全量提取音视频参数，并生成媒体信息缓存，可选缺图时自动补图。
查看文档https://wiki.flixpilot.top/guide/%E5%AA%92%E4%BD%93%E4%BF%A1%E6%81%AF%E6%89%AB%E6%8F%8F
v2.7.3 新增 2优化 1修复 1
新增
- 电影和剧集详情页显示 TMDB ID，支持一键复制并保留 TMDB 详情链接。
- 字幕翻译支持选择智能体中配置的 Whisper/转写 API 生成无字幕视频的原文。
优化
- 移除 AI 字幕翻译插件及其入口，避免暴露未使用的字幕处理功能。
修复
- 修复部分 AI 翻译模型返回空响应时任务无法继续处理的问题。
v2.7.2 新增 3优化 3修复 2
新增
- 插件中心新增 123 网盘助手，支持多账号配置、状态校验、目录管理与直链能力。
- 新增 CloudDrive2 连接配置，可校验访问权限并联动 115、123 网盘直链与去重删除。
- 用户管理新增 Excel 批量导入，支持统一创建和同步面板、Emby 用户资料。
优化
- Emby 302 完善多服务器路由、路径推导、回源处理和播放日志，提升不同客户端的兼容性。
- 系统日志调整字体渲染、时间展示和详情布局，减少无效提示并提升可读性。
- Docker 部署移除 Redis 依赖，业务数据统一由 SQLite 持久化，简化单镜像部署。
修复
- 修复求片批准错误依赖 MoviePilot 即时资源搜索结果的问题；现在直接向 MoviePilot 创建订阅，由 MoviePilot 按订阅规则持续搜索和下载。
- 修复部分 Emby 302 播放场景识别错误媒体源、回源结果记录不准确及日志时间异常的问题。
v2.7.1 新增 2优化 3修复 2
新增
- 批量删除插件新增可配置任务线程数，扫描和删除共用同一线程设置，支持 1-32 个线程。
- 插件中心卡片按统一图标、标题和描述布局展示，优化多插件浏览体验。
优化
- 批量删除扫描和删除均采用受控并发，提升大量文件处理速度。
- 批量删除任务继续保留进度、失败计数、取消和逐文件日志记录。
- 插件卡片调整为紧凑的五列布局，减少无效留白并改善卡片间距。
修复
- 修复批量删除任务删除阶段只能逐个处理文件的问题。
- 修复插件卡片内容垂直布局不自然、上下间距拥挤的问题。
v2.6
v2.6.20 新增 1优化 10修复 6
新增
- 新增 Excel 用户同步，按 Emby 用户 ID 精确匹配并自动绑定已有 Emby 账号，同步爆米花、会员到期时间、Telegram 绑定和禁用状态，保留用户原 Emby 密码登录。
优化
- 优化系统日志降噪，Emby 横版背景图缺失不再刷屏。
- 保留 Emby 海报缺失和真实上游异常日志，便于继续排查关键问题。
- 优化批量删除目录选择器，从容器根目录完整展示文件夹树，映射目录可逐级展开。
- 优化 Emby 批量导入用户弹窗，改为分页渲染，避免几千个用户同时加载导致页面卡死。
- 操作结果提示统一固定在右下角，不再随页面滚动或被内容区域裁切。
- Emby 权限管理将主屏幕媒体库排序前置，打开弹窗即可直接调整。
- 优化 Emby 302 播放参数识别，兼容 `UserId`、`MediaSourceId`、`PlaySessionId` 的大小写、下划线和短横线写法。
- 优化 Emby 302 播放日志，区分“已返回直链”和“客户端播放成功”，并记录客户端及直链 UA 策略。
- 优化 Excel 用户同步流程，选择文件后先预览新增、更新、Emby 不存在和用户名冲突数量，并分页核对用户名、爆米花、会员时间及 Telegram 状态后再确认同步。
- 移除耗时且不稳定的“关于系统”版本检测与网页更新功能，镜像更新统一由 Docker 或 Compose 管理工具执行。
修复
- 修复最近播放、正在播放等卡片请求 Backdrop 缺图时产生无意义 404 日志的问题。
- 修复批量删除遗漏群晖 Compose 映射目录及进入子目录后无法返回上一级的问题。
- 修复 API 降权运行导致群晖挂载目录无法读取或删除的问题。
- 修复 TG 转存成功提示被旧警告覆盖、必须滚动页面才能看到的问题。
- 修复 Emby 用户设置返回成功但主屏幕媒体库顺序未真正生效的问题，保存后会回读 Emby 配置并校验结果。
- 修复 HILLS、Infuse 等播放器跟随 302 时丢失或更换 User-Agent，导致主账号 115 直链验签失败、日志显示已返回直链但客户端无法播放的问题；其他播放器继续沿用原 UA。
v2.6.19 新增 4优化 8修复 8
新增
- 新增管理员直接授予会员或白名单时，立即创建并绑定同名同密码 Emby 账号。
- Emby 302 新增用户个人 115 账号摘要，展示面板账号、Emby 账号、会员、到期时间和存储空间。
- Emby 302 新增个人 115 资料刷新，可重新获取头像、会员状态、到期时间和容量。
- 管理员可在 Emby 302 用户账号列表中直接浏览并修改个人 115 秒传目录。
优化
- 优化 115 直链请求兼容性，对齐 OpenList 下链参数格式。
- 优化同名同 SHA1 文件的候选匹配和缓存，减少重复搜索并加快再次起播。
- 优化 Emby 302 播放日志，直接展示失败原因、命中网盘、路径映射和路由账号。
- 优化 Emby 用户名识别，单用户查询失败时自动从完整用户列表反查。
- 用户注册密码仅以主密钥加密保存待创建凭据，Emby 绑定成功后立即清除。
- 优化个人 115 账号卡片，增加真实头像、容量进度、账号 ID 和资料更新时间。
- 优化 Emby 302 整体界面，统一网关、账号、播放策略和路径映射的布局与移动端体验。
- 默认播放策略改为分段选择，路径映射增加清晰的启停状态和紧凑操作区。
修复
- 修复明确选择 115 的路径映射被目录名称误判为 123 网盘的问题。
- 修复 123 路由失败被错误记录成 115 服务异常，以及失败原因过于模糊的问题。
- 修复手机端 Emby 用户列表操作列不可见，无法进入权限配置的问题。
- 修复部分剧集因首个 115 pickcode 不可用而无法 302 播放的问题。
- 修复 115 下链失败后直接回源 Emby，导致起播慢和占用服务器上行的问题。
- 修复个人 115 未选择秒传目录时秒传失败的问题，新旧账号均默认使用根目录。
- 修复旧个人 115 账号资料长期显示未知，以及嵌套容量字段识别不完整的问题。
- 修复用户绑定个人 115 后未自动切换秒传直连，以及解绑后未恢复默认策略的问题。
v2.6.18 新增 3优化 2修复 2
新增
- 新增工单管理员站内通知，点击通知可直接进入工单处理台。
- 新增各外部通知渠道独立的工单通知开关与工单通知模板。
- 新增 Emby“显示合集入口”独立开关，可与媒体库访问权限分别设置。
优化
- 优化工单列表排版、长标题显示和列表操作体验。
- 优化 Emby 媒体库权限勾选状态展示，取消选择后即时生效。
修复
- 修复提交工单后管理员无法收到通知的问题。
- 修复部分 Emby 版本保存自定义媒体库权限时 ID 不兼容、导致全部分类被取消的问题。
v2.6.17 修复 1
修复
- 修复 Emby 自定义媒体库权限使用子目录 ID 时，面板无法同步实际已授权媒体库、全部显示未勾选的问题。
v2.6.16 优化 3
优化
- 优化缺集补充时，moviepilot种子内容显示不完全
- 优化缺集补充时，tg转存资源不显示
- 优化Emby用户权限，允许访问所有媒体库没有展开勾选
v2.6.15 新增 4优化 4修复 4
新增
- Telegram 机器人新增管理员控制台，支持通过按钮或命令生成会员卡、邀请码和快速创建 FlixPilot/Emby 账号。
- Telegram 通知配置新增机器人管理员 ID 白名单，支持配置多个管理员；正数管理员 Chat ID 可直接作为主管理员。
- 123 网盘、CloudDrive2 与 Emby 302 增加独立配置和联动能力，支持 115/123 路线区分、路径映射及资源转存目录。
- Telegram 管理员生成邀请码后同步返回可点击的注册链接，打开后自动填写邀请码。
优化
- 注册链接自动使用 Telegram Webhook 配置中的面板公网域名，适配 VPS 反向代理部署。
- 机器人发卡、邀请和开号复用面板现有业务接口，操作结果与面板数据保持一致，并记录执行管理员的 Telegram ID。
- Emby 302 播放日志补充失败原因和完整路线信息，支持按管理员配置决定直链失败后是否回源服务器上行。
- 123 网盘 TG 链接识别和资源订阅支持使用独立转存目录，CloudDrive2 配置统一放入插件中心。
修复
- 修复机器人生成邀请后只能复制邀请码、无法直接分享注册入口的问题。
- 修复 123/115 路径替换、CloudDrive2 实际路径推导和跨容器挂载路径不一致时无法生成直链的问题。
- 修复 Emby 302 播放失败提示不完整、路线显示不全及部分配置保存后无法正确返回插件页的问题。
- 修复 Telegram 通知群组 ID 可能与管理员身份混淆的问题；负数群组 ID 不会获得机器人管理权限，敏感结果仅在私聊返回。
v2.6.14
*FlixPilot v2.6.14 更新说明**
*新增**
Telegram 机器人新增管理员控制台，支持通过按钮或命令生成会员卡、邀请码和快速创建 FlixPilot/Emby 账号。
Telegram 通知配置新增机器人管理员 ID 白名单，支持配置多个管理员；正数管理员 Chat ID 可直接作为主管理员。
123 网盘、CloudDrive2 与 Emby 302 增加独立配置和联动能力，支持 115/123 路线区分、路径映射及资源转存目录。
*优化**
机器人发卡、邀请和开号复用面板现有业务接口，操作结果与面板数据保持一致，并记录执行管理员的 Telegram ID。
Emby 302 播放日志补充失败原因和完整路线信息，支持按管理员配置决定直链失败后是否回源服务器上行。
123 网盘 TG 链接识别和资源订阅支持使用独立转存目录，CloudDrive2 配置统一放入插件中心。
*修复**
修复 123/115 路径替换、CloudDrive2 实际路径推导和跨容器挂载路径不一致时无法生成直链的问题。
修复 Emby 302 播放失败提示不完整、路线显示不全及部分配置保存后无法正确返回插件页的问题。
修复 Telegram 通知群组 ID 可能与管理员身份混淆的问题；负数群组 ID 不会获得机器人管理权限，敏感结果仅在私聊返回。
v2.6.13 修复 2
修复
- 修复同一剧集因 Emby 媒体记录不同而被拆成多条入库通知的问题，微信、QQ、Telegram 与飞书会合并连续入库集数后统一推送。
- 修复 Emby 持续发送入库 Webhook 时不断重置合并计时、导致通知长期不发送的问题。
v2.6.12 修复 1
修复
- 修复 STRM 入库通知将指针文件类型误显示为视频规格的问题，优先展示实际分辨率和编码，无法探测时隐藏规格行。
v2.6.10 新增 3优化 5修复 11
新增
- Emby 302 自动推导支持从 Emby 近期媒体自动选取真实路径，并兼容 CD2 本地挂载路径。
- Emby 302 支持按用户策略记录播放会话、实际路线和直链打开结果。
- Emby 302 新增 CloudDrive2 API 地址、Token、连接测试和热重载配置。
优化
- Emby 302 每条路径映射可独立选择 115 账号，自动推导与播放会使用并保存所选账号。
- Emby 播放日志改为结果导向展示，补充播放用户、媒体源、路线、账号、缓存和耗时信息。
- Emby 302 路径映射精简为 Emby 路径和 115 账号网盘路径，自动推导前会通过 CloudDrive2 校验文件。
- CloudDrive2 Token 默认脱敏，管理员可通过显隐按钮查看完整配置。
- 通知模板测试会向全部已启用渠道发送完整样例，并为媒体与求片场景附带竖版海报及逐渠道结果。
修复
- 修复 QQ、企业微信和飞书入库通知不显示海报的问题，现在会按渠道上传并发送 Emby 海报。
- 修复 QQ、企业微信和飞书通知直接显示 HTML 链接标签的问题，分别转换为可点击 URL 或 Markdown 链接。
- 修复企业微信海报与正文分开发送的问题，改为单条图文消息，并隐藏正文中的长 URL。
- 修复求片通知只向 Telegram 传递海报的问题，QQ 和企业微信会复用海报地址下载图片；企业微信求片通知不再被审核按钮阻断。
- 修复 Telegram 海报与通知内容分开的问题，海报、正文和操作按钮会合并为单条媒体消息，正文链接不再显示长 URL。
- 修复 QQ 通知正文显示长 URL 的问题，保留链接名称但不再展开原始地址。
- 修复 Emby 302 多媒体源下路径选择、用户识别和失败后回源记录不准确的问题。
- 修复 CD2 static 编码路径和带查询参数 STRM 直链无法识别或播放的问题。
- 修复 CD2 绑定账号后仍通过 CD2 下载地址播放的问题，现在会按文件名和 SHA1 匹配所选 115 账号并生成 115 直链，无法匹配时再回退 CD2。
- 修复个人播放模式未配置个人 115 Cookie 时直接失败的问题，现在会回退全局默认策略，并在用户管理中显示实际生效模式。
- 修复批量修改面板权限可能误将管理员降级的问题，管理员角色会自动受保护，当前登录管理员也无法自降级。
v2.6.9 新增 3优化 2修复 4
新增
- QQ、企业微信和飞书补齐 TG 的排行榜、全部下载、资源搜索、115 转存/离线、管理员交互。
- MoviePilot、TG 频道和 PanSou 搜索结果支持通过文本序号、下载码或转存码继续操作，兼容不展示按钮的客户端。
- QQ、企业微信和飞书支持独立绑定、解绑对应渠道账号。
优化
- 四个通知渠道统一复用后端会话逻辑，菜单文字、命令别名、分页和帮助提示保持一致。
- 求片与资源选择按渠道和用户隔离，并保留 15 分钟操作窗口，避免群聊或不同用户之间串选。
修复
- 修复求片结果发送数字序号后被当作自由对话的问题。
- 修复求片序号越界、结果过期时缺少明确提示的问题。
- 修复 115 分享转存读取错误资源缓存，导致转存操作无法继续的问题。
- 修复资源搜索缓存未初始化时无法保存结果的问题。
v2.6.8 新增 2优化 4修复 2
新增
- 普通用户可在账号页扫码绑定或更新个人 115，并自行选择秒传目录。
- TG、QQ、企业微信和飞书的服务器状态支持展示管理员开放的 Emby 线路、备注、地址和延迟。
优化
- 首页“最近在看”向普通用户展示媒体动态，全服视图不显示其他用户的用户名、账号、IP 和设备信息。
- 用户可见线路统一测量延迟，隐藏线路和 Emby 后台地址不向普通用户或 Bot 泄漏。
- 115 负载均衡账号仅保留 302 秒传目录，不再显示或保存转存、求片和离线目录。
- Telegram 离线任务只发送一条最终结果，不再发送处理中提示或附带菜单。
修复
- 修复个人 115 扫码确认后保存失败时无法直接重试的问题，Cookie 仅保存到当前登录用户且不回传浏览器。
- 修复 115 SHA1 秒传将目标目录 CID 误当成子目录名，导致文件进入数字目录的问题。
v2.6.7
*FlixPilot v2.6.7 更新说明**
*新增**
媒体服务器支持配置独立的用户可见线路，可设置地址、备注和展示开关，并在账号页及 TG、QQ、企业微信、飞书的服务器状态中显示延迟；隐藏线路和后台地址不公开。
Emby 媒体去重支持电影和剧集多版本识别、保留建议、白名单、删除预检及批量清理，可同步处理云盘文件、STRM 和 Emby 条目。
QQ、企业微信和飞书机器人补齐与 TG 一致的账号绑定、菜单、求片审核、资源操作、签到、抽奖和管理交互，并支持按钮/卡片通知。
TG 收到 115 分享链接时支持先选择已配置的转存目录，确认后执行转存。
PWA/Web Push 支持手机桌面业务通知，可按用户订阅求片、追更入库、会员到期、聊天、公告和全站入库等通知，并支持测试与重新同步。
115 助手支持主号、负载均衡池和个人 115 账号，分别用于源盘定位、路径推导、自动转存、均衡直链和个人秒传。
普通用户可在账号页扫码绑定或更新个人 115，并自行选择秒传/转存目录。
Emby 302 支持源盘直连、负载均衡、个人秒传和服务器上行四种播放策略，可配置全局默认策略并在用户列表设置独立策略；非 302 反代继续使用服务器上行。
Emby 302 新增直链网关、路径映射和自动推导能力，支持按服务器绑定、从完整 STRM 路径推导映射，以及失败后回源 Emby。
Emby 302 网关支持禁用 WEB 页面，同时保留客户端 API 和 302 播放能力。
资源订阅聚合搜索支持按 TMDB ID 解析中文名、原始片名和年份，并统一检索 TG 频道、PanSou 和聚影来源。
侧边栏和顶栏新增 PRO 动效标识；Agent 对话页支持通过 `@名称` 快速选择协作 Agent。
*优化**
首页“最近在看”向普通用户开放，全服动态仅展示媒体内容和时间，不返回或显示其他用户的用户名、账号、IP 与设备信息；“个人”视图仍可筛选自己的记录。
系统日志统一使用面板业务名称，记录面板操作的开始、完成、状态、耗时和错误原因；接口路径仅保留在详情中。
Emby 播放日志统一展示用户、源文件名、播放路线、账号、文件大小、打开耗时、缓存/CDN 和回源结果。
播放耗时改为统计从收到媒体请求到客户端确认开始播放的时间，不再使用观看时长代替启动耗时；失败原因直接使用中文业务文案展示。
播放记录地区解析增加备用数据源、失败缓存快速刷新和历史误判修正，无法解析时显示待解析状态。
115 账号页面改为账号列表，Cookie、状态、转存/离线目录和求片自动转存收进配置弹窗；负载账号支持按 Emby 用户粘性分配并设置活跃用户上限。
负载账号支持独立配置秒传文件夹，未配置时自动使用根目录 `/最近接收`；路径映射和自动推导统一使用主号，负载池同步 115 助手配置。
Emby 302 网关与媒体服务器配置解耦，可独立填写 IP/主机名、原始端口、反代端口和 API Key；自动推导结果弹窗展示 Emby 前缀、网盘前缀及共同路径。
Emby 302 播放日志采用结果导向展示，直接区分“302 成功”“302 失败后回源”和“服务器上行”，并显示所属服务器和实际路线。
首页工具条、侧栏和管理员编辑入口重新对齐；普通用户首页保持只读布局。
登录页默认使用影院剧照背景；插件中心改用本地官方 Logo 和更清晰的卡片布局；资源订阅结果卡片改为中性灰样式。
PanSou 搜索超时由 8 秒调整为 20 秒，聚合搜索的慢响应不再轻易被截断。
*修复**
修复 Emby 302 在多服务器及 VidHub 等客户端中识别错用户、只显示 UserId 或选错媒体源的问题；现在按当前网关和 API Key 查询，并兼容 Token、`apiKey`、`userId`，显示真实用户名、Emby 源文件名、实际 115 账号及完整路线。
修复负载均衡解析失败被误记为“服务器上行成功”的问题；现在明确记录失败阶段、账号和中文原因，并区分失败后回源与服务器上行。
修复空用户识别结果被缓存的问题；播放前会检查当前服务器的全部媒体路径，个人秒传可立即重试，回源日志会记录识别结果和候选路径。
修复 Emby 302 把 STRM 展示路径当作真实文件路径的问题；现在通过 `PlaybackInfo` 和 `MediaSourceId` 获取 CD2 实际媒体路径，再进行 115 映射和直链定位。
修复跨 115 账号播放复用源盘 Pickcode、处理大文件二次校验及非完整加密块失败的问题；改用 Cookie 上传协议完成秒传，失败时回源 Emby。
修复 115 文件逐层定位失败时无法找到文件的问题，增加同名搜索和完整路径精确比对，并修复仅多一层挂载根目录时的路径匹配。
修复 115 手动转存只显示目录 ID、无法确认保存位置的问题；日志和 TG 回执现在显示最终目录名称及 CID。
修复 CD2/115 去重删除只通知 Emby、未删除网盘文件的问题；现在按 Emby 实际媒体路径定位并依次删除网盘源文件、STRM、Emby 重复版本，最后刷新媒体库。
修复 CD2 删除时将真实 `/CloudNAS/CloudDrive/115` 文件误判为不存在的问题，并兼容 `/CloudNAS/CloudDrive/strm` 与容器 `/strm` 路径。
修复剧集去重默认仅比较完全相同体积、漏掉不同体积版本的问题；同时修复重复组显示 `undefined`。
修复 STRM 缺失媒体大小时显示“未知大小”的问题，扫描会解析指向并补齐可访问真实文件的大小。
修复旧版多账号配置迁移、主号切换或删除后职责混用的问题，始终保持唯一主号并避免源盘账号与下载账号混用。
修复普通用户首页请求管理员 Emby 用户列表、自动测量或布局迁移触发布局保存并产生 403 的问题；首页编辑和全局布局保存现在仅限管理员。
修复 Emby 未安装或无权访问 Playback Reporting 插件时播放历史持续返回 502 的问题，自动降级到本地播放历史并抑制重复失败请求。
修复 Emby 302 API Key 保存后显示空白、未保存映射时仍测试并返回模糊 502 的问题，改为显示加密保存状态并提示先生成/保存映射。
修复手动反代端口被覆盖、网关误读媒体服务器上游，以及 Emby 地址带 `/emby` 时重复拼接路径导致接口 404/500 的问题。
修复“秒传直连”测试结果与真实播放结果混淆的问题；源盘测试不再误报 302 成功，播放失败会显示明确中文原因。
修复 PanSou 搜索必失败的问题，`cloud_types` 按上游要求改为数组；同时修复资源搜索被错误记录为转存的问题。
修复 Emby 302 自动推导无法区分 115 登录失效与服务器网络失败的问题，改为显示明确原因。
修复 115 二维码获取/加载失败后持续转圈、扫码成功后状态延迟恢复，以及账号卡片显示内部流程文案的问题；失败可重试，登录后立即同步并后台静默刷新。
修复 115 API 连接失败未触发备用 DNS 的问题；所有 115 域名连接失败都会尝试备用 DNS，并缩短错误 IP 的首次等待。
修复接口失败日志只显示状态码或暴露内部请求 URL 的问题，常见 HTTP 错误、网络超时、连接失败和文件不存在均显示中文原因。
修复播放日志停留在独立内存队列、系统日志看不到播放结果的问题，成功和失败结果现在立即落盘。
修复系统日志经前端代理后只记录代理地址的问题；后台保留真实 IPv4/IPv6 审计信息，日志界面不显示 IP，并修复部分播放 IP 无地区的问题。
v2.6.6
*FlixPilot v2.6.6 更新说明**
*新增**
Telegram 通知渠道新增群组 ID 配置，可按消息类型把通知推送到指定群组。
Telegram 群/频道推送类型支持独立勾选，求片处理、媒体入库、追更订阅等类型可分别路由。
*优化**
Telegram 通知配置区拆分管理员 Chat ID、群组 ID、频道 ID，并精简群组/频道配置提示。
Telegram 求片通知带海报发送，群组/频道里更容易识别片名。
飞书、QQ、企业微信等 Webhook 成功回调不再刷系统运行日志，仅保留失败与异常日志。
Telegram 测试连通性优先验证群组或频道目标，便于确认 Bot 是否已加入并具备发消息权限。
*修复**
修复 Telegram 配置了频道 ID 后，普通管理员通知也可能被路由到频道的问题；未勾选群/频道推送类型时默认回到管理员 Chat ID。
v2.6.5
*FlixPilot v2.6.5 更新说明**
*新增**
网页端抽奖管理：管理员在「运营中心 → 抽奖管理」创建、编辑、删除抽奖，支持立即开奖和定时自动开奖。
抽奖可推送到 Telegram 群/频道：创建时勾选自动推送，或在列表手动推送，群成员点消息按钮参与（推送目标取通知渠道中配置的群/频道）。
邀请配置入口迁移到「我的邀请」页，仅管理员可见，系统设置中的邀请标签页同步移除。
知识库管理并入知识库页：管理员点「发布 / 管理文章」页内切换管理模式，旧 /knowledge-manage 地址自动跳转。
*优化**
求片页顶部统计带改为白卡可点筛选，选中态与下方筛选标签打通；求片卡片信息行对齐，只保留中文名和年份。
商城、抽奖、我的邀请、工单、知识库五个互动页面统一白卡设计语言，补齐加载骨架和失败重试入口。
用户管理页降噪：统计卡与筛选器合并，角色与会员状态合并为一列（淡彩小标签），Emby 账号和求片额度改纯文本，仅过期/即将到期上色。
发现片库海报网格加密，桌面 7 列增至 9 列。
知识库页重构：品牌渐变 Hero 内嵌搜索、分类横滑标签、文章卡片网格、精选文章强调卡。
卡密管理、客户端管控、观看排行三页统一新设计语言；观看排行海报改为白底品牌蓝风格（导出比例不变）。
登录页玻璃卡更通透，卡内文字适配暗色背景。
追剧日历加载提速：TMDB 抓取改为并发，缓存未命中时从 25 秒超时降至约 11 秒；macOS 下自动使用系统代理。
开户文案模板入口统一到「用户管理 - 邀请码」，移除邀请设置中的重复配置区域。
缓存 Emby 用户列表，减少设置标签来回切换时的重复请求。
*修复**
修复邀请排行榜显示已删除账号原始 ID（无用户名头像）的问题。
修复知识库分类接口返回格式错误，导致分类名称显示空白的问题。
修复本地开发环境 TMDB 直连不可达时，追剧日历长时间停留在骨架屏的问题。
修复切换到用户设置时，Emby 模板用户下拉框短暂空白的问题。
修复普通文本误触发求片搜索以及部分渠道收到消息后无回复的问题。
修复通知范围在编辑弹窗确认后未立即保存，导致关闭「媒体入库」后仍收到通知的问题。
v2.6.4
*FlixPilot v2.6.4 更新说明**
*新增**
飞书通知渠道支持"测试连通性"：有应用凭证时真实校验并可发测试消息，纯接收配置显示就绪状态与回调地址。
*优化**
全站页面统一全宽布局（求片、商城、监控中心、商城管理、用户活跃、播放排行等 20+ 页面）。
系统设置全部标签页视觉统一：卡片化分区、语义图标、字段栅格排列、主开关样式统一。
推荐页：轮播图改原图清晰度、内容突出度增强、移除顶部标题卡。
通知渠道编辑弹窗简化：按钮改"确认"，只有页面右上角一个保存入口；飞书接收入口地址保存后常显不丢失。
系统运行日志窗口增加强制刷新，日志接口禁用缓存，避免旧告警误显示为新问题。
自动通过的求片改为后台执行订阅策略，提交后立即返回，不再因 TG 或 MoviePilot 超时卡在“提交中”。
*修复**
修复会员状态同步在同一 Emby 用户绑定多个面板账号时每分钟反复禁用/启用的问题：改为聚合判定，任一绑定账号会员有效即保持启用。
会员状态变更通知现在带上用户名。
修复通知渠道编辑弹窗"保存并生效"与全局保存并存导致的困惑。
修复 QQ 官方机器人通知只校验凭证但不主动分发的问题，并增强私聊/群消息 OpenID 自动记录。
修复 QQ 官方机器人 C2C 私聊/群聊订阅位错误导致收不到消息的问题；只有收到 QQ `READY` 后才显示消息接收已上线。
修复飞书事件回调只记录不处理的问题，现已支持 Verification Token 验签、文本消息解析和被动回复。
修复 Telegram Bot 已启用 Webhook 时本地消息接收仍反复轮询并刷 409 告警的问题。
修复 Telegram Webhook 成功处理后重复写入通用通知 Webhook 日志的问题。
修复 TMDB 官方 Base URL 缺少 `/3` 时片库发现接口返回 404 的问题。
修复 TG 找到 115 候选后转存请求缺少分享文件 ID、实际无法转存的问题，并支持依次尝试多个 115 候选。
修复订阅源全部失败时日志只显示最后一个 MoviePilot 错误、掩盖 TG 转存失败原因的问题。
v2.6.3
*FlixPilot v2.6.3 更新说明**
*新增**
登录页全新视觉：影院剧照背景（TMDB 热门/高分电影无字剧照，随机呈现）、磨砂透明登录卡、3D 模型 Logo（鼠标可拖拽旋转），与原有"电影海报"模版并存，可在 系统设置 → 网站 → 登录页自定义 中切换。
登录页媒体统计展示真实数据：修复公开统计接口（原始终返回 0），电影/剧集数量、在线状态、在播人数均为真实值。
媒体服务器设置页视觉改版：统一卡片语言、KPI 瓷贴统计、编号步骤引导。
*优化**
手动"立即同步"改为后台异步执行，同步状态自动刷新，不再受请求超时影响。
全站操作提示统一为浅色卡片样式（左侧色条区分成功/失败/警告/信息）。
登录页细节：公告改走马灯滚动、自动填充底色适配透明设计、提交按钮不再因浏览器自动填充而灰置、Emby 服名识别恢复（修复接口字段不匹配）。
入库通知 Webhook 区块简化为一键复制完整地址。
优化账号页解除绑定按钮和确认弹窗。
优化 Telegram 本地消息接收提示和系统日志，避免直接暴露 Polling 等技术词。
*修复**
修复手动同步媒体库索引在部署环境约 10 秒被强制取消（context canceled）的问题。
修复手机端首页欢迎卡、天气卡等内容空白的问题（容器查询尺寸容器在非确定高度下不绘制，移动端卡片改固定高度）。
修复媒体服务器页不显示 Emby 服名的问题。
修复 API Token 显示为固定短掩码、无法查看完整值的问题。
修复监控中心点开用户资料全部显示为管理员的问题。
修复用户列表出现“外面显示未绑定，点进去又显示已绑定”的问题。
修复编辑用户解除 Emby 绑定不生效的问题。
修复导入 Emby 用户选择保留原 Emby 密码后无法使用 Emby 密码登录的问题。
修复日历详情仍显示“已入库”状态的问题，改为优先展示平台信息。
v2.6.2
*FlixPilot v2.6.2 更新说明**
*新增**
无
*优化**
首页性能优化：天气动画与最近入库跑马灯在滚出屏幕后自动暂停，页面滚动更流畅、不再掉帧。
系统开启"减弱动态效果"时，首页动画真正关闭（此前适配未生效），跑马灯退化为手动横滑。
媒体库索引同步更健壮：单页请求超时从 20 秒放宽到 120 秒，单页失败自动重试 3 次，整轮上限放宽到 30 分钟，远程/慢速 Emby 也能稳定完成同步。
Telegram Polling 启动不再写入系统日志，减少噪音（失败类日志保留）。
*修复**
修复媒体库索引同步在慢速远程 Emby 下单页超时被掐断、导致整轮同步失败的问题。
修复媒体库索引同步整轮超过 10 分钟被强制取消的问题。
v2.6.1
*FlixPilot v2.6.1 更新说明**
*新增**
媒体库总览卡片常驻显示"本月新增"（电影/剧集/总集数）。
*优化**
天气组件改版：全幅动态天空（晴/多云/阴/雨/雪/雾/昼夜变化），定位改为浏览器优先、失败自动回退服务器位置，移除手动城市设置。
最近在看改版：剧照行背景、用户头像、正在播脉冲标记与实时进度条，点击条目直接续播。
最近入库改版：边缘渐隐、海报常驻标题与类型标签、3 天内入库显示 NEW 徽章。
入库统计改堆叠柱状图，每天剧集与电影构成一目了然。
播放器排行与设备分布改为整行比例填充条。
首页各卡片标题栏图标统一移除，版面更干净。
月度入库统计改走本地媒体库索引，大媒体库秒级出数。
v2.5
v2.5.10
*FlixPilot v2.5.10 更新说明**
*优化**
首页欢迎卡、媒体库总览、播放器排行与设备分布卡片视觉改版：总览改为一排四列大数字瓷贴，排行改为整行比例填充条。
影视详情、聊天、TG 同步、AI 控制台、用户管理等大型页面拆分重构，加载更快、结构更清晰。
配置与用户数据增加内存缓存，显著降低每次请求的开销。
系统日志改为批量落盘，高并发下写入开销明显降低。
全局搜索增加请求取消与批量补拉，搜索响应更快。
全站交互规范收敛：统一确认对话框（移除全部浏览器原生确认框）、统一头像预设、统一设计色板。
高频轮询接口统一接入页面可见性判断，后台标签页自动降频。
*修复**
修复退出登录后首页仍继续请求媒体库统计，导致系统日志被大量 401 警告刷屏的问题。
修复 Telegram 机器人在服务重启后不响应 /start 等命令的问题：启动时自动恢复消息接收，测试通知成功时也会自动开启。
修复 Telegram 机器人回复发送失败时无任何日志记录的问题。
修复播放页媒体信息、分辨率与音轨字幕显示不正确的问题。
修复管理页面缺少前端权限守卫，普通用户可直接打开管理界面的问题。
修复注册与卡密兑换缺少频率限制，可被批量滥用的问题。
修复聊天附件可上传任意文件类型的安全隐患。
修复部分接口可能泄露 Emby 服务器内网地址与密钥信息的问题。
修复公开 Webhook 端点缺少令牌校验、事件记录无上限的问题。
修复企业微信通知渠道，支持回调验签与加密消息推送。
v2.5.9 优化 2修复 2
优化
- 天气组件重新启用后，定位不可用时自动回退到后端默认天气。
- 天气失败状态增加刷新入口，手机端可直接重试。
修复
- 修复手机端首页组件快速删改后，完成编辑可能保存到旧组件列表的问题。
- 修复天气组件一次加载失败会清空最后有效天气缓存的问题。
v2.5.8 优化 6修复 6
优化
- 优化手机端首页卡片高度和间距，首屏信息更完整。
- 增强手机端底部导航安全区预留，减少内容被遮挡。
- Docker 部署改为统一 `huanhq99/flixpilot` 应用镜像，前端、API 与 Emby 网关随同一容器启动。
- 优化 Emby 媒体库自动同步策略，已有成功索引后优先使用增量同步，减少深分页请求。
- 自动同步失败后增加冷却期，避免 Emby 不稳定时反复重试造成持续高负载。
- 备份恢复弹窗增加实际上传进度、分片数量和后端恢复阶段提示。
修复
- 修复未激活插件授权时侧边栏仍显示 PRO 标识的问题。
- 修复首页组件编辑完成后可能只写入本地缓存、后端保存不及时的问题。
- 修复首页组件开关配置字段与实际组件不一致，导致部分组件开关保存后丢失的问题。
- 修复超大 Emby 媒体库首次自动索引默认被 50000 条保护上限拦截的问题。
- 修复大型备份文件被 200MB/220MB 恢复上限拦截的问题。
- 修复首页最近入库中同一剧集多版本重复展示的问题。
v2.5.7 新增 1优化 4修复 9
新增
- 增加前端、API 和 Redis 三容器独立健康检查。
优化
- 简化 Docker Compose 网络，容器统一通过服务名通信。
- API 仅保留容器内 `8080`，不再占用宿主机 API 端口。
- Redis 默认使用 Docker 命名卷保存 AOF 数据。
- API 启动时自动处理 NAS 数据目录权限。
修复
- 修复部分群晖和飞牛环境中前端无法访问 API，导致首次初始化向导不跳转的问题。
- 修复 Redis 因宿主机绑定目录权限不足而反复重启的问题。
- 修复宿主机 `8080` 被占用时部署端口容易配置错误的问题。
- 修复 Go 版站内群聊发送、未读和已读状态异常的问题。
- 修复 Web Push 缺少 VAPID 密钥时开启通知报错的问题。
- 修复测试通知只记录订阅但不实际发送 Web Push 的问题。
- 修复站内聊天新消息不会触发手机推送的问题。
- 修复私聊列表只显示“私聊”而不显示对方用户名的问题。
- 修复管理员无法从左侧会话列表删除聊天会话的问题。
v2.5.6 新增 1优化 3修复 8
新增
- 备份支持按系统配置、用户权限、业务数据、插件集成、日志任务、运行资产分类导出。
优化
- 优化备份目录选择弹窗，增加面包屑、搜索、映射目录快捷入口和移动端适配。
- 优化备份设置输入框对齐和目录选择状态展示。
- Docker 默认部署恢复为前端、API、Redis 三容器模式，并显式声明容器网络和 API 上游。
修复
- 修复 Telegram 将普通文本链接误判为未知命令的问题，支持直接识别 115 分享链接并转存。
- 修复 Emby 入库 Webhook 成功日志显示调试字段的问题，改为显示入库电影或剧集名称。
- 修复 Telegram 直接发送 115 分享链接时默认转存到第一个目录映射的问题，未指定目录时保存到根目录。
- 修复 NAS/飞牛/群晖旧数据卷权限导致 API 容器启动时报 SQLite 只读的问题。
- 修复部分 NAS 容器网络别名异常导致前端反代 API 返回 502、初始化引导无法完成的问题。
- 修复前端健康检查依赖后端 `/api/ready`，导致 NAS 环境下 API 重建或慢启动时前端被误判 unhealthy 的问题。
- 修复部署模板缺少显式网络配置时，部分 NAS 环境前端解析 API 容器不稳定的问题。
- 修复群晖环境前端容器直连 API 容器 IP 超时导致初始化接口 502 的问题。
v2.5.5 优化 4
优化
- 同步用户头像失败
- 追剧日历长时间空白加载。
- 追剧日历异常api获取失败
- 优化，面板反代网关网页无法登录账号
v2.5.4 新增 1优化 2修复 3
新增
- 头像同步支持将站内头像推送到 Emby 账号。
优化
- 头像上传入口改为可点击、可拖拽区域，提升移动端和严格浏览器兼容性。
- 头像同步结果改为更新、跳过、失败统计，失败明细更清晰。
修复
- 修复同步头像只回填本站头像、未实际推送到 Emby 的问题。
- 修复旧版头像文件目录读取导致头像 404 的兼容问题。
- 修复同步头像提示出现 success/undefined 统计的问题。
v2.5.3 优化 1修复 1
优化
- 管理员头像预设弹窗改为原生文件选择触发，兼容更严格的浏览器点击限制。
修复
- 修复“新增预设”按钮点击无反应，导致管理员无法上传新头像的问题。
v2.5.2 新增 1优化 3修复 1
新增
- 管理员可在头像选择器中新增或删除全站预设头像。
优化
- 注册、快速开户等新用户创建入口统一从当前预设头像池随机分配。
- 删除预设只影响后续选择和随机分配，不影响已使用该头像的用户。
- 预设头像管理弹窗适配手机窄屏布局。
修复
- 修复新用户头像随机来源写死，管理员新增头像无法进入随机池的问题。
v2.5.1 新增 1优化 2修复 2
新增
- 卡密管理新增可配置的复制模板，支持变量、实时预览和批量复制。
优化
- 快速开户和卡密复制内容可按场景自定义，Emby 主备地址会自动补全端口。
- 播放记录时间解析兼容无时区数据，减少时间显示偏差。
修复
- 修复快速开户只创建面板用户、未同步创建 Emby 用户的问题。
- 快速开户现会同步设置 Emby 密码、应用权限与首页模板，失败时自动回滚半成品账号。
v2.4
v2.4.10 新增 1优化 10
新增
- 115 插件新增“求片自动转存”配置，可为电影和电视剧分别指定默认 115 转存目录。
优化
- 115 插件将转存目录、离线目录、电影默认目录和电视剧默认目录集中到同一配置页，配置关系更清楚。
- 求片策略配置仅保留实际接入的 MoviePilot 与 TG 频道，不再显示未接入来源。
- 电视剧求片支持多季选择，并按季分别提交到 MoviePilot，避免多季只提交一季。
- 首页播放器数量较少时优化卡片排布，避免大片空白和布局显得松散。
- 移动端首页补齐组件展示和响应式布局，减少手机上组件消失或错位的问题。
- 首页缓存改为先显示旧数据并后台静默刷新，避免入库状态或 Emby 配置变化后被会话缓存卡住。
- 流媒体和趋势页面在重新获得焦点时会刷新入库状态，减少旧状态残留。
- 通知模板可用变量改为弹窗查看，避免变量表长期占用页面底部空间。
- 通知模板变量弹窗支持拖动，查看长变量表时可挪开预览区域对照编辑。
- 快速开户选择“跟随全局模板”时，会显示实际使用的模板账号及其管理员、禁用状态。
v2.4.9 新增 4优化 11修复 12
新增
- 备份恢复包含运行时密钥时，登录页会提示需要重启服务后重新登录。
- 求片功能新增可见范围配置，管理员可选择“全服可见”或“仅本人可见”；默认保持全服可见，管理员始终可以查看全部求片。
- 求片管理新增管理员专用“策略”入口，可在求片页配置手动审核、自动通过和订阅源优先级。
- 求片订阅源支持 MoviePilot 与 TG 频道两级策略；MoviePilot 未处理时可继续搜索 TG 候选资源。
优化
- 通知模板可用变量改为弹窗查看，避免变量表长期占用页面底部空间。
- 通知模板变量弹窗支持拖动，查看长变量表时可挪开预览区域对照编辑。
- 通知模板变量说明与语法说明集中到弹窗内，保留点击变量芯片一键插入正文的操作。
- 首页天气增加失败退避和旧缓存兜底，外部天气服务异常时不再反复请求。
- 媒体库容量统计降低 Emby 查询分页大小，并增加缓存复用和失败退避。
- 恢复备份后旧页面产生的未登录轮询不再刷屏系统运行日志。
- 快速开户选择“跟随全局模板”时，会显示实际使用的模板账号及其管理员、禁用状态，开户结果也会展示最终使用的模板账号。
- 快速开户和邀请信息补充服务器名称、Emby 主地址及备用地址；启用 Emby 网关时优先使用网关公开地址，并支持在开户文案中正确替换相关变量。
- 求片页顶部统计与筛选工具条重新整理，降低视觉噪音，并将策略配置从系统设置移到求片页。
- 电视剧求片支持多季选择，并按季分别提交到 MoviePilot，避免多季只提交一季。
- 求片策略配置仅保留实际接入的 MoviePilot 与 TG 频道，不再显示未接入来源。
修复
- 修复魂师觉醒的先天魂力和武魂被写死，导致 `/awaken` 总是显示固定武魂的问题。
- 修复魂师玩法未启用时仍可通过 TG 指令或接口觉醒、结算、猎魂和 PK 的问题。
- 修复魂师修炼结算未按播放记录计算，`/syncsoul` 始终只结算 1 项固定收益的问题。
- 修复完整备份恢复后旧登录态继续轮询，导致系统日志大量 HTTP 401 的问题。
- 修复普通用户页面仍请求管理员任务接口，导致 `/api/admin/tasks` 401/403 的问题。
- 修复 Emby 用户头像缺失时 `/api/avatar/proxy` 返回 404，导致头像破图和日志噪音的问题。
- 修复 Emby LibraryStats 超时或失败时首页容量统计直接返回 502 的问题。
- 修复“仅本人可见”模式可能通过列表、详情、投票或待处理数量接口获取其他用户求片信息的问题。
- 修复快速开户选择全局模板后不显示实际模板账号，以及开户结果误报“未配置模板”的问题。
- 修复快速开户和邀请结果缺少 Emby 地址，导致复制的开户文案无法提供正确服务器地址的问题。
- 修复求片自动通过或管理员批准后只关注 MoviePilot 结果，未按订阅源策略继续处理 TG 候选的问题。
- 修复求片范围选择弹窗中季号与“第 N 季”重复展示的问题。
v2.4.8 优化 10修复 10
优化
- 聚影配置页已保存的 API Key 和签到密码刷新后显示为掩码，避免误判为配置丢失。
- 聚影密钥输入框支持直接覆盖掩码，避免把掩码字符误保存成新密钥。
- 115 扫码登录应用改为官方客户端列表，移除不准确的安卓平板选项。
- 115 助手账号信息展示改为更稳定的容量、VIP 到期和 Cookie 状态文案。
- 通知渠道编辑弹窗保存后会立即同步到系统设置，减少二次保存造成的误解。
- 侧边栏收起后的展开按钮位置调整到导航区内，避免跑到页面内容区。
- 数据备份设置页去掉冗余路径和执行状态提示，页面更简洁。
- 媒体库同步页移除不准确的电影/电视剧分类统计，避免和实际媒体库数量对不上。
- 备份记录刷新按钮增加加载、错误和空记录提示，减少点击后没反应的误解。
- 账号头像弹窗移除随机生成页签，只保留预设头像和本地上传。
修复
- 补充聚影插件配置回归测试，确保保存、掩码保留和点击眼睛查看已保存密钥都能正常工作。
- 修复 115 扫码登录生成二维码时使用错误客户端，导致登录设备识别不符合选择的问题。
- 修复旧备份导入后 Telegram 绑定无法被 Bot 识别，导致 `/start` 显示未绑定的问题。
- 修复 Telegram `/unbind` 缺失和旧绑定解绑审核请求 ID 可能丢失的问题。
- 修复 Telegram 直接发送 magnet、ed2k 或 torrent 链接时未触发 115 离线任务的问题。
- 修复 115 离线任务目录读取不完整，导致离线下载没有使用已配置离线目录的问题。
- 修复通知渠道在弹窗内开关后需要关闭再打开、再到外层保存才生效的问题。
- 修复新注册用户可能继续分配旧版头像或已删除预设头像的问题。
- 修复账号页随机生成头像可能绕过预设列表，抽到已删除头像的问题。
- 修复 IP 归属地接口返回空地区，导致播放历史和在线监控只显示 IP 不显示地区的问题。