Compare commits

...
2 Commits
Author SHA1 Message Date
jinghui 3b9f3bbf5d perf: 最新港剧聚合秒开——/api/tvbox/all SWR + fetchClass端点竞速 (fixed133)
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
- 接口 stale-while-revalidate: 过期先秒回旧数据(STALE)后台刷新, 60s内HIT
- fetchClass 三端点串行逐试改并发竞速: 冷启动 60s+ -> 22.3s
- 失败分类缓存 30s->2min; 宿主 cron 每分钟保活
- Dockerfile NEXT_PUBLIC_SITE_VERSION=fixed133
2026-11-16 15:42:13 +08:00
jinghui 5d58eee4c7 docs: README 更新日志+当前版本对齐 v-fixed132 2026-11-16 15:01:31 +08:00
5 changed files with 112 additions and 30 deletions

No files matched your search

+14
View File
@@ -2,6 +2,20 @@
本文档记录 KatelyaTV 项目的重要更新和功能变更。
## [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)
+2 -2
View File
@@ -35,7 +35,7 @@ RUN find ./src -type f -name "route.ts" -print0 \
ENV DOCKER_ENV=true
# 海报走站内 /api/image-proxy(浏览器直连豆瓣图被拦导致全裂)
ENV NEXT_PUBLIC_IMAGE_PROXY=/api/image-proxy
ENV NEXT_PUBLIC_SITE_VERSION=fixed131
ENV NEXT_PUBLIC_SITE_VERSION=fixed133
ENV NEXT_PUBLIC_ENABLE_REGISTER=true
# 存储模式必须烤进镜像:丢失会导致服务端数据(观看记录/账号/收藏)全部不可读,
# 且登录接口走 localstorage 分支无 AUTH_PASSWORD 直接放行(2026-11-15 事故)
@@ -59,7 +59,7 @@ ENV HOSTNAME=0.0.0.0
ENV PORT=3000
ENV DOCKER_ENV=true
ENV NEXT_PUBLIC_IMAGE_PROXY=/api/image-proxy
ENV NEXT_PUBLIC_SITE_VERSION=fixed131
ENV NEXT_PUBLIC_SITE_VERSION=fixed133
ENV NEXT_PUBLIC_ENABLE_REGISTER=true
# 存储模式必须烤进镜像:丢失会导致服务端数据(观看记录/账号/收藏)全部不可读,
# 且登录接口走 localstorage 分支无 AUTH_PASSWORD 直接放行(2026-11-15 事故)
+4 -2
View File
@@ -247,6 +247,8 @@ docker compose -f docker-compose.redis.yml down
## 📋 更新日志
- **v-fixed133**:**最新港剧加载提速(对齐热门电影)**——`/api/tvbox/all` 聚合接口改 stale-while-revalidate:过期先秒回旧数据(STALE 实测 0.02s)后台再刷新,60s 内 HIT 0.03s;分类端点由串行逐试改并发竞速,**冷启动聚合 60s+ → 22.3s**;失败分类缓存 30s→2min + 宿主 cron 每分钟保活;热门电影仍走豆瓣单接口(数据源不变,点击仍直达片源)
- **v-fixed132**:全新浏览器标签页图标——替换旧「暗黑肖像缩略图」favicon(16px 下糊成黑团),新图标为**深蓝渐变圆角底 + 天蓝播放三角 + 右上角星光**,与暗色主题/天蓝主色一致;16px 用专用优化版(三角放大加粗),32/48/64 为标准版(4K 超采样抗锯齿);同步更新 PWA 图标 `icons/icon-{192,256,384,512}.png`
- **v-fixed131**:相关推荐重做——数据改为**本站已有片源**,新增 `/api/related` 按 **主演/导演/语言/地区/类型** 五项元数据匹配打分(豆瓣推荐接口不再用于推荐);卡片点击带 `source+id` **直达实际片源开播**(播放页直达模式不再按标题搜索,杜绝片源对不上);「相关推荐」标题旁常驻显示匹配规则「按主演 / 导演 / 语言 / 地区 / 类型匹配 · 本站片源直达」,卡片下标注重合依据
- **v-fixed130**:详情页「相关推荐」标题旁显示推荐规则说明「豆瓣相似影片推荐 · 取前10」(数据来自豆瓣官方推荐接口,取前 10 条相似影片)
@@ -270,13 +272,13 @@ docker compose -f docker-compose.redis.yml down
```bash
# 公网可拉(匿名)
docker pull gitea.88531.cn/jinghui/katelyatv:latest # 固定版本
docker pull gitea.88531.cn/jinghui/katelyatv:fixed96
docker pull gitea.88531.cn/jinghui/katelyatv:fixed133
# 腾讯云 TCR(东京,公网匿名)
docker pull jpccr.ccs.tencentyun.com/jinghui/katelyatv:latest
```
当前版本:**v-fixed96**
当前版本:**v-fixed133**
## 🔗 源码
+68 -12
View File
@@ -10,25 +10,81 @@ export const runtime = 'edge';
// 聚合/class/9xx 映射逻辑已收拢到 @/lib/tvboxagg(旧补丁 ALL 逻辑的源码化实现),
// 本文件只负责:进程内缓存 + 出口。
// 进程内响应缓存:相同查询 60s 内直接返回,避免每次刷新都重新聚合上游(最新港剧等栏目秒开)
// 进程内响应缓存(stale-while-revalidate):
// - HIT:有数据 60s 内直接返回(浏览器同样 max-age=60);
// - STALE:过期后 10 分钟内先立刻返回旧数据,同时后台重新聚合——
// 多源聚合实测 8~18s,用户请求永远零等待(最新港剧与热门电影一样秒开);
// - 完全冷(容器刚重启、无任何旧数据)才同步等一次聚合。
const respCache = new Map<string, [number, any]>();
const refreshing = new Set<string>();
const FRESH_MS = 60000; // 有数据的强新鲜窗口
const FRESH_EMPTY_MS = 5000; // 空结果只短缓存 5s:上游偶发超时不能把空列表当正常数据缓存
const STALE_MS = 10 * 60 * 1000; // stale 窗口:旧数据最多用 10 分钟,期间后台必然已刷新
async function aggregateNow(cacheKey: string, sp: URLSearchParams): Promise<any | null> {
try {
const config = await getConfig();
const sourceConfigs: SrcCfg[] = (config.SourceConfig || []).filter((s: any) => !s.disabled);
const r = await aggregateAll(sourceConfigs, sp);
// 只缓存有数据的结果;空结果不驻留(下次请求立即重试)
if (r && Array.isArray(r.list) && r.list.length) {
respCache.set(cacheKey, [Date.now(), r]);
if (respCache.size > 200) respCache.clear();
return r;
}
} catch {
// 聚合失败静默:stale 数据继续可用,下次请求/预热会再试
}
return null;
}
// 后台刷新(同一 key 并发去重,避免多个过期请求同时打上游)
function refreshInBackground(cacheKey: string, sp: URLSearchParams) {
if (refreshing.has(cacheKey)) return;
refreshing.add(cacheKey);
aggregateNow(cacheKey, sp).finally(() => refreshing.delete(cacheKey));
}
export async function GET(request: NextRequest) {
const { searchParams } = new URL(request.url);
const cacheKey = searchParams.toString();
const now = Date.now();
const c = respCache.get(cacheKey);
// 空结果只缓存 5s:上游偶发超时不能把空列表当 60s 正常数据缓存(最新港剧整栏消失的根因之一)
const cTTL = c && c[1] && Array.isArray(c[1].list) && c[1].list.length ? 60000 : 5000;
if (c && now - c[0] < cTTL) {
const hasList = !!(c && c[1] && Array.isArray(c[1].list) && c[1].list.length);
const freshTTL = hasList ? FRESH_MS : FRESH_EMPTY_MS;
if (c && now - c[0] < freshTTL) {
return NextResponse.json(c[1], { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60', 'X-Cache': 'HIT' } });
}
const config = await getConfig();
const sourceConfigs: SrcCfg[] = (config.SourceConfig || []).filter((s: any) => !s.disabled);
const r = await aggregateAll(sourceConfigs, searchParams);
// 只缓存有数据的结果;空结果短缓存(上面 5s TTL)且不长期驻留
if (r && Array.isArray(r.list) && r.list.length) respCache.set(cacheKey, [now, r]);
// 防止缓存无限增长:超过 200 条清空
if (respCache.size > 200) respCache.clear();
return NextResponse.json(r, { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60' } });
// stale:先给旧数据、后台刷新——用户零等待
if (hasList && now - c[0] < STALE_MS) {
refreshInBackground(cacheKey, searchParams);
return NextResponse.json(c[1], { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60', 'X-Cache': 'STALE' } });
}
// 完全冷:没人有数据可给,只能同步聚合一等(配合下方启动预热 + 宿主保活 cron,正常用户几乎碰不到)
const r = await aggregateNow(cacheKey, searchParams);
return NextResponse.json(
r || { code: 1, msg: '数据列表', page: 1, pagecount: 1, limit: 0, total: 0, list: [] },
{ headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60' } },
);
}
// ---------- 启动预热 + 周期保活 ----------
// 模块被首个请求加载后:3s 后预热首页聚合键(最新港剧),此后每 55s 续一次
// (接在 60s fresh 窗口前),用户请求几乎永远命中 HIT/STALE。
// edge isolate 若不保留定时器则自然退化为"过期请求触发后台刷新",无副作用。
const WARM_KEYS = ['ac=videolist&t=902&pg=1&by=time'];
function scheduleWarm() {
const g = globalThis as any;
if (g.__tvboxAllWarm) return;
g.__tvboxAllWarm = true;
const run = () => {
for (const q of WARM_KEYS) {
const ent = respCache.get(q);
if (!ent || Date.now() - ent[0] > FRESH_MS - 5000) refreshInBackground(q, new URLSearchParams(q));
}
};
setTimeout(run, 3000);
setInterval(run, 55000);
}
scheduleWarm();
+24 -14
View File
@@ -36,28 +36,38 @@ export function ns(x: any, key: string) {
return Object.assign({}, x, { vod_id: String(key) + ':' + String(x.vod_id) });
}
// 源站分类表缓存:非空 10 分钟(分类表很稳定),空 30 秒(失败要尽快重试)
// 源站分类表缓存:非空 10 分钟(分类表很稳定),空 2 分钟(失败过 2 分钟再试,
// 30s 太短会让每分钟的刷新都重新踩满超时拖慢整体聚合)
const classCache = new Map<string, [number, any[], boolean]>();
export async function fetchClass(api: string): Promise<any[]> {
const now = Date.now();
const c = classCache.get(api);
if (c && (c[2] ? now - c[0] < 30000 : now - c[0] < 600000)) return c[1];
for (const ep of [api, api + (api.includes('?') ? '&' : '?') + 'ac=list', api + (api.includes('?') ? '&' : '?') + 'ac=class']) {
if (c && (c[2] ? now - c[0] < 120000 : now - c[0] < 600000)) return c[1];
// 三个候选端点并发竞速(旧行为是串行逐试:半死源每端点都等满 8s 超时,
// 最坏 3×8s=24s 拖死整体聚合——冷启动 60s 的主要来源);首个返回非空分类的端点即胜,
// 全部失败/超时(单端点 8s)才缓存空结果 → 冷启动最坏 8s 而非 24s
const eps = [api, api + (api.includes('?') ? '&' : '?') + 'ac=list', api + (api.includes('?') ? '&' : '?') + 'ac=class'];
const attempt = async (ep: string): Promise<any[]> => {
const ctrl = new AbortController();
const t = setTimeout(() => ctrl.abort(), 8000);
try {
const ctrl = new AbortController();
const t = setTimeout(() => ctrl.abort(), 8000);
const r = await fetch(ep, { headers: { 'User-Agent': UA, Accept: 'application/json' }, signal: ctrl.signal });
clearTimeout(t);
if (!r.ok) continue;
if (!r.ok) throw new Error('http ' + r.status);
const j = await r.json();
if (Array.isArray(j?.class) && j.class.length) {
classCache.set(api, [now, j.class, false]);
return j.class;
}
} catch {}
if (Array.isArray(j?.class) && j.class.length) return j.class;
throw new Error('no class');
} finally {
clearTimeout(t);
}
};
try {
const classes = await Promise.any(eps.map(attempt));
classCache.set(api, [now, classes, false]);
return classes;
} catch {
classCache.set(api, [now, [], true]);
return [];
}
classCache.set(api, [now, [], true]);
return [];
}
// 顶层 9xx 分类表 + 筛选器(旧补丁 MK):TVBox 端每个站点看到的就是这 7+1 个分类