更新记录 (Changelog)

✨ 新增 (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 功能

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

• 初始版本上线