Files
jinghui 500cc343ab
Docker Build & Test / build (push) Canceled after 0s
Docker Build & Test / test (push) Canceled after 0s
Build & Push Docker image / build-and-push (linux/amd64) (push) Canceled after 0s
Build & Push Docker image / build-and-push (linux/arm/v7) (push) Canceled after 0s
Build & Push Docker image / build-and-push (linux/arm64) (push) Canceled after 0s
Build & Push Docker image / merge-images (push) Canceled after 0s
Release / release (push) Canceled after 0s
Release / docker (push) Canceled after 0s
fix: fixed135 翻页箭头始终可见 + 窄屏不溢出 + CHANGELOG/README
2026-11-16 23:48:19 +08:00

22 KiB
Raw Permalink Blame History

更新日志 (CHANGELOG)

本文档记录 KatelyaTV 项目的重要更新和功能变更。

[fixed135] - 2026-11-16

🎨 界面改进(翻页箭头始终可见)

  • 翻页箭头不再只在 hover 时显示:PaginatedRow 共享组件移除 isHovered 状态与 onMouseEnter/onMouseLeave,两个箭头按钮默认 opacity-100(hover 仅保留 scale-110 反馈)——此前箭头 hover 前 opacity-0,桌面端鼠标未悬停时不可见、触屏设备永远不可见;用户反馈「没看到有箭头」即为此。首页「最新港剧」与详情页「相关推荐」共用同一组件,一次修复两处。
  • 窄屏不再横向溢出:箭头定位 -left-12/-right-12 → -left-2 md:-left-12 / -right-2 md:-right-12,小屏内收至网格边缘,大屏保持贴边;桌面 772px 与移动 375px 实测 scrollWidth−clientWidth=0、箭头完全在视口内。
  • 翻页逻辑不变:每页 10 条、页尾回绕、左箭头返回第 1 页、不足 10 条不显示箭头;/api/related 36 候选/30 返回、匹配规则/证据门槛/排序/10 分钟缓存均不变。

🧪 验证(2026-11-16 实测)

  • 桌面 772px:相关推荐第 1 页箭头 opacity=1 且未 hover;点击右箭头 → 第 2 页 10 条且内容不同、左箭头 opacity=1;再点右箭头 → 第 3 页 10 条;左箭头点回第 1 页;overflowX=0、无横向滚动条
  • 移动 375px(deviceScaleFactor=2):相关推荐与首页箭头 opacity=1、完全在视口内、overflowX=0
  • 响应式扫描 375/640/768/1024/1440 五档:箭头全部在视口内、opacity=1;640 首页的 overflowX=24 来自「继续观看」横向滚动区的有意设计,与本版无关
  • 容器 katelyatv:fixed135 重建(1:1 复刻原参数:--env-file .env + 网络 katelyatv_katelyatv-network + 双 --add-host),/login 200、页面 banner vfixed135

[fixed134] - 2026-11-16

✨ 详情页「相关推荐」左右箭头翻页(与首页最新港剧同款)

  • 翻页控件复用首页共享组件 PaginatedRow:相关推荐卡片网格外包同款翻页组件——hover 时网格两侧浮现紫色圆形箭头(右侧下一页、左侧上一页),每页 10 条,效果与首页「最新港剧」完全一致;第 3 页再点右箭头回第 1 页、第 2 页点左箭头回第 1 页(与首页行为一致);不足 10 条不显示箭头
  • 服务端候选扩容:/api/related 元数据补全候选 12 → 36、返回上限 10 → 30 条,凑够 3 页翻页数据;匹配规则、证据门槛(主演≥3 或导演≥2)、排序、10 分钟缓存均不变,冷启动仅详情补全并发数增加(实测 14.0s 返回 30 条),缓存命中 0.009s

🧪 验证(2026-11-16 实测)

  • 接口:真实港剧参数调 /api/related 冷启动 30 条、二次请求 0.009s;每条带 source/id 直达与匹配依据(导演/主演/地区/语言)
  • UI(浏览器实测):第 1/2/3 页各 10 条且内容不同;右箭头翻到页尾自动回第 1 页、左箭头返回第 1 页;双箭头对称贴网格两侧、不压卡片不被裁切、页面无横向溢出(scrollWidth−clientWidth=0)
  • 容器 katelyatv:fixed134 重建(1:1 复刻原参数:--env-file .env + 网络 katelyatv_katelyatv-network + 双 --add-host),/login 200、公告弹窗显示 vfixed134

[fixed133] - 2026-11-16

⚡ 性能:最新港剧等聚合板块秒开(对齐热门电影的加载体验)

  • 接口层 stale-while-revalidate:/api/tvbox/all 缓存过期后先立即返回旧数据(X-Cache: STALE,实测 0.02s),同时在后台重新聚合——多源聚合实测 8~22s,用户请求从此零等待;60s 内 X-Cache: HIT(0.03s)
  • 分类端点并发竞速:fetchClass 三个候选端点由「串行逐试、每端点等满 8s」改为「并发竞速、首个成功即用」(半死源最坏 3×8s=24s → 8s);容器重启后的冷启动全量聚合从 60s+ 降到 22.3s(前端 25s 超时内可通过)
  • 失败分类表缓存 30s → 2min:避免每分钟刷新反复踩满超时拖慢整体
  • 保活:模块级预热定时器(edge 隔离下不保证存活)+ 宿主 crontab 每分钟保活请求——无用户流量时聚合结果也持续续期,数据最多旧约 2 分钟
  • 根因说明:热门电影走豆瓣单接口(1~2s 即回),最新港剧走全片源站聚合(分类表映射 + 列表拉取 + 硬过滤去重),慢在聚合本身与 60s 缓存过期后的同步等待;本版以 SWR + 端点竞速消灭「等待」,数据源保持片源直达不降级(不换豆瓣源,避免点击后退化为标题搜索)
  • Dockerfile ENV NEXT_PUBLIC_SITE_VERSION 同步 fixed133(客户端编译期常量)

🧪 验证(2026-11-16 实测)

  • tsc / next build 通过;冷启动聚合 22.3s(list=70)、第 2 发 HIT 0.031s、过期后 STALE 0.024s(list=65)
  • 站点 307→login 200、Redis 67 键完好、容器 SITE_VERSION=fixed133

[fixed132] - 2026-11-16

✨ 全新浏览器标签页图标(favicon)

  • 重新设计网站图标:替换原来「暗黑肖像插画缩略图」的旧 favicon(16px 下糊成一团黑、不可辨识)。 新图标为 深蓝渐变圆角底 + 天蓝播放三角 + 右上角星光点缀,与站点暗色主题/天蓝主色一致, 影视播放属性一眼可辨。
  • 小尺寸专门优化:favicon.ico 内含 4 个尺寸——16px 用专用优化版(三角放大至 72%、去星光、 加粗边线,保证标签页最小尺寸下清晰可辨为播放三角),32/48/64px 用标准版(4K 超采样渲染 + LANCZOS 缩放抗锯齿)。
  • 同步更新 PWA 图标:public/icons/icon-{192,256,384,512}.png 全部换成新版设计, manifest.json 图标路径不变,浏览器安装/书签场景同步生效。
  • 图标由代码渲染生成(Pillow,脚本存 scratch),无需外部素材;16/32/48/64 四尺寸经视觉逐级核验。

验证

  • 线上 /favicon.ico(32038 字节)与源文件 sha256 逐字节一致;浏览器实际加载的 favicon hash 同为 960d4431c7c88996…,MATCH。
  • 首页 307→登录页正常、登录探针 401、/icons/icon-512x512.png 200、Redis 65 键数据完好。
  • 镜像 katelyatv:fixed132 双推内网 Gitea + 腾讯 TCR(fixed132 与 latest tag,双仓 digest 一致 7648449d…)。

🔄 保持不变

  • 站点功能、登录鉴权、观看记录(Redis)、相关推荐(fixed131)、TVBox 配置等全部无改动; 仅替换图标资源文件。

[fixed131] - 2026-11-14

✨ 重做(相关推荐:本站片源按元数据匹配,点击直达实际片源)

  • 数据源换成本站已有片源,不再走豆瓣推荐接口:新增 /api/related 接口 (src/app/api/related/route.ts),用当前片的 主演 / 导演 名称全站搜索本站资源站拿到候选池, 再对前 12 个候选取详情,按 主演、导演、语言、地区、类型 五项元数据重合度打分, 排除自己/同名/豆瓣同 ID,同名跨源去重后取前 10 返回(score + reasons 标注重合依据)。
  • 点击直达实际片源:相关推荐卡片 href 改为 /play?source=<源>&id=<条目ID>&title=... (src/components/VideoMetaExtra.tsx),带 source+id 进播放页后 直接取该条详情开播, 不再做标题搜索(src/app/play/page.tsx 直达模式)——彻底解决「按 title 找片对不上」的问题; 同名源随后台补搜填充「换源」面板,不阻塞开播;该 id 失效时自动回退标题搜索。
  • 推荐规则显示在「相关推荐」旁:标题右侧常驻说明「按主演 / 导演 / 语言 / 地区 / 类型匹配 · 本站片源直达」, 每张卡片下方还显示年份 · 源站与重合依据(如「导演:叶伟信 · 主演:甄子丹」,悬停看全量)。
  • /api/related 加入 middleware 白名单(与 /api/search、/api/detail 同级),接口 10 分钟内存缓存。

验证

  • 《叶问》(甄子丹/叶伟信/香港/剧情,动作) → 10 条全部同导演同主演:叶问2/叶问4、杀破狼、龙虎门、导火线、叶问3 等,耗时 12.7s。
  • 返回条目逐条 source+id 直取 /api/detail 均返回可播 m3u8(如叶问2 → c1.rrcdnbf2.com/.../index.m3u8);/play?source=&id= HTTP 200。
  • 构建产物确认播放页 chunk 含「本站片源直达」文案与 /api/related 调用。

🔄 保持不变

  • 登录/注册鉴权、豆瓣评分/短评(仅推荐改成本站数据)、TVBox 配置(fixed128)、首页最新港剧(fixed127)、首访 IPv6 线路门。

🐛 修复(2026-11-15 追加:观看记录"消失"事故)

  • 根因:某次 docker run 重建容器时漏带 --env-file .env,NEXT_PUBLIC_STORAGE_TYPE=redis 环境变量丢失 → 站点退回 localstorage 模式:服务端 Redis 里的 24 个账号、全部观看记录/收藏/ 管理配置瞬间不可读(用户表现为"观看记录都没了"),且登录接口在该模式下未配置 AUTH_PASSWORD 直接放行(站内登录形同虚设;外层 Basic Auth 仍在)。数据本身未丢失,Redis 中 13 条记录完好。
  • 修复:① Dockerfile builder/runner 两阶段 ENV NEXT_PUBLIC_STORAGE_TYPE=redis 烤进镜像, 彻底杜绝再丢;② 容器重建改用 --env-file /vol3/1000/HD3/docker/katelyatv/.env 全量环境 + 显式 -e NEXT_PUBLIC_STORAGE_TYPE=redis 兜底;③ README 新增「方式二 docker run(必须带 --env-file)」与部署铁则警示;④ compose image 对齐 katelyatv:fixed131。
  • 验证:RUNTIME_CONFIG.STORAGE_TYPE=redis;/api/playrecords(合法签名 cookie)200 返回 13 条记录;登录探针 __probe__ 401「用户名或密码错误」(修复前为 ok:true 直接放行); 登录态首页 200、/login 200、公网 tv.88531.cn 跳转链正常。
  • 注:故障窗口内在浏览器新看的片记录留在本地 localStorage,不会自动同步回服务端。

镜像

  • katelyatv:fixed131(内网 + 腾讯云双推,latest 同步)

[fixed130] - 2026-11-14

✨ 优化(相关推荐)

  • 标题旁显示推荐规则:「相关推荐」右侧新增说明「豆瓣相似影片推荐 · 取前10」—— 数据来自豆瓣官方推荐接口 m.douban.com/rexxar/api/v2/{tv|movie}/{豆瓣ID}/recommendations(取前 10 条), 让用户知道这一栏是按什么规则出的数据(src/components/VideoMetaExtra.tsx)。

🔄 保持不变

  • 相关推荐卡片点击直达播放页(fixed129)、登录/注册鉴权、TVBox 配置(fixed128)、首页最新港剧(fixed127)。

镜像

  • katelyatv:fixed130(内网 + 腾讯云双推,latest 同步)

[fixed129] - 2026-11-14

🐛 修复(详情页「相关推荐」点了跳到搜索页)

  • 相关推荐卡片改为直接进播放页:href 由 /search?q=<片名> 改为 /play?title=<片名>, 点击即打开对应影片详情并开始播放,不再跳转到搜索页(src/components/VideoMetaExtra.tsx)。
  • 播放页标题匹配加兜底:精确匹配不到时(相关推荐/豆瓣标题与源站标题常有差异,如「无惧」vs「无惧神明」、 「大医凌然 第二季」vs「大医凌然」)自动放宽到双向包含匹配,再找不到才走「未找到匹配结果」页 (src/app/play/page.tsx 的 fetchSourcesData)。原先这类点击必然落到未找到页。

验证

  • 构建产物确认:相关推荐卡片 href:"/play?title=";播放页 bundle 含「严格→放宽→未找到」三级匹配逻辑。
  • 接口级复现(按播放页同款匹配逻辑跑 /api/search):「无惧」严格 0 → 放宽命中《无惧神明》; 「大医凌然 第二季」严格 0 → 放宽命中《大医凌然》;「无名英雄」严格命中 9 条。 「模范律师团」「去远方 第二季」源站确实无此片(返回的都是模糊无关结果),仍走未找到页(属数据缺失,非跳转 bug)。

🔄 保持不变

  • 登录/注册鉴权、首访 IPv6 线路门(__v6dest)、TVBox 配置(fixed128)、首页最新港剧(fixed127)。

镜像

  • katelyatv:fixed129(内网 + 腾讯云双推,latest 同步)

[fixed128] - 2026-11-13

🐛 修复(TVBox 接口“用不了/没数据/功能和之前不一样”)

  • 恢复 TVBox 旧版配置结构:站点列表改回「全部资源」(/api/tvbox/all) + 各源逐站代理 /api/tvbox/<key>。 源码化(fixed68)时该结构被替换成直连第三方源,旧配置里的 /api/tvbox/<key> 路径直接 404, 电视/手机端点播因此拿不到数据;现在全部经本站域名转发,只需能访问 tv.88531.cn 即可点播。
  • 新增 /api/tvbox/[site] 逐站代理(旧补丁 P() 的源码化恢复):9xx 顶层分类 → 该源自身分类 id、 agg 分类逐子分类聚合(去重+更新时间排序+10 分钟缓存)、AI短剧搜索(kwPat 过滤)、st/area/year/by 筛选与兜底重查。
  • 裸 /api/tvbox 的 9xx 分类全部返回 0 条:agg 分支没把 903/904/905/907 换成源站真实 type_id, 现统一走 @/lib/tvboxagg 的逐源映射。
  • /api/tvbox?wd= 搜索返回成配置 JSON:补上 wd 分支(聚合搜索)。
  • 配置页「Base64 格式」实际返回 JSON:format=base64 现在真正返回 base64。
  • 配置响应 Cache-Control 改 no-store(旧版语义,改完立即生效);88531 域名下接口地址强制 https(v-fixed43 需求回归)。
  • /api/tvbox/all 的 agg 分类恢复逐子分类聚合(更全,300 条封顶);分类表缓存统一为非空 10 分钟 / 空 30 秒。
  • 分类视图统一 TOP7:AI短剧/香港电影/香港剧/电影/电视剧/综艺/动画片/动漫(含每站 filters 筛选器)。

🔄 保持不变

  • 直播 live=txt 首频道 TVB翡翠台(fixed126);公告/版本 hub 字段;parses/flags/ads;首页最新港剧逻辑。

镜像

  • katelyatv:fixed128(内网 + 腾讯云双推,latest 同步)

[fixed96] - 2026-11-09

✨ 新增

  • 动漫独立页 /anime(源码化)
    • 聚合各资源站全部动漫内容,地区切换:全部 / 国产 / 日韩 / 欧美 / 港台 / 海外
    • 后端 /api/anime:多源并行抓取 → 地区归一化(国产剧/港台/韩国/日本/欧美/动漫… → 动漫域分类) → 按 title+year 去重 → 按 update_time 降序 → 分页 pg/next_pg/has_more
    • 顶部菜单与移动端底部导航均新增「动漫」入口(源码内 PageLayout / MobileBottomNav)
  • 第三方分类浏览接口 /api/browse(源码化)
    • 统一 kind=tv|movie|show|anime + cat(分类,支持 | 多选)+ area(地区)+ pg
    • 新增 src/lib/vodcat.ts 集中维护八大分类与地区选项
    • 三类页签分类全量切到第三方分类语义(电影/剧集/综艺),不再用豆瓣分类值

🐛 修复

  • 动漫页首次进入永远空列表:reset=true 时 base 被置成空数组,新到的 arr 没有拼进去, 导致接口 200、页面却显示「暂无动漫内容」;改为 base = [...arr]

🔄 变更

  • /douban 电影/剧集/综艺 三类选择器改走 /api/browse,与 /api/anime 共用排序去重逻辑
  • 版本号 NEXT_PUBLIC_SITE_VERSION → fixed96(Dockerfile 构建期注入,已验证镜像内 chunk 与页头一致)

[fixed44] - 2026-11-06

🐛 修复

  • 管理页「用户配置」点击崩溃(React #31)
    • 根因:getAllUsers() 返回的是 User 对象数组,src/lib/config.ts 却把它当用户名字符串使用, 导致 Users[].username 被写成 {username, role, created_at} 对象,页面渲染对象触发 React #31
    • 修复:src/lib/config.ts 两处统一取 username 字符串后再补全用户列表
  • 放行静态面板脚本:src/middleware.ts 跳过认证路径新增 /user-admin.js
  • public/sw.js 改为自毁式 Service Worker,强制清理旧缓存版本,避免客户端卡在过期 chunk

✨ 新增

  • 全新「用户管理」面板(原生 JS,独立于 React 组件):用户列表、添加用户、修改密码、 设为管理/取消管理、封禁/解封、删除

[0.6.0-katelya] - 2025-09-03

🎉 新增功能

  • 🖱️ 用户界面优化

    • 在用户菜单中新增"TVBox配置"按钮,提供便捷的配置入口
    • 新增电视图标(Tv)标识,界面更加直观
  • 🎬 跳过控制器增强

    • 新增片尾倒计时模式选择:支持剩余时间模式和绝对时间模式
    • 剩余时间模式:基于视频剩余时间进行倒计时(推荐)
    • 绝对时间模式:基于视频播放时间进行检测(兼容旧版本)
    • 优化用户界面,提供更清晰的配置说明和帮助文本
    • 优化用户体验,一键访问TVBox配置页面

🐛 Bug修复

  • 🎯 选集点击精确性修复
    • 修复选集界面点击偏移问题,确保点击哪个集数就选择哪个集数
    • 问题根因:SkipController的固定定位面板(bottom-4 right-4)覆盖了选集面板右下角
    • 解决方案:将跳过配置面板移动到左下角(bottom-4 left-4),避免与选集面板冲突
    • 保持所有跳过功能正常工作,仅调整UI布局避免重叠

🔧 重要改进

  • 🔓 TVBox API 认证优化

    • 重要变更:TVBox API (/api/tvbox) 现已开放无需认证访问
    • 解决 TVBox 客户端无法登录的根本问题
    • 支持直接在 TVBox 应用中使用配置链接,无需预先登录
    • 中间件配置优化,确保其他管理 API 仍受保护
  • ☁️ Cloudflare Pages 部署支持

    • 修复所有 API 路由的 Edge Runtime 配置问题
    • 重构文件系统访问逻辑,使用 getConfig() 替代 fs.readFileSync
    • 解决 Cloudflare Pages 部署失败的核心问题
    • 确保生产环境部署稳定性

🐛 问题修复

  • 修复代码导入排序导致的 ESLint 警告
  • 解决 TVBox API 认证导致的访问失败问题
  • 优化构建过程,减少开发环境警告

📱 使用体验

  • TVBox 配置链接可直接在客户端使用
  • 支持 JSON 和 Base64 两种配置格式
  • 完全兼容 TVBox 及其衍生应用

[0.5.1] - 2025-09-03

🎉 新增功能

  • 📺 TVBox 兼容支持
    • 新增 TVBox 配置接口,支持标准 JSON 格式配置
    • 提供直观的配置管理界面 (/config 页面)
    • 支持 JSON 和 Base64 两种配置格式
    • 内置视频解析接口,支持多种视频平台
    • 完全兼容 TVBox 及其衍生应用
    • 自动同步 KatelyaTV 配置的所有视频源

🔧 技术改进

  • 新增 /api/tvbox API 端点,提供 TVBox 标准配置
  • 新增 /api/parse 视频解析接口
  • 新增 TVBox 配置页面组件,支持动态格式切换
  • 添加 CORS 跨域支持,确保 TVBox 应用正常访问
  • 完善的错误处理和用户提示
  • 新增详细的 TVBox 使用文档

🐛 问题修复

  • 修复 Cloudflare Pages 部署时的 Suspense 边界问题
  • 解决 Next.js 静态生成时的 useSearchParams 错误
  • 优化构建配置,确保跨平台部署兼容性

[0.5.0] - 2025-09-02

🎉 新增功能

  • ⏭️ 跳过片头片尾功能
    • 智能检测播放时间是否在跳过区间内
    • 支持手动设置片头、片尾跳过时间段
    • 播放时自动显示跳过按钮,8秒后自动隐藏
    • 每个用户可独立配置,支持跨设备同步
    • 完全兼容所有存储后端(LocalStorage、Redis、D1、Upstash)

🔧 技术改进

  • 新增 SkipController 组件,提供完整的跳过功能界面
  • 新增 SkipSegment 和 EpisodeSkipConfig 数据类型
  • 扩展所有存储实现以支持跳过配置 CRUD 操作
  • 新增 /api/skip-configs API 路由,支持服务端跳过配置管理
  • 完善的类型定义和错误处理

🌐 部署兼容性

  • ✅ Cloudflare Pages - Edge Runtime 完全兼容
  • ✅ Docker 部署 - 自动 Runtime 转换,完全兼容
  • ✅ Vercel 部署 - 自动适配,完全兼容
  • ✅ 传统服务器 - Node.js Runtime,完全兼容
  • ✅ 其他云平台 - 全面支持各种部署环境

📚 文档更新

  • 更新 README.md,添加跳过功能介绍和使用教程
  • 新增 DEPLOYMENT_COMPATIBILITY.md 部署兼容性说明
  • 添加功能特性详细描述
  • 完善环境变量和配置说明

🧪 测试验证

  • 新增 test-docker-compatibility.js 兼容性测试脚本
  • 验证所有 22 个 API 路由的 Edge Runtime 配置
  • 确认所有存储后端的跳过配置功能支持

[0.4.0] - 之前版本

基础功能

  • 🔍 多源聚合搜索
  • 📺 高清视频播放
  • ⭐ 收藏功能
  • 📖 播放历史记录
  • 👥 多用户支持
  • 🐳 Docker 一键部署
  • ☁️ 多平台部署支持
  • 🌓 深色模式
  • 📱 PWA 支持

版本说明

版本号规则

  • 主版本号:重大功能更新或架构变更
  • 次版本号:新功能添加或重要改进
  • 修订版本号:Bug 修复和小幅优化

更新类型说明

  • 🎉 新增功能 - 全新的功能特性
  • 🔧 技术改进 - 代码优化、性能提升、架构改进
  • 🌐 部署兼容性 - 部署方式和环境支持
  • 📚 文档更新 - 文档完善和说明补充
  • 🧪 测试验证 - 测试覆盖和质量保证
  • 🐛 Bug 修复 - 问题修复和稳定性改进
  • ⚡ 性能优化 - 响应速度和资源使用优化
  • 🎨 界面改进 - UI/UX 优化和视觉改进

贡献指南

如果您想为项目贡献代码或反馈问题:

  1. 提交 Issue - 报告 Bug 或提出功能建议
  2. 发起 Pull Request - 贡献代码改进
  3. 完善文档 - 帮助改进项目文档
  4. 测试反馈 - 在不同环境下测试并反馈

感谢所有贡献者的支持!🙏