更新记录 (Changelog)

后台媒体运维、AI 任务拆分与内容过滤统一。管理员现在可以直接检查单部影片的资料、来源和任务状态；语义文本与向量改为独立生成，避免向量重试反复调用 AI Gateway；原有版权、分类和敏感内容规则也合并到一处管理。

✨ 新增 (Added)

• Media 运维工具：数据管理页支持按豆瓣 ID 或标题查找媒体，查看资料完整度、语义文本、向量、外部 ID、来源快照和最近任务，并可手动重新抓取豆瓣/TMDB资料或重新生成语义文本与向量；未输入关键词时不查询或展示默认列表。
• 统一内容过滤：新增内容过滤页面，同一关键词可以分别设置禁止采集、版权限制和敏感内容；禁止采集只影响新抓取资源，版权限制保持标题匹配，敏感内容不会进入热搜且会在观看记录中模糊封面。

🛠️ 变更/优化 (Changed/Improved)

• 语义文本与向量分阶段生成：AI Gateway 只负责生成和保存语义文本，向量任务只处理已有语义文本但向量为空的媒体。语义资料变化时先保留旧向量继续服务，新文本保存后再原子清空旧向量并创建向量任务，减少重复模型调用和失败重试成本。
• 无效豆瓣 ID 持久化：只有电影、电视剧和综艺详情端点全部返回 404 时才记录为不存在，后续自动任务会跳过该 ID；管理员仍可手动重新验证。请求时优先使用已有媒体类型提示，减少无效端点探测。
• 敏感内容覆盖完整观看记录：标题、规范分类及资源站分类和标签都会参与判断，首页和分页加载的观看记录使用相同的封面模糊规则；规则修改后立即清除热搜缓存。
• 数据库迁移 0067：自动创建统一的 content_filters 表及关键词约束和唯一索引；旧过滤表继续保留，已有规则的数据合并由部署时一次性执行。

🐞 修复 (Fixed)

• 豆瓣任务重复排队：修正豆瓣 ID 校验为 6 至 9 位数字，并让资源同步跳过无效 ID，避免异常条目反复进入后台队列。
• 向量任务入队失败：修复 PostgreSQL 构造 JSON 任务载荷时无法推断参数类型的问题，并补充数据库写入错误处理。
• 无效豆瓣内容展示：已确认不存在的豆瓣条目不再显示豆瓣链接、评分和短评，也不会继续自动刷新相关资料。

播放架构重构与实时解析升级。核心播放逻辑从持久化候选改为实时解析模式，数据库层面精简冗余表与字段，新增媒体展示规则统一层，播放器与播放页体验优化，同时修复多个播放与数据库相关问题。

♻️ 重构 (Refactored)

• 播放架构重构：持久化改为实时解析：删除旧的 resource_episode_candidates 和 playback_attempt_events 表，改为实时从播放源解析候选集，减少数据冗余与同步延迟；新增 playurl 包统一处理播放地址解析与过滤，新增 mediaview 包实现规范媒体数据优先的统一展示规则。
• 数据库迁移 0064 / 0065：将存量播放数据迁移到 playback_results 表，清理历史冗余记录，新增 vod_items 播放清洗标记字段，优化约束与索引结构。
• 模板复用优化：移除重复的 play 页面模板，播放和观看页统一复用 watch 模板，减少维护成本与代码冗余。

✨ 新增 (Added)

• playbackreconcile 工具命令：新增数据协调工具，支持在线检查、资源同步、媒体单元合并与历史数据处理，适配多阶段迁移与故障恢复。

🛠️ 变更/优化 (Changed/Improved)

• 播放器资源升级：更新 Service Worker 缓存版本至 v15，升级 player.js 至 v5.0、CSS 至 v4.3.5，替换页面广告脚本为 Trafficstars，调整播放容器空状态支持自定义提示。
• 业务模块优化：调整调度任务批量大小，移除旧的质量刷新任务，重构播放统计、目录刷新、历史记录等模块的查询与更新逻辑，提升性能与可靠性。
• 顶部线路面板完善：优化 watch 页顶部线路选择面板的显示/隐藏逻辑，增强空值检查，提升交互稳定性。

🐞 修复 (Fixed)

• 指定资源不可用时播放器显示：修复当访问 /watch/:douban_id?source_key=...&vod_id=... 时，如果指定的资源组合无法找到，播放器就不会渲染的问题。现在会自动回退至该集数的第一个可用播放源，确保用户总能看到播放器。
• 电影特性变体迁移优化：优化迁移脚本锁超时与查询性能，添加唯一约束幂等操作，适配已手工创建约束的生产环境，合并更新步骤以提升迁移稳定性与速度。

📚 文档与测试

• 架构文档更新：详细说明新的播放与资料统一规则，补充迁移阶段说明与故障恢复指南。
• 测试更新：同步更新所有相关测试用例与导入顺序，修正媒体类型归一化规则验证。

播放页线路切换重做。电影不再把清晰度当成分集排在选集区，各家叫法不一的版本统一收进线路列表；播放器上方新增可直接下拉的线路面板，不用再滚到页面下方去换源。

✨ 新增 (Added)

• 播放器上方直接换线路：点信息条上的「当前线路」就地下拉出这一集的全部来源，点面板以外的地方自动收起；手机上「当前线路」独占一行，来源列表改为单列。页面下方原有的线路区块保留不变。

🛠️ 变更/优化 (Changed/Improved)

• 电影不再按清晰度分集：720P、HD中字、TC国语这些各家命名不一的版本此前被当作「分集」排在选集区，切换全靠猜。现在它们统一收进线路列表，每条线路标出自己的版本，同一线路下的多个版本也都保留。电影因此不再显示选集网格和上一集/下一集。
• 线路列表排版：改为等宽三列（手机一列），来源名过长时省略，加载秒数和稳定度靠右对齐。
• 稳定度标签更统一：统一为两个字（稳定 / 一般 / 较差 / 未测）并移到每条线路的最右端，去掉与它重复的彩色圆点。

🐞 修复 (Fixed)

• 综艺被当成电影：豆瓣资料按电影、电视剧、综艺依次探测，综艺常被标成电影，导致整季被并成一集。现在还要求分集名本身确实是清晰度或语言版本才会合并，按期数、日期编号的综艺不再受影响，已经合并错的记录也一并清理。
• 换源丢失版本：同一条线路下的多个清晰度此前会互相覆盖、只剩最后一个，现在全部保留并且都能点到；带旧版本名的收藏和站内链接也能正常打开。

片单关联推荐与月报统计修正。片单新增继续探索的入口，完善发布要求与搜索引擎信息；月报明确按片单记录生成，修正连续天数和类型标签的判断，片场也能展示本周更新过的观影记录。

✨ 新增 (Added)

• 相关片单推荐：后台可为每个片单按顺序选择最多三个相关片单，并填写推荐说明；详情页新增「继续看片单」入口，关联片单下架或变空后会自动隐藏。

🛠️ 变更/优化 (Changed/Improved)

• 片单发布要求更完整：发布前需填写导语及每部影片的推荐理由，草稿仍可逐步补全；后台补充选片标准提示，相关片单不允许重复选择或关联自身。
• 片单导航与搜索信息：详情页新增面包屑导航、影片列表及面包屑结构化数据；列表分页使用各自的规范地址，后续页增加返回片单首页的入口，无效或超出范围的页码返回 404。
• 月报改为「本月观影侧写」：明确按片单记录创建日期归入月份，仅统计当前标记为看过的作品，不再从录入时间推断深夜观影习惯；记录较少或类型资料不足时暂不判断偏好，类型标签增加数量门槛，并将最高评分作品的描述改为客观表述。

🐞 修复 (Fixed)

• 月报连续记录天数：改为统计当月最长连续记录天数，修复此前只从月末向前计算的问题；片单日期同步显示创建日期，类型统计去除空格和重复类型，并固定同次数类型的排序。
• 片场本周影片及时更新：按公开观影记录的更新时间筛选和排序，较早创建、但本周更新评分或短评的在看与看过记录也能进入列表。

社区化：关注关系、动态流、短评永久链接与片单。这一版把原本散落在各个影片页的短评和评分连成可回访的内容——你可以关注口味相近的片友并在一处看到他们在看什么，每条短评有了自己的地址，同时新增按主题整理的片单作为新的入口。

✨ 新增 (Added)

• 关注与关注动态：可以关注口味相近的片友，侧边栏新增「关注动态」展示他们最近标记想看和看过的影片及短评。片场的片友推荐、用户公开主页和短评页都带有关注按钮；还没关注任何人时，动态页会直接推荐可关注的片友。
• 被关注会收到消息：消息中心新增关注类型通知，点开可直接进入对方主页。取消关注会一并撤回通知，反复关注同一个人也不会重复提醒。
• 短评永久链接：每条短评有了独立地址 /review/:id，可以单独分享和收藏，页面包含影片信息、评分、点赞与回复。影片详情页短评上的日期就是入口。
• 片单：新增 /list 与 /list/:slug，按主题整理影片并为每一部写一句推荐语。后台可新建、编辑、发布和删除片单；未发布的片单只有管理员能预览，已发布的片单会进入站点地图。
• ads.txt：新增符合 IAB 标准的 /ads.txt 广告授权卖家清单。

🛠️ 变更/优化 (Changed/Improved)

• 注册时默认公开观影主页：注册表单新增开关并默认勾选。此前主页默认不公开，新用户写的短评无法进入片场的精选短评和片友推荐，社区内容始终是空的。仍可随时在设置里关闭。
• 消息中心可容纳更多互动类型：通知的数据结构放宽，新增一种通知不再需要改动数据库结构，未读计数也会自动覆盖新类型。
• 广告跳过的边界恢复更稳健：优化跳过位置的处理逻辑，新增播放事件监听以清理缓冲恢复定时器，避免重复触发。

🐞 修复 (Fixed)

• 图片代理兼容旧版浏览器：同源校验新增 Referer 作为备选，兼容不支持 Sec-Fetch-* 请求头的浏览器；移除前端冗余的 referrerpolicy，统一由代理控制；盗链拦截的占位图改为竖版海报比例。
• 反馈内容不再被截断：反馈与回复内容保留换行并自动换行，移除原有的高度截断和省略号；后台反馈表格单元格改为顶部对齐。
• 后台表格在手机上可横向滚动：片单管理表格补上滚动容器，此前窄屏下状态和操作列会被直接裁掉，够不到编辑和删除。

💅 界面优化 (UI)

• 片单封面自适应：列表页卡片的封面条按实际影片数量均分并锁定比例，不足四部时不再在右侧留白，同一行卡片的标题也不会高低不齐。
• 后台新建表单默认收起：片单管理页的新建表单改为可展开卡片，片单列表不再被挤出首屏（手机上尤其明显）；点击编辑或保存失败时会自动展开。
• 表单提示区分成功与失败：保存失败改用红色提示，不再和成功提示同色；片单地址增加浏览器端格式校验，避免提交被拒后丢失已经填好的内容。
• 顶部加载进度条：默认隐藏，仅在 HTMX 请求进行时展示；调整移动端头部操作区域的元素间距。

播放稳定性、互动消息、剧集导航与资料刷新维护。统一升级 HLS 播放内核，补齐短评互动通知与长剧集切换体验，收敛重复的播放进度，并简化影片资料与向量的更新链路。

✨ 新功能 (Features)

• 新增互动消息中心：短评被点赞或回复后会通知原作者，侧边栏和手机顶栏显示聚合未读数；消息页支持查看原短评、全部已读和单条硬删除，同一短评的多个点赞聚合为一条消息。
• 新增手动上下集导航：播放页在播出日程与选集区域之间显示上一集、当前播放和下一集，三栏等宽；超过 30 集时选集列表自动收起，只保留首尾及当前集附近内容，也可随时展开全部。

🛠️ 修复 (Fixed)

• HLS 跨分片播放更稳定：/play、/watch、独立播放器、IPTV 和嵌入播放器统一升级到 hls.js 1.7.1，改善跨 EXT-X-GAP 时的停顿与音频管线恢复。
• 清理重复播放进度：同一用户、同一影片写入新进度后自动清理较旧的有效记录，继续观看列表统一按影片合并，避免同一内容重复出现。
• 修正资料刷新覆盖：豆瓣主资料刷新时正确保留已有剧照和短评，并使用详情接口返回的真实影视类型，不再默认按电影处理。
• 修复设置开关安全令牌错误：公开主页和自动跳过片头片尾开关改为触发标准表单提交事件，确保 CSRF 安全令牌正常注入，不再返回“安全令牌无效”。

🚀 性能优化 (Performance)

• 向量只在语义资料变化时重算：标题、简介、类型和主创等语义字段变化后直接排入向量任务，历史补全只处理从未生成向量的影片，减少重复 AI 调用。
• 放宽 AI 请求时间：目录 AI 默认超时从 90 秒调整为 120 秒，降低语义描述在模型响应较慢时过早回退的概率。

🔎 搜索与收录 (SEO)

• 站点地图改为分片索引：/sitemap.xml 现在按固定页面、影片详情和相似推荐生成 sitemap index，每片最多 5000 条，不再只收录最近更新的少量影片。
• 完善结构化数据与页面路径：详情页按电影或剧集输出 Movie/TVSeries 与 BreadcrumbList，相似页输出安全序列化的 ItemList 与面包屑，并为主要静态页面补充 canonical。
• 收紧低价值页面索引范围：搜索结果、播放页、资料抓取等待页、版权提示、404、空相似页和个性化推荐页统一使用 noindex, follow，将抓取资源集中到规范详情页。
• 相似推荐结果更准确：电影和剧集不再混排，同一系列最多保留一个其他季度；推荐理由改为基于共同类型、导演和演员的克制描述。

💅 界面优化 (UI)

• 详情页与相似页导航整理：详情页新增可见面包屑和「查看全部」普通链接；相似页改为更紧凑的响应式纵向列表，保留豆瓣评分、推荐理由和普通详情链接，并移除大面积卡片效果与页面内联样式。
• 手机播放页减少广告占高：四个横幅广告在手机端改为两行两列，保持全部可见，不再纵向占据大量页面空间。
• 后台窄屏布局改善：标题与菜单分为两行，标签栏支持横向滚动，表格保持内容自然宽度，避免窄屏下挤压变形。
• 播放入口整理：更新 IPTV 默认频道源，并隐藏侧边栏的 TVBox 配置入口；TVBox 页面与 API 仍保持可用。
• 消息界面与导航状态完善：恢复消息页标题、空状态和列表样式；进入消息页时只高亮消息入口，不再与用户中心同时处于选中状态。

🎬 片场 (Cinema)

• 本周放映单纳入「在看」：除了已看过的公开记录，正在观看的影片也会进入本周影片统计，更及时反映片友动态。

观看记录同步精简与性能优化。移除冗余的同步事件账本，简化观看记录的删除与同步链路，同时优化相似影片查询性能和前端加载体验。

🚀 性能优化 (Performance)

• 相似影片查询提速：详情页「喜欢这部剧集的人也喜欢」接口不再拉取向量文本和评论等大字段，仅查询卡片展示所需的轻量列，减少数据传输量。

🛠️ 修复 (Fixed)

• 修复观看记录删除后重新出现：删除接口返回 200 但刷新后记录仍在，原因是删除路径重新解析了媒体单元 ID 导致插入新行而非删除原行，现改为直接按记录 ID 硬删除。
• 修复 HTMX 加载动画不显示：播放记录和相似影片区域的加载 loading 因 CSS 选择器层级不匹配而无法触发，已修正选择器。

🧹 精简 (Simplified)

• 移除同步事件账本：删除 history_sync_events 表及全部相关代码，客户端每次打开页面直接从数据库获取最新进度，不再维护增量同步版本链。
• 观看记录改为硬删除：删除记录时直接从数据库移除行，不再保留软删除标记，减少冗余数据。
• 缩短任务记录保留期：后台任务的完成和失败记录从 30/90 天缩短为 3 天，减少数据库存储。

M3U8 广告指纹众包跳过。新增基于 M3U8 结构分析的广告检测与众包跳过系统，同时完善向量生成链路和过载保护页面。

✨ 新功能 (Features)

• 智能跳过广告：前端解析 M3U8 播放列表的分片结构，通过 DISCONTINUITY 标记、加密方式变化、路径差异和时长特征识别疑似广告片段，为每个候选生成 SHA-256 指纹。已达到众包共识（≥5 票确认、确认率 ≥80%）的广告在 HLS 加载时直接注入 EXT-X-GAP 跳过，未确认的以浮层提示用户「是广告，跳过 / 不是」，投票结果全局共享。功能仅对主动开启的登录用户生效，所有异常失败开放，不影响正常播放。
• 播放设置页：用户设置新增「播放设置」分区，提供智能跳过广告的全局开关，设置保存到用户表、全端同步。播放页和观看页的操作栏同步显示开关，支持 HTMX 即时切换。
• 向量补全后台调度：新增 ScheduleEmbeddingBackfills，由调度器每轮自动选取元数据完整但尚未生成向量的影片入队（优先级 -10），替代原来详情页访问时的即时入队逻辑；向量任务现在严格等待 TMDB 合并完成后才触发，避免半成品元数据生成低质量向量。

🛠️ 修复 (Fixed)

• 修复播放简介 HTML 泄漏：资源站返回的影片简介可能包含 HTML 标签，播放页现在会剥离所有标签并反转义实体，避免页面显示原始 HTML 或注入风险。
• hls.js 版本锁定：将 hls.js 从 @latest 锁定到 @1.5.18，避免不可控的版本升级引入播放兼容问题。

💅 界面优化 (UI)

• 过载保护页面重设计：高并发触发 503 时不再返回纯文本，改为展示完整的品牌页面（带加载动画和刷新重试按钮），HTMX 局部请求则返回简洁的嵌入式提示卡片。
• 播放页操作栏自适应：操作栏改为 flex-wrap 布局，按钮在窄屏下自动换行而不溢出。

🧹 精简 (Simplified)

• 移除详情页即时向量入队：详情页不再在访问时检查向量是否缺失并排即时任务，改由后台调度统一补全，减少热路径的数据库查询和并发争用。

页面加载速度专项优化。聚焦影片详情页和播放页的首屏速度，把非关键数据全部改为页面渲染后异步加载，同时修复搜索空结果被长时间缓存的问题。

🚀 性能优化 (Performance)

• 影片详情页延迟加载：初始渲染只保留电影元数据（标题、海报、简介、评分），播放按钮、想看/看过状态、社交统计、在线资源、系列季度导航、播出日程和相似推荐全部改为 htmx 异步加载，首屏从 9 次串行查询降至 1 次。
• 播放页启动提速：播放器初始化所需的播放地址保持同步获取，用户看过状态和播出日程改为页面渲染后异步填充，不再阻塞播放器启动；版权检查提前到候选解析之前，命中时直接跳转不做后续昂贵查询；影片标题查找延迟到错误路径才执行，正常播放不再多一次数据库查询。

✨ 新功能 (Features)

• NSFW 海报模糊：新增后台 NSFW 关键词管理，首页「继续观看」区域自动模糊匹配关键词的海报，点击可解除模糊。
• 统一播放跳转：全站播放按钮统一判断逻辑，自动选择直连播放或选集页面；今日更新页新增资源未同步提示。
• 任务调度优先级：Worker 任务支持优先级配置，推荐刷新与热门快照设为最高优先级；已完成采集的影片不再重复触发刷新。

🛠️ 修复 (Fixed)

• 修复搜索空结果缓存：搜索结果为空时不再写入缓存，避免实际有数据的影片在缓存有效期内（3 小时）持续显示「未找到相关资源」。修复涉及首次搜索和后台异步刷新两条路径。

💅 界面优化 (UI)

• 数据抓取等待页重设计：首次访问未收录影片时，页面自动每 3 秒轮询数据状态，就绪后无感知跳转到详情页，不再需要手动刷新；30 秒超时后显示重试和搜索入口。
• 想看/看过按钮选中态优化：收紧按钮内间距，修复选中状态下「已想看」「已看过」三字文字撑出按钮边界的问题。
• 全站主题配色统一：亮色与暗色模式统一采用更柔和的品牌红 #cc5656，同步调整背景、文字、边框和状态色；暗色背景由接近纯黑改为带暖调的深灰，减少大面积黑色带来的压迫感。
• 实心按钮颜色优化：主操作按钮改用更明亮的 #c24b4f，悬停状态使用 #b64047，在贴近品牌色的同时保持白色文字清晰可读。
• 静态内容页排版统一：重新整理关于本站、广告合作、隐私政策、服务协议、DMCA、更新记录和 TVBox 配置指南的正文宽度、标题层级、章节间距、链接、列表与图片样式；修复步骤列表显示为圆点和更新记录暗色文字对比度不足的问题。

🧹 精简 (Simplified)

• 移除详情页相似推荐缓存：详情页不再维护独立的相似影片缓存和 singleflight，改为复用推荐模块已有的 htmx 接口，减少重复代码和内存占用。

4.0 上线后的首个稳定性更新。这一版集中处理真实运行中暴露出的任务堆积、资源关联、跨设备进度和搜索性能问题，同时移除切流完成后不再需要的代码与数据结构，让系统更轻、更稳。

🚀 性能与稳定性 (Performance & Stability)

• 「为你推荐」改为快照读取：页面不再现场执行多轮向量查询；首次访问先展示已有热门榜，快照缺失或过期时由 Worker 去重刷新，过期结果可继续使用，避免高峰期集中重算。
• 热门发现统一快照读取：「热门好片」不再因条数不足现场回源补齐，「本站热播」改由 Worker 定时生成快照，页面请求不再实时扫描播放事件；快照过期时自动降级展示旧数据，避免页面空白。
• 搜索结果更清楚：豆瓣规范资料与播放资源合并为同一组卡片，有资源时显示已匹配数量和「立即播放」；未确认影视归属的资源保留地区、类型、演员、速度和更新状态。
• 搜索缓存即时返回：搜索结果缓存过期时先返回旧结果、后台异步刷新，重复搜索不再等待资源站响应；热搜榜刷新时自动预热榜上关键词的搜索缓存，用户点击热搜词可直接命中。
• 资料刷新更克制：豆瓣主资料、短评、TMDB 剧照、语义向量在数据已完整时一律跳过，不再重复采集；资料完整的影片退出定时轮转，不完整的每天重试；详情页自动任务增加冷却时间，迁移影片的刷新日期分批错峰，避免访问流量反复制造相同任务。
• Worker 任务优先级分级：推荐和热门快照最高优先级（10），豆瓣主资料和画质刷新中等优先级（5），短评、剧照、向量等锦上添花任务保持默认，避免批量任务堆积时饿死用户可感知的刷新。
• 热门与热播快照改为每日刷新：热门好片和本站热播快照从频繁间隔改为每天刷新一次，快照有效期 48 小时，减少无谓的重复计算。
• Worker 限流不再误伤任务：上游限流拥有独立计数，不再消耗普通失败的重试预算；队列增加终态任务冷却索引，降低上游异常时的重复请求压力。
• 搜索热路径提速：为片名模糊搜索、豆瓣资源匹配和播放质量查询补齐索引，数据增长后仍能保持稳定响应。
• 后台刷新有界执行：短评、剧照等机会型刷新统一受并发数和超时保护，繁忙时优先保障正在访问页面的用户。

🛠️ 修复 (Fixed)

• 修复「有资源却打不开」：补齐并持续维护播放候选与影片的关联，避免 /watch 找不到已存在的资源后跳回搜索页。
• 修复跨设备进度冲突：同步以设备上报的实际活动时间判断新旧操作，幂等重试不再产生无效版本空洞，离线设备的旧进度不会覆盖较新的观看记录。
• 修复向量资料重复生成：影片读取现在会正确带回已保存的向量，避免重复调用 AI 与向量服务。
• 完善 IMDb / TMDB 补全链路：IMDb 映射拆为批量查询与兜底查询两阶段，已查无结果的影片不会一直阻塞后续任务；已有 TMDB 映射但剧照为空的影片仍会继续补图。

💅 界面优化 (UI)

• 搜索结果分区更名：「影片资料」改为「媒体库收录」，不再暗示数据一定来自豆瓣。
• 管理后台全宽布局：后台页面不再限制 1200px 最大宽度，表格和列表在宽屏上有更多空间。
• 用户列表倒序：管理后台用户列表按注册时间倒序排列，最新注册的用户显示在最前面。

🧹 精简 (Simplified)

• 收起一次性迁移路径：4.0 切流完成后，移除旧库迁移、旧站兼容检查和无数据库内存回退等不再使用的生产路径，只保留日常运行与发布仍需要的命令。
• 精简数据库结构：移除没有读取方或未实际生效的匹配审计、热词快照、资源生命周期等结构，并将播放质量汇总直接收敛到资源记录，减少重复表与重复状态。

✨ 新增 (Added)

• 站内弹幕系统：视频播放器完整接入弹幕功能，支持弹幕显示/隐藏开关、发送弹幕、记住用户偏好；后端聚合外部弹弹play源与站内弹幕，支持缓存、IP 限流、防重复校验及登录态发送。
• 采集站点健康统计与熔断：新增按小时分桶的站点健康统计，自动跳过连续失败的采集站点，5 分钟后自动恢复探测；后台资源管理页展示成功率、空返回率与平均耗时。
• 播放页已看过按钮：播放页面新增已看过状态标记按钮，可直接在播放页完成观影标记。
• 播放页站内短评展示：播放页新增展示站内用户短评模块，观影讨论更便捷。
• 站点健康异常告警：当采集站点近 1 小时成功率等于 0% 或空返回率高于 98% 时，自动写入后台反馈页面；同一站点 24 小时内最多生成一次。
• 播放页免责声明：新增播放页免责声明，提示用户警惕视频内的广告诈骗风险。
• 品牌 Logo 升级：将表情符号 Logo 替换为实际图片 Logo，同步更新 favicon、PWA 缓存及全站页面模板样式。

🛠️ 变更/优化 (Changed/Improved)

• 模板 URL 编码修复：修复全站模板 URL 参数未编码的问题，避免特殊字符破坏 HTMX 请求。
• 用户电影操作按钮重构：抽离并重构用户电影操作按钮模板，支持播放页专用变体与更灵活的 HTMX 目标处理。
• HTTP 写超时配置：新增 HTTP 写超时与熔断开关环境变量，适配长搜索请求场景。
• 静态资源版本更新：更新播放器脚本、Service Worker 及全局静态资源缓存版本，确保新功能生效。

✨ 新增 (Added)

• 全站广场：新增广场页面，展示公开用户观影动态流，支持分页加载；同时提供本周及历史用户活跃度排行榜，发现更多同好。
• 短评互动：完整实现短评点赞/取消点赞、回复列表懒加载与回复提交功能，观影讨论更具社交感。
• 电影社交统计：电影详情页新增「XX 人看过 / XX 人想看」展示，快速感知影片热度。
• 观影重合数：月度观影小记页新增登录访客与目标用户的观影重合数计算，看看你们有多少共同看过的电影。
• 用户中心分页加载：为用户想看、已看、观影历史页面添加分页加载与「加载更多」交互，告别长列表卡顿。
• 公开主页分页加载：公开用户主页的想看、已看列表支持加载更多，与仪表盘分页逻辑保持一致。
• 月度报告后台管理：管理员后台新增手动生成 / 重新生成月度观影报告功能，支持前端配置与后端 API。
• 月度报告内容增强：月度观影报告新增观影人设生成、海报墙抽样、精选短评提取，让每月小结更丰富有趣。

🛠️ 变更/优化 (Changed/Improved)

• 月度报告生成重构：预统计全站月度观影分布以高效计算用户百分位排名；生成范围不再仅限绑定豆瓣账号的用户，所有产生观影记录的用户均可生成月报。
• 月度报告查询性能优化：新增按日期范围查询观影记录，避免全量拉取数据；使用 SQL 聚合计算平均评分替代内存遍历，显著提升大数据量下的渲染性能。
• 相似电影查询优化：修复 pgvector 相似电影查询无法命中 HNSW 索引的问题，相似影片推荐速度更快。
• 图片代理 SSRF 防护：为图片代理新增 Host 白名单校验，仅允许豆瓣与 TMDB 源站图片访问，防止服务端请求伪造攻击。
• 异步任务管理统一：替换手动 goroutine 超时处理逻辑，统一异步任务调度与生命周期管理。
• 公开主页与月度分享页渲染优化：抽离重复模板代码进行复用，减少冗余并提升可维护性。
• UI 样式调整：优化月度分享卡片、广场页面及相关组件的样式展示，提升视觉一致性。

✨ 新增 (Added)

• 用户头像功能：新增用户头像字段与默认头像，支持设置 Emoji 头像；用户列表与登录 Session 同步展示头像信息。
• 电影强制刷新：新增电影信息强制刷新接口，可手动触发重新抓取影片元数据。
• 月度报告二维码分享：月度观影报告分享页新增二维码展示，方便移动端扫码查看。

🛠️ 变更/优化 (Changed/Improved)

• 观影报告与公开分享页重构：优化月度报告生成逻辑与分享页面布局；公开观影记录路由由 /share 前缀改为 /user，统计展示更清晰。
• 豆瓣同步优化：解析豆瓣观影记录的创建时间并写入本地观影记录，时间线更准确。
• 前端模板体验优化：新增观看日期展示、手动刷新评分按钮，更新静态资源缓存版本。
• 设置页错误处理重构：抽离通用错误渲染方法，统一设置相关接口的错误提示逻辑。

🐞 修复 (Fixed)

• 豆瓣图片代理：修复 img9 等豆瓣图片链接无法经安全代理加载的问题。
• 播放器脚本缓存：为 monoo 加载脚本添加版本参数，避免浏览器缓存导致脚本失效。
• 播放页广告横幅：将广告横幅由内联 flex 改为响应式 CSS 网格布局，适配不同屏幕尺寸。

✨ 新增 (Added)

• 豆瓣观影记录同步完整功能：新增豆瓣同步调度器与同步服务，支持定时自动同步和手动触发同步任务。添加用户绑定、解绑豆瓣账号的接口和页面逻辑，实现同步任务状态的 HTMX 轮询展示，新增豆瓣同步任务的数据库模型与存储逻辑。
• 播放页版权拦截及提示页面：重构版权关键词匹配逻辑为可复用函数，兼顾搜索结果过滤与播放页拦截，新增版权限制提示页面、对应路由及处理函数。
• 观影月报功能：新增月度报告服务，自动生成用户每月观影统计，包括观影数量、平均评分、本月最佳电影、连续观影天数、类型分布统计等；支持报告导出为图片。
• 公开分享功能：用户可在设置中开启观影记录公开分享，生成专属分享页面展示想看/已看列表；支持分享月度报告。

🛠️ 变更/优化 (Changed/Improved)

• 更新管理员版权关键词管理页帮助提示：补充播放页面拦截说明，优化用户体验。
• 用户模型扩展：新增公开分享开关、豆瓣用户ID等字段支持。

✨ 新增 (Added)

• IPTV 电视直播功能：新增 IPTV 电视直播页面，支持导入自定义 M3U 直播源，提供央视、卫视等频道的在线观看服务。包含频道分组、搜索、Logo 展示等完整功能，适配桌面端与移动端。
• 站点级联删除：添加删除站点时级联删除关联 VodItem 的功能，使用 GORM 事务保证操作原子性。

🛠️ 变更/优化 (Changed/Improved)

• 强制 TMDB 图片安全代理：移除 TMDB 图片的特判放行，全站所有图片（豆瓣 & TMDB）一律经由安全代理路径分发，彻底解决国内部分地区海报访问不通问题，同时享受 CDN 边缘节点和浏览器缓存加速。
• 反馈按钮 UX 优化：播放页面反馈按钮添加禁用状态与加载指示器，提升用户交互反馈体验。
• 播放器支持直播模式：播放器新增 isLive 参数支持 IPTV 直播流播放，同时优化历史记录逻辑，排除 IPTV 内容的自动记录。

🐞 修复 (Fixed)

• Cloudflare AI 调用稳定性：为语义生成调用添加 3 次重试机制，间隔依次为 3s、5s、8s，同时优化 Gemini 回退逻辑处理。

✨ 新增 (Added)

• Base64 安全前缀代理：图片代理支持将图片原始 URL 编码为安全格式，隐藏上游豆瓣等敏感源站 URL，降低图片加载被拦截风险。
• Referer 防盗链验证：后端图片代理路由新增 Referer 安全验证。非白名单及本站发起的图片请求一律拦截并返回 403，保护服务器流量，同时本地调试支持自动放行。

🛠️ 变更/优化 (Changed/Improved)

• RESTful 路径参数重构：将图片代理地址由 /api/proxy/image?url= 重构为 /api/proxy/image/:url 路径参数形式，提供极其卓越的 CDN 缓存和边缘加速支持，降低源站穿透率。
• 全局模板函数与前端简化：注册 proxyImg 全局模板函数，将前端十余处原有的繁冗条件分支统一简化重构成单行，并无缝适配搜索栏下拉图及剧照大图预览组件。
• 爬虫抓取防御：在动态 robots.txt 服务中新增显式 Disallow: /api/proxy/image/ 规则，强力限制各大搜索引擎抓取。
• 代码整洁优化：利用 Gin 框架路由特性，精简了 ProxyImage 处理器中冗余的空参数校验逻辑。

✨ 新增 (Added)

• TVBox 接入支持：新增 /api/tvbox.json 配置接口与 /api/vod 数据接口，兼容苹果CMS v10 协议，支持分类浏览、关键词搜索、影片详情及在线播放。
• TVBox 使用引导页：新增专属说明页（/tvbox），提供配置地址一键复制、图文使用步骤及常见问题解答。

🛠️ 变更/优化 (Changed/Improved)

• 导航栏新增 TVBox 入口：顶部导航增加 TVBox 页面链接，方便用户快速跳转配置页面。
• VodItem 仓库扩展：新增按分类分页查询、关键词搜索等方法，为 TVBox 数据接口提供底层支撑。

✨ 新增 (Added)

• 自动播放下一集：视频播放结束后，自动弹出倒计时浮层，5 秒内无操作将跳转至下一集；支持「立即播放」与「取消」两种交互，配合圆形进度环直观展示剩余时间。
• 反馈列表类型筛选：历史反馈页新增筛选栏，可按「Bug 报告 / 求片 / 功能建议 / 版权投诉」分类查看，翻页时自动保留当前筛选状态。
• 用户中心「我的反馈」：个人中心新增独立反馈记录页，登录用户可分页查看自己提交的所有反馈。
• 全局 htmx 请求进度条：页面顶部新增固定进度条，所有 htmx 局部刷新请求期间自动显示加载进度，提升操作反馈感知。

🛠️ 变更/优化 (Changed/Improved)

• 后台服务优雅停机完善：CleanupService 与内存缓存均新增 Stop 方法，服务退出时按序调用，杜绝定时器与 goroutine 泄漏。
• 播放器资源清理加固：HLS bufferTimer、iOS 卡顿恢复 recoverTimer 及 waiting 事件监听器在播放器销毁时统一清理，解决内存泄漏隐患。
• 豆瓣爬虫 HTTP Body 修复：修复重试循环中 resp.Body 被 defer 延迟关闭的问题，改为请求成功后立即关闭，避免连接被长期占用。

✨ 新增 (Added)

• 异步任务安全管理：新增 utils.GoSafe 封装，为所有的后台并发任务提供统一的恐慌恢复 (Panic Recovery) 机制，避免局部报错导致主程序崩溃。
• 优雅停机机制：在服务关闭时引入等待队列，保障正在进行的后台任务（如保存数据、同步记录）在彻底停止前有充足的收尾时间。

🛠️ 变更/优化 (Changed/Improved)

• 全局 HTTP 连接池：重构了底层的 HTTP 请求模块，使用全局单例 Transport 替代频繁新建的 Client，显著提高了高并发下的连接复用率，彻底修复了引发“僵尸连接”与文件描述符 (FD) 枯竭的隐患。
• 防阻塞超时控制：为所有的外部 API 请求（豆瓣、TMDB、外部大模型）注入带时间限制的 Context，彻底解决了因外部网络无响应造成的爬虫请求无限阻塞与协程内存泄漏问题。
• 豆瓣热门抓取回退机制：为热门电影、剧集、综艺、动漫引入了 Rexxar 移动端接口作为二级回退方案。当常规网页接口抓取失败时，系统将自动切换至备选 API，并整合国内与国外热门剧集数据，显著提升了首页热门推荐的鲁棒性。
• 图片代理内存优化：重构了图片代理逻辑，改为直接流式透传原始数据，彻底消除了服务器处理图片时的内存解码与转码开销；同时将浏览器缓存时间延长至 30 天，大幅减轻了服务器的并发处理压力与带宽损耗。

✨ 新增 (Added)

• AI 语义化描述生成：接入 Cloudflare AI Gateway，支持 Kimi 等高性能模型为影视作品自动生成高密度语义摘要。
• 多模型回退机制：实现了 Cloudflare AI 与 Gemini API 的双向容错，确保在主模型不可用时能平滑切换，保障核心业务稳定性。
• 向量检索精度提升：通过 LLM 生成的特征文本显著增强了 Embedding 向量的表达能力，大幅提升了语义搜索的匹配度。

🛠️ 变更/优化 (Changed/Improved)

• 配置系统升级：重构了应用配置加载逻辑，支持通过环境变量动态配置多个 AI 服务商及其模型参数。
• Prompt 深度调优：优化了用于特征提取的 System Prompt，使其更符合影视社会学与语义检索的需求。
• 豆瓣爬虫双重保障：新增了 API 与网页解析的双重回退机制。当移动端接口失效时自动切换至网页抓取，确保影视元数据采集的极高成功率。

✨ 新增 (Added)

• 精准搜索增强：搜索结果页新增“豆瓣收录”卡片展示。当搜索词与本地库中豆瓣数据精准匹配时，在结果顶部展示详细的影视信息卡片。
• 广告位集成：在播放预览区域新增响应式广告位，助力站点可持续运营。

🛠️ 变更/优化 (Changed/Improved)

• 搜索卡片样式升级：为搜索结果卡片添加了品牌色边框与悬浮阴影，提升视觉一致性与点击反馈。
• 发现页加载优化：完善了发现页面的异步加载逻辑，确保在不同设备下更平滑地展示热门内容。
• 广告合作页重构：优化了广告合作页面的布局与引导文案，提供更清晰的合作方案展示。
• 代码瘦身：清理了页面模板中冗余的旧版广告脚本，优化页面加载性能。
• 全局样式微调：优化了电影推荐容器等组件的层级与间距，修复部分移动端显示瑕疵。

✨ 新增 (Added)

• 社交媒体与流量展示：添加了 X (Twitter) 联系方式以及站点流量截图展示，增加透明度与互动。
• 资源网自定义测试：后台管理新增资源网测试时的自定义关键词输入支持，管理员可针对不同站点灵活验证抓取效果。

🛠️ 变更/优化 (Changed/Improved)

• 播放器稳定性增强：优化 HLS 播放器的错误处理与通知机制，并调整了缓冲与重试设置，显著降低播放卡顿风险。
• 播放器组件维护：更新了 player.js 版本至最新，并修复了 HLS 实例销毁逻辑中的潜在问题。
• 爬虫容错与诊断：改进了来源抓取器的 JSON 解析错误处理，当解析失败时将输出更详细的原始报文信息，便于快速排查接口异常。
• 播放源按钮显示优化：修正播放源按钮的显示逻辑，增加具体的资源站点名称显示。

✨ 新增 (Added)

• 智能搜索结果过滤：搜索 API 新增 exclude 参数支持，可在详情页搜索资源时自动过滤当前正在播放的内容，避免重复展示。
• 电影抓取状态页：新增友好的数据抓取状态页面，当电影信息未收录时显示加载动画和清晰的操作指引，提升用户体验。

🛠️ 变更/优化 (Changed/Improved)

• 搜索性能优化：重构搜索过滤逻辑，将年份过滤和结果排除的两轮遍历合并为单次遍历，显著降低 CPU 开销，提升响应速度。
• 异步数据抓取：电影详情页数据抓取改为后台异步进行，避免用户长时间等待，页面即时响应并显示加载状态。
• 防重复抓取机制：引入 sync.Map 并发控制，防止同一部电影被多次重复抓取，优化资源利用。

🐞 修复 (Fixed)

• 电影数据完整性：修复标题为空的脏数据问题，自动清理并重新抓取，确保数据质量。

✨ 新增 (Added)

• 搜索年份过滤：搜索 API 新增 year 参数支持，允许用户精确按年份筛选影片，并优化了翻页时的过滤状态保持。

🛠️ 变更/优化 (Changed/Improved)

• iOS 播放引擎优化：针对 iOS 设备重构 HLS 播放逻辑，引入卡顿自动恢复机制与 MSE 参数调优，显著提升移动端播放稳定性。
• 异步向量内容生成：实现 EmbeddingContent 后台异步生成机制，在访问未索引影片时自动补全语义向量，提升推荐覆盖率且不影响页面响应。

🐞 修复 (Fixed)

• 详情页逻辑容错：优化影片详情页展示，当豆瓣 ID 无效时自动隐藏相关链接和推荐模块，避免空数据展示。

🐞 修复 (Fixed)

• 剧照代理修复：解决了电影详情页 TMDB 剧照无法正常显示的问题。
• 海报代理统一：统一了全站电影海报的代理地址，提升图片加载的可靠性和一致性。

🛠️ 变更/优化 (Changed/Improved)

• 优化图片代理响应的缓存策略并改进图片灯箱的图片清除逻辑。
• 为图片代理请求添加 `raw=1` 参数以获取原始图像。

✨ 新增 (Added)

• AI 智能推荐系统 (AI-Powered)：
  • Moovie 推荐语：在电影详情页引入 AI 深度生成的个性化推荐语，基于 LLM 对剧情内核与艺术风格的解析，为您揭示每部作品的独特魅力。
  • 深度语义向量匹配：底层推荐引擎全面接入 pgvector 向量技术，支持基于剧情语义、叙事结构及导演手法的多维相关性推荐，大幅提升相似影片的发现精度。

🛠️ 变更/优化 (Changed/Improved)

• 剧照展示引擎重构：针对移动端（尤其是安卓设备）进行了底层交互重写。将“展开/收起”逻辑由 JavaScript 驱动迁移至纯 CSS Checkbox 状态引擎，从根本上解决了脚本兼容性、点击失效及响应延迟问题。
• 触控响应性能优化：为交互组件引入 touch-action: manipulation 属性，彻底消除移动端浏览器默认的 300ms 点击延迟，提供原生级的灵敏触控体验。
• 视频播放优化：针对 iOS 设备，优化了视频播放时的缓冲策略，有效减少了视频加载延迟，提升了用户在移动设备上的播放体验。

🐞 修复 (Fixed)

• 跨设备脚本容错：修复了在部分旧版移动浏览器中因不支持 scrollIntoView 高级配置对象而导致的页面滚动逻辑中断问题。

✨ 新增 (Added)

• 高清剧照展示：详情页接入 TMDB 剧照 API，支持高清剧照的异步采集与展示。内置轻量级 Lightbox 图片查看器，支持大图浏览与手势/快捷键操作

🛠️ 变更/优化 (Changed/Improved)

• 海报代理逻辑优化：新增 contains 模板函数，智能识别海报来源。针对 TMDB 源的海报直接加载，不再通过中转代理，提升海报加载速度与稳定性
• 全局海报适配：完成电影详情页、个性化推荐、仪表盘等全站海报组件的动态代理适配

✨ 新增 (Added)

• 广告合作页面：新增独立的广告合作申请页，上线投放优势、广告形式说明及全球化支付支持

🛠️ 变更/优化 (Changed/Improved)

• 搜索排序默认优化：默认启用“按加载速度”智能排序，简化 UI 交互，提升搜索效率
• 全局加载效果：引入全新的页面级 Loading 指示器，优化数据加载时的视觉平滑度
• 分类筛选体验：重构手机端分类筛选组件，加入动态展开/折叠功能，适配触屏操作

🐞 修复 (Fixed)

• 模态框交互修复：解决了部分弹窗点击遮罩层意外关闭的问题，并统一样式
• 模板加载错误：修复了“为你推荐”页面在分页加载过程中可能出现的模板解析异常

✨ 新增 (Added)

• 用户标记系统重构：全面升级“想看/已看”功能，支持更加便捷的状态标记与管理
• 评分与短评功能：新增弹窗式评分与短评编辑器，支持在仪表盘及电影详情页快速添加或修改影评
• 品牌升级：系统品牌增加中文名称“Moovie 影牛”

🛠️ 变更/优化 (Changed/Improved)

• 仪表盘视觉焕新：统计栏图标由 Emoji 升级为 SVG 图标，界面更加专业统一
• 短评展示优化：改进用户评论列表排版，评分与元数据显示更清晰
• 移动端体验优化：优化“已看”列表在移动端的操作按钮布局
• 缓存性能提升：引入更精细的缓存过期策略，提升系统响应速度
• 优化推荐逻辑：个性化推荐算法优化，提升推荐准确性

✨ 新增 (Added)

• 全面增强“为你推荐”页面：引入沉浸式 Hero 电影展示、多类别推荐列表和改进的空状态提示
• 新增相似电影推荐功能，并在电影详情页直接集成
• 为推荐系统增加 SEO 友好的结构化数据（导演、海报等）

🛠️ 变更/优化 (Changed/Improved)

• 优化相似原因生成逻辑，提升推荐准确性
• 引入缓存机制（特别是在相似电影推荐中），显著提升响应速度
• 优化数据库连接池配置
• 重构推荐页 UI 布局，提供更直步观的长列表展示

🐞 修复 (Fixed)

• 修复部署时环境变量配置不生效的问题

✨ 新增 (Added)

• 添加视频加载速度显示功能，使用增量平均算法基于其他用户的实际播放反馈来计算平均速度，优化用户体验
• 为视频搜索结果为空和缺少播放链接的情况添加具体错误信息
• 实现HTMX预加载功能，优化页面切换体验
• 为按钮和标签添加鼠标悬停延迟触发功能
• 添加豆瓣Rexxar API作为主要爬取方案，增加爬取成功率
• 实现搜索结果缓存和分页功能

🛠️ 变更/优化 (Changed/Improved)

• 跳过采集没有播放链接的视频项，提高数据质量
• 为评论标题链接添加title属性，提升可访问性
• 添加豆瓣ID有效性校验函数，增强数据准确性

🛠️ 变更/优化 (Changed/Improved)

• 从头整理了整站的全部代码，优化了代码结构，增加了好多新功能，并且开源了全部代码。

🛠️ 变更/优化 (Changed/Improved)

• 重构前端为Vue3单页应用并优化后端API

🗑️ 移除 (Removed)

• 收到通知，已移除部分纯福利类资源网、屏蔽福利相关分类资源

✨ 新增 (Added)

• 新增八个资源网

🛠️ 变更/优化 (Changed/Improved)

• 在关键词区域添加"点击展开查看"的提示文本
• 观影记录区域添加"点击影片右下角 ☑ 可删除观影记录"的提示文本

🛠️ 变更/优化 (Changed/Improved)

• 实现首页关键词区块的手风琴折叠效果并优化样式

✨ 新增 (Added)

• 在搜索路由中增加版权屏蔽功能

✨ 新增 (Added)

• 新增多个资源网，目前资源网总量 33 个

🐞 修复 (Fixed)

• 修复播放页面更多视频源显示为空问题

✨ 新增 (Added)

• 新增基于观影记录的影片推荐功能

✨ 新增 (Added)

• 新增想法建议页面，用户可匿名提交建议或留下联系方式
• 新增三个资源网

🐞 修复 (Fixed)

• 修复视频播放时可能出现的卡顿问题

🛠️ 变更/优化 (Changed/Improved)

• 优化视频播放性能，减少加载时间和缓冲等待
• 为搜索结果添加分页功能，避免一次返回过多数据导致性能问题

重构播放器实现，使用ArtPlayer替换DPlayer，提供更稳定的播放体验

🛠️ 变更/优化 (Changed/Improved)

• 替换DPlayer为ArtPlayer并优化播放体验

🐞 修复 (Fixed)

• 改进缓冲和错误处理机制

优化视频播放器配置和卡顿处理逻辑

✨ 新增 (Added)

• 添加自动获取焦点和互斥播放功能提升用户体验

🛠️ 变更/优化 (Changed/Improved)

• 优化HLS缓冲策略和网络性能参数减少卡顿

🐞 修复 (Fixed)

• 改进卡顿检测逻辑，避免频繁强制seek操作

全面优化搜索、缓存与播放体验，提升站点性能与响应速度

✨ 新增 (Added)

• 实现搜索缓存功能，显著提升搜索性能
• 添加每日定时任务清理低频与过期缓存
• 实现热门搜索词与最近搜索词展示
• 视频测速升级为综合视频质量测试

🛠️ 变更/优化 (Changed/Improved)

• 重构爬虫服务，使用统一的数据结构
• 优化搜索与播放页面的关键词上下文展示
• 优化热门页面分类展示与视频质量检测逻辑

🐞 修复 (Fixed)

• 将广告脚本改为延迟加载以提高页面性能
• 为视频播放器添加主题色、音量控制和播放速度选项

✨ 新增 (Added)

• 添加视频测速功能以优化视频播放体验

✨ 新增 (Added)

• 新增下载 M3U8 功能

重新构建全新的前端页面，更简约现代人性化。

• 初始版本上线