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
22 KiB
22 KiB
更新日志 (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/related36 候选/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),/login200、页面 bannervfixed135
[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),/login200、公告弹窗显示 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.png200、Redis 65 键数据完好。 - 镜像
katelyatv:fixed132双推内网 Gitea + 腾讯 TCR(fixed132与latesttag,双仓 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 条记录完好。 - 修复:①
Dockerfilebuilder/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)」与部署铁则警示;④ composeimage对齐katelyatv:fixed131。 - 验证:
RUNTIME_CONFIG.STORAGE_TYPE=redis;/api/playrecords(合法签名 cookie)200 返回 13 条记录;登录探针__probe__401「用户名或密码错误」(修复前为ok:true直接放行); 登录态首页 200、/login200、公网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 仍受保护
- 重要变更: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/tvboxAPI 端点,提供 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-configsAPI 路由,支持服务端跳过配置管理 - 完善的类型定义和错误处理
🌐 部署兼容性
- ✅ 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 优化和视觉改进
贡献指南
如果您想为项目贡献代码或反馈问题:
- 提交 Issue - 报告 Bug 或提出功能建议
- 发起 Pull Request - 贡献代码改进
- 完善文档 - 帮助改进项目文档
- 测试反馈 - 在不同环境下测试并反馈
感谢所有贡献者的支持!🙏